# 挂号预约排班状态过滤修复

## 问题描述

在挂号预约时，系统显示了所有时间段（9:00-18:00），但没有检查医生的排班状态。即使医生休息或停诊，系统仍然显示可预约时段。

### 问题截图说明

从截图可以看到：
- 周三 03-04 下午显示"休息"
- 但系统仍然可能显示下午的预约时段

## 排班状态定义

根据数据库模型 `Roster`，排班状态定义如下：

| 状态值 | 状态名称 | 说明 |
|--------|---------|------|
| 1 | 出诊 | 医生正常出诊，可以预约 |
| 2 | 停诊 | 医生停诊，不可预约 |
| 3 | 休息 | 医生休息，不可预约 |
| 4 | 请假 | 医生请假，不可预约 |

## 排班时段定义

| 时段值 | 时段名称 | 时间范围 |
|--------|---------|---------|
| 1 | 上午 | 09:00-12:00 |
| 2 | 下午 | 14:00-18:00 |

## 问题根源

### 原来的逻辑

```php
public static function getAvailableSlots(array $params)
{
    // 1. 直接生成 9:00-18:00 的所有时间段
    for ($hour = 9; $hour < 18; $hour++) {
        for ($minute = 0; $minute < 60; $minute += 15) {
            $slots[] = [
                'time' => sprintf('%02d:%02d', $hour, $minute),
                'available' => true,
                'quota' => 1
            ];
        }
    }
    
    // 2. 只检查已预约的时间段
    // ❌ 没有检查医生的排班状态
}
```

### 问题

1. 不检查医生是否有排班
2. 不检查排班状态（出诊/休息/停诊）
3. 不区分上午/下午时段
4. 即使医生休息也显示可预约

## 解决方案

### 修复后的逻辑

```php
public static function getAvailableSlots(array $params)
{
    // 1. 先检查医生在该日期是否有出诊排班
    $rosters = Roster::where([
        'doctor_id' => $doctorId,
        'date' => $date,
        'status' => 1  // ✅ 只查询出诊状态
    ])->select()->toArray();

    // 如果没有出诊排班，返回空数组
    if (empty($rosters)) {
        return ['slots' => []];
    }

    // 2. 根据排班时段生成时间段
    foreach ($rosters as $roster) {
        if ($roster['period'] == 1) {
            // 上午：9:00-12:00
            $startHour = 9;
            $endHour = 12;
        } elseif ($roster['period'] == 2) {
            // 下午：14:00-18:00
            $startHour = 14;
            $endHour = 18;
        }
        
        // 生成15分钟间隔的时间段
        for ($hour = $startHour; $hour < $endHour; $hour++) {
            for ($minute = 0; $minute < 60; $minute += 15) {
                $slots[] = [
                    'time' => sprintf('%02d:%02d', $hour, $minute),
                    'available' => true,
                    'quota' => 1,
                    'period' => $roster['period']
                ];
            }
        }
    }

    // 3. 查询已预约的时间段并标记
    // ...
}
```

## 修复效果

### 场景 1：医生上午出诊，下午休息

**排班数据：**
```
date: 2026-03-04
period: 1 (上午)
status: 1 (出诊)
```

**预约时段：**
- ✅ 显示：09:00, 09:15, 09:30, ..., 11:45
- ❌ 不显示：14:00-18:00 的时段

### 场景 2：医生全天休息

**排班数据：**
```
date: 2026-03-04
period: 1 (上午)
status: 3 (休息)

date: 2026-03-04
period: 2 (下午)
status: 3 (休息)
```

**预约时段：**
- ❌ 不显示任何时段
- 💡 提示：该医生暂无可预约时段

### 场景 3：医生全天出诊

**排班数据：**
```
date: 2026-03-04
period: 1 (上午)
status: 1 (出诊)

date: 2026-03-04
period: 2 (下午)
status: 1 (出诊)
```

**预约时段：**
- ✅ 显示：09:00-11:45 (上午)
- ✅ 显示：14:00-17:45 (下午)

### 场景 4：医生上午停诊，下午出诊

**排班数据：**
```
date: 2026-03-04
period: 1 (上午)
status: 2 (停诊)

date: 2026-03-04
period: 2 (下午)
status: 1 (出诊)
```

**预约时段：**
- ❌ 不显示：09:00-12:00 的时段
- ✅ 显示：14:00-17:45 (下午)

## 时间段生成规则

