48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# 前端集成蓝图：合规证书自动化生成 (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 证书。
|