状态机和订单类型字典

1. 文档目标

状态字典不能只写“数字等于什么”。真正可用于开发和排查的状态机还必须说明：

• 状态属于哪个业务对象和字段；
• 哪个动作、接口、MQ 或定时任务触发迁移；
• 迁移允许的前置状态；
• 迁移后要同步哪些数量、库存、资金和下游系统；
• 哪些状态是终态，哪些允许回退或恢复；
• 相同数值在不同枚举里为什么不能混用；
• billStatus、orderType、srcOrderType、transType 各自解决什么问题。

本文适用于：

• 判断页面按钮为什么不可用；
• MQ 回调提示“状态错误或者消息重复”；
• 单据状态与库存、付款、配送、活动状态不一致；
• 新增状态、来源、订单类型或交易类型；
• 评估补偿任务是否能安全重跑；
• 排查历史数据中的废弃状态和兼容分支。

状态迁移来自当前代码静态核对。外部订单中心、支付中心、OA、配送中心的真实重试和状态合同需结合环境消息证据确认。

2. 先区分六个维度

flowchart LR
    DOC["一张业务单"] --> S["生命周期状态\nbillStatus"]
    DOC --> T["业务类型\norderType"]
    DOC --> SRC["来源\nsrcOrderType/sourceType"]
    DOC --> TRANS["交易方向\ntransType"]
    DOC --> MONEY["支付/核销状态"]
    DOC --> QTY["数量过程状态"]

六个维度可以同时存在。例如一张单可以是：

秒杀采购订单(orderType=30-Cxx-77)
+ 来源于秒杀(srcOrderType=13)
+ 采购交易(transType=170401)
+ 当前待支付(billStatus=10)
+ 在线支付(payment=1)
+ 明细待发数量尚未进入履约

3. 枚举入口地图

4. 采购主状态字典

4.1 状态值

4.2 采购不是单一路径

stateDiagram-v2
    [*] --> Draft: 保存草稿
    Draft --> Submitted: 提交线下单
    [*] --> WaitPay: 创建在线支付单
    WaitPay --> Submitted: 支付成功
    WaitPay --> PayOvertime: 超时关闭消息
    PayOvertime --> Submitted: 迟到的支付成功回调
    Submitted --> Auditing: 订单中心受理
    Submitted --> AuditPass: 部分回调直接通过
    Auditing --> AuditPass: 审核通过
    Submitted --> AuditUnpass: 审核拒绝
    Auditing --> AuditUnpass: 审核拒绝
    AuditPass --> Delivery: 上游发货
    Delivery --> Finished: 全部入库/履约完成
    AuditPass --> Closed: 未发货关闭
    Delivery --> Closed: 部分关闭并完成剩余履约
    Submitted --> WaitRefund: 在线未发货退货审核通过
    WaitRefund --> Finished: 退款成功
    AuditPass --> WaitStorageIn: 已履约采退
    WaitStorageIn --> Finished: 退货入库/结算完成

上图是多业务路径并集，不代表任意采购类型都允许所有箭头。

4.3 已观察到的迁移合同

4.4 非法或危险迁移

5. 采购订单类型 orderType

5.1 完整类型字典

5.2 类型相关辅助维度

6. 采购来源 srcOrderType

flowchart TD
    PO["采购单状态变化"] --> SRC{"srcOrderType"}
    SRC -->|1 活动| ACT["退回活动商品数量"]
    SRC -->|11 轮胎| TYRE["更新理赔状态"]
    SRC -->|12 预订单| PRE["退回/扣减提货数量"]
    SRC -->|13 秒杀| FLASH["locked/used 与秒杀订单联动"]
    SRC -->|0 普通| NORMAL["普通采购副作用"]

7. 新预订单状态机

7.1 主单状态

stateDiagram-v2
    [*] --> ToPay
    ToPay --> ToPick: 支付成功
    ToPay --> Cancel: 用户取消
    ToPay --> AutoCancel: 超时
    ToPick --> Picking: 部分提货
    Picking --> PickFinish: 全部提货
    PickFinish --> OrderFinish: 退款/售后收尾完成
    ToPick --> Closed: 关闭
    Picking --> Closed: 关闭

