# 前端集成方案：供应商经营风险自动探测 (Supplier Risk Radar) - [BIZ_OPS_157]

## 1. 业务场景描述 (Business Context)
- **目标**：监控供应商的经营合规性，识别潜在的法律诉讼、经营异常或财务危机，防止供应链突然中断。
- **用户收益**：规避违约风险，保障货源稳定，建立供应商全生命周期的风险闭环。

## 2. UI 布局草图 (UI Layout Sketch)
- **风险雷达图 (Risk Radar Chart)**:
  - 五个维度：`Quality`, `Lead Time`, `Financial Stability`, `Legal Compliance`, `Price Stability`。
  - 不同颜色的区域代表不同的风险级别。
- **高危预警列表 (Critical Alerts)**:
  - 红色卡片展示：供应商名称、风险等级（CRITICAL/HIGH）、触发原因。
  - 操作：`Start Audit`（发起实地审厂）、`Switch Source`（寻找替代货源）。
- **供应商档案详情 (Supplier Dossier)**:
  - 展示法务公告原文、历史处罚记录、工商变更流水。

## 3. 核心 API 字段映射 (API Mapping)
- **后端服务**: `SupplierRiskRadar.scanRisks(tenantId)`
- **响应结构**:
  ```json
  {
    "success": true,
    "data": [
      {
        "supplierId": "SUP-007",
        "name": "义乌某某电子厂",
        "riskLevel": "CRITICAL",
        "notices": ["经营异常名录", "劳动争议诉讼"],
        "lastScanAt": "2026-03-14T10:00:00Z"
      }
    ]
  }
  ```
- **因果链呈现 (XAI Integration)**:
  - 调用 `DecisionExplainabilityEngine.getDecisionNarrative`
  - 示例：“该供应商已被列入经营异常名录，且过去 3 个月质量破损率从 2% 飙升至 12%，建议立即停止新订单下发。”

## 4. 交互状态机 (Interaction State Machine)
- **On Dashboard Load**: 执行全量租户供应商扫描。
- **Risk Expansion**: 点击风险等级可展开具体的法务/工商证据链。
- **Mitigation Action**: 选择 `Switch Source` 自动跳转至 `VisualSourcing` 页面。

## 5. ROI 可视化逻辑 (ROI Tracking)
- **风险规避值**: 计算若该供应商突然倒闭可能导致的未交付订单总损失（$ Expected Loss $）。
- **供应链韧性**: 展示通过多元化货源分散风险后的系统稳定性提升。

---
**蓝图维护者**: AI-2 (Internal) | **版本**: V1.0  
**相关任务**: [BIZ_OPS_157](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)