zyt/admin/DOCTOR_ROSTER.md

# 医生排班管理功能说明

## 数据来源

### 医生数据

医生数据来自系统管理员表 `zyt_admin`，筛选条件：
- `role_id = 1`（医生角色）
- 使用管理员的 `id` 作为医生ID
- 使用管理员的 `name` 或 `account` 作为医生姓名

### 排班数据

排班数据存储在 `la_doctor_roster` 表中，通过 `doctor_id` 关联到 `zyt_admin` 表。

## 功能特性

### 1. 时间维度

- 周期：周一至周日，7天
- 时段：上午、下午（可扩展为全天）
- 支持按周查询和切换

### 2. 排班状态

- 出诊：医生正常出诊，可预约
- 停诊：临时停诊，不可预约
- 休息：正常休息日
- 请假：医生请假

### 3. 排班规则

- 同一医生同一天可排上午、下午其中一个或两个
- 同一时段可排多名医生
- 支持设置可预约号源数/最大接诊数

### 4. 核心功能

- 排班配置：新增、编辑、删除排班
- 排班展示：周视图展示，直观清晰
- 排班查询：按医院、科室、医生筛选
- 排班修改：快速修改排班状态和号源数
- 批量排班：支持多医生、多日期、多时段批量设置排班

## 页面结构

### 查询区域

- 医院选择
- 科室选择
- 医生选择
- 周选择器
- 查询/重置按钮

### 排班表格

- 横向：周一至周日
- 纵向：医生列表
- 单元格：上午/下午两个时段
- 颜色标识：
  - 绿色：出诊
  - 红色：停诊
  - 蓝色：休息
  - 橙色：请假
  - 灰色：未排班

### 操作功能

- 上一周/下一周：切换周
- 本周：快速回到当前周
- 点击单元格：编辑排班

## 数据结构

### 排班记录

```typescript
interface Roster {
    id: number              // 排班ID
    doctor_id: number       // 医生ID（对应 zyt_admin 表的 id）
    date: string           // 日期 YYYY-MM-DD
    period: string         // 时段 morning/afternoon
    status: number         // 状态 1-出诊 2-停诊 3-休息 4-请假
    quota: number          // 号源数
    max_patients: number   // 最大接诊数
    remark: string         // 备注
    create_time: string    // 创建时间
    update_time: string    // 更新时间
}
```

### 医生信息

医生信息来自 `zyt_admin` 表：

```typescript
interface Doctor {
    id: number             // 管理员ID（作为医生ID使用）
    name: string           // 姓名
    account: string        // 账号
    role_id: number        // 角色ID（1=医生）
    // ... 其他管理员字段
}
```

## API 接口

### 1. 获取医生列表

**接口**: `GET /perms.admin/lists`

**请求参数**:
```json
{
  "role_id": 1,
  "page_no": 1,
  "page_size": 1000
}
```

**返回数据**:
```json
{
  "code": 1,
  "msg": "success",
  "data": {
    "lists": [
      {
        "id": 1,
        "name": "张医生",
        "account": "doctor1",
        "role_id": 1
      }
    ]
  }
}
```

### 2. 获取排班列表

**接口**: `GET /doctor.roster/lists`

**请求参数**:
```json
{
  "hospital_id": 1,
  "department_id": 2,
  "doctor_id": 3,
  "start_date": "2024-03-04",
  "end_date": "2024-03-10"
}
```

**返回数据**:
```json
{
  "code": 1,
  "msg": "success",
  "data": {
    "lists": [
      {
        "doctor_id": 1,
        "doctor_name": "张医生",
        "department_id": 2,
        "department_name": "内科",
        "rosters": [
          {
            "id": 1,
            "date": "2024-03-04",
            "period": "morning",
            "status": 1,
            "quota": 20,
            "max_patients": 30,
            "remark": ""
          }
        ]
      }
    ]
  }
}
```

### 2. 保存排班

**接口**: `POST /doctor.roster/save`

**请求参数**:
```json
{
  "id": 1,
  "doctor_id": 1,
  "date": "2024-03-04",
  "period": "morning",
  "status": 1,
  "quota": 20,
  "max_patients": 30,
  "remark": ""
}
```

### 3. 删除排班

**接口**: `POST /doctor.roster/delete`

**请求参数**:
```json
{
  "id": 1
}
```

### 4. 批量保存排班

**接口**: `POST /doctor.roster/batchSave`

**请求参数**:
```json
{
  "rosters": [
    {
      "doctor_id": 1,
      "date": "2024-03-04",
      "period": "morning",
      "status": 1,
      "quota": 20,
      "max_patients": 30
    }
  ]
}
```

### 5. 复制排班

**接口**: `POST /doctor.roster/copy`