7.2 预订单售后和退款

主单完成、售后完成和退款完成是三个字段事实，不能只查一个状态。

8. 销售主状态机

8.1 状态值

SaInvoiceSer::getOutboundQty() 会过滤已撤销出库，再根据销售总量、有效出库数量和关闭数量重算销售状态。

stateDiagram-v2
    [*] --> Wait
    Wait --> Partial: 部分出库
    Wait --> Finished: 一次全部出库
    Partial --> Finished: 剩余全部出库/关闭
    Wait --> Closed: 关闭
    Partial --> Closed: 关闭剩余行
    Finished --> Partial: 撤销部分出库后重算
    Finished --> Wait: 全部出库撤销后重算

销售状态可能因撤销出库回退，不是严格单向状态机。

8.2 销售来源

8.3 销售支付和核销

9. 销售出库状态机

9.1 状态值

stateDiagram-v2
    [*] --> Outed
    Outed --> Sending: 配送中
    Sending --> Arrive: 已送达
    Sending --> Outed: 配送取消/退回
    Arrive --> Check: 对账但未全部收款
    Arrive --> Over: 零金额或已全收
    Check --> Over: 后续收款完成
    Check --> Arrive: 撤销对账且未收款
    Outed --> Canceled: 撤销出库
    Sending --> Canceled: 允许的撤销路径

9.2 迁移和副作用

9.3 出库辅助类型

10. 秒杀多维状态机

秒杀至少有六套状态，任何一套单独满足都不能证明可购买。

10.1 状态字典

10.2 活动审批和启用

stateDiagram-v2
    [*] --> Draft
    Draft --> OaWait: 提交 OA
    OaWait --> Passed: OA 通过
    OaWait --> Rejected: OA 驳回
    Rejected --> Draft: 编辑后重提
    Passed --> Enabled: 启用
    Enabled --> EndEarly: 提前结束

页面“进行中”还要求当前时间位于活动窗口，不能直接等同于 enable_status=1。

10.3 秒杀订单

stateDiagram-v2
    [*] --> Created: 创建快照
    Created --> WaitPay: 采购单生成并待支付
    WaitPay --> Paid: 支付中心成功
    Created --> Cancel: 用户取消
    WaitPay --> Cancel: 用户主动取消
    WaitPay --> Closed: 采购超时/关闭
    Paid --> Closed: 采购行关闭，可能部分释放 used

10.4 可买条件

flowchart TD
    A["审批/OA 通过"] --> B["enable_status=1"]
    B --> C["当前时间在窗口"]
    C --> D["商品状态可售"]
    D --> E["服务站命中范围"]
    E --> F["物理/指定/预留库存足够"]
    F --> G["活动余量 = total-locked-used"]
    G --> H["站点/用户限购未超"]
    H --> BUY["允许加购/下单"]

11. 渠道订单和售后

11.1 渠道订单

stateDiagram-v2
    [*] --> Created
    [*] --> WaitShip: DCD 特定创建路径
    Created --> WaitShip: 审核通过
    Created --> Cancel: 审核拒绝
    WaitShip --> PartShip: 部分发货
    WaitShip --> Finish: 全部发货
    PartShip --> Finish: 剩余发货

11.2 渠道售后

stateDiagram-v2
    [*] --> Created
    Created --> Pass: action=pass
    Created --> Reject: action=reject
    Pass --> Finish: 退货处理完成

渠道状态都是字符串；CHS/CHR 是单号前缀；180601/180602 是交易类型。三者不能交叉比较。

12. 微仓补货、退货和调拨

12.1 补货主单

stateDiagram-v2
    [*] --> Outed: 创建并完成调出
    Outed --> Delivery: DELIEVER
    Delivery --> Outed: DEL_CANCEL
    Delivery --> WaitShelf: CONFIRM
    WaitShelf --> Shelf: 全部扫码上架/调入

updateMsStatus() 对不符合前置状态的请求统一抛“该订单状态已改变”。

