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

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

## 1. 业务意图 (Business Intent)
- **核心价值**：通过实时比价锁定 1688 源头工厂，为运营提供一键切换货源的决策支持，直接降低采购成本。
- **关联后端 Service**：[SupplyChainService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/SupplyChainService.ts)

## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**：Console -> 供应链 -> 降本建议
- **展示组件**：
    - **货源对比矩阵 (Source Matrix)**：左侧为当前供应商，右侧为 1688 推荐供应商，对比单价、MOQ、交期。
    - **ROI 预测环**：展示“切换后年化节省总额”。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [货源切换建议] 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)
- [x] 需支持 1688 商品主图点击预览。
- [x] 利润提升计算逻辑需包含“跨境运费摊销”差异。
- [x] 针对大额节省（> $10,000/年）需有特殊高亮动画。