3.5 KiB
3.5 KiB
订单系统快速安装指南
文件结构修正
后端文件已按照项目规范放置在正确的子目录中:
server/app/adminapi/
├── controller/order/OrderController.php
├── logic/order/OrderLogic.php
├── validate/order/OrderValidate.php
└── lists/order/OrderLists.php
安装步骤
1. 数据库迁移
执行以下命令创建订单表:
# 方式一:使用迁移文件
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
验证安装
前端验证
- 打开浏览器访问订单页面
- 检查是否能正常加载列表
- 尝试搜索、筛选功能
后端验证
- 检查数据库表是否创建成功
SHOW TABLES LIKE '%order%';
DESC order;
DESC order_detail;
- 测试API端点
# 获取订单列表
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
下一步
- 根据实际需求调整订单类型和状态
- 集成第三方支付接口
- 添加订单统计和报表功能
- 实现订单提醒和通知功能