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

**Branch**: `test` | **Date**: 2026-05-15 | **Spec**: [spec.md](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)

```text
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)

```text
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 字段混用已导致无法支持新订单类型 |