foodie-server/specs/006-orderstate/quickstart.md

Quickstart: 订单状态四字段分离

前置条件

1. 数据库执行 updatesql/sql.md 中的 ALTER TABLE 语句添加三个新列
2. 历史订单数据手动清空（系统未正式使用）

实施顺序

Step 1: 数据库 & 实体层

• SQL 脚本写入 updatesql/sql.md
• PosOrder.java 新增 3 个字段
• PosOrderMapper.xml resultMap + insert/update 添加新字段

Step 2: 订单创建 & 支付回调

• UserOrderController.createOrder() 设置新字段初始值
• 支付回调中更新 payStatus

Step 3: 商家操作改造

• 接单：state 0→1
• 出餐：state 1→2，外送额外设 deliveryStatus=0
• 完成（自取/堂食）：state 2→3 + payStatus 0→1

Step 4: 骑手操作改造

• acceptOrder：deliveryStatus=1
• pickupOrder：deliveryStatus=2
• deliverOrder：deliveryStatus=3 + state=3

Step 5: 订单取消

• OrderAppealController 改造取消逻辑：state→4

Step 6: 定时任务改造

• TestTask.java 使用新字段条件

Step 7: 新列表接口（三端）

• 用户端 UserOrderController.orderList()
• 商家端 PosOrderShOprateController.orderList()
• 骑手端 PosOrderQsOprateController.orderList()

Step 8: 骑手约束逻辑

• RiderPositionMapper 条件更新

Step 9: 平台管理端前端

• foodie-admin-vue 订单列表页改造

验证方式

每个 Step 完成后：

1. 启动服务确认无编译错误
2. 用 Postman/curl 测试相关接口
3. 检查数据库字段值正确