3.1 KiB
R01-D4-2 GET 评分快照停写实施报告
日期：2026-09-16 状态：实现与自动化复验通过，待独立真实环境黑盒验收。
1. 变更结论
CandidateScoringEngineService#getOverview、getDimensionDetail、getCompanyScoring 已改为
@Transactional(readOnly = true)，并移除 CandidateScoringCalculator#upsertSnapshots 调用。
三个接口仍以同一次 capturedNow 实时计算并返回原响应结构，趋势接口继续读取已物化快照。
快照更新改由 D4-1 的写侧登记、后台 Worker 和补偿扫描负责。生产配置默认启用刷新与补偿； test、integration-test、mysql-it profile 显式关闭调度，仅由测试主动驱动，避免后台线程干扰断言。
2. D4-1 网关补齐
V44 同时创建 candidate_scoring_refresh_scan_checkpoints。补偿扫描使用持久化游标、固定单轮预算和
SELECT ... FOR UPDATE 串行推进；游标与任务登记同事务提交。扫描到尾部后从 0 开始下一轮，避免首
页饥饿，也不会单次遍历全量用户。
真实 MySQL 8.4 Testcontainers 已验证：V1–V44 迁移和 schema validate、游标持久化、每轮预算、 Writer 幂等与强制版本、并发唯一领取、处理中重登记、租约恢复、失败事务隔离。
3. 测试迁移
R01D4GetWritesSnapshotEvidenceTest改为逐字段快照，证明 overview、dimension、trend GET 零写入。CandidateScoringEngineServiceTest与时钟一致性测试显式断言三个 GET 从不调用 upsert。CandidateScoringPersistenceIntegrationTest显式调用 Calculator/Writer 验证物化幂等，不再借 GET 造数据。V38AbilityRankingIntegrationTest显式走真实物化入口，原排名公式和结果断言保持不变。
首次干净全量构建据此发现 V38 排名测试仍依赖 GET 副作用（1 Error）；修正夹具后专项测试通过， 再次执行干净全量构建成功。
4. 实测结果
| 项目 | 结果 |
|---|---|
| D4-2 + D4-1 H2/MySQL 组合定向 | 38 / 38，0 failure，0 error，0 skip |
| 时钟与持久化定向 | 13 / 13，0 failure，0 error，0 skip |
| V38 排名回归 | 1 / 1，原断言不变 |
mvn clean verify |
2131 / 2131，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS |
| MySQL Testcontainers | Q01 与 V44 用例均真实执行，无跳过 |
| OpenAPI | 176 paths / 214 operations，校验通过 |
git diff --check |
无空白错误，仅既有 LF/CRLF 提示 |
5. 边界
V44 是唯一新增迁移，V1–V43 未修改；无新增公网接口、ErrorCode、RabbitMQ 消息或通知；未暂存、 未提交、未推送；历史未跟踪文件未删除或移动。
6. 待独立验收
仍需使用最新 JAR 与项目真实 MySQL/Docker 环境完成：三条真实 HTTP GET 前后快照逐字段零变化； 写侧事件到任务登记再到快照可见；趋势、申诉、排名、看板、公平性监控不退化；RabbitMQ 队列终态 为零；并精确清理或记录隔离验收数据。自动化与 Testcontainers 结果不能替代该黑盒步骤。
R01-D4-2 实现及自动化复验完成，待独立真实 MySQL/Docker 黑盒验收。