Files
makemd/archive/handover/trade-compliance-ui.md

46 lines
2.3 KiB
Markdown
Raw Normal View History

# 前端集成蓝图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 类别的分级合规检查。
- [ ] 导出包含详细证据链的合规审计报告。