# 📋 前端实现方案：AGI 销量预测与智能补货 (Inventory Forecast)

## 1. UI 布局草图 (UI Layout Sketch)

```
+-------------------------------------------------------------------------+
| [Breadcrumb: Console > Inventory > Smart Replenish]                     |
+-------------------------------------------------------------------------+
| [Search SKU: [__________]] [Filter: Low Stock Only [x]]                 |
+-------------------------------------------------------------------------+
| +---------------------------------------------------------------------+ |
| | SKU: SKU-9988 (Handheld Blender)                                    | |
| |---------------------------------------------------------------------| |
| | [当前库存: 45 PCS] [7天日均销量: 12.5 PCS] [预计可用天数: 3.6 Days]     | |
| |---------------------------------------------------------------------| |
| | [销量预测 (7 Days Forecast)]                                         | |
| | [Chart: 历史销量(蓝线) vs AI 预测销量(绿虚线)]                         | |
| |---------------------------------------------------------------------| |
| | [AI 补货建议 (Replenishment Advice)]                                 | |
| | > 建议立即补货: 200 PCS                                              | |
| | > 理由: 销售速率增长 20%，当前库存无法支撑至下次补货到货 (Lead time: 7d) | |
| | [按钮: 生成采购单 (Create PO)] [按钮: 忽略建议 (Ignore)]               | |
| +---------------------------------------------------------------------+ |
+-------------------------------------------------------------------------+
```

## 2. 交互状态机 (Interaction FSM)

- **IDLE**: 展示待补货列表。
- **PREDICTING**: 点击“刷新预测”按钮，调用 `/api/trade/inventory/forecast/:skuId`。
- **ADVISING**: 渲染 AI 建议与 PO 预填单。
- **EXECUTING**: 点击“生成采购单”，调用 `TradeService.createPurchaseOrder`，按钮进入 Loading。
- **COMPLETED**: 采购单生成成功，自动跳转至 PO 详情页。

## 3. 核心 API 字段映射 (API Field Mapping)

| 前端字段 (Frontend) | 后端 API 字段 (Backend) | 说明 (Description) |
| :--- | :--- | :--- |
| 7天日均销量 | `avgDailySales7d` | 最近一周的真实动销速率 |
| AI 预测总量 | `forecastNext7d` | 未来一周的预测销量 |
| 信心指数 | `confidenceScore` | AI 对预测结果的把握度 (0-1) |
| 建议补货量 | `policy.orderQuantity` | 来自 RL 算法的最优订单量 |
| 补货触发点 | `policy.reorderPoint` | 当库存低于此值时建议补货 |

## 4. ROI 可视化逻辑 (ROI Visualization)

- **缺货风险分值**: 红色 (Risk > 80) / 橙色 (Risk > 50) / 绿色 (Safe)。
- **补货 ROI 预估**: 联动 `InventoryRLService` 展示“补货后预计挽回的缺货损失” vs “仓储成本增加额”。