huangzd1997 56c8a4ff88 test(phase-0): 1A 中断上报→进度快照终态同步契约钉上——markTerminal 此前零引用
重构蓝图 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)。
2026-10-18 12:25:20 +08:00
S
Description
No description provided
200 MiB
Languages
Java 73.1%
TypeScript 17.4%
Vue 8.9%
CSS 0.2%
Python 0.2%
Other 0.2%