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

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

archive/handover/intermodal-failover-ui.md

@@ -0,0 +1,49 @@
+# 前端集成蓝图：弹性多式联运自动对冲引擎 (Intermodal Failover)
+
+> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_LOG_50 逻辑后产出。
+
+## 1. 业务意图 (Business Intent)
+- **核心价值**：当全球主航道发生黑天鹅事件时，自动计算并执行多式联运切换（如海转铁），最小化时效延误。
+- **关联后端 Service**：`IntermodalFailoverService.ts`
+
+## 2. UI/UX 布局方案 (Layout Design)
+- **页面入口**：Console -> 履约中心 -> 多式联运调度
+- **展示组件**：
+    - [ ] **全球航道监控图**：展示苏伊士运河、巴拿马运河等关键航道的实时拥堵度。
+    - [ ] **多式联运切换建议列表**：展示 AGI 生成的 Failover 建议（SEA_TO_RAIL, SEA_TO_AIR）。
+    - [ ] **时效-成本平衡图**：对比原始海运路径与多式联运路径的时效提升与成本增加。
+- **交互草图**：
+    ```text
+    +-----------------------------------------------------------+
+    | [Icon] 多式联运自愈看板 (Intermodal Failover)           |
+    +-----------------------------------------------------------+
+    | [ 原始路径: 苏伊士运河 (Sea) ] [ 状态: 严重堵塞 (BLOCKED) ] |
+    +-----------------------------------------------------------+
+    | 目的地: 伦敦 (London) | 预估延误: 25 天                    |
+    +-----------------------------------------------------------+
+    | [ AGI 路由自愈建议 (Failover Suggestion) ]                |
+    | --------------------------------------------------------- |
+    | 建议：切换至 [中欧班列 (Sea-to-Rail)]                     |
+    | 时效：-10 天 (缩短 10 天) | 成本：+$5.2/kg (建议对冲)     |
+    | --------------------------------------------------------- |
+    | [?] 为何建议？                                            |
+    | "苏伊士运河发生长达 15 天的严重拥堵，海转铁成本仅增加 |
+    | $5.2/kg，但可避免 10 天以上的订单违约风险。"            |
+    +-----------------------------------------------------------+
+    | [ 忽略建议 ]                      [ 确认切换并对冲运费 ]   |
+    +-----------------------------------------------------------+
+    ```
+
+## 3. API 交互契约 (API Integration)
+- **数据获取**：`GET /api/v1/logistics/failover/calculate?original_route_id=SEA-001`
+- **关键字段映射**
+    - `method` -> 切换方法 (SEA_TO_RAIL, etc.)
+    - `estimated_cost` -> 预估切换成本
+    - `timeframe_days` -> 预估时效
+- **状态流转**：
+    - 切换发现风险 -> 调用 `IntermodalFailoverService.calculateFailover` -> 重新渲染成本对比图。
+
+## 4. 生产校验项 (FE Readiness)
+- [ ] 实时获取全球航道拥堵数据。
+- [ ] 支持针对大批量订单的一键批量切换。
+- [ ] 导出包含多式联运切换路径的物流报告。