- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# 前端集成蓝图:基于 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 证明的信用证正本。
|