post_clear_check/doc

post_clear_check

清算完成之后，对发行、销售、TRS 的订单和日常报表做数据核对，并把结论发到飞书。不配推送类型时，正确、错误、可疑都发。

这是独立产品。现在的目录只是暂存在 leopard 工作区里，后续会单独建 git 仓库。程序运行时只读本工具自己的目录和自己的环境变量，不打开 leopard 的文件。

怎么跑以 doc/使用说明.md 为准。

按业务链路核对的设计（11 条链路、卡片版式、依据写法）见 doc/业务链路核对设计.md，改某条链路先改该文档。

目录

路径	内容
doc/README.md	本文件。了解产品时看
doc/使用说明.md	现行怎么跑、怎么看结果
doc/业务链路核对设计.md	链路口径、节点、依据、卡片版式
code/post_clear_check/	程序、单测和自有库建库脚本

结论

库里的结论值只用英文：correct、error、suspect。飞书卡片上显示为 正确、错误、可疑。没有发生的业务不写结论行，也不发卡片。

一张卡片只承载一条链路、一个归属对象。卡片上有多条时，总结论取最严重的一档：错误 高于 可疑，可疑 高于 正确。每条结论写依据、公式、代入式、期望值与当前值，格式见 doc/业务链路核对设计.md 第 7 节。

什么时候跑

进程做完一轮就退出。同一个市场、同一个交易日，发行和销售的批次都是 completed 才开始。这一天有对冲时，TRS 的批次也必须是 completed。没有对冲就不产生 TRS 的结论行。重算看批次的 end_time 和规则文件版本，同一轮次不重复发送。细节以 doc/使用说明.md 为准。

飞书用专用群的自定义机器人，不走三端的通知表。业务库连接必须是只读会话。运行记录写在 db_post_clear_check。

维护

排查启动失败、飞书发送失败，或修改 code/post_clear_check，调用项目 skill post-clear-check。现行行为以 doc/使用说明.md 和代码为准，链路口径以 doc/业务链路核对设计.md 为准。