makemd/docs/blueprints/frontend-integration/inventory-aging-ui.md

前端集成方案：海外仓库龄过长清仓建议 (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)
• 响应结构:

  {
    "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