foodie-server/docs/order-api-usage.md

外卖订单操作入口清单

面向后端维护者的订单接口职责边界。2026-09-29 起明确：用户、骑手、商家的订单状态流转操作一律走三个专用操作控制器，不使用 PosOrderController 的方法；新增状态流转类功能不得加到 PosOrderController。已在四个控制器类注释与 add/edit 的 @Deprecated 标注同步记录。

操作入口（在用）

角色	控制器	路由前缀	典型操作
用户	UserOrderController	/system/userOrder	下单（createOrder，含支付方式闸门）、用户取消
骑手	PosOrderQsOprateController	/system/orderQsOprate	接单 / 取餐 / 送达（按 deliveryStatus 1/2/3）
商家	PosOrderShOprateController	/system/orderShOprate	商家端下单（/createOrder）、出餐（chuCan）、商家取消

闪送订单不在本清单内，走 flashdelivery 包的独立控制器体系。

PosOrderController（/system/order）职责边界

仍在用：

类别	接口
查询	/getorderlist、/getstoreorderlist、/getqsorderlist、/getqishouorderlist、/getorderxq、/getorderhout、/getuserfootlist、/getPsOrdersPosition、/list、/shlist1~/shlist3、/export、/{id}、/{id}/status-context
平台改状态	/setorderuzt
平台管理操作	/{id}/status、/{id}/line-payment/reconcile、/{id}/line-refund、/{id}/offline-payment/confirm、/{id}/offline-refund/confirm（Spring Security @PreAuthorize，操作留痕 @Log）

已废弃（@Deprecated 已标注，代码保留备查，勿增量修改）：

接口	说明
/addorder	旧代客外送下单流程（货到付款 + sendHdfkMessage 推送）；2026-09-29 确认废弃，商家端下单走 PosOrderShOprateController /createOrder。内含 031 支付闸门 assertUsable 调用点，随入口一并废弃，勿再以此为基准增量开发
POST /system/order（add）	RuoYi CRUD 新增订单；用户下单走 UserOrderController.createOrder
PUT /system/order（edit）	修改订单信息入口不再使用；状态流转已迁出
/testYjsdTime	随 setYjsdTime 停用（依赖已停用的 Mapbox 接口，见 map-api-usage.md）

新改动规则

1. 状态流转类新功能（改 state / deliveryStatus / payStatus / afterSaleStatus 的操作）一律实现到对应角色控制器，不进 PosOrderController。
2. PosOrderController 仅维护查询接口、平台管理接口与既有的 /addorder、/setorderuzt。
3. 废弃方法不做增量修改；排查问题时也不得以其为基准（同 CLAUDE.md 已废弃代码清单约定）。

关联

• CLAUDE.md 已废弃代码清单（订单/支付）
• specs/030-unified-order-list/（统一订单列表，列表查询口径）
• docs/map-api-usage.md（/testYjsdTime、setYjsdTime 停用详情）