zyt/admin/INSTALLATION_CHECKLIST.md

订单系统安装检查清单

✅ 安装前检查

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

📋 安装步骤

第一步：创建数据库表

选择以下任一方式：

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

# 在项目根目录执行
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 迁移

cd server
php think migrate:run

第二步：验证表创建

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

-- 检查表是否存在
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：

# 获取订单列表
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 是否有效

📊 验证清单

数据库验证

-- 检查表是否存在
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;

后端验证

# 检查文件是否存在
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

前端验证

# 检查文件是否存在
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. 导出订单数据

---

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