wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
43 lines
2.3 KiB
Markdown
43 lines
2.3 KiB
Markdown
# 前端集成蓝图：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/年）需有特殊高亮动画。
|