订单与履约异常工作台｜项目方案产品系统

项目方案文档，软件尚未实施。小型线上商户需要让运营看到待处理订单、可发货项目和物流异常，仓库人员只接触履约所需信息。本次交付为需求、流程、接口及验收方案，不代表客户项目或上线系统。

已确认订单→选择未发货品项→创建分批包裹→发货→送达/异常。未发数量由订单品项减去已承诺发货量得到，不由前端直接改写订单总状态。主要规则：超量发货返回409，负数/缺字段返回422；重复或乱序物流事件不让已送达退回运输中。列表隐藏完整地址，详情按角色授权；库存分配和付款由外部模拟接口承担。 发货数量必须为正整数，重复品项ID拒绝；按稳定品项顺序锁行，在同一事务内计算非取消包裹的已承诺数量并保存包裹和幂等记录。首版不提供取消包裹接口，不能凭物流异常释放数量。物流事件校验包裹归属，先按供应商序号或已定义状态图处理，不以接收顺序推导状态；原始occurred_at与received_at均保存UTC，未能排序的冲突进入异常队列。界面覆盖查询、详情和状态跟进，并明确加载、空数据、保存失败和权限不足的状态。

已完成需求、状态流程、数据模型、接口契约与验收方案文档。拟采用 React/TypeScript、Python/FastAPI 与 PostgreSQL。拟定验收：一张订单分两次发货后未发数量为零，重复创建请求不会重复扣数量。重放、乱序、签名错误的物流事件分别验证去重、状态防回退和拒绝处理。尚未实施软件或运行测试，无客户交付或实测业绩；附件为方案PDF。