# 前端集成蓝图：合规证书自动化生成 (Compliance Certificate)

> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_TRADE_50 逻辑后产出。

## 1. 业务意图 (Business Intent)
- **核心价值**：自动提取订单数据并生成符合目的国要求的电子合规证书（原产地证、CE、FDA），减少人工录入 90%，确保合规过关。
- **关联后端 Service**：`ComplianceCertificateService.ts`

## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**：Console -> 供应链管理 -> 合规中心 -> 合规证书
- **展示组件**：
    - [ ] **已生成证书流水**：展示每笔订单生成的电子合规证书及其状态。
    - [ ] **合规证书预览**：展示证书详情及对应的 DID 签名。
    - [ ] **多国合规政策提示**：展示各国所需的证书类型。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [Icon] 合规证书管理 (Compliance Certificates)           |
    +-----------------------------------------------------------+
    | [ 证书 ID: CERT-2233 ] [ 状态: 已生成 (GENERATED) ]       |
    +-----------------------------------------------------------+
    | 证书类型: 原产地证 (ORIGIN) | 颁发机构: DID-Gov-Hub     |
    +-----------------------------------------------------------+
    | [ 证书预览 (Certificate Preview) ]                         |
    | 订单 ID: ORD-5566 | 目的地: 德国 (DE) | 有效期: 12 个月  |
    +-----------------------------------------------------------+
    | [ AGI 合规建议 (Compliance Insight) ]                    |
    | "系统已基于订单数据自动生成电子原产地证。已通过 DID 签 |
    | 名，符合欧盟 IOSS 合规通关要求。"                      |
    +-----------------------------------------------------------+
    | [ 撤销证书 ]                      [ 下载电子正本 (PDF) ]   |
    +-----------------------------------------------------------+
    ```

## 3. API 交互契约 (API Integration)
- **数据获取**：`GET /api/v1/trade/compliance/certificates?order_id=ORD-5566`
- **关键字段映射**
    - `certificate_type` -> 证书类型
    - `digital_signature` -> 电子签名
    - `valid_until` -> 有效期
- **状态流转**：
    - 触发生成 -> `GENERATED` -> 被海关/第三方验证 -> `VERIFIED`。

## 4. 生产校验项 (FE Readiness)
- [ ] 证书生成逻辑的准实时性核对。
- [ ] 证书预览界面的水印保护。
- [ ] 导出包含数字签名的 PDF 证书。