wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
2.5 KiB
2.5 KiB
前端集成蓝图：绿色供应链碳足迹核算与抵扣 (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)。
- 交互草图：
+-----------------------------------------------------------+ | [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)
- 碳足迹计算模型的参数可配置界面。
- 碳中和路径的长期跟踪看板。
- 导出包含详细证据链的绿色供应链报告。