qipai/docs/api-changelog/2026-06-20-M04-B-order-state-machine.md

M04-B 订单状态机 API

• GET /app-api/orders/:orderId/history：订单所有者或有门店管理权限的人员查看完整状态历史。
• POST /app-api/orders/:orderId/cancel：订单所有者发起取消。
• POST /admin-api/orders/:orderId/actions：管理员提交受控业务动作。

管理接口只接受 SUBMIT、CONFIRM_PAYMENT、RESERVE、START、FINISH、CANCEL、BEGIN_REFUND、COMPLETE_REFUND、CLOSE，由服务端映射目标状态并校验合法迁移。请求不能直接提交目标状态或最终金额。

每次迁移记录操作者、来源、原因和 traceId；相同订单和 traceId 的重试幂等返回第一次结果。