makemd/docs/blueprints/frontend-integration/supplier-risk-radar-ui.md

前端集成方案：供应商经营风险自动探测 (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)
• 响应结构:

  {
    "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