更新

2026-03-11 09:49:47 +08:00
parent 02ae537b4c
commit 38ad60f4bb
290 changed files with 36917 additions and 123 deletions
@@ -0,0 +1,152 @@
+# 订单系统快速安装指南
+
+## 文件结构修正
+
+后端文件已按照项目规范放置在正确的子目录中：
+
+```
+server/app/adminapi/
+├── controller/order/OrderController.php
+├── logic/order/OrderLogic.php
+├── validate/order/OrderValidate.php
+└── lists/order/OrderLists.php
+```
+
+## 安装步骤
+
+### 1. 数据库迁移
+
+执行以下命令创建订单表：
+
+```bash
+# 方式一：使用迁移文件
+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. 检查数据库表是否创建成功
+
+```sql
+SHOW TABLES LIKE '%order%';
+DESC order;
+DESC order_detail;
+```
+
+2. 测试API端点
+
+```bash
+# 获取订单列表
+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. 实现订单提醒和通知功能