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

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

archive/handover/did-settlement.md

@@ -0,0 +1,49 @@
+# 前端集成蓝图：基于 DID 的自治清算协议 (DID Settlement)
+
+> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_FIN_40 逻辑后产出。
+
+## 1. 业务意图 (Business Intent)
+- **核心价值**：自动化处理品牌方、代运营与达人的三方自动分润，降低结算争议 95%，实现“无感清算”。
+- **关联后端 Service**：`DIDSettlementService.ts`
+
+## 2. UI/UX 布局方案 (Layout Design)
+- **页面入口**：Console -> 财务中心 -> 自治清算管理
+- **展示组件**：
+    - [ ] **DID 合约看板**：展示各主体的 DID 身份与分成比例。
+    - [ ] **清算记录表**：展示每笔订单的清算状态与隐私存证证明。
+    - [ ] **分润热力图**：展示各主体的历史收益占比。
+- **交互草图**：
+    ```text
+    +-----------------------------------------------------------+
+    | [Icon] 自治清算管理 (DID-based Settlement)               |
+    +-----------------------------------------------------------+
+    | [ 当前合约状态：已激活 (ACTIVE) ]                         |
+    | - 品牌方 (Brand): 70% [DID: brand-001] [✅ Verified]      |
+    | - 代运营 (Ops):   20% [DID: ops-002]   [✅ Verified]      |
+    | - 达人 (KOL):     10% [DID: kol-003]   [✅ Verified]      |
+    +-----------------------------------------------------------+
+    | [ 最近清算记录 (Last 10 Settlements) ]                    |
+    | --------------------------------------------------------- |
+    | Order ID | Party | Amount | Status | ZKP Proof          |
+    | ORD-1234 | Brand | $140.0 | ✅ Done | [ View Proof ]     |
+    | ORD-1234 | Ops   | $40.0  | ✅ Done | [ View Proof ]     |
+    | ORD-1234 | KOL   | $20.0  | ✅ Done | [ View Proof ]     |
+    +-----------------------------------------------------------+
+    | [?] 审计备注：所有清算均通过 ZKP 存证，隐私且不可篡改。   |
+    +-----------------------------------------------------------+
+    ```
+
+## 3. API 交互契约 (API Integration)
+- **数据获取**：`GET /api/v1/finance/settlement/did`
+- **关键字段映射**：
+    - `party_did` -> DID 标识
+    - `party_role` -> 角色
+    - `amount` -> 清算金额
+    - `proof_hash` -> ZKP 证明哈希
+- **状态流转**：
+    - 点击 [View Proof] -> 调用 `PrivateAuditService.verifyProof` -> 展示验证通过标识。
+
+## 4. 生产校验项 (FE Readiness)
+- [ ] DID 身份的实名/实体认证校验。
+- [ ] 大额清算的二次确认机制。
+- [ ] 导出加密格式的清算审计流水。