292 lines
6.2 KiB
Markdown
292 lines
6.2 KiB
Markdown
# 订单系统安装检查清单
|
||
|
||
## ✅ 安装前检查
|
||
|
||
- [ ] 确认数据库连接正常
|
||
- [ ] 确认有数据库 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. 导出订单数据
|
||
|
||
---
|
||
|
||
**安装日期**: _______________
|
||
**安装人**: _______________
|
||
**验证人**: _______________
|
||
**备注**: _______________
|