Files
makemd/archive/handover/circuit-breaker-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.4 KiB
Raw Blame History

前端集成蓝图:全自动执行熔断控制 (Circuit Breaker UI)

[AI-2 @ 2026-03-14]:由后端 Agent 在完成 Batch 56 熔断器逻辑后产出,用于指导 Console 端全栈实现。

1. 业务意图 (Business Intent)

  • 核心价值:保护企业资产,当 AGI 执行出现连续异常或资金回撤时,自动切断全自动执行链路,强制转回人工审批模式。
  • 关联后端 ServiceAutoCircuitBreakerService.ts

2. UI/UX 布局方案 (Layout Design)

  • 页面入口Console -> AI 控制台 -> 风险熔断器
  • 展示组件
    • 全模块熔断状态矩阵:显示各业务模块(调价、采购、库存)的实时熔断状态。
    • 熔断根因展示:最近一次触发熔断的异常日志。
    • 手动控制开关:人工手动强制熔断或重置。
  • 交互草图
    +-----------------------------------------------------------+
    | [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 级别告警。