makemd/docs/blueprints/frontend-integration/supplier-capacity-watch.md

前端集成蓝图：自动化供应商产能预警 (Supplier Capacity Watch)

[AI-3 @ 2026-03-14]：由后端 Agent 在完成 BIZ_TRADE_30 逻辑后产出。

1. 业务意图 (Business Intent)

• 核心价值：提前感知供应商交期延误风险，通过 AGI 预测产能饱和度，自动建议切换备选源。
• 关联后端 Service：SupplierCapacityWatchService.ts

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

• 页面入口：Console -> 供应链管理 -> 供应商产能看板
• 展示组件：
  • 产能饱和度图表：展示各供应商的积压比例 (Backlog Ratio)。
  • 风险预警列表：高亮显示 risk_score 超过阈值的供应商。
  • 交期延误预测：展示各供应商的预估延误天数。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 供应商产能看板 (Supplier Capacity Watch)           |
  +-----------------------------------------------------------+
  | [ 状态：严重预警 (CRITICAL) ]                             |
  | 供应商 ID: SUP-001 | 积压比例: 145% | 预估延误: 8 天     |
  +-----------------------------------------------------------+
  | 最大日产能: 10,000 | 当前积压: 14,500 | 平均交期: 7 天    |
  +-----------------------------------------------------------+
  | [ AGI 风险洞察 (Capacity Insight) ]                      |
  | "供应商 SUP-001 产能严重过载，积压比例达 145%，预估   |
  | 交期延误 8 天。建议切换备选源 SUP-002，其目前产能充足。"|
  +-----------------------------------------------------------+
  | [ 保持现状 ]                      [ 切换至备选源 SUP-002 ] |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/trade/supplier/capacity
• 关键字段映射
  • backlog_ratio -> 积压比例
  • estimated_delay_days -> 预估延误天数
  • risk_score -> 风险评分
• 状态流转：
  • 点击 [切换备选源] -> 调用 POST /api/v1/trade/sourcing/failover -> 更新后端采购路由。

4. 生产校验项 (FE Readiness)

• 供应商产能数据的准实时性（< 1 hour 延迟）。
• 备选源的产能余量实时检查。
• 导出包含风险预测的采购报告。