# 前端集成蓝图：基于 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 证明的信用证正本。