tradingSystem/scripts/AGENTS.md

30 lines
2.6 KiB
Markdown
Raw Normal View History

# 测试与运维脚本规则
本文件适用于`scripts/`;其他目录修改代码时,按根规则来此查测试入口。
## 单测隔离
- `run_tests.py`逐批调用`unit_test_guard.py`,清除业务环境变量,在无`.env`的临时目录运行并阻断套接字。只跑一批也必须走同一隔离入口;新增可直接运行的测试沿用现有安装护栏方式。
- 新增服务调用需补`test_wiring.py`中的`install_fakes`或对应内存桩;真实连接尝试即失败,不能靠业务层吞异常让测试通过。
- 新增`test_batch*.py`同时登记`run_tests.py`的`SUITES`和例数说明。缺失测试文件必须失败,不能当跳过。
- DDL、调度、API、密钥、动作求值顺序及仓储签名变化,检查`run_tests.py`顶部哨兵位置清单及实际断言,不照抄历史表数或测试总数。
- 合并分支时检查测试文件是否重名,不能让一批测试覆盖另一批;缺项不能靠删登记解决。
- 跨边界修复至少保留一个经过真实入口和真实输出编码的反例,只替换外部I/O。桩保留实际响应包装、Decimal/日期、空值、失败返回和版本字段;不要把待核验的序列化、路由或任务入口一起替换掉。涉及异步动作按影响选择迟到、重放、部分完成和恢复场景,并检查原来允许的正常路径。
开发机在安装了项目依赖的独立虚拟环境中、从仓库根目录执行:
```bash
python scripts/run_tests.py
python scripts/unit_test_guard.py scripts/test_batch48_units.py
```
全量预期末行为`ALL SUITES PASS`。单批编号按改动选择,不固定只跑微盘。纯文档修改不要求全量回归。页面三道护栏由全量入口覆盖,也可分别经隔离入口运行。
## 运行脚本
`make help`是命令目录,不能把每个目标都当只读探针。`make test`用于部署服务器,发布前还须对匹配的候选镜像断网验证,步骤见[pms-release](../.agents/skills/pms-release/SKILL.md)。
新脚本应区分只读检查和实际写入,并验证重复执行及失败后的状态。`tick`、回放、建表、清账和重建账本都有业务副作用,不在活跃交易账户上当作普通单测。隔离演练使用独立数据库与前缀,不使用会认领真实成交的shadow路径。历史探针文件和文档中的日期不自动构成今天的执行授权。
历史准备与任务回执的只读导出、自动判定见[业务证据核验工具](../docs/业务证据核验工具.md)。失败返回非零退出码;无显式错误不代表业务完成。工具不会触发业务任务,也没有安装定时调度。