feat(alert): A2 告警引擎分布式安全 — Redis 分布式锁(SetNX)

- Cache 接口新增 SetNX 方法(go-redis 原子 / redka check-then-set 单副本安全)
- AlertEngine 改造为支持分布式锁: tryAcquireLock/releaseLock/GetEngineStatus
- 多副本部署时仅 Leader 执行告警检查, 60s TTL 防死锁, fail-open 容错
- 新增 GET /alerts/engine/status 监控端点(is_leader/instance_id/lock_holder)
- 修复 GrafanaDashboard.tsx Panel.options 类型不匹配导致构建中断
- 同步未提交的前端类型安全迁移(140+ 文件)
- ROADMAP/TDD_PLAN/PROJECT_EVALUATION 三文档同步更新

验证: go build 零错误, Docker 部署 healthy, 引擎状态端点正常,
锁竞争测试通过(非 Leader 跳过检查), 5/5 核心 API 回归通过
This commit is contained in:
attacker committed 2026-06-26 21:13:15 +08:00
1 parent 5ca0e6d83a
commit c68aef4444
150 files changed
+1038 -690

No files matched your search

+11 -3
View File
@@ -162,11 +162,19 @@ services/api.ts (1324L)
**方案**: 以 Kuboard code 路由为主,ID 路由保留向后兼容(标记 deprecated)
### A2: 告警引擎分布式安全 [pending]
### A2: 告警引擎分布式安全 [done]
**问题**: 告警引擎用 goroutine + 30s ticker 常驻,多副本会重复告警
**方案**: Redis 分布式锁(每轮 ticker 先抢锁),或选主机制
**方案**: Redis 分布式锁(SetNX 原子抢锁),每轮 ticker 先抢锁,60s TTL 防死锁。单实例/redka 模式自动 fallback 为无锁直行。
**验收标准**:
- [x] Cache 接口新增 `SetNX` 方法(go-redis 原子 / redka check-then-set 单副本安全)
- [x] 多副本部署时仅 Leader 副本执行告警检查(SetNX 分布式锁 + 实例 ID 校验)
- [x] Leader 崩溃后锁自动过期(60s TTL),其他副本自动接管
- [x] Redis 故障时 fail-open(不阻断告警)
- [x] `GET /alerts/engine/status` 状态监控端点(is_leader / instance_id / lock_holder)
- [x] 本地/redka 模式(cache=nil)自动 fallback 为单实例直行
### A3: WebSocket 连接统一管理 [pending]
@@ -207,7 +215,7 @@ services/api.ts (1324L)
| F2 | 审计日志导出 | P1 | **done** |
| F3 | 前端 RBAC 控制 | P1 | **done** |
| A1 | K8s 路由统一 | P2 | pending |
| A2 | 告警引擎分布式 | P2 | pending |
| A2 | 告警引擎分布式 | P2 | **done** |
| A3 | WebSocket 管理 | P2 | pending |
| U1 | 虚拟滚动 | P3 | pending |
| U2 | 统一 DataTable | P3 | pending |