Files
makemd/docs/blueprints/frontend-integration/carbon-pledge-ui.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

48 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端集成蓝图:自动化供应链碳配额质押建议 (Carbon Pledge)
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_TRADE_60 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**:允许租户将积累的碳抵扣额度作为“绿色资产”质押,换取更优的采购账期、更低的手续费或更高的授信额度。
- **关联后端 Service**`CarbonPledgeService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> 供应链管理 -> 绿色供应链 -> 碳配额质押
- **展示组件**
- [ ] **可质押资产看板**:展示租户当前的累计碳信用额度。
- [ ] **权益兑换建议表**:展示 AGI 建议的质押方案及对应收益。
- [ ] **质押合约状态流**:展示已生效的质押记录及其对账期的影响。
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] 碳配额质押建议 (Carbon Pledge) |
+-----------------------------------------------------------+
| [ 可质押总额: 5,000 kg ] [ 已质押: 1,200 kg ] |
+-----------------------------------------------------------+
| [ AGI 权益建议 (Pledge Suggestion) ] |
| --------------------------------------------------------- |
| 建议质押: 2,500 kg | 目标收益: 账期延长 15 天 (Net-45) |
| 收益价值: 预估节省资金成本 $120.00/月 |
+-----------------------------------------------------------+
| [ AGI 洞察 ] |
| "监测到您的碳信用充足,通过质押 50% 的配额,可显著优化 |
| 资金周转率。该操作不会影响您的绿色品牌评级。" |
+-----------------------------------------------------------+
| [ 拒绝建议 ] [ 确认质押并应用权益 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/trade/green/pledge/suggestions`
- **关键字段映射**
- `pledge_amount` -> 质押量
- `target_benefit` -> 目标收益
- `status` -> 质押状态
- **状态流转**
- 触发质押 -> `PENDING` -> 供应商/平台确认 -> `ACTIVE`。
## 4. 生产校验项 (FE Readiness)
- [ ] 碳信用资产的锁定与释放逻辑界面。
- [ ] 账期变动在财务模块的实时映射。
- [ ] 导出包含绿色金融贡献的租户年度审计报告。