210 lines
4.1 KiB
Markdown
210 lines
4.1 KiB
Markdown
# 订单系统 - 快速参考
|
|
|
|
## 快速开始
|
|
|
|
### 1. 数据库初始化
|
|
```bash
|
|
# 在MySQL中执行
|
|
mysql -u root -p your_database < admin/order.sql
|
|
```
|
|
|
|
### 2. 访问订单管理
|
|
- 路由: `/order`
|
|
- 权限: `order.order/lists`
|
|
|
|
---
|
|
|
|
## 主要功能
|
|
|
|
| 功能 | 权限 | 说明 |
|
|
|------|------|------|
|
|
| 查看列表 | 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 | 导出为Excel |
|
|
|
|
---
|
|
|
|
## 订单类型
|
|
|
|
| 类型 | 值 | 说明 |
|
|
|------|-----|------|
|
|
| 挂号费 | 1 | 医生挂号费用 |
|
|
| 问诊费 | 2 | 在线问诊费用 |
|
|
| 药品费用 | 3 | 药品购买费用 |
|
|
|
|
---
|
|
|
|
## 订单状态
|
|
|
|
| 状态 | 值 | 说明 |
|
|
|------|-----|------|
|
|
| 待支付 | 1 | 新创建的订单 |
|
|
| 已支付 | 2 | 已完成支付 |
|
|
| 已取消 | 3 | 已取消的订单 |
|
|
| 已退款 | 4 | 已退款的订单 |
|
|
|
|
---
|
|
|
|
## 支付方式
|
|
|
|
| 方式 | 值 | 说明 |
|
|
|------|-----|------|
|
|
| 支付宝 | alipay | 支付宝支付 |
|
|
| 微信 | wechat | 微信支付 |
|
|
| 银行卡 | bank | 银行卡支付 |
|
|
|
|
---
|
|
|
|
## API 端点速查
|
|
|
|
### 列表
|
|
```
|
|
GET /order.order/lists?order_no=&patient_keyword=&order_type=&status=&create_time_start=&create_time_end=&page_no=1&page_size=15
|
|
```
|
|
|
|
### 详情
|
|
```
|
|
GET /order.order/detail?id=1
|
|
```
|
|
|
|
### 创建
|
|
```
|
|
POST /order.order/create
|
|
{
|
|
"patient_id": 1,
|
|
"order_type": 1,
|
|
"amount": 100.00,
|
|
"remark": "备注",
|
|
"details": [
|
|
{
|
|
"related_type": "appointment",
|
|
"related_id": 1,
|
|
"quantity": 1,
|
|
"unit_price": 100.00,
|
|
"total_price": 100.00
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### 支付
|
|
```
|
|
POST /order.order/pay
|
|
{
|
|
"id": 1,
|
|
"payment_method": "alipay"
|
|
}
|
|
```
|
|
|
|
### 取消
|
|
```
|
|
POST /order.order/cancel
|
|
{
|
|
"id": 1
|
|
}
|
|
```
|
|
|
|
### 退款
|
|
```
|
|
POST /order.order/refund
|
|
{
|
|
"id": 1
|
|
}
|
|
```
|
|
|
|
### 删除
|
|
```
|
|
POST /order.order/delete
|
|
{
|
|
"id": 1
|
|
}
|
|
```
|
|
|
|
### 搜索患者
|
|
```
|
|
GET /tcm.diagnosis/searchPatient?keyword=张三&page_no=1&page_size=10
|
|
```
|
|
|
|
---
|
|
|
|
## 常见问题
|
|
|
|
### Q: 如何创建订单？
|
|
A: 点击"创建订单"按钮，选择患者、订单类型、输入金额，添加订单详情项，点击确认。
|
|
|
|
### Q: 患者信息从哪里来？
|
|
A: 从诊单表（tcm_diagnosis）搜索患者，支持按姓名、电话、身份证号搜索。
|
|
|
|
### Q: 创建人ID是什么？
|
|
A: 自动记录当前登录管理员的ID，用于追踪订单创建者。
|
|
|
|
### Q: 订单能否修改？
|
|
A: 只能修改备注，其他信息不可修改。
|
|
|
|
### Q: 订单能否删除？
|
|
A: 可以删除，但会永久删除数据（支持软删除恢复）。
|
|
|
|
### Q: 支付后能否取消？
|
|
A: 不能，只能退款。
|
|
|
|
---
|
|
|
|
## 文件位置
|
|
|
|
| 文件 | 位置 |
|
|
|------|------|
|
|
| 前端页面 | admin/src/views/order/index.vue |
|
|
| API接口 | admin/src/api/order.ts |
|
|
| 控制器 | server/app/adminapi/controller/order/OrderController.php |
|
|
| 业务逻辑 | server/app/adminapi/logic/order/OrderLogic.php |
|
|
| 数据模型 | server/app/common/model/Order.php |
|
|
| 数据库脚本 | admin/order.sql |
|
|
|
|
---
|
|
|
|
## 权限配置示例
|
|
|
|
```php
|
|
// 在权限管理中添加
|
|
[
|
|
'name' => '订单管理',
|
|
'permissions' => [
|
|
'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' => '导出订单',
|
|
]
|
|
]
|
|
```
|
|
|
|
---
|
|
|
|
## 菜单配置示例
|
|
|
|
```php
|
|
[
|
|
'name' => '订单管理',
|
|
'path' => '/order',
|
|
'component' => 'order/index',
|
|
'icon' => 'shopping-cart',
|
|
'permissions' => ['order.order/lists']
|
|
]
|
|
```
|
|
|
|
---
|
|
|
|
**版本**: 1.0.0
|
|
**最后更新**: 2026-03-10
|
|
**状态**: ✅ 完成
|