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