Files
makemd/docs/blueprints/frontend-integration/private-lc-ui.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

48 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端集成蓝图:基于 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 证明的信用证正本。