feat: replay real FT546 queue history

javaTest/README.md

@@ -37,6 +37,9 @@
 - JSON 黄金决策事件、SHA-256 输入哈希和离线回放。
 - 固定种子 `546001` 至 `546010` 的容量、无环和确定性不变量回归。
 - `shadow-simulation-60.json` 提供 60 条独立模拟数据，覆盖 12 类资源、决策、快照和反馈场景；每条数据由参数化测试独立计数。
+- `shadow/history` 保存从 `FT546-wcs.dbo.wcs_srgv_queue_finish` 只读抽取的 240 条真实队列历史样本，保留原始任务号、车辆号、站点号和路径。
+- 真实历史数据覆盖车辆 `1/2/3` 和任务类型 `1/2/3`；数据库全量扫描口径为 17,136 条，其中 11,943 条带有非空路径。
+- 历史回放使用 `[create_date, finish_date)` 推导潜在并发窗口；数据库“已完成”事实与当前 SHADOW 的 `GRANT/HOLD/INSUFFICIENT_DATA` 推演结果分栏记录。
 
 `com.ft546.wcs.demo` 是 LEGACY 演示；新增能力位于 `com.ft546.wcs.shadow`，交通区段状态不会写入 LEGACY 业务队列。
 
@@ -48,6 +51,26 @@ mvn clean test
 
 测试必须由 Maven Surefire 实际发现并执行；验收标准为测试数大于 0、Failures 为 0、Errors 为 0。
 
+真实历史专项测试：
+
+```bash
+mvn -Dtest=HistoricalQueueDatabaseReplayTest test
+```
+
+生成真实历史离线回放证据：
+
+```bash
+mvn exec:java \
+  -Dexec.mainClass=com.ft546.wcs.shadow.history.HistoricalReplayApplication \
+  -Dexec.args="outputs/wcs-shadow-history-replay-local"
+```
+
+输出包括 `summary.json`、`replay-results.csv`、`data-quality-issues.csv` 和
+`manifest.sha256`。报告保留数据库原始业务编号，方便回查。
+
+> 这些结果是“真实历史队列离线回放”，不是现场 SHADOW 验收。历史队列表没有保存
+> 当时每一轮 PLC 快照、资源账本或 LEGACY 决策，因此不能把最终完成状态当作算法正确率。
+
 ## 运行控制台模拟
 
 ```bash