12.2 微仓退货

12.3 站内调拨

12.4 站间调拨申请和实单

补货单、调拨单、库存流水三者状态必须一起检查；补货已上架但调拨未全部调入属于不一致。

13. 配送状态映射

13.1 自配送中心

13.2 三方配送

flowchart LR
    EXT["TMS/美团/达达状态"] --> MAP["TransportSer / InvSaService 映射"]
    MAP --> INV["销售出库 billStatus"]
    INV --> UI["页面配送/送达/对账按钮"]
    MAP --> REL["配送关系与退回状态"]

14. 收付款和对账状态

14.1 收付款单

14.2 对账单

stateDiagram-v2
    [*] --> Draft
    Draft --> Checked: 核对
    Checked --> Draft: 取消核对且未发生收款
    state Checked {
        [*] --> Unreceived
        Unreceived --> Partial: 部分收款
        Partial --> Received: 全部收款
        Unreceived --> Received: 一次全收
    }

对账时，来源出库单金额已全收或金额为 0 会直接变已核销 5，否则变已对账 4。取消核对只把“仍为已对账且没有收款”的出库单回退到已送达。

15. transType 交易类型字典

15.1 库存和单据

15.2 资金

15.3 套包和 SaaS 流水

15.4 已发现的语义冲突

16. 状态、副作用和事实一致性

flowchart TD
    ACTION["业务动作/MQ"] --> GUARD["校验前置状态"]
    GUARD --> STATE["更新主单状态"]
    STATE --> DETAIL["更新明细/数量过程"]
    DETAIL --> INV["库存流水/实时库存"]
    DETAIL --> MONEY["付款/账户/核销"]
    DETAIL --> EXT["活动/渠道/预订单/理赔"]
    STATE --> MQ["发送下游消息"]
    MQ --> REPORT["DWD/报表"]

一个状态迁移只有在相关副作用完成后才是业务完整的。排查时按下表判断：

17. 状态排查 SQL

17.1 采购

SELECT id, sid, billNo, billStatus, orderType, srcOrderType,
       transType, payment, closeType, orderCate, sendMode,
       srcOrderId, srcOrderNo, paymentTime, modifyTime, isDelete
FROM t_scm_po_order
WHERE sid = :sid AND billNo = :bill_no;

17.2 销售和出库

-- 替换真实 16 分片
SELECT id, billNo, billStatus, sourceType, payType,
       hxStateCode, billNo_type, srcOrderId, srcOrderNo
FROM t_scm_sa_order_{sid_mod_16}
WHERE sid = :sid AND billNo = :sale_no;

-- 替换真实 64 分片
SELECT id, billNo, billStatus, transType, sourceType,
       hxStateCode, return_type, srcOrderId, srcOrderNo,
       delieverTime, hasTime, cancelTime
FROM t_scm_sa_invoice_0_{sid_mod_64}
WHERE sid = :sid
  AND (billNo = :invoice_no OR srcOrderNo = :sale_no);

17.3 秒杀与采购联动

SELECT id, sid, bill_no, activity_id, order_status,
       pay_time, cancel_reason, create_time
FROM t_flash_order
WHERE sid = :sid AND bill_no = :flash_no;

SELECT id, activity_id, sku_id, total_qty, locked_qty, used_qty,
       status
FROM t_flash_activity_goods
WHERE activity_id = :activity_id;

SELECT id, billNo, billStatus, orderType, srcOrderType,
       srcOrderId, srcOrderNo
FROM t_scm_po_order
WHERE sid = :sid
  AND srcOrderType = 13
  AND (srcOrderId = :flash_order_id OR srcOrderNo = :flash_no);

17.4 状态时间线

SELECT iid, log, operateName, createTime
FROM t_scm_po_log
WHERE iid = :po_order_id
ORDER BY createTime, id;

SELECT iid, log, operateName, createTime
FROM t_scm_sa_log
WHERE iid = :sa_invoice_id
ORDER BY createTime, id;

日志字段以目标环境 DDL 为准；若业务日志缺失，还要查 MQ 和应用日志。

