# 挂号预约排班状态测试指南

## 快速测试

### 准备测试数据

```sql
-- 1. 确保有医生数据
SELECT a.id, a.name, ar.role_id 
FROM zyt_admin a
INNER JOIN zyt_admin_role ar ON a.id = ar.admin_id
WHERE ar.role_id = 1;

-- 2. 清空测试医生的排班（可选）
DELETE FROM zyt_doctor_roster WHERE doctor_id = 1;

-- 3. 添加测试排班数据
-- 场景1：周一全天出诊
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2026-03-09', 1, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),  -- 上午出诊
(1, '2026-03-09', 2, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());  -- 下午出诊

-- 场景2：周二上午出诊，下午休息
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2026-03-10', 1, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),  -- 上午出诊
(1, '2026-03-10', 2, 3, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());    -- 下午休息

-- 场景3：周三全天休息
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2026-03-11', 1, 3, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),  -- 上午休息
(1, '2026-03-11', 2, 3, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());  -- 下午休息

-- 场景4：周四上午停诊，下午出诊
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2026-03-12', 1, 2, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),   -- 上午停诊
(1, '2026-03-12', 2, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()); -- 下午出诊

-- 场景5：周五只有上午出诊
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2026-03-13', 1, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());  -- 上午出诊
```

## 测试步骤

### 测试 1：周一全天出诊

1. 登录管理后台
2. 进入诊单管理
3. 点击某条诊单的"挂号"按钮
4. 选择医生（ID=1）
5. 选择日期：2026-03-09（周一）

**预期结果：**
- ✅ 显示上午时段：09:00, 09:15, 09:30, ..., 11:45（共12个）
- ✅ 显示下午时段：14:00, 14:15, 14:30, ..., 17:45（共16个）
- ✅ 总共28个时段

### 测试 2：周二上午出诊，下午休息

1. 选择日期：2026-03-10（周二）

**预期结果：**
- ✅ 显示上午时段：09:00-11:45（共12个）
- ❌ 不显示下午时段
- ✅ 总共12个时段

### 测试 3：周三全天休息

1. 查看可选日期列表

**预期结果：**
- ❌ 2026-03-11（周三）不出现在可选日期列表中
- 💡 如果强制选择该日期，不显示任何时段

### 测试 4：周四上午停诊，下午出诊

1. 选择日期：2026-03-12（周四）

**预期结果：**
- ❌ 不显示上午时段
- ✅ 显示下午时段：14:00-17:45（共16个）
- ✅ 总共16个时段

### 测试 5：周五只有上午出诊

1. 选择日期：2026-03-13（周五）

**预期结果：**
- ✅ 显示上午时段：09:00-11:45（共12个）
- ❌ 不显示下午时段
- ✅ 总共12个时段

## 浏览器控制台测试

打开浏览器开发者工具（F12），在 Network 标签中查看接口请求：

### 1. 查看排班列表请求

```
GET /adminapi/doctor.roster/lists?doctor_id=1&start_date=2026-03-09&end_date=2026-03-15&status=1
```

**预期响应：**
```json
{
  "code": 1,
  "data": {
    "lists": [
      {
        "id": 1,
        "doctor_id": 1,
        "date": "2026-03-09",
        "period": 1,
        "status": 1
      },
      {
        "id": 2,
        "doctor_id": 1,
        "date": "2026-03-09",
        "period": 2,
        "status": 1
      }
      // ... 只返回 status=1 的排班
    ]
  }
}
```

### 2. 查看可用时段请求

```
GET /adminapi/doctor.appointment/availableSlots?doctor_id=1&appointment_date=2026-03-09&period=all
```

**预期响应（全天出诊）：**
```json
{
  "code": 1,
  "data": {
    "slots": [
      {"time": "09:00", "available": true, "quota": 1, "period": 1},
      {"time": "09:15", "available": true, "quota": 1, "period": 1},
      // ... 上午时段
      {"time": "14:00", "available": true, "quota": 1, "period": 2},
      {"time": "14:15", "available": true, "quota": 1, "period": 2}
      // ... 下午时段
    ]
  }
}
```

**预期响应（只有上午出诊）：**
```json
{
  "code": 1,
  "data": {
    "slots": [
      {"time": "09:00", "available": true, "quota": 1, "period": 1},
      {"time": "09:15", "available": true, "quota": 1, "period": 1}
      // ... 只有上午时段
    ]
  }
}
```

**预期响应（全天休息）：**
```json
{
  "code": 1,
  "data": {
    "slots": []  // 空数组
  }
}
```

## 功能测试

### 测试已预约时段

