Implementation Plan: 订单状态四字段分离

Branch: test | Date: 2026-05-15 | Spec: spec.md Input: Feature specification from /specs/006-orderstate/spec.md

Summary

将现有 pos_order 表中混用的 state 字段拆分为四个独立字段（state、delivery_status、pay_status、after_sale_status），参考美团订单状态机设计。涉及数据库变更、实体类扩展、MyBatis Mapper 更新、三端（用户/商家/骑手）操作接口改造、新订单列表接口开发、定时任务调整、以及平台管理端前端适配。

Technical Context

Language/Version: Java 21 Primary Dependencies: Spring Boot 3.3.5, MyBatis 3.0.3 (mybatis-spring-boot-starter),若依框架 Storage: MySQL Testing: 手动测试（项目无自动化测试框架） Target Platform: Linux/Windows Server Project Type: Web Service (REST API + 管理端前端) Performance Goals: 无特殊性能要求，常规 CRUD Constraints: 数据库变更写 SQL 脚本（updatesql/sql.md），不直接执行 Scale/Scope: 3 个 Controller 改造 + 3 个新列表接口 + 1 个前端项目调整

关键文件清单

文件	路径	变更类型
PosOrder.java	`ruoyi-system/.../domain/PosOrder.java`	新增3个字段
PosOrderMapper.xml	`ruoyi-system/.../mapper/system/PosOrderMapper.xml`	resultMap + SQL 更新
PosOrderShOprateController	`ruoyi-admin/.../app/order/PosOrderShOprateController.java`	改造接单/出餐 + 新增列表接口
PosOrderQsOprateController	`ruoyi-admin/.../app/order/PosOrderQsOprateController.java`	改造骑手操作 + 新增列表接口
UserOrderController	`ruoyi-admin/.../app/order/UserOrderController.java`	改造创建订单 + 新增列表接口
OrderAppealController	`ruoyi-admin/.../app/order/OrderAppealController.java`	改造取消订单
TestTask.java	`ruoyi-admin/.../app/order/TestTask.java`	定时任务改造
sql.md	`updatesql/sql.md`	新增 ALTER TABLE 语句
平台管理前端	`E:\QtwCode\foodie\foodie-admin-vue\src\views\system\order\index.vue`	筛选/展示改造

Constitution Check

Constitution 为模板状态，无自定义约束。跳过 gate 检查。

Project Structure

Documentation (this feature)

specs/test/
├── plan.md              # This file
├── research.md          # Phase 0 output
├── data-model.md        # Phase 1 output
├── quickstart.md        # Phase 1 output
├── contracts/           # Phase 1 output
└── tasks.md             # Phase 2 output (via /speckit.tasks)

Source Code (repository root)

ruoyi-system/src/main/java/com/ruoyi/system/
├── domain/PosOrder.java                  # 实体类
├── mapper/PosOrderMapper.java            # Mapper接口
└── service/                              # Service层

ruoyi-system/src/main/resources/mapper/system/
└── PosOrderMapper.xml                    # MyBatis XML

ruoyi-admin/src/main/java/com/ruoyi/app/order/
├── PosOrderShOprateController.java       # 商家操作
├── PosOrderQsOprateController.java       # 骑手操作
├── UserOrderController.java              # 用户操作
├── OrderAppealController.java            # 售后/取消
└── TestTask.java                         # 定时任务

updatesql/
└── sql.md                                # SQL迁移脚本

# 前端（外部项目）
E:\QtwCode\foodie\foodie-admin-vue\
└── src/views/system/order/index.vue      # 平台管理端订单页

Structure Decision: 后端遵循若依多模块 Maven 结构。前端在独立仓库中。

Complexity Tracking

Violation	Why Needed	Simpler Alternative Rejected Because
四字段拆分增加查询复杂度	自取/堂食订单无配送状态，单字段无法表达	单 state 字段混用已导致无法支持新订单类型

plan.md 4.0 KB Historique Raw