18. 代码检索命令

rg -n "BILLSTATUS_|ORDERTYPE_|SRC_ORDER_TYPE_" application/KzData/Enums/PoOrderEnums.php
rg -n "SA_STATUS_|OUT_BILLSTATUS_|ORDER_SOURCE_TYPE_" application/KzData/Enums/SaOrderEnums.php
rg -n "BILL_STATUS_|INVOICE_TYPE_|OUT_STATUS_" application/KzData/Enums/SaInvoiceEnums.php
rg -n "ORDER_STATUS_|APPLY_STATUS_|ENABLE_STATUS_" application/KzData/Enums/FlashActivityEnums.php
rg -n "MOVE_SUPPLY_STATUS_|MOVE_RE_STATUS_" application/KzData/Enums/MoveMallEnums.php
rg -n "TRANSTYPE_|TRANS_TYPE_" application/KzData/Enums/TransTypeEnums.php

找所有状态写入点：

rg -n "billStatus.*=|bill_status.*=|order_status.*=|setStatus\(" application/Services application/service application/controllers/tasks

找前置状态守卫：

rg -n "状态错误|状态非法|状态已改变|不能取消|不能撤销|in_array.*STATUS" application/Services application/service application/controllers/tasks

19. 常见问题故障树

19.1 回调提示状态错误

flowchart TD
    ERR["状态错误/消息重复"] --> OBJ["确认对象和字段"]
    OBJ --> CUR["查询当前状态和更新时间"]
    CUR --> LOG["查业务日志与 MQ message id"]
    LOG --> DUP{"已成功处理过"}
    DUP -->|是| IDEM["应识别为幂等成功，检查为何 NACK"]
    DUP -->|否| ORDER["检查消息乱序/人工提前操作"]
    ORDER --> SIDE["核对库存/资金/活动副作用"]

19.2 页面状态正确但业务不完整

20. 新增或修改状态的实施清单

1. 在 Enum 中定义值、名称和终态属性；
2. 明确允许的前置状态和迁移图；
3. Controller/Service 增加统一状态守卫；
4. 数据库字段类型能容纳新值；
5. 列表筛选、详情、按钮、导出同步；
6. MQ 生产者和消费者更新合同；
7. 重复消息按业务唯一键幂等；
8. 定时补偿知道新状态是否可处理；
9. 库存、资金、活动、来源业务副作用齐全；
10. 报表/DWD 状态映射更新；
11. APP、SaaS、OPS、订单中心、支付和配送完成联调；
12. 历史数据和废弃状态仍可读取；
13. 日志记录前后状态、动作、操作人和 request/message id；
14. 回滚方案不是简单改回旧状态，而是反向处理副作用。

21. 回归清单

21.1 采购和预订单

• 草稿、线下提交、在线待支付两种起点；
• 支付成功、重复成功、超时、超时后迟到支付；
• 审核通过、拒绝、未知结果；
• 待发、部分发、全部发、部分入、全部入；
• 未发货退货、已入库退货、退款、关闭；
• 普通、活动、预订单、秒杀、轮胎、专属授信副作用；
• 预订单部分提货、全部提货、用户取消、自动取消和售后。

21.2 销售和配送

• 待出、部分出、全部出和关闭；
• 部分撤销、全部撤销后状态回退；
• 自配送和三方配送所有外部状态；
• 配送取消/退回后恢复已出库；
• 已送达、对账、部分收款、全收、核销；
• 有收款和无收款两类取消对账；
• 普通、E站、APP、机器人、SaaS 来源。

21.3 活动、渠道和微仓

• 秒杀审批通过/拒绝、启用、提前结束和时间状态；
• 秒杀创建、待支付、支付、取消、关闭和部分采购行关闭；
• 渠道审核通过/拒绝、部分发货、全部发货和售后；
• 微仓派送、取消派送、确认、部分上架、全部上架；
• 调拨主单和补货/退货主单状态一致。

22. 当前代码风险

22.1 状态枚举分散且缺少统一迁移表

