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