Files
makemd/archive/handover/private-lc-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.6 KiB
Raw Blame History

前端集成蓝图:基于 ZKP 的链上隐私信用证 (Private L/C)

[AI-3 @ 2026-03-14]:由后端 Agent 在完成 BIZ_FIN_70 逻辑后产出。

1. 业务意图 (Business Intent)

  • 核心价值:利用 ZKP 保护商业机密(如供应商 ID、具体利润同时向金融机构证明交易真实性以换取信贷。
  • 关联后端 ServiceSovereignPrivateLCService.ts

2. UI/UX 布局方案 (Layout Design)

  • 页面入口Console -> 财务中心 -> 隐私信用证管理
  • 展示组件
    • 信用证看板:展示信用证合约列表 (ID, Amount, Status, Expiry)。
    • ZKP 证明验证卡:展示隐私存证证明的哈希与验证状态。
    • 交易流转追踪:展示信用证的签发、议付、承付全过程。
  • 交互草图
    +-----------------------------------------------------------+
    | [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 证明的信用证正本。