feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义

archive/handover/biz-sup-15-sourcing-optimization.md

@@ -0,0 +1,42 @@
+# 前端集成蓝图：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/年）需有特殊高亮动画。