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

46 lines
2.4 KiB
Markdown
Raw Normal View History

# 前端集成蓝图:自动化供应商产能预警 (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 延迟)。
- [ ] 备选源的产能余量实时检查。
- [ ] 导出包含风险预测的采购报告。