大量 Service 直接赋值，状态守卫和副作用散落在 Controller、Service、MQ 任务中。新增状态容易漏列表、报表、消息或补偿。

22.2 支付重复消息以异常 NACK 表达

已成功处理的重复消息会因为采购不再处于待支付/超时而抛错。需要用上游支付单号或消息 ID 建立幂等成功分支。

22.3 支付超时可恢复但额度可能为负

迟到支付把采购恢复为已提交；专属授信代码明确说明重新扣减可能产生负额度，必须建立业务决策和告警。

22.4 迁移服务后保留不可达旧代码

OrderCenterNotify::orderCenterAfterSaleAudit() 开头直接 ACK，后续旧实现不可达。阅读状态机时必须先确认实际责任服务。

22.5 相同状态值跨对象含义完全不同

采购 1 是已提交，销售 1 是部分出库，出库 1 是已出库，付款 1 是已提交，秒杀 1 是待支付。禁止裸数字跨域复用。

22.6 transType 存在冲突和映射覆盖

170502、150501、150602 的定义/标签存在歧义。修改前必须先统计真实表数据和所有调用方。

22.7 终态不是简单按最大值判断

采购状态值不连续，支付超时 12 可恢复；销售完成 2 可因撤销回退；出库已核销 5 后还有撤销状态 6。不能用 status >= N 作为通用终态判断。

23. 代码证据索引

24. 仍需环境确认

1. 生产历史数据中所有未在 Enum MAP 出现的状态值；
2. 外部订单中心的审核、关闭、退款状态和乱序保证；
3. 支付中心重复回调、迟到支付和退款消息的官方合同；
4. 采购售后迁移到 dgi-purchase-service 后的真实状态责任边界；
5. 每个 MQ 消费者对非法状态的 ACK/NACK、重试和死信策略；
6. 销售状态重算是否覆盖所有老出库和软删数据；
7. 对账单已核对后的撤销和收款回滚业务规则；
8. 微仓取消 5 的真实入口及其调拨/库存副作用；
9. TF_BILL_STATUS_IN_CLOSE=5 的页面名称和可操作动作；
10. transType 冲突值在生产各表的真实分布和报表解释；
11. 废弃来源类型是否仍有外部系统持续发送；
12. 是否可建立统一的状态迁移审计表，保存对象、前后状态、动作、请求 ID 和副作用结果。

环境核对结果要回填本文；不能仅以 Enum 注释替代跨系统状态合同。

请求-日志-数据变更追踪卡

多入口请求链路

日志证据矩阵

| 链路段 | 日志来源 | 可检索锚点 | 成功信号 | 失败信号 | 与下一段关联方式 | | --- | --- | --- | --- | --- | --- | --- | | 动作请求 | Controller 日志 | request_id、业务单号、action、请求状态 | Service 接受动作 | 非法动作、无权限、并发版本冲突 | 业务单号查迁移前后快照 | | 状态校验 | Service/Enum 异常 | Enum 常量、oldStatus、目标状态 | 命中允许分支 | default/unsupported、状态已变化 | 方法分支对应主表更新 SQL | | 回调映射 | Consumer 日志 | 外部状态、消息 ID、来源单号 | 映射后状态推进并 ACK | 未知外部状态、旧消息导致回退 | 来源单号关联本地主表和关系表 | | 补偿 | Task 日志 | task、批次、业务 ID、最终事实 | 影响行数与候选数可对账 | 重复副作用、状态无变化但持续重试 | 批次列表回查状态和关联事实 |

环节数据变更台账

子模块追踪：po-status 采购主状态机

子模块追踪：po-type-source 采购订单类型与来源

子模块追踪：preorder-status 预订单状态机

子模块追踪：sale-status 销售订单状态机

子模块追踪：invoice-status 销售出库状态机

子模块追踪：flash-status 秒杀活动、购物车与订单状态机

子模块追踪：channel-status 渠道订单与售后状态机

子模块追踪：move-status 微仓补货、退货与调拨状态机

子模块追踪：delivery-status 配送状态映射

子模块追踪：finance-status 收付款、对账与交易类型状态