docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
This commit is contained in:
Ansonai
2026-03-16 01:31:26 +08:00
commit 6759d47de4
74 changed files with 9310 additions and 0 deletions

View File

@@ -0,0 +1,44 @@
# 前端集成蓝图:全自动执行熔断控制 (Circuit Breaker UI)
> **[AI-2 @ 2026-03-14]**:由后端 Agent 在完成 Batch 56 熔断器逻辑后产出,用于指导 Console 端全栈实现。
## 1. 业务意图 (Business Intent)
- **核心价值**:保护企业资产,当 AGI 执行出现连续异常或资金回撤时,自动切断全自动执行链路,强制转回人工审批模式。
- **关联后端 Service**`AutoCircuitBreakerService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> AI 控制台 -> 风险熔断器
- **展示组件**
- [ ] **全模块熔断状态矩阵**:显示各业务模块(调价、采购、库存)的实时熔断状态。
- [ ] **熔断根因展示**:最近一次触发熔断的异常日志。
- [ ] **手动控制开关**:人工手动强制熔断或重置。
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] AGI 熔断保护墙 (Circuit Breaker Status) |
+-----------------------------------------------------------+
| 模块: 动态调价 | 状态: [ OPEN (已熔断) ] | 失败数: 5/5 |
+-----------------------------------------------------------+
| 模块: 供应链采购 | 状态: [ CLOSED (正常) ] | 失败数: 0/5 |
+-----------------------------------------------------------+
| [!] 熔断触发详情: |
| "模块 '动态调价' 已触发熔断保护 (原因: 连续 5 次执行异常)" |
| 时间: 2026-03-14 15:30:22 |
+-----------------------------------------------------------+
| [ 导出异常报告 ] [ 手动重置并恢复全自动 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/circuit/status` (返回 `cf_circuit_breaker_status` 数据)
- **关键字段映射**
- `status` -> 状态 (OPEN/CLOSED)
- `failure_count` -> 连续失败次数
- `last_failure_at` -> 最近失败时间
- **状态流转**
- 点击 [手动重置] -> `POST /api/v1/circuit/reset` -> 恢复正常。
## 4. 生产校验项 (FE Readiness)
- [ ] 熔断状态需使用显眼的红色/绿色标签。
- [ ] 重置操作必须包含二次确认弹窗。
- [ ] 熔断触发时应在全局通知栏推送 CRITICAL 级别告警。