tradingSystem/app/AGENTS.md

26 lines
2.5 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.

# 后端目录规则
本文件适用于`app/`及其子目录;根目录规则继续适用。
## 分层与契约
- `core/`只放纯逻辑,不接数据库或网络。`repo/`负责单表访问,`services/`编排取数、判断、落表和动作。跨表数据分次读取,在服务层组合。
- `db/session.py`会拒绝JOIN、逗号连表和跨表子查询。不要绕过守卫;修改upsert时检查`ON DUPLICATE KEY UPDATE`兼容性。
- `executor`在worker中把委托写入出口表,`ws/runner.py`只负责传输与回报落库,不直接改策略账本。回放服务按委托归属记账,兼顾重复、迟到和部分成交。
- 业务参数走`services/param_store.py`;`config/settings.py`只是业务初值和基础设施配置。新密钥同时登记`SECRET_KEYS`和相应测试,不进入参数快照。
- 资金冻结、在途买入、卖出释放及策略划拨使用既有统一占用口径。新增执行路径不能另算一份余额;划拨不是盈利。
- 关键写入和下发函数可能返回`ok=False`或影响0行而不抛异常,必须检查返回值并处理失败。新软失败函数同步登记`test_batch10_units.py`的`SOFT_FAIL`。
- 内部股票代码使用Tushare点式,例如`600000.SH`;访问上游时在边界转换。改`core/ws_codec.py`后验证协议签名向量,不能只看连接成功。
- 修改接口先查对应契约:QMT用[协议](../QMT_WS_PROTOCOL.md),bionic用[接口说明](../BIONIC_PMS_INTERFACE.md),上游选股用[计划接口](../UPSTREAM_PLAN_API.md)。架构定位见[README](../README.md)。
## 数据与时间
- 数据源由`db/session.py`选择,表前缀区分实例。不要硬编码生产前缀,也不要凭旧文档判断某库“当前不用”。
- 交易日期按北京日期处理。时间戳先核对列类型、写入代码、会话时区及实际读数,不能统一加八小时。容器日志使用北京时间;已核验的`pms_ws_state.heartbeat_at`为北京时间DATETIME原值。
- 区分数据日期、计算时间、冻结时间和执行日期。修订另存版本,空结果不解释为退出,展示重算结果不冒充历史执行记录。
- Redis客户端保持`redis` 5.x约束。升级前须验证现网服务端协议兼容性,不能直接放开到默认RESP3的版本。
## 验证入口
后端、DDL、路由或调度变化,按[scripts目录规则](../scripts/AGENTS.md)检查测试桩和哨兵。改`web/`时还要读该目录的规则。临时日志不得输出密钥、完整连接串或登录凭据。