Files
makemd/archive/handover/carbon-credit-trading-ui.md

47 lines
2.4 KiB
Markdown
Raw Normal View History

# 前端集成蓝图:碳信用交易撮合建议 (Carbon Credit Trading)
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_LOG_60 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**:聚合租户碳足迹数据,撮合碳抵扣额度购买,提升品牌绿色合规等级,增强 DTC 品牌溢价。
- **关联后端 Service**`CarbonCreditTradingService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> 供应链管理 -> 绿色供应链 -> 碳信用交易
- **展示组件**
- [ ] **碳中和看板**:展示租户已抵消的碳排放量。
- [ ] **碳信用交易列表**:展示 AGI 撮合的碳抵扣交易Credits, Cost, Provider
- [ ] **绿色合规证书**:展示租户已获得的碳中和证书及对应订单。
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] 碳信用交易管理 (Carbon Credit Trading) |
+-----------------------------------------------------------+
| [ 累计抵消: 4,500 kg CO2 ] [ 状态: 已抵消 (SETTLED) ] |
+-----------------------------------------------------------+
| [ 碳抵扣撮合建议 (Credit Match) ] |
| --------------------------------------------------------- |
| 建议抵扣: 250 kg | 成本: $6.25 | 供应商: Carbon-Pool-X |
+-----------------------------------------------------------+
| [ AGI 绿色建议 (Green Insight) ] |
| "该订单 (ORD-1122) 碳足迹为 25.5 kg。建议购买碳信用 |
| 以抵销。抵消后可解锁:'绿色品牌' 标签及 10% 税务减免。" |
+-----------------------------------------------------------+
| [ 忽略建议 ] [ 确认购买并抵扣 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/trade/green/trading/matches`
- **关键字段映射**
- `credits_purchased` -> 抵扣额度
- `cost_amount` -> 交易成本
- `provider_did` -> 提供商 DID
- **状态流转**
- 撮合建议 -> `PENDING` -> 交易确认 -> `SETTLED`
## 4. 生产校验项 (FE Readiness)
- [ ] 碳信用池数据的准实时性核对。
- [ ] 碳抵消成本的财务对账报表。
- [ ] 导出包含交易证明的绿色合规证书。