docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
49
docs/blueprints/frontend-integration/did-settlement.md
Normal file
49
docs/blueprints/frontend-integration/did-settlement.md
Normal file
@@ -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 身份的实名/实体认证校验。
|
||||
- [ ] 大额清算的二次确认机制。
|
||||
- [ ] 导出加密格式的清算审计流水。
|
||||
Reference in New Issue
Block a user