52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# 前端集成方案：海外仓库龄过长清仓建议 (Aging Inventory) - [BIZ_OPS_156]
|
||
|
||
## 1. 业务场景描述 (Business Context)
|
||
- **目标**：识别在海外仓积压超过 90 天的“死货”，通过自动化的打折、清仓建议释放资金流，降低仓储成本。
|
||
- **用户收益**：提升库存周转率，减少坏账计提，实时掌握全球各仓的资金沉淀情况。
|
||
|
||
## 2. UI 布局草图 (UI Layout Sketch)
|
||
- **顶部看板 (Aging KPIs)**:
|
||
- `Dead Stock Value`: 积压超过 90 天的库存总价值（美元）。
|
||
- `Avg Inventory Age`: 全球平均库龄。
|
||
- `Potential Cash Release`: 预计通过清仓可释放的现金总额。
|
||
- **中部：库龄分布直方图 (Aging Distribution Chart)**:
|
||
- X 轴：库龄区间（0-30, 31-60, 61-90, 90+ 天）。
|
||
- Y 轴：SKU 数量或库存金额。
|
||
- **底部：积压 SKU 清单 (Aging SKU List)**:
|
||
- 表格列：SKU ID、仓库、库龄（天）、库存价值、建议操作（`DISCOUNT`, `CLEARANCE`, `LIQUIDATE`）。
|
||
- 操作项：`Apply Discount`（一键同步到多平台改价）、`View Causal Chain`（查看 AI 清仓理由）。
|
||
|
||
## 3. 核心 API 字段映射 (API Mapping)
|
||
- **后端服务**: `InventoryAgingService.analyzeAging(tenantId)`
|
||
- **响应结构**:
|
||
```json
|
||
{
|
||
"success": true,
|
||
"data": [
|
||
{
|
||
"skuId": "SKU-9981",
|
||
"warehouseId": "US-WEST-01",
|
||
"agingDays": 125,
|
||
"stockValue": 5200.50,
|
||
"suggestedAction": "CLEARANCE"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
- **因果链呈现 (XAI Integration)**:
|
||
- 提示词：`DecisionExplainabilityEngine.getDecisionNarrative`
|
||
- 示例：“该 SKU 已在美西仓积压 125 天，且过去 30 天零动销，资金沉淀 $5200.50，建议执行 5 折清仓以释放库位。”
|
||
|
||
## 4. 交互状态机 (Interaction State Machine)
|
||
- **Init**: 加载时按仓库维度聚合库龄。
|
||
- **Filter**: 支持按仓库、价格区间、类目筛选。
|
||
- **Bulk Action**: 勾选多个 SKU 批量执行 `Batch Approve Suggestions`。
|
||
|
||
## 5. ROI 可视化逻辑 (ROI Tracking)
|
||
- **资产释放率**: 清仓完成后展示回笼资金量。
|
||
- **仓储费节省**: 预计可节省的月度仓储费用（基于库位占用率）。
|
||
|
||
---
|
||
**蓝图维护者**: AI-2 (Internal) | **版本**: V1.0
|
||
**相关任务**: [BIZ_OPS_156](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)
|