新增功能
This commit is contained in:
Your Name
@@ -0,0 +1,212 @@
|
||||
# 医生预约系统快速开始指南
|
||||
|
||||
## 快速安装
|
||||
|
||||
### Windows用户
|
||||
|
||||
```bash
|
||||
# 双击运行
|
||||
install_appointment_system.bat
|
||||
```
|
||||
|
||||
### Linux/Mac用户
|
||||
|
||||
```bash
|
||||
# 添加执行权限
|
||||
chmod +x install_appointment_system.sh
|
||||
|
||||
# 运行安装脚本
|
||||
./install_appointment_system.sh
|
||||
```
|
||||
|
||||
### 手动安装
|
||||
|
||||
1. **创建数据库表**
|
||||
```bash
|
||||
mysql -u username -p database < server/sql/doctor_appointment.sql
|
||||
```
|
||||
|
||||
2. **清除缓存**
|
||||
```bash
|
||||
cd server
|
||||
php think clear
|
||||
```
|
||||
|
||||
3. **验证安装**
|
||||
访问: `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. 准备测试数据
|
||||
|
||||
创建医生排班:
|
||||
```sql
|
||||
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测试:
|
||||
|
||||
```bash
|
||||
# 获取可用时间段
|
||||
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. 测试前端
|
||||
|
||||
1. 登录后台管理系统
|
||||
2. 进入"中医诊断"页面
|
||||
3. 点击任意患者的"挂号"按钮
|
||||
4. 选择医生、日期、时间段
|
||||
5. 点击"确定"完成预约
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 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 - 预约详情
|
||||
```
|
||||
|
||||
## 数据库表结构
|
||||
|
||||
```sql
|
||||
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 (更新时间)
|
||||
```
|
||||
|
||||
## 业务规则
|
||||
|
||||
1. **时间段间隔**: 30分钟
|
||||
2. **上午时段**: 09:00 - 11:30
|
||||
3. **下午时段**: 13:00 - 20:30
|
||||
4. **预约限制**:
|
||||
- 必须有医生排班
|
||||
- 排班状态必须为"出诊"
|
||||
- 时间段不能重复预约
|
||||
- 预约数不能超过号源数
|
||||
|
||||
## 下一步
|
||||
|
||||
1. ✅ 安装完成
|
||||
2. ⏳ 配置权限
|
||||
3. ⏳ 创建测试数据
|
||||
4. ⏳ 测试功能
|
||||
5. ⏳ 上线使用
|
||||
|
||||
## 相关文档
|
||||
|
||||
- 详细安装说明: `server/APPOINTMENT_BACKEND_SETUP.md`
|
||||
- 系统设计文档: `admin/APPOINTMENT_SYSTEM.md`
|
||||
- UI更新说明: `admin/APPOINTMENT_UI_UPDATE.md`
|
||||
- 实现总结: `admin/APPOINTMENT_IMPLEMENTATION_SUMMARY.md`
|
||||
|
||||
## 技术支持
|
||||
|
||||
如遇问题，请检查:
|
||||
1. PHP版本 >= 7.2
|
||||
2. MySQL版本 >= 5.7
|
||||
3. ThinkPHP框架正常运行
|
||||
4. 数据库连接配置正确
|
||||
|
||||
---
|
||||
|
||||
**版本**: 1.0.0
|
||||
**创建时间**: 2024-02-26
|
||||
**最后更新**: 2024-02-26
|
||||
Reference in New Issue
Block a user