45 lines
2.4 KiB
Markdown
45 lines
2.4 KiB
Markdown
# 前端集成蓝图：全自动执行熔断控制 (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 级别告警。
|