# 订单系统快速安装指南

## 文件结构修正

后端文件已按照项目规范放置在正确的子目录中：

```
server/app/adminapi/
├── controller/order/OrderController.php
├── logic/order/OrderLogic.php
├── validate/order/OrderValidate.php
└── lists/order/OrderLists.php
```

## 安装步骤

### 1. 数据库迁移

执行以下命令创建订单表：

```bash
# 方式一：使用迁移文件
php think migrate:run

# 方式二：直接执行SQL
mysql -u root -p your_database < admin/order.sql
```

### 2. 前端集成

将以下文件复制到项目中：

```
admin/src/api/order.ts                    → 项目的 src/api/
admin/src/views/order/index.vue           → 项目的 src/views/
```

### 3. 后端集成

所有后端文件已在正确的位置：

```
server/app/common/model/Order.php
server/app/common/model/OrderDetail.php
server/app/adminapi/controller/order/OrderController.php
server/app/adminapi/logic/order/OrderLogic.php
server/app/adminapi/validate/order/OrderValidate.php
server/app/adminapi/lists/order/OrderLists.php
```

### 4. 权限配置

在后端权限管理系统中添加以下权限节点：

```
order.order/lists      - 订单列表
order.order/detail     - 订单详情
order.order/create     - 创建订单
order.order/edit       - 编辑订单
order.order/pay        - 支付订单
order.order/cancel     - 取消订单
order.order/refund     - 退款订单
order.order/delete     - 删除订单
order.order/export     - 导出订单
```

### 5. 路由配置

路由会自动识别，无需手动配置。系统会根据以下规则自动生成路由：

- 控制器路径：`app\adminapi\controller\order\OrderController`
- 路由前缀：`order.order`
- 方法映射：`lists`, `detail`, `create`, `edit`, `pay`, `cancel`, `refund`, `delete`, `export`

## 验证安装

### 前端验证

1. 打开浏览器访问订单页面
2. 检查是否能正常加载列表
3. 尝试搜索、筛选功能

### 后端验证

1. 检查数据库表是否创建成功

```sql
SHOW TABLES LIKE '%order%';
DESC order;
DESC order_detail;
```

2. 测试API端点

```bash
# 获取订单列表
curl -X GET "http://localhost:8000/order.order/lists" \
  -H "token: your_token"

# 创建订单
curl -X POST "http://localhost:8000/order.order/create" \
  -H "token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": 1,
    "order_type": 1,
    "amount": 100.00
  }'
```

## 常见问题

### Q: 控制器找不到？
A: 确保文件在正确的子目录中：`server/app/adminapi/controller/order/OrderController.php`

### Q: 表不存在？
A: 执行数据库迁移或直接运行 SQL 脚本

### Q: 权限不足？
A: 在后端权限管理中添加相应的权限节点

### Q: API 返回 404？
A: 检查路由是否正确，应该是 `/order.order/lists` 而不是 `/order/lists`

## 文件清单

✅ 前端文件
- admin/src/api/order.ts
- admin/src/views/order/index.vue

✅ 后端文件
- server/app/common/model/Order.php
- server/app/common/model/OrderDetail.php
- server/app/adminapi/controller/order/OrderController.php
- server/app/adminapi/logic/order/OrderLogic.php
- server/app/adminapi/validate/order/OrderValidate.php
- server/app/adminapi/lists/order/OrderLists.php

✅ 数据库文件
- server/database/migrations/2024_03_10_create_order_tables.php
- admin/order.sql

✅ 文档文件
- admin/ORDER_SYSTEM_GUIDE.md
- admin/ORDER_SETUP.md

## 下一步

1. 根据实际需求调整订单类型和状态
2. 集成第三方支付接口
3. 添加订单统计和报表功能
4. 实现订单提醒和通知功能