### 上午时段（period = 1）

```
开始时间：09:00
结束时间：12:00
间隔：15分钟

生成时段：
09:00, 09:15, 09:30, 09:45,
10:00, 10:15, 10:30, 10:45,
11:00, 11:15, 11:30, 11:45
```

### 下午时段（period = 2）

```
开始时间：14:00
结束时间：18:00
间隔：15分钟

生成时段：
14:00, 14:15, 14:30, 14:45,
15:00, 15:15, 15:30, 15:45,
16:00, 16:15, 16:30, 16:45,
17:00, 17:15, 17:30, 17:45
```

## 前端显示逻辑

前端已经正确处理了排班状态的过滤：

```typescript
// 加载医生排班信息
const loadDoctorRoster = async () => {
  const res = await rosterLists({
    doctor_id: selectedDoctorId.value,
    start_date: startDate,
    end_date: endDate,
    status: 1  // ✅ 只查询出诊状态
  })
  
  // 提取有排班的日期
  if (res?.lists && res.lists.length > 0) {
    doctorRosterDates.value = [...new Set(res.lists.map(item => item.date))].sort()
  }
}
```

## 完整流程

### 1. 选择医生

```
用户选择医生 → 加载医生排班 → 只显示有出诊排班的日期
```

### 2. 选择日期

```
用户选择日期 → 加载该日期的可用时段 → 只显示出诊时段的时间
```

### 3. 选择时段

```
用户选择时段 → 检查是否已被预约 → 创建预约
```

## 数据库查询

### 查询医生出诊排班

```sql
SELECT * FROM zyt_doctor_roster
WHERE doctor_id = 1
  AND date = '2026-03-04'
  AND status = 1  -- 只查询出诊状态
ORDER BY period ASC;
```

### 查询已预约时段

```sql
SELECT appointment_time FROM zyt_doctor_appointment
WHERE doctor_id = 1
  AND appointment_date = '2026-03-04'
  AND status = 1  -- 只查询有效预约
```

## 测试用例

### 测试 1：医生全天出诊

```sql
-- 插入排班
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients) 
VALUES 
(1, '2026-03-10', 1, 1, 20, 20),  -- 上午出诊
(1, '2026-03-10', 2, 1, 20, 20);  -- 下午出诊
```

**预期结果：**
- 显示上午时段：09:00-11:45
- 显示下午时段：14:00-17:45

### 测试 2：医生上午出诊，下午休息

```sql
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients) 
VALUES 
(1, '2026-03-11', 1, 1, 20, 20),  -- 上午出诊
(1, '2026-03-11', 2, 3, 0, 0);    -- 下午休息
```

**预期结果：**
- 显示上午时段：09:00-11:45
- 不显示下午时段

### 测试 3：医生全天休息

```sql
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients) 
VALUES 
(1, '2026-03-12', 1, 3, 0, 0),  -- 上午休息
(1, '2026-03-12', 2, 3, 0, 0);  -- 下午休息
```

**预期结果：**
- 该日期不出现在可选日期列表中
- 如果强制访问，不显示任何时段

### 测试 4：医生上午停诊，下午出诊

```sql
INSERT INTO zyt_doctor_roster (doctor_id, date, period, status, quota, max_patients) 
VALUES 
(1, '2026-03-13', 1, 2, 0, 0),   -- 上午停诊
(1, '2026-03-13', 2, 1, 20, 20); -- 下午出诊
```

**预期结果：**
- 不显示上午时段
- 显示下午时段：14:00-17:45

## 已修改的文件

- ✅ `server/app/adminapi/logic/doctor/AppointmentLogic.php`

## 优势

1. **准确性**：只显示医生实际出诊的时段
2. **用户体验**：避免用户选择无效时段
3. **数据一致性**：预约数据与排班数据保持一致
4. **灵活性**：支持上午/下午独立设置状态
5. **可维护性**：逻辑清晰，易于理解和维护

## 注意事项

1. **排班状态**：只有 `status = 1`（出诊）的排班才会生成时段
2. **时段区分**：上午和下午时段独立判断
3. **时间格式**：统一使用 `HH:MM` 格式（如：09:00）
4. **已预约检查**：在生成时段后，还需要检查已预约情况
5. **空数组处理**：如果没有出诊排班，返回空数组而不是错误

---

**修复日期：** 2024-03-04
**状态：** ✅ 完成
**影响范围：** 挂号预约功能