预约管理 API

预约管理模块允许您查看医生排班、管理客户预约以及监控看板状态。

1. 预约环境配置

获取当前门店的排班规则、可选科室、医生列表以及房间 / 床位配置。通常用于渲染预约界面。

GET /api/appointment/config

响应数据结构

• room : 可预约的房间 / 诊室列表。
• doctor : 可预约的医生列表（slug 为 doctor 的用户）。
• technician : 可预约的技师列表。
• department : 可预约的科室列表。
• business_start/end : 营业时间。
• slot_duration : 预约步长（如 30 分钟）。

---

2. 预约列表

获取预约的历史或未来记录。

GET /api/appointment/lists

请求参数

参数名	类型	必填	描述
date	string	否	精确日期过滤 (YYYY-MM-DD)
rows	integer	否	每页数量
sort	string	否	排序字段 (默认 start)
order	string	否	排序方向 (asc/desc)

---

3. 预约看板

获取结构化的看板数据，通常用于 FullCalendar 等组件展示。

GET /api/appointment/dashboard

请求参数

• start : 开始时间
• end : 结束时间

---

4. 创建预约

发起一个新的客户预约。

POST /api/appointment/create

请求参数 (JSON)

参数名	类型	必填	描述
customer_id	integer	是	客户 ID
date	string	是	预约日期 (YYYY-MM-DD)
start	string	是	开始时间 (HH:mm)
end	string	是	结束时间 (HH:mm)
doctor_id	integer	否	指定医生 ID
department_id	integer	否	指定科室 ID
remark	string	否	预约备注

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 501,
    "customer": { "name": "张三", "idcard": "..." },
    "doctor": { "name": "李医生" },
    ...
  }
}