申请、任务与记录模型¶

状态：首轮样板阶段已开始抽取公共模型；WMS 采购收货是首轮取证样例。本文沉淀已由 dev 基线证实的共用规则；未覆盖业务仍须逐项核验，不要当成全站已闭合矩阵。

本页解决什么问题¶

现场单据常被写成「一张单」或「一个状态」，排障时却对不上：申请里还在审批，任务已到现场，记录已经动了库存。本页把 申请 / 任务 / 记录 拆开说明——各自解决什么问题、如何用单号追溯、通用状态与自动策略如何改流转。

读完应能判断：当前业务是否按三层走、卡在哪一层、业务页该复用本页哪些通则、哪些差异必须留在业务页。

如何使用本页¶

具体业务页只写本业务特有内容（来源单据、字段差异、库存影响、接口挂接、异常分支、终端入口）。通用定义、通用状态和通用动作统一链接本页。

抽取时机与复用原则¶

这类共用知识不等到全站批量占位时再抽取，而是在样板闭环阶段完成首版抽取。

分层责任¶

通用链路¶

通用理解：

• 申请解决「要不要做、为什么做、由谁批准」。
• 任务解决「谁去做、去哪里做、按什么限制做」。
• 记录解决「实际做了什么、对库存和接口造成了什么影响」。
• 预计库存通常挂在任务阶段，实际库存变化通常挂在记录阶段。

通用关联字段¶

字段名称必须以当前 DDL、DO、VO 和前端实际请求为准。旧文档中自行翻译出来的 request_no、task_id、receipt_no 等名称不能作为当前字段依据。

通用状态与动作¶

申请状态¶

申请动作¶

任务状态与动作¶

记录状态与动作¶

记录不是普通可编辑数据。记录撤销通常需要校验库存现状，并生成反向库存事务或冲抵记录；具体影响必须在业务页说明。

通用状态机（已证实状态码）¶

下图按通用状态码与动作绘制。业务页若复用本模型，可直接引用；若存在拒收、撤销可见性等差异（如采购收货 GAP-009），在业务页用虚线或待确认说明，不要改写本图为「全业务必经路径」。

自动策略¶

这些策略通常来自业务类型、单据配置或服务默认值。业务页必须说明本业务实际读取的配置代码、默认值来源和是否允许用户修改。配置对象总览见单据类型、业务类型与单据配置。

适用与例外¶

业务页输出规则¶

具体业务页不重复解释「申请、任务、记录为什么存在」，只补充：

1. 本业务是否完整采用申请、任务、记录三层。
2. 哪些来源会生成申请，哪些情况下跳过申请或跳过任务。
3. 本业务的状态按钮是否与通用状态机一致。
4. 任务阶段是否生成预计入、预计出或其它中间对象。
5. 记录阶段是否生成库存事务、接口消息、后续申请或报表数据。
6. 终端操作与 Web 操作的差异。
7. 当前实现与通用模型不一致的地方，必须登记为待确认或产品差距。

自检或验证点¶

写业务页或做验收时，可快速核对：

1. 分层是否说清： 读者能否区分「意图（申请）/ 待执行（任务）/ 已发生（记录）」？
2. 追溯是否可走通： 从记录号能否回查 job_number → request_number？预计是否挂任务号、事务是否挂记录号？
3. 自动策略是否点名： 自动提交/通过/执行开启后，状态跳过哪几步？默认值来自哪份配置？
4. 例外是否诚实： 拒收、撤销、关闭与通用状态机不一致处，是否写在业务页并保留 ❓ / GAP？

待继续核验¶