Files

Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

2026-03-16 01:31:26 +08:00

2.4 KiB

Raw Blame 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）。
- 绿色合规证书：展示租户已获得的碳中和证书及对应订单。

交互草图：

+-----------------------------------------------------------+
| [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)

碳信用池数据的准实时性核对。
碳抵消成本的财务对账报表。
导出包含交易证明的绿色合规证书。

2.4 KiB Raw Blame History Unescape Escape

前端集成蓝图：碳信用交易撮合建议 (Carbon Credit Trading)

1. 业务意图 (Business Intent)

2. UI/UX 布局方案 (Layout Design)

3. API 交互契约 (API Integration)

4. 生产校验项 (FE Readiness)

2.4 KiB

Raw Blame History