Files
makemd/docs/blueprints/frontend-integration/supplier-capacity-watch.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

46 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端集成蓝图:自动化供应商产能预警 (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 延迟)。
- [ ] 备选源的产能余量实时检查。
- [ ] 导出包含风险预测的采购报告。