2.8 KiB
2.8 KiB
后端目录规则
本文件适用于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客户端保持
redis5.x约束。升级前须验证现网服务端协议兼容性,不能直接放开到默认RESP3的版本。
验证入口
后端、DDL、路由或调度变化,按scripts目录规则检查测试桩和哨兵。改web/时还要读该目录的规则。临时日志不得输出密钥、完整连接串或登录凭据。