feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
This commit is contained in:
2026-03-17 22:07:19 +08:00
parent c0870dce50
commit 136c2fa579
728 changed files with 107690 additions and 5614 deletions

View File

@@ -0,0 +1,49 @@
# 前端集成方案:供应商经营风险自动探测 (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)