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

4.1 KiB

订单系统 - 快速参考

快速开始

1. 数据库初始化

# 在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

权限配置示例

// 在权限管理中添加
[
    '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' => '导出订单',
    ]
]

菜单配置示例

[
    'name' => '订单管理',
    'path' => '/order',
    'component' => 'order/index',
    'icon' => 'shopping-cart',
    'permissions' => ['order.order/lists']
]

版本: 1.0.0
最后更新: 2026-03-10
状态: 完成