Files

Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

2026-03-16 01:31:26 +08:00

2.5 KiB

Raw Blame 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 签名。
- 多国合规政策提示：展示各国所需的证书类型。

交互草图：

+-----------------------------------------------------------+
| [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 证书。

2.5 KiB Raw Blame History Unescape Escape

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

1. 业务意图 (Business Intent)

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

3. API 交互契约 (API Integration)

4. 生产校验项 (FE Readiness)

2.5 KiB

Raw Blame History