◆ 测试数据治理说明 · 2026-04-29 00:16

测试写入可追踪、可快照、可预览清理

本页面向开发、测试和实施人员,说明 xia 测试环境中的订单提交、签收提交、反馈提交等动作接口写入的是 runtime 演示数据,不是生产业务数据;清理前必须先快照,清理动作需要显式确认。

一、数据边界

runtime 演示数据TEST ONLY

订单提交、签收提交、反馈提交会写入 apps/api/data/runtime-db.json,只用于联调、验收回放和问题追踪。

Git 提交边界SAFE

运行库文件在 .gitignore 中,不纳入 Git 提交;提交的只有脚本和客户可见说明页。

生产数据边界NOT PROD

runtime 中的测试订单、签收、账单不作为生产业务单据,也不作为客户最终结算依据。

基线保留规则BASELINE

清理计划保留 SO20260424-018SG20260424-018SB20260424-018 三条基线演示记录。

二、推荐操作顺序

1. 生成快照

用于保存清理前现场。

node scripts/runtime-test-data-snapshot.js --write
2. 预览可回收记录

只输出候选订单、签收、账单和数量,不删除数据。

node scripts/runtime-test-data-snapshot.js --plan-cleanup
3. 实际清理

必须显式确认,执行前会自动生成快照。

node scripts/runtime-test-data-snapshot.js --apply-cleanup --confirm-runtime-cleanup
4. 清理后复核

再次查看统计和最近记录,确认只保留基线演示数据。

node scripts/runtime-test-data-snapshot.js --plan-cleanup

三、安全原则

默认不清理

无参数或只带 --plan-cleanup 时只读运行库。

无确认不清理

只带 --apply-cleanup 会退出并提示,不修改数据。

先快照再清理

真正清理前自动写入 apps/api/data/runtime-snapshots/

客户验收口径

如果客户要复看某次测试,先保留快照,再决定是否执行清理。

runtime test data guide xia-runtime-data-guide runtime-test-data-snapshot --write --plan-cleanup --apply-cleanup --confirm-runtime-cleanup