Files
makemd/docs/blueprints/frontend-integration/compliance-certificate-ui.md

48 lines
2.5 KiB
Markdown
Raw Normal View History

# 前端集成蓝图:合规证书自动化生成 (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 证书。