Files
junhong_cmp_fiber/openspec/changes/archive/2026-09-02-reduce-polling-observability-load/tasks.md
break 370fd3e67f
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 10m49s
update
2026-09-03 09:28:28 +08:00

27 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 1. 轮询背压配置
- [x] 1.1 在 Worker/轮询配置中加入默认保守且受范围校验的全部轮询总并发上限,并保留现有分类轮询上限。
- [x] 1.2 扩展 Redis 轮询令牌获取、释放和 TTL 修复,使其原子地同时限制总量与任务类型;令牌不足时沿用延后入队语义。
- [x] 1.3 收紧轮询并发配置入口的参数校验,拒绝零、负数和超过代码安全上限的配置,并记录令牌不足的结构化指标日志。
## 2. 轮询记录策略
- [x] 2.1 盘点所有 Gateway 自动轮询处理器及其预调用 Integration Log、审计 Writer 调用,区分正常无变化、业务变化、失败和未知结果路径。
- [x] 2.2 为轮询增加按终态记录外部交互的最小持久化路径:失败、无效/未知结果和业务变化保留可调查记录;成功无变化不创建 Integration Log。
- [x] 2.3 修改所有自动轮询处理器,使成功无变化路径不创建 Audit Event、Audit Event Resource 或 Integration Log且不影响下一次调度、缓存失效和领域观测判断。
- [x] 2.4 确保轮询业务变化和失败仍写入必要的业务事实、审计或恢复记录;支付、审批、入站回调及其他非轮询可靠外部交互路径保持不变。
- [x] 2.5 为无变化跳过、变化持久化、失败持久化及按总量/分类限流延后的轮询输出可聚合结构化日志。
## 3. 归档与留存降载
- [x] 3.1 新增默认关闭的审计归档与日留存任务总开关,并同步配置加载、生产运行说明和 Worker 启动日志。
- [x] 3.2 总开关关闭时停止注册相关定时任务,并让 Audit 日归档、Integration 日归档和日留存处理器安全跳过已入队任务。
- [x] 3.3 将留存服务从一次跨全部历史日期的循环改为一次最多处理一个已结束上海自然日保留既有归档校验、pending 保留和物理清理语义。
## 4. 验证与运维交接
- [x] 4.1 在隔离环境核验:成功无变化轮询不新增三张日志表记录;状态变化和失败仍保留可调查记录;入站回调幂等与恢复路径不受影响。
- [x] 4.2 在隔离环境核验:总量或分类轮询令牌耗尽时不调用渠道且任务延后;非法并发配置被拒绝。
- [x] 4.3 在隔离环境核验:归档/留存总开关关闭时已入队任务不扫描在线日志表;开启时单次仅处理一个日期。
- [x] 4.4 执行 `gofmt``go build ./cmd/api ./cmd/worker``go run cmd/gendocs/main.go``openspec validate --all``./scripts/context-health.sh`,并记录生产低峰发布、并发预算逐项调整和回滚步骤。