docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

docs/blueprints/frontend-integration/private-lc-ui.md

@@ -0,0 +1,47 @@
+# 前端集成蓝图：基于 ZKP 的链上隐私信用证 (Private L/C)
+
+> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_FIN_70 逻辑后产出。
+
+## 1. 业务意图 (Business Intent)
+- **核心价值**：利用 ZKP 保护商业机密（如供应商 ID、具体利润），同时向金融机构证明交易真实性以换取信贷。
+- **关联后端 Service**：`SovereignPrivateLCService.ts`
+
+## 2. UI/UX 布局方案 (Layout Design)
+- **页面入口**：Console -> 财务中心 -> 隐私信用证管理
+- **展示组件**：
+    - [ ] **信用证看板**：展示信用证合约列表 (ID, Amount, Status, Expiry)。
+    - [ ] **ZKP 证明验证卡**：展示隐私存证证明的哈希与验证状态。
+    - [ ] **交易流转追踪**：展示信用证的签发、议付、承付全过程。
+- **交互草图**：
+    ```text
+    +-----------------------------------------------------------+
+    | [Icon] 隐私信用证管理 (Private L/C)                      |
+    +-----------------------------------------------------------+
+    | [ 状态：已签发 (ISSUED) ] [ 合约 ID: LC-5544 ]            |
+    +-----------------------------------------------------------+
+    | 开证行: DID-Bank-X | 受益人: DID-Supplier-Y | 金额: $50,000 |
+    +-----------------------------------------------------------+
+    | [ ZKP 隐私存证 (Private Proof) ]                          |
+    | 证明哈希: 0x8f2...e3d | [ 验证证明真实性 ] [ 隐私设置 ]     |
+    +-----------------------------------------------------------+
+    | [ AGI 金融建议 (Finance Insight) ]                       |
+    | "该信用证已通过 ZKP 存证，隐私且不可篡改。供应商 ID 已 |
+    | 被屏蔽，开证行无法识别底层供应源，保护商业机密。"        |
+    +-----------------------------------------------------------+
+    | [ 撤销合约 ]                      [ 发起议付请求 ]         |
+    +-----------------------------------------------------------+
+    ```
+
+## 3. API 交互契约 (API Integration)
+- **数据获取**：`GET /api/v1/finance/lc/contracts`
+- **关键字段映射**
+    - `zkp_proof_hash` -> ZKP 证明哈希
+    - `status` -> 合约状态 (ISSUED, HONORED, etc.)
+    - `expiry_date` -> 过期日期
+- **状态流转**：
+    - 点击 [验证证明真实性] -> 调用 `PrivateAuditService.verifyProof` -> 展示验证通过标识。
+
+## 4. 生产校验项 (FE Readiness)
+- [ ] 针对不同层级（如银行、供应商、平台）的隐私级别设置界面。
+- [ ] 信用证到期自动提醒机制。
+- [ ] 导出包含 ZKP 证明的信用证正本。