makemd/docs/blueprints/frontend-integration/biz-sup-15-sourcing-optimization.md

前端集成蓝图：1688 极速降本比价建议 (Sourcing Optimization)

[AI-1 @ 2026-03-14]：基于 SupplyChainService.ts 补全。

1. 业务意图 (Business Intent)

• 核心价值：通过实时比价锁定 1688 源头工厂，为运营提供一键切换货源的决策支持，直接降低采购成本。
• 关联后端 Service：SupplyChainService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 供应链 -> 降本建议
• 展示组件：
  • 货源对比矩阵 (Source Matrix)：左侧为当前供应商，右侧为 1688 推荐供应商，对比单价、MOQ、交期。
  • ROI 预测环：展示“切换后年化节省总额”。
• 交互草图：

  +-----------------------------------------------------------+
  | [货源切换建议] SKU-8899 | 预期单均节省：$1.50 (降幅 18%)    |
  +-----------------------------------------------------------+
  | 当前源 (Local) | VS | 推荐源 (1688 Direct Factory)        |
  | 单价: $8.50    |    | 单价: $7.00                         |
  | 交期: 3天      |    | 交期: 5天 (风险可控)                |
  +-----------------------------------------------------------+
  | [?] AGI 深度分析：                                        |
  | "该 1688 供应商为勋章工厂，评分 4.8，与当前款式匹配度 98%..." |
  +-----------------------------------------------------------+
  | [ 暂时保留 ]                      [ 一键更新采购路由 ]    |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/sourcing/suggestions?type=COST_DOWN
• 关键字段：
  • current_source_info -> 当前货源详情
  • suggested_source_info -> 1688 货源详情
  • causalChain -> 供应商信誉与匹配度分析
• 状态流转：
  • 应用建议 -> POST /api/v1/sourcing/apply-suggestion -> 自动更新 cf_product_sourcing 关联。

4. 生产校验项 (FE Readiness)

• 需支持 1688 商品主图点击预览。
• 利润提升计算逻辑需包含“跨境运费摊销”差异。
• 针对大额节省（> $10,000/年）需有特殊高亮动画。