wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
This commit is contained in:
Ansonai
2026-03-16 01:31:26 +08:00
commit 6759d47de4
74 changed files with 9310 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/blueprints/frontend-integration/green-supply-chain-ui.md Normal file
View File

@@ -0,0 +1,46 @@
# 前端集成蓝图：绿色供应链碳足迹核算与抵扣 (Green Supply Chain)
> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_LOG_40 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**：自动计算订单与商品的碳排放，提供减排建议并建议购买碳抵扣额度，提升品牌绿色竞争力。
- **关联后端 Service**：`GreenSupplyChainService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**：Console -> 供应链管理 -> 绿色供应链
- **展示组件**：
- [ ] **碳足迹仪表盘**：展示累计碳排放与抵消额度。
- [ ] **订单碳足迹记录**：展示每笔订单的碳排放明细 (Logistics, Production, Packaging)。
- [ ] **减排建议卡片**：展示减排策略 (Strategy, Reduction, Cost)。
- **交互草图**：
```text
+-----------------------------------------------------------+
| [Icon] 绿色供应链碳足迹 (Green Supply Chain) |
+-----------------------------------------------------------+
| [ 累计碳排放: 1,500 kg CO2 ] [ 抵消金额: $37.50 ] |
+-----------------------------------------------------------+
| [ 订单 ID: ORD-1122 ] [ 碳足迹: 25.50 kg CO2 ] |
| --------------------------------------------------------- |
| 物流: 15.00 kg | 生产: 10.00 kg | 包装: 0.50 kg |
+-----------------------------------------------------------+
| [ AGI 减排建议 (Green Insight) ] |
| "建议：将空运转为海运 (LCL)，预估可减少 75% 碳排放。 |
| 相比空运节省成本：$200。时效增加：10 天。" |
+-----------------------------------------------------------+
| [ 忽略建议 ] [ 购买碳抵扣额度 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**：`GET /api/v1/trade/green/footprint?order_id=ORD-1122`
- **关键字段映射**
- `total_co2` -> 累计碳排放
- `offset_cost` -> 抵扣金额
- `status` -> 状态 (ESTIMATED, OFFSET_COMPLETED, etc.)
- **状态流转**：
- 点击 [购买碳抵扣额度] -> 调用 `GreenSupplyChainService.recordFootprint` -> 更新 `status` 为 `OFFSET_COMPLETED`。
## 4. 生产校验项 (FE Readiness)
- [ ] 碳足迹计算模型的参数可配置界面。
- [ ] 碳中和路径的长期跟踪看板。
- [ ] 导出包含详细证据链的绿色供应链报告。