**请求参数**:
```json
{
  "source_start_date": "2024-03-04",
  "source_end_date": "2024-03-10",
  "target_start_date": "2024-03-11",
  "doctor_id": 1
}
```

## 数据库设计

### 排班表 (la_doctor_roster)

```sql
CREATE TABLE `la_doctor_roster` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `doctor_id` int(11) NOT NULL COMMENT '医生ID',
  `hospital_id` int(11) DEFAULT NULL COMMENT '医院ID',
  `department_id` int(11) DEFAULT NULL COMMENT '科室ID',
  `date` date NOT NULL COMMENT '日期',
  `period` varchar(20) NOT NULL COMMENT '时段 morning-上午 afternoon-下午',
  `status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态 1-出诊 2-停诊 3-休息 4-请假',
  `quota` int(11) DEFAULT '0' COMMENT '号源数',
  `max_patients` int(11) DEFAULT '0' COMMENT '最大接诊数',
  `booked_count` int(11) DEFAULT '0' COMMENT '已预约数',
  `remark` varchar(500) DEFAULT '' COMMENT '备注',
  `create_time` int(11) NOT NULL COMMENT '创建时间',
  `update_time` int(11) NOT NULL COMMENT '更新时间',
  `delete_time` int(11) DEFAULT NULL COMMENT '删除时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_doctor_date_period` (`doctor_id`,`date`,`period`,`delete_time`),
  KEY `idx_date` (`date`),
  KEY `idx_doctor` (`doctor_id`),
  KEY `idx_hospital` (`hospital_id`),
  KEY `idx_department` (`department_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='医生排班表';
```

## 使用流程

### 1. 查看排班

1. 选择医院、科室、医生（可选）
2. 选择要查看的周
3. 点击"查询"按钮
4. 查看排班表格

### 2. 新增排班

1. 点击表格中的空白单元格
2. 在弹窗中设置排班信息：
   - 排班状态
   - 号源数（出诊时）
   - 最大接诊数（出诊时）
   - 备注
3. 点击"保存"

### 3. 编辑排班

1. 点击表格中已有排班的单元格
2. 修改排班信息
3. 点击"保存"

### 4. 删除排班

1. 点击表格中已有排班的单元格
2. 在弹窗中点击"删除排班"
3. 确认删除

### 5. 周切换

- 点击"上一周"/"下一周"切换周
- 点击"本周"快速回到当前周
- 使用周选择器选择特定周

### 6. 批量排班

1. 点击"批量排班"按钮
2. 选择要排班的医生（可多选）
3. 选择日期范围
4. 选择时段（上午/下午，可多选）
5. 选择星期（周一至周日，可多选）
6. 设置排班状态和号源数
7. 点击"确定"批量创建排班

批量排班会根据选择的条件自动生成所有符合条件的排班记录。例如：
- 选择2位医生
- 日期范围：2024-03-04 至 2024-03-10（7天）
- 时段：上午、下午
- 星期：周一至周五（5天）
- 结果：2 × 5 × 2 = 20条排班记录

## 扩展功能

### 1. 批量操作

- 批量设置某医生一周的排班
- 批量复制排班到其他周
- 批量导入/导出排班

### 2. 统计分析

- 医生出诊统计
- 号源使用率统计
- 预约情况分析

### 3. 提醒功能

- 排班冲突提醒
- 号源不足提醒
- 排班变更通知

### 4. 权限控制

- 科室主任：管理本科室排班
- 医生：查看自己的排班
- 管理员：管理所有排班

## 注意事项

1. 同一医生同一天同一时段只能有一条排班记录
2. 修改排班时需要考虑已有预约
3. 删除排班前需要检查是否有预约
4. 号源数不能小于已预约数
5. 建议提前一周设置排班

## 技术要点

### 1. 周视图实现

使用 dayjs 的 isoWeek 插件实现 ISO 8601 标准的周计算（周一为一周的开始）

```typescript
import dayjs from 'dayjs'
import isoWeek from 'dayjs/plugin/isoWeek'

dayjs.extend(isoWeek)

const weekStart = dayjs().startOf('isoWeek')
```

### 2. 数据结构优化

后端返回数据按医生分组，每个医生包含其所有排班记录，前端根据日期和时段快速查找

### 3. 交互优化

- 点击单元格直接编辑
- 颜色区分不同状态
- 今日高亮显示
- 响应式布局

### 4. 性能优化

- 按周加载数据，减少数据量
- 使用计算属性缓存结果
- 防抖处理频繁操作

## 后续优化

1. 支持全天时段
2. 支持自定义时段（如夜诊）
3. 支持排班模板
4. 支持排班审批流程
5. 移动端适配
6. 打印排班表
7. 排班日历视图
8. 排班冲突检测