Files
zyt/admin/ORDER_SETUP.md
T
2026-03-11 09:49:47 +08:00

3.5 KiB
Raw Blame History

订单系统快速安装指南

文件结构修正

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

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

验证安装

前端验证

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

后端验证

  1. 检查数据库表是否创建成功
SHOW TABLES LIKE '%order%';
DESC order;
DESC order_detail;
  1. 测试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

下一步

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