56c8a4ff88
重构蓝图 Phase 0 · 1A 那句「把心跳与进度接进 task contract 套件」逐条对撞后,心跳轴其实早被 别的路钉透了(TaskModuleHeartbeatSpiCoverageTest 12 支 SPI 与 moduleType 一一对上、 TaskHeartbeatServiceTest 进度随心跳转发、StaleTaskHeartbeatPolicyTest 首次心跳前的宽限、 TaskProgressSnapshotServiceThrottleTest 节流与终态豁免、三支 contract 用例 verify touchTaskHeartbeat) ⇒ 那一半本轮不重造,登记为「已闭·复用」。 真缺口在终态那一头:`TaskProgressSnapshotService.markTerminal` 在 src/test 里**一处引用都没有**, 而它对应的是一起真机事故(2026-09-13 客户端重启后店铺数据采集一直显示 28094「处理中」并阻塞该工具 后续任务——progress/batch 读缓存/快照,DB 行已终态而快照还停在 RUNNING)。Phase 2/3 抽公共管线时 这个出口最容易被当「顺手的小方法」漏在新契约之外,故补 10 例钉死: - markTerminal:快照不存在不许凭空造行;同 status 同 message 幂等不空写;只换 message 也要落; 非法入参一次库都不碰;写完必须摘限写窗(附对照组:不插终态时第二笔确被 500ms 窗吞掉, 否则「三笔都落」说不清是摘窗摘对了还是限写窗压根没生效)。 - markInterrupted:DB 仍 RUNNING ⇒ 模块缓存与快照同步 FAILED 并带真因;DB 已终态 ⇒ 按现值自愈 刷一遍快照(历史遗留旧缓存就是在这儿卡住前端的);快照写抛异常不得让中断接口本身失败; 非法 taskId 不落到快照。 门禁:`mvn -o test` 全量 4427 passed/0 failures/7 skipped(6:58,BUILD SUCCESS)。