# 订单系统安装检查清单

## ✅ 安装前检查

- [ ] 确认数据库连接正常
- [ ] 确认有数据库 CREATE TABLE 权限
- [ ] 确认表前缀为 `la_`（不是 `zyt_`）
- [ ] 备份现有数据库（可选但推荐）

## 📋 安装步骤

### 第一步：创建数据库表

**选择以下任一方式：**

#### 方式 A：使用 SQL 文件（推荐）

```bash
# 在项目根目录执行
mysql -u root -p your_database < admin/order.sql
```

或者在 phpMyAdmin/Navicat 中：
1. 打开 `admin/order.sql` 文件
2. 复制所有内容
3. 在数据库管理工具中执行

#### 方式 B：直接复制 SQL

在数据库管理工具中执行 `admin/CREATE_ORDER_TABLES.sql` 中的 SQL 语句。

#### 方式 C：使用 ThinkPHP 迁移

```bash
cd server
php think migrate:run
```

### 第二步：验证表创建

在数据库管理工具中执行：

```sql
-- 检查表是否存在
SHOW TABLES LIKE 'la_order%';

-- 应该显示两个表：
-- la_order
-- la_order_detail

-- 查看表结构
DESC la_order;
DESC la_order_detail;
```

**预期结果：**
```
✅ la_order 表存在
✅ la_order_detail 表存在
✅ 所有字段都正确
✅ 所有索引都正确
```

### 第三步：添加权限节点

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

```
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     - 导出订单
```

### 第四步：验证后端文件

检查以下文件是否存在：

- [ ] `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`

### 第五步：验证前端文件

检查以下文件是否存在：

- [ ] `admin/src/api/order.ts`
- [ ] `admin/src/views/order/index.vue`

### 第六步：测试 API

使用 Postman 或 curl 测试 API：

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

# 预期响应：
# {
#   "code": 1,
#   "msg": "success",
#   "data": {
#     "lists": [],
#     "count": 0,
#     "page_no": 1,
#     "page_size": 15
#   }
# }
```

### 第七步：访问前端页面

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

## 🔍 故障排除

### 问题 1：表不存在错误

**错误信息：**
```
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'zyt.order' doesn't exist
```

**原因：** 表未创建或表名前缀错误

**解决方案：**
1. 执行 SQL 脚本创建表
2. 检查表前缀是否为 `la_order` 而不是 `zyt_order`
3. 检查数据库连接配置

### 问题 2：控制器找不到

**错误信息：**
```
控制器不存在:\\app\\adminapi\\controller\\order\\OrderController
```

**原因：** 文件不在正确的目录

**解决方案：**
1. 确保文件在 `server/app/adminapi/controller/order/` 目录中
2. 检查文件名是否为 `OrderController.php`
3. 检查命名空间是否正确
4. 清除应用缓存

### 问题 3：权限不足

**错误信息：**
```
权限不足，无法访问或操作
```

**原因：** 用户没有相应的权限

**解决方案：**
1. 在权限管理系统中添加权限节点
2. 为用户分配权限
3. 清除权限缓存

### 问题 4：API 返回 404

**错误信息：**
```
404 Not Found
```

**原因：** 路由不正确

**解决方案：**
1. 检查 API 路由是否为 `/order.order/lists` 而不是 `/order/lists`
2. 检查请求方法是否正确（GET/POST）
3. 检查 token 是否有效

## 📊 验证清单

### 数据库验证

```sql
-- 检查表是否存在
SELECT COUNT(*) FROM information_schema.TABLES 
WHERE TABLE_SCHEMA = 'your_database' 
AND TABLE_NAME IN ('la_order', 'la_order_detail');
-- 应该返回 2

-- 检查表结构
DESC la_order;
DESC la_order_detail;

-- 检查索引
SHOW INDEX FROM la_order;
SHOW INDEX FROM la_order_detail;
```

### 后端验证

```bash
# 检查文件是否存在
ls -la server/app/adminapi/controller/order/OrderController.php
ls -la server/app/adminapi/logic/order/OrderLogic.php
ls -la server/app/adminapi/validate/order/OrderValidate.php
ls -la server/app/adminapi/lists/order/OrderLists.php
```

### 前端验证

```bash
# 检查文件是否存在
ls -la admin/src/api/order.ts
ls -la admin/src/views/order/index.vue
```

## 🎯 最终检查

- [ ] 数据库表已创建
- [ ] 表结构正确
- [ ] 所有索引已创建
- [ ] 后端文件都在正确位置
- [ ] 前端文件都在正确位置
- [ ] 权限节点已添加
- [ ] API 可以正常访问
- [ ] 前端页面可以正常加载
- [ ] 可以创建订单
- [ ] 可以查看订单列表
- [ ] 可以支付订单
- [ ] 可以取消订单
- [ ] 可以退款订单

## 📞 需要帮助？

如果遇到问题，请按以下顺序检查：

1. **检查数据库表**
   - 表是否存在？
   - 表前缀是否正确？
   - 字段是否完整？

2. **检查后端文件**
   - 文件是否在正确的目录？
   - 命名空间是否正确？
   - 是否有语法错误？

3. **检查前端文件**
   - 文件是否存在？
   - API 导入是否正确？
   - 路由是否配置？

4. **检查权限**
   - 权限节点是否添加？
   - 用户是否有权限？
   - 权限缓存是否清除？

5. **查看日志**
   - 后端错误日志
   - 前端控制台错误
   - 数据库错误日志

## 📚 相关文档

- `README_ORDER.md` - 快速开始指南
- `ORDER_SYSTEM_GUIDE.md` - 完整系统指南
- `INSTALL_ORDER_TABLES.md` - 表安装详细指南
- `ORDER_SETUP.md` - 安装步骤
- `ORDER_IMPLEMENTATION_COMPLETE.md` - 实现完成说明

## ✅ 安装完成

当所有检查都通过后，你可以：

1. 访问订单页面
2. 创建新订单
3. 管理订单状态
4. 查看订单详情
5. 导出订单数据

---

**安装日期**: _______________
**安装人**: _______________
**验证人**: _______________
**备注**: _______________