tradingSystem/scripts/AGENTS.md

30 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 测试与运维脚本规则
本文件适用于`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)。失败返回非零退出码;无显式错误不代表业务完成。工具不会触发业务任务,也没有安装定时调度。