# 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` 为准。