1. 先创建一个预约：
```sql
INSERT INTO zyt_doctor_appointment (
    doctor_id, 
    patient_id, 
    appointment_date, 
    appointment_time, 
    status,
    create_time,
    update_time
) VALUES (
    1,
    1,
    '2026-03-09',
    '09:00:00',
    1,
    UNIX_TIMESTAMP(),
    UNIX_TIMESTAMP()
);
```

2. 刷新预约页面，选择 2026-03-09

**预期结果：**
- ✅ 09:00 时段显示"已约"
- ✅ 09:00 时段不可点击
- ✅ 其他时段正常显示"可约"

### 测试预约创建

1. 选择一个可用时段（如 09:15）
2. 填写患者信息
3. 点击"确定预约"

**预期结果：**
- ✅ 预约创建成功
- ✅ 该时段变为"已约"
- ✅ 数据库中有对应记录

## 边界测试

### 测试 1：没有排班的医生

```sql
-- 删除医生的所有排班
DELETE FROM zyt_doctor_roster WHERE doctor_id = 1;
```

**预期结果：**
- ❌ 没有可选日期
- 💡 提示：该医生暂无排班

### 测试 2：排班已满

```sql
-- 设置排班的 booked_count = max_patients
UPDATE zyt_doctor_roster 
SET booked_count = max_patients 
WHERE doctor_id = 1 AND date = '2026-03-09';
```

**预期结果：**
- ⚠️ 这个测试取决于是否实现了号源限制
- 如果实现了，应该显示"已满"

### 测试 3：过期日期

```sql
-- 添加过去的排班
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
VALUES 
(1, '2024-01-01', 1, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());
```

**预期结果：**
- ❌ 过去的日期不出现在可选列表中
- ✅ 只显示未来7天的排班

## 检查清单

### 后端检查

- [ ] 接口正确查询 `status = 1` 的排班
- [ ] 根据 `period` 生成对应时段
- [ ] 上午时段：09:00-11:45
- [ ] 下午时段：14:00-17:45
- [ ] 已预约时段正确标记
- [ ] 返回数据格式正确

### 前端检查

- [ ] 只显示有出诊排班的日期
- [ ] 时段按时间排序
- [ ] 可约时段显示"可约"标签
- [ ] 已约时段显示"已约"标签
- [ ] 已约时段不可点击
- [ ] 选中时段有高亮效果

### 数据库检查

- [ ] 排班数据正确
- [ ] 预约数据正确
- [ ] 状态值正确（1=出诊）
- [ ] 时段值正确（1=上午，2=下午）

## 常见问题

### 问题 1：显示了休息时段

**原因：**
- 后端没有过滤 `status = 1`
- 前端没有传递 `status` 参数

**解决：**
```php
// 后端确保查询条件
$rosters = Roster::where([
    'doctor_id' => $doctorId,
    'date' => $date,
    'status' => 1  // 必须有这个条件
])->select()->toArray();
```

### 问题 2：显示了全天时段（9:00-18:00）

**原因：**
- 没有根据排班的 `period` 生成时段
- 直接生成了全天时段

**解决：**
- 检查代码是否使用了修复后的逻辑
- 确保根据 `period` 值生成对应时段

### 问题 3：没有显示任何时段

**原因：**
- 医生没有出诊排班
- 数据库中 `status` 不是 1

**解决：**
```sql
-- 检查排班数据
SELECT * FROM zyt_doctor_roster 
WHERE doctor_id = 1 
  AND date = '2026-03-09';

-- 确保 status = 1
UPDATE zyt_doctor_roster 
SET status = 1 
WHERE doctor_id = 1 
  AND date = '2026-03-09';
```

## 性能测试

### 测试大量排班

```sql
-- 添加未来30天的排班
DELIMITER $$
CREATE PROCEDURE add_test_rosters()
BEGIN
    DECLARE i INT DEFAULT 0;
    DECLARE test_date DATE;
    WHILE i < 30 DO
        SET test_date = DATE_ADD(CURDATE(), INTERVAL i DAY);
        INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients, create_time, update_time) 
        VALUES 
        (1, test_date, 1, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
        (1, test_date, 2, 1, 20, 20, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());
        SET i = i + 1;
    END WHILE;
END$$
DELIMITER ;

CALL add_test_rosters();
DROP PROCEDURE add_test_rosters;
```

**预期结果：**
- ✅ 接口响应时间 < 500ms
- ✅ 前端渲染流畅
- ✅ 没有性能问题

## 成功标准

- ✅ 只显示出诊状态的排班
- ✅ 休息/停诊/请假的排班不显示
- ✅ 上午/下午时段正确区分
- ✅ 已预约时段正确标记
- ✅ 用户体验流畅
- ✅ 没有控制台错误

---

**测试日期：** 2024-03-04
**版本：** 1.0