docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
45
docs/blueprints/frontend-integration/trade-compliance-ui.md
Normal file
45
docs/blueprints/frontend-integration/trade-compliance-ui.md
Normal file
@@ -0,0 +1,45 @@
|
||||
# 前端集成蓝图:AGI 驱动的全球合规与制裁扫描 (Compliance Scan)
|
||||
|
||||
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_TRADE_40 逻辑后产出。
|
||||
|
||||
## 1. 业务意图 (Business Intent)
|
||||
- **核心价值**:自动扫描订单与 SKU,识别全球贸易禁令与出口管制风险,防止商户产生合规违约金。
|
||||
- **关联后端 Service**:`TradeComplianceService.ts`
|
||||
|
||||
## 2. UI/UX 布局方案 (Layout Design)
|
||||
- **页面入口**:Console -> 供应链管理 -> 合规中心
|
||||
- **展示组件**:
|
||||
- [ ] **风险扫描仪表盘**:展示当前待审核订单的合规风险评分。
|
||||
- [ ] **违规详情卡片**:列出具体的制裁项或禁运理由。
|
||||
- [ ] **合规热力图**:展示全球各目的国的风险等级分布。
|
||||
- **交互草图**:
|
||||
```text
|
||||
+-----------------------------------------------------------+
|
||||
| [Icon] 全球合规与制裁扫描 (Trade Compliance) |
|
||||
+-----------------------------------------------------------+
|
||||
| [ 订单 ID: ORD-9988 ] [ 风险等级: 高 (HIGH) ] [ 评分: 90 ] |
|
||||
+-----------------------------------------------------------+
|
||||
| 目的国: 伊朗 (IR) | 风险详情: 该国家目前处于 OFAC 全面制裁名单 |
|
||||
+-----------------------------------------------------------+
|
||||
| [ AGI 合规建议 (Compliance Insight) ] |
|
||||
| "建议决策:阻断 (BLOCK)。订单目的国属于制裁名单,继续履 |
|
||||
| 约将面临极高法律风险。系统已自动挂起该订单。" |
|
||||
+-----------------------------------------------------------+
|
||||
| [ 强制放行 ] [ 取消订单并退款 ] |
|
||||
+-----------------------------------------------------------+
|
||||
```
|
||||
|
||||
## 3. API 交互契约 (API Integration)
|
||||
- **数据获取**:`GET /api/v1/trade/compliance/scan?order_id=ORD-9988`
|
||||
- **关键字段映射**
|
||||
- `risk_score` -> 风险评分
|
||||
- `is_compliant` -> 是否合规
|
||||
- `violations` -> 违规项列表
|
||||
- `suggested_action` -> 建议动作
|
||||
- **状态流转**:
|
||||
- 扫描发现风险 -> 订单自动进入 `PENDING_REVIEW` -> 管理员在 Console 端确认。
|
||||
|
||||
## 4. 生产校验项 (FE Readiness)
|
||||
- [ ] 实时更新全球制裁名单库。
|
||||
- [ ] 支持针对特定 SKU 类别的分级合规检查。
|
||||
- [ ] 导出包含详细证据链的合规审计报告。
|
||||
Reference in New Issue
Block a user