# 前端集成蓝图：自动化供应商产能预警 (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` 超过阈值的供应商。
    - [ ] **交期延误预测**：展示各供应商的预估延误天数。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [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 延迟）。
- [ ] 备选源的产能余量实时检查。
- [ ] 导出包含风险预测的采购报告。