业务逻辑
BUSINESS LOGIC · 业务逻辑专辑
目前有 居民收益付款、推送链路两个专辑，共 17 篇业务阅读内容。
居民收益付款
Section titled “居民收益付款”围绕居民收益付款流程，梳理选单工作台、候选规则和异步任务之间的关系。目前收录 16 篇。先读 S01～S05，理解从选单到审核计划创建的主线；再读 S07～S09，理解审核回调、明细进度与独立后续任务。S06 说明失败提交的锁释放补偿，S10 说明审核后续任务的缺失补建。S11～S14 继续说明付款状态刷新、查询快照与作废后的数据更新。另有两篇扩展阅读，连接月度全量统计提交、批量后台处理与已有快照刷新。
| 顺序 | 文章 | 主要内容 |
|---|---|---|
| S01 | 选单工作集构建，通俗完整版 | 24 节完整内容：创建与受理、NEW 候选构建、REVISE 重提、两层所有权、断点恢复、排查 SQL 与源码证据。 |
| S02 | 选单工作集批量调整，通俗完整版 | 13 章通俗解读及逐章原文对照：跨页全选、冻结筛选、批量归类、执行权与版本、事务边界、失败恢复和完整源码索引。 |
| S03 | 居民收益提交构建，通俗完整版 | 13 章及原文对照：提交身份、正式数据构建、账单预占、原子发布、后续交接与失败补偿。 |
| S04 | 账单锁激活任务，通俗完整版 | 13 章及原文对照：锁激活、底表同步、事务与执行权、失败重试、审核创建交接和源码索引。 |
| S05 | 审核计划创建任务，通俗完整版 | 12 章及原文对照：远程审核配置、本地审批实例、状态推进、重试与独立回调链的边界。 |
| S06 | 账单锁释放补偿任务，通俗完整版 | 11 章及源码附录、原文对照：失败提交的精确锁释放、领取条件、事务边界、重试与最终清理。 |
| S07 | 审核回调任务，通俗完整版 | 12 章及原文对照：审核结果受理、回调消费、明细进度、主业务生效、重试与独立后续支线。 |
| S08 | 审核回调进度任务，通俗完整版 | 13 章及原文对照：分批明细推进、主业务生效、状态刷新、执行权、恢复机制和源码索引。 |
| S09 | 审核后续任务，通俗完整版 | 12 章及原文对照：审核通过后的通知、付款批次准备、任务领取、失败重试与实际支付边界。 |
| S10 | 审核回调副作用补建，通俗完整版 | 12 章及原文对照：后续任务缺失补建、候选筛选、幂等受理、事务边界和消费者分工。 |
| S11 | 付款状态刷新任务，通俗完整版 | 12 章及原文对照：刷新请求受理、三张底表状态重算、付款主单聚合、查询快照交接与失败重试。 |
| S12 | 付款状态分片刷新，通俗完整版 | 13 章及原文对照：审核后的精确分片、状态规则、事务与执行权、聚合放行和快照交接。 |
| S13 | 付款结果查询快照刷新，通俗完整版 | 13 章及原文对照：审核快照资格、创建与刷新范围、付款事实聚合、金额与状态判断及源码索引。 |
| S14 | 付款单作废刷新，通俗完整版 | 13 章及原文对照：作废后的底表状态重算、处理范围、已有快照刷新、独立事务和失败重试。 |
| 扩展 | 居民收益月度全量统计刷新，通俗完整版 | 12 章及源码定位索引、原文对照：账户扫描与批量任务提交、截止账期、金额口径、逐户事务、投影与已有快照刷新。 |
| 扩展 | 居民收益付款状态批量刷新，通俗完整版 | 13 章及原文对照：任务领取、逐户重算、断点与事务、已有快照交接、历史初始化分支和完成判据。 |
从外部请求进入平台开始，梳理消息交接、事务提交、异步处理与完成证据。目前收录 1 篇：合作方居民收益账单推送链路，包含 8 章完整内容、32 段关键源码摘录和逐章原文对照。
第一次阅读，先沿着业务操作理解工作集的来龙去脉；需要排障时，再进入并发控制和恢复章节。
| 阅读目的 | 从这里开始 |
|---|---|
| 建立业务概念 | 阅读起点：先分清四个东西 → 任务目标 → 完整调用链 |
| 理解新建与重提 | NEW 模式 → REVISE 模式 |
| 理解批量调整 | S02 任务概览 → 筛选规则 → 分批与事务边界 → 成功、失败与重复执行 |
| 理解提交到审核 | S03 提交构建 → S04 锁激活与同步 → S05 审核计划创建 |
| 理解审核结果如何生效 | S07 回调受理与消费 → S08 分批推进与刷新 → S09 独立后续任务 |
| 排查后续任务缺失与重试 | S10 补建候选规则 → 补建的异常与重复执行 → S09 消费失败与重试 |
| 排查失败提交与锁释放 | S03 失败与补偿 → S06 释放范围 → 事务、重试与重复执行 |
| 理解状态与查询数据更新 | S11 普通状态刷新 → S12 审核后的分片刷新 → S13 查询快照的创建与刷新规则 |
| 排查作废后的数据更新 | S14 作废刷新调用链 → 异常与重复执行 → S13 快照刷新与重试 |
| 理解月度统计与批量处理 | 月度入口提交与消费链 → 统计金额与落库 → 批量任务执行链 → 整条链路完成判据 |
| 理解并发与恢复 | 两层所有权 → 重试与补偿 → 故障判断顺序 |
| 对照排查依据 | 只读 SQL → 源码证据索引 → 证据等级 |
来源与内容状态
Section titled “来源与内容状态”十七篇文章均来自提供的 HTML 阅读版，具体文件名保留在文章元数据中。导入保留原有章节、业务说明、示例、表格、代码与证据边界，并适配平台的目录、搜索和代码复制功能；S02～S14 及两篇扩展阅读保留逐章原文对照，S03～S14 及两篇扩展阅读另保留完整流程图及 Mermaid 源码。推送链路文章保留八章结构、步骤 0–18、关键源码 C01–C32、索引 F01–F21、主链步骤图和 Mermaid 源码。
文章目前标记为 草稿：本次完成内容导入与格式校验。S01 对应其原文源码基线及 2026-09-04 数据库核验；S02～S14 及两篇扩展阅读保留各自原文的源码分析日期、工作区状态和未验证事项，本次导入未重新检查业务源码、运行任务或核验数据库及线上环境。部分文档中原文归档编号与源码阶段编号的差异也按原文保留。各篇结论的适用范围以篇首说明为准。
推送链路文章另保留原文声明的固定源码提交及历史行号，证据范围为原文的静态核对；本次导入未执行接口、Kafka、数据库或 Worker 的运行验收。