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

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

archive/handover/sea-freight-advisor-ui.md

@@ -0,0 +1,47 @@
+# 前端集成方案：全球物流拥堵指数与航线优化建议 (Sea Freight Advisor) - [BIZ_OPS_160]
+
+## 1. 业务场景描述 (Business Context)
+- **目标**：全球贸易环境复杂，罢工、恶劣天气或港口瓶颈会严重拖慢发货时效。系统通过监控全球港口实时拥堵指数，为商户提供“避坑”建议和自动绕路方案。
+- **用户收益**：规避超长延迟，降低消费者退款率，提升供应链应对“黑天鹅”事件的韧性。
+
+## 2. UI 布局草图 (UI Layout Sketch)
+- **全球港口状态地图 (Global Port Map)**:
+  - 地图标记：主要国际港口（LAX, RTM, NGB, SIN 等）。
+  - 标记颜色：绿色（畅通）、黄色（拥堵）、红色（瘫痪/罢工）。
+- **受影响订单雷达 (Affected Shipments)**:
+  - 动态滚动条展示正在经过“红色”港口的订单号。
+  - 预计延迟天数实时更新。
+- **自适应路由策略 (Adaptive Routing Suggestions)**:
+  - 方案 A: `Switch to Air`（切换至空运，展示差价）。
+  - 方案 B: `Alternative Port`（切换至临近备选港口）。
+  - 方案 C: `Customer Notification`（自动向受影响买家发送道歉信并赠送优惠券）。
+
+## 3. 核心 API 字段映射 (API Mapping)
+- **后端服务**: `SeaFreightAdvisor.auditRoutes(tenantId, indices)`
+- **响应结构**:
+  ```json
+  {
+    "success": true,
+    "routingSuggestions": [
+      {
+        "port": "Los Angeles (LAX)",
+        "affectedCount": 150,
+        "advice": "LA 港口罢工导致平均等待期延长至 14 天。建议后续订单路由至 Long Beach (LGB) 或切换空运。"
+      }
+    ]
+  }
+  ```
+- **因果链呈现 (XAI Integration)**:
+  - 叙述：“根据实时海运遥测，LA 港口的作业效率下降 60%，触发预警门槛。系统建议对高货值订单执行空运 Failover。”
+
+## 4. 交互状态机 (Interaction State Machine)
+- **Hover Mark**: 鼠标悬停在港口图标上，展示该港口过去 30 天的拥堵趋势图。
+- **Apply Failover**: 点击“执行绕路”，系统自动更新 `cf_logistics_route` 优先级。
+
+## 5. ROI 可视化逻辑 (ROI Tracking)
+- **时效保全值**: 计算通过绕路成功规避的平均延迟天数。
+- **退款预防额**: 基于历史数据，预估通过提前通知买家而减少的“未收到货”纠纷退款。
+
+---
+**蓝图维护者**: AI-2 (Internal) | **版本**: V1.0  
+**相关任务**: [BIZ_OPS_160](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)