新增功能
This commit is contained in:
Your Name
@@ -0,0 +1,395 @@
|
||||
# 批量排班接口测试
|
||||
|
||||
## 接口信息
|
||||
|
||||
**URL**: `POST /adminapi/doctor.roster/batchSave`
|
||||
|
||||
**Content-Type**: `application/json`
|
||||
|
||||
## 测试用例
|
||||
|
||||
### 测试1：批量创建工作日排班
|
||||
|
||||
为2位医生创建一周工作日的排班（周一至周五，上午和下午）。
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-02",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30,
|
||||
"remark": "工作日排班"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-02",
|
||||
"period": "afternoon",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30,
|
||||
"remark": "工作日排班"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-03",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30,
|
||||
"remark": "工作日排班"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-03",
|
||||
"period": "afternoon",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30,
|
||||
"remark": "工作日排班"
|
||||
},
|
||||
{
|
||||
"doctor_id": 2,
|
||||
"date": "2026-03-02",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 15,
|
||||
"max_patients": 25,
|
||||
"remark": "工作日排班"
|
||||
},
|
||||
{
|
||||
"doctor_id": 2,
|
||||
"date": "2026-03-02",
|
||||
"period": "afternoon",
|
||||
"status": 1,
|
||||
"quota": 15,
|
||||
"max_patients": 25,
|
||||
"remark": "工作日排班"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**预期结果**:
|
||||
```json
|
||||
{
|
||||
"code": 1,
|
||||
"msg": "批量保存成功",
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
|
||||
### 测试2：批量设置周末休息
|
||||
|
||||
为所有医生设置周末休息。
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-07",
|
||||
"period": "morning",
|
||||
"status": 3,
|
||||
"quota": 0,
|
||||
"max_patients": 0,
|
||||
"remark": "周末休息"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-07",
|
||||
"period": "afternoon",
|
||||
"status": 3,
|
||||
"quota": 0,
|
||||
"max_patients": 0,
|
||||
"remark": "周末休息"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-08",
|
||||
"period": "morning",
|
||||
"status": 3,
|
||||
"quota": 0,
|
||||
"max_patients": 0,
|
||||
"remark": "周末休息"
|
||||
},
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-08",
|
||||
"period": "afternoon",
|
||||
"status": 3,
|
||||
"quota": 0,
|
||||
"max_patients": 0,
|
||||
"remark": "周末休息"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### 测试3：更新已存在的排班
|
||||
|
||||
如果某个排班已存在，应该更新而不是创建新记录。
|
||||
|
||||
**第一次请求**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-04",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**第二次请求（更新）**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-04",
|
||||
"period": "morning",
|
||||
"status": 2,
|
||||
"quota": 0,
|
||||
"max_patients": 0,
|
||||
"remark": "临时停诊"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**预期结果**: 第二次请求应该更新第一次创建的记录，而不是创建新记录。
|
||||
|
||||
### 测试4：空数组
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"rosters": []
|
||||
}
|
||||
```
|
||||
|
||||
**预期结果**: 应该返回成功，但不创建任何记录。
|
||||
|
||||
### 测试5：数据验证
|
||||
|
||||
**请求体（缺少必填字段）**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-04"
|
||||
// 缺少 period 和 status
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**预期结果**: 应该返回验证错误。
|
||||
|
||||
## 使用 cURL 测试
|
||||
|
||||
### 基本测试
|
||||
|
||||
```bash
|
||||
curl -X POST http://your-domain/adminapi/doctor.roster/batchSave \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "token: your-token-here" \
|
||||
-d '{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-04",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30
|
||||
}
|
||||
]
|
||||
}'
|
||||
```
|
||||
|
||||
### 批量测试（10条记录）
|
||||
|
||||
```bash
|
||||
curl -X POST http://your-domain/adminapi/doctor.roster/batchSave \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "token: your-token-here" \
|
||||
-d @batch_roster_data.json
|
||||
```
|
||||
|
||||
**batch_roster_data.json**:
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{"doctor_id": 1, "date": "2026-03-04", "period": "morning", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-04", "period": "afternoon", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-05", "period": "morning", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-05", "period": "afternoon", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-06", "period": "morning", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-06", "period": "afternoon", "status": 1, "quota": 20, "max_patients": 30},
|
||||
{"doctor_id": 1, "date": "2026-03-07", "period": "morning", "status": 3, "quota": 0, "max_patients": 0},
|
||||
{"doctor_id": 1, "date": "2026-03-07", "period": "afternoon", "status": 3, "quota": 0, "max_patients": 0},
|
||||
{"doctor_id": 1, "date": "2026-03-08", "period": "morning", "status": 3, "quota": 0, "max_patients": 0},
|
||||
{"doctor_id": 1, "date": "2026-03-08", "period": "afternoon", "status": 3, "quota": 0, "max_patients": 0}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 验证结果
|
||||
|
||||
### 1. 检查数据库
|
||||
|
||||
```sql
|
||||
-- 查看批量创建的排班
|
||||
SELECT * FROM la_doctor_roster
|
||||
WHERE doctor_id = 1
|
||||
AND date BETWEEN '2026-03-04' AND '2026-03-08'
|
||||
ORDER BY date, period;
|
||||
```
|
||||
|
||||
### 2. 检查唯一索引
|
||||
|
||||
```sql
|
||||
-- 尝试插入重复记录，应该失败
|
||||
INSERT INTO la_doctor_roster (doctor_id, date, period, status, create_time, update_time)
|
||||
VALUES (1, '2026-03-04', 'morning', 1, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());
|
||||
-- 错误: Duplicate entry '1-2026-03-04-morning' for key 'uk_doctor_date_period'
|
||||
```
|
||||
|
||||
### 3. 检查更新逻辑
|
||||
|
||||
```sql
|
||||
-- 第一次插入
|
||||
-- 第二次用相同的 doctor_id, date, period 但不同的 status
|
||||
-- 应该更新而不是插入新记录
|
||||
SELECT COUNT(*) FROM la_doctor_roster
|
||||
WHERE doctor_id = 1 AND date = '2026-03-04' AND period = 'morning';
|
||||
-- 应该返回 1，不是 2
|
||||
```
|
||||
|
||||
## 性能测试
|
||||
|
||||
### 测试100条记录
|
||||
|
||||
```bash
|
||||
# 生成100条记录的JSON
|
||||
php generate_test_data.php 100 > test_100.json
|
||||
|
||||
# 测试
|
||||
time curl -X POST http://your-domain/adminapi/doctor.roster/batchSave \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "token: your-token-here" \
|
||||
-d @test_100.json
|
||||
```
|
||||
|
||||
**预期**: 应该在2秒内完成
|
||||
|
||||
### 测试500条记录
|
||||
|
||||
```bash
|
||||
php generate_test_data.php 500 > test_500.json
|
||||
|
||||
time curl -X POST http://your-domain/adminapi/doctor.roster/batchSave \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "token: your-token-here" \
|
||||
-d @test_500.json
|
||||
```
|
||||
|
||||
**预期**: 应该在10秒内完成
|
||||
|
||||
## 错误处理测试
|
||||
|
||||
### 1. 事务回滚测试
|
||||
|
||||
在批量数据中插入一条错误数据，整个批量操作应该回滚。
|
||||
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026-03-04",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30
|
||||
},
|
||||
{
|
||||
"doctor_id": 999999,
|
||||
"date": "2026-03-04",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**预期**: 如果第二条记录失败，第一条也不应该被保存。
|
||||
|
||||
### 2. 日期格式错误
|
||||
|
||||
```json
|
||||
{
|
||||
"rosters": [
|
||||
{
|
||||
"doctor_id": 1,
|
||||
"date": "2026/03/04",
|
||||
"period": "morning",
|
||||
"status": 1,
|
||||
"quota": 20,
|
||||
"max_patients": 30
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**预期**: 返回日期格式错误
|
||||
|
||||
## 常见问题排查
|
||||
|
||||
### 问题1: 批量保存失败
|
||||
|
||||
**检查**:
|
||||
1. 数据库连接是否正常
|
||||
2. 表是否存在
|
||||
3. 字段类型是否匹配
|
||||
4. 唯一索引是否正确
|
||||
|
||||
### 问题2: 部分记录保存失败
|
||||
|
||||
**检查**:
|
||||
1. 查看错误日志
|
||||
2. 检查是否有数据验证失败
|
||||
3. 检查是否有外键约束
|
||||
|
||||
### 问题3: 性能问题
|
||||
|
||||
**优化**:
|
||||
1. 减少单次批量的记录数
|
||||
2. 添加数据库索引
|
||||
3. 使用批量插入而不是循环插入
|
||||
|
||||
## 总结
|
||||
|
||||
批量排班接口已经完整实现，包括：
|
||||
- ✅ 批量创建排班
|
||||
- ✅ 批量更新排班
|
||||
- ✅ 事务处理
|
||||
- ✅ 数据验证
|
||||
- ✅ 错误处理
|
||||
|
||||
可以正常使用了！
|
||||
Reference in New Issue
Block a user