Files

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

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

2026-03-16 01:31:26 +08:00

2.4 KiB

Raw Blame History

前端集成蓝图：全自动执行熔断控制 (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 控制台 -> 风险熔断器
展示组件：
- 全模块熔断状态矩阵：显示各业务模块（调价、采购、库存）的实时熔断状态。
- 熔断根因展示：最近一次触发熔断的异常日志。
- 手动控制开关：人工手动强制熔断或重置。

交互草图：

+-----------------------------------------------------------+
| [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 级别告警。

2.4 KiB Raw Blame History Unescape Escape

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

1. 业务意图 (Business Intent)

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

3. API 交互契约 (API Integration)

4. 生产校验项 (FE Readiness)

2.4 KiB

Raw Blame History