153 lines
3.5 KiB
Markdown
153 lines
3.5 KiB
Markdown
# 订单系统快速安装指南
|
||
|
||
## 文件结构修正
|
||
|
||
后端文件已按照项目规范放置在正确的子目录中：
|
||
|
||
```
|
||
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. 实现订单提醒和通知功能
|