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

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

archive/handover/carbon-credit-trading-ui.md

@@ -0,0 +1,46 @@
+# 前端集成蓝图：碳信用交易撮合建议 (Carbon Credit Trading)
+
+> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_LOG_60 逻辑后产出。
+
+## 1. 业务意图 (Business Intent)
+- **核心价值**：聚合租户碳足迹数据，撮合碳抵扣额度购买，提升品牌绿色合规等级，增强 DTC 品牌溢价。
+- **关联后端 Service**：`CarbonCreditTradingService.ts`
+
+## 2. UI/UX 布局方案 (Layout Design)
+- **页面入口**：Console -> 供应链管理 -> 绿色供应链 -> 碳信用交易
+- **展示组件**：
+    - [ ] **碳中和看板**：展示租户已抵消的碳排放量。
+    - [ ] **碳信用交易列表**：展示 AGI 撮合的碳抵扣交易（Credits, Cost, Provider）。
+    - [ ] **绿色合规证书**：展示租户已获得的碳中和证书及对应订单。
+- **交互草图**：
+    ```text
+    +-----------------------------------------------------------+
+    | [Icon] 碳信用交易管理 (Carbon Credit Trading)           |
+    +-----------------------------------------------------------+
+    | [ 累计抵消: 4,500 kg CO2 ] [ 状态: 已抵消 (SETTLED) ]      |
+    +-----------------------------------------------------------+
+    | [ 碳抵扣撮合建议 (Credit Match) ]                         |
+    | --------------------------------------------------------- |
+    | 建议抵扣: 250 kg | 成本: $6.25 | 供应商: Carbon-Pool-X    |
+    +-----------------------------------------------------------+
+    | [ AGI 绿色建议 (Green Insight) ]                          |
+    | "该订单 (ORD-1122) 碳足迹为 25.5 kg。建议购买碳信用 |
+    | 以抵销。抵消后可解锁：'绿色品牌' 标签及 10% 税务减免。" |
+    +-----------------------------------------------------------+
+    | [ 忽略建议 ]                      [ 确认购买并抵扣 ]       |
+    +-----------------------------------------------------------+
+    ```
+
+## 3. API 交互契约 (API Integration)
+- **数据获取**：`GET /api/v1/trade/green/trading/matches`
+- **关键字段映射**
+    - `credits_purchased` -> 抵扣额度
+    - `cost_amount` -> 交易成本
+    - `provider_did` -> 提供商 DID
+- **状态流转**：
+    - 撮合建议 -> `PENDING` -> 交易确认 -> `SETTLED`。
+
+## 4. 生产校验项 (FE Readiness)
+- [ ] 碳信用池数据的准实时性核对。
+- [ ] 碳抵消成本的财务对账报表。
+- [ ] 导出包含交易证明的绿色合规证书。