# 订单系统 - 快速参考

## 快速开始

### 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  
**状态**: ✅ 完成