docs(javaTest): document business and raw replay

This commit is contained in:
zgw
2026-08-10 12:33:42 +08:00
parent 49c374b4b3
commit 352c17eb9f

View File

@@ -92,17 +92,23 @@ mvn compile exec:java \
## 运行真实历史负载全链路调度仿真
240 条历史记录按 `create_date` 生成到达事件,默认按 `100x` 加速。调度中心重新选车和
历史数据包含 240 条原始扫描快照、98 个唯一队列 GUID、142 条重复快照、76 个业务父任务和
17 个车辆运行作业。默认 `business` 模式按生产源码语义组装 76 个父任务,再按 `create_date`
生成到达事件;`raw` 模式才按旧口径逐条运行 240 条快照。两种模式都由调度中心重新选车和
规划路径,经过 SHADOW 交通裁决、模拟 PLC/ACK、逐节点移动、资源释放、完成归档和
幂等 WMS 回调。历史 `agv_id/path_info/finish_date/完成状态` 仅用于对照。
```bash
mvn compile exec:java \
mvn -q -DskipTests compile exec:java \
-Dexec.mainClass=com.ft546.wcs.shadow.history.simulation.HistoricalDispatchSimulationApplication \
-Dexec.args="outputs/wcs-history-driven-center-dispatch-local 100"
-Dexec.args="outputs/wcs-history-business-dispatch-local 100 business"
mvn -q -DskipTests compile exec:java \
-Dexec.mainClass=com.ft546.wcs.shadow.history.simulation.HistoricalDispatchSimulationApplication \
-Dexec.args="outputs/wcs-history-raw-dispatch-local 100 raw"
```
第二个参数只允许 `10` 或 `100`。Java 原始证据包括 `summary.json`、`route-decisions.json`、
第二个参数只允许 `10` 或 `100`,第三个参数只允许 `business` 或 `raw`。Java 原始证据包括 `summary.json`、`route-decisions.json`、
`task-results.csv`、`tick-events.csv`、`invariant-results.json` 和 `manifest.sha256`,回答完成/等待/失败、
每车完成数、车辆和路径差异、资源安全、平均/P95/P99、HOLD/重试原因、历史耗时差异、
归档和 WMS 幂等情况。正式验收证据目录另包含由这些原始证据生成的
@@ -144,15 +150,24 @@ mvn compile exec:java "-Dexec.mainClass=com.ft546.wcs.shadow.history.visualizer.
直接显示 Java 返回的候选和最终选中项。成功 REROUTE 事件保存换路前后剩余路径及同一交通快照的
质量,选择重规划记录后会在完整地图上同时叠加两条路线。页面不重新规划,也不自行推断地图邻接。
“240 条历史任务”会重新执行全部历史负载并列出完成、等待、失败、重新选车和路径变化;
“历史任务回放”默认使用“业务任务”口径,运行 76 个业务父任务,并同时显示 240/98/142/76/17
五项输入审计计数。右侧按真实执行顺序列出空车取货、载货回源通道前端、载货入位和空车回目标
通道前端等阶段;点击任一阶段,完整地图只叠加后端返回的该阶段 `plannedPath`。检查器还显示货物
状态、源/目标通道前端、业务完成时间、车辆释放时间和归并后的原始 GUID。
切换到“RAW 快照”后,会执行 240 条兼容任务并恢复历史 `path_info` 与新规划路径的共同边、专属边
和无效段对照。跨层过程始终以换层入口、出口和独立作业事件表达,页面不会在两个楼层之间画一条
虚假的普通地图边。
“安全审计”集中显示节点双占、资源超容量、对向换边、死锁、归档完整性和 WMS 回调幂等。
导出的 JSON 是本次内存仿真的页面证据。
服务严格绑定 `127.0.0.1`,只读取打包的历史与地图资源,不接收任意文件路径,不连接数据库、
真实 PLC 或 WMS。按 `Ctrl+C` 停止服务。该页面用于离线上线前检查,不能替代现场 HIL/ACTIVE 验收。
服务运行时可在另一个终端执行真实 Chromium 验收;脚本会运行 A→B 和 240 条接口,并检查完整地图、
图层开关、视口、候选证据、桌面/移动布局、横向溢出及控制台错误:
服务运行时可在另一个终端执行真实 Chromium 验收;脚本会运行 A→B、76 个业务父任务和 240 条
RAW 快照,并检查完整地图、业务阶段切换、跨层端口、历史路径差异、图层开关、视口、候选证据、
桌面/移动布局、横向溢出及控制台错误:
```bash
python scripts/visualizer_browser_qa.py http://127.0.0.1:18084 outputs/browser-qa