ZYT/zyt

Fork 0

Files

T

Your Name ab77f5488d 新增功能

2026-03-04 15:32:30 +08:00

5.0 KiB

Raw Blame History

医生预约系统快速开始指南

快速安装

Windows用户

# 双击运行
install_appointment_system.bat

Linux/Mac用户

# 添加执行权限
chmod +x install_appointment_system.sh

# 运行安装脚本
./install_appointment_system.sh

手动安装

创建数据库表

mysql -u username -p database < server/sql/doctor_appointment.sql

清除缓存

cd server
php think clear

验证安装 访问: http://your-domain/adminapi/doctor.appointment/availableSlots?doctor_id=1&appointment_date=2026-03-04&period=morning

文件清单

后端文件 (已创建)

✅ server/app/common/model/doctor/Appointment.php - 数据模型
✅ server/app/adminapi/controller/doctor/AppointmentController.php - 控制器
✅ server/app/adminapi/logic/doctor/AppointmentLogic.php - 业务逻辑
✅ server/app/adminapi/validate/doctor/AppointmentValidate.php - 验证器
✅ server/app/adminapi/lists/doctor/AppointmentLists.php - 列表
✅ server/sql/doctor_appointment.sql - 数据库脚本

前端文件 (已创建)

✅ admin/src/api/doctor.ts - API接口
✅ admin/src/views/tcm/diagnosis/appointment.vue - 预约组件
✅ admin/src/views/tcm/diagnosis/index.vue - 诊断列表(已更新)

API接口速查

1. 获取可用时间段

GET /adminapi/doctor.appointment/availableSlots
参数: doctor_id, appointment_date, period

2. 创建预约

POST /adminapi/doctor.appointment/create
参数: patient_id, doctor_id, appointment_date, period, appointment_time

3. 取消预约

POST /adminapi/doctor.appointment/cancel
参数: id

4. 预约列表

GET /adminapi/doctor.appointment/lists
参数: page_no, page_size

5. 医生可用号源

GET /adminapi/doctor.appointment/doctorAvailability
参数: doctor_id, date

测试步骤

1. 准备测试数据

创建医生排班:

INSERT INTO `la_doctor_roster` 
(`doctor_id`, `date`, `period`, `status`, `quota`, `max_patients`, `create_time`, `update_time`)
VALUES
(1, '2026-03-04', 'morning', 1, 10, 15, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
(1, '2026-03-04', 'afternoon', 1, 10, 15, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());

2. 测试API

使用Postman或curl测试:

# 获取可用时间段
curl "http://localhost/adminapi/doctor.appointment/availableSlots?doctor_id=1&appointment_date=2026-03-04&period=morning"

# 创建预约
curl -X POST "http://localhost/adminapi/doctor.appointment/create" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": 1,
    "doctor_id": 1,
    "appointment_date": "2026-03-04",
    "period": "morning",
    "appointment_time": "09:00",
    "appointment_type": "video"
  }'

3. 测试前端

登录后台管理系统
进入"中医诊断"页面
点击任意患者的"挂号"按钮
选择医生、日期、时间段
点击"确定"完成预约

常见问题

Q1: 控制器不存在

A: 运行 cd server && php think clear 清除缓存

Q2: 数据库表不存在

A: 执行 mysql -u username -p database < server/sql/doctor_appointment.sql

Q3: 没有可用时间段

A: 检查医生是否有排班，排班状态是否为"出诊"(status=1)

Q4: 预约失败

A: 检查:

医生排班是否存在
时间段是否已被占用
号源是否已满

权限配置

在后台权限管理中添加以下权限节点:

doctor.appointment/availableSlots - 查看可用时间段
doctor.appointment/create - 创建预约
doctor.appointment/cancel - 取消预约
doctor.appointment/lists - 预约列表
doctor.appointment/detail - 预约详情

数据库表结构

la_doctor_appointment
├── id (主键)
├── patient_id (患者ID)
├── doctor_id (医生ID)
├── roster_id (排班ID)
├── appointment_date (预约日期)
├── period (时段: morning/afternoon)
├── appointment_time (预约时间)
├── appointment_type (预约类型: video/text/phone)
├── status (状态: 1=已预约, 2=已取消, 3=已完成)
├── remark (备注)
├── create_time (创建时间)
└── update_time (更新时间)

业务规则

时间段间隔: 30分钟
上午时段: 09:00 - 11:30
下午时段: 13:00 - 20:30
预约限制:
- 必须有医生排班
- 排班状态必须为"出诊"
- 时间段不能重复预约
- 预约数不能超过号源数

下一步

✅ 安装完成
⏳ 配置权限
⏳ 创建测试数据
⏳ 测试功能
⏳ 上线使用

技术支持

如遇问题，请检查:

PHP版本 >= 7.2
MySQL版本 >= 5.7
ThinkPHP框架正常运行
数据库连接配置正确

版本: 1.0.0
创建时间: 2024-02-26
最后更新: 2024-02-26

5.0 KiB Raw Blame History