tradingSystem/app/AGENTS.md

2.5 KiB
Raw Permalink Blame History

后端目录规则

本文件适用于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用协议,bionic用接口说明,上游选股用计划接口。架构定位见README。

数据与时间

  • 数据源由db/session.py选择,表前缀区分实例。不要硬编码生产前缀,也不要凭旧文档判断某库“当前不用”。
  • 交易日期按北京日期处理。时间戳先核对列类型、写入代码、会话时区及实际读数,不能统一加八小时。容器日志使用北京时间;已核验的pms_ws_state.heartbeat_at为北京时间DATETIME原值。
  • 区分数据日期、计算时间、冻结时间和执行日期。修订另存版本,空结果不解释为退出,展示重算结果不冒充历史执行记录。
  • Redis客户端保持redis 5.x约束。升级前须验证现网服务端协议兼容性,不能直接放开到默认RESP3的版本。

验证入口

后端、DDL、路由或调度变化,按scripts目录规则检查测试桩和哨兵。改web/时还要读该目录的规则。临时日志不得输出密钥、完整连接串或登录凭据。