医生表单字段说明文档

文档信息

文档名称：医生管理-新增医生表单字段说明
数据库表名：fa_doctors
对应功能：医生管理 - 医生信息 - 新增医生
源码路径：/application/admin/controller/doctor/Doctor.php
表单视图：/application/admin/view/doctor/doctor/add.html
生成日期：2025-12-05

字段对照表

序号	表单显示名称	数据库字段名	字段类型	是否必填	取值说明
1	用户名	`username`	文本	是	登录用户名，需符合username规则
2	密码	`password`	密码	是	登录密码，需符合password规则
3	医生姓名	`realname`	文本	是	医生真实姓名
4	医疗机构	`institution_id`	下拉选择	是	所属医疗机构ID
5	科室	`department_id`	下拉选择	科室级必填	所属科室ID（医生等级为科室级时必填）
6	医生等级	`doctor_grade`	单选	否	1=管理级（查看所有） 2=科室级（查看医生科室下数据） 3=医生级（查看该医生数据）
7	职称	`doctor_title`	文本	否	医生职称
8	医生角色	`doctor_role`	树形多选	是	从doctor_menu表选择，逗号分隔存储ID
9	报告权限	`is_report`	单选	是	1=启用, 0=禁用
10	状态	`status`	单选	是	1=正常, 0=禁用
11	医生分类	`doctor_class`	多选下拉	是	1=临床医生 2=报告医生 3=审核医生 4=确认医生 5=登记医生 6=远程申请医生 7=远程报告医生 8=远程审核医生 9=报告修改医生 10=影像检查删除医生（逗号分隔）
12	检查权限	`exam_class`	多选下拉	是	CR, CT, DX, ES, MR, XA, ECG, MG, PT, RF, PETCT, US （逗号分隔，*表示全部）
13	是否为管理员	`is_admin`	单选	否	0=否, 1=是
14	登陆安全验证	`is_send_message`	单选	否	0=否, 1=是
15	短信消息推送	`send_sms`	单选	否	0=否, 1=是
16	检查分配权重	`weight`	数字	否	用于自动分配检查时的权重值
17	联系电话	`phone`	文本	否	医生联系电话
18	特殊机构	`special_institution`	下拉多选	否	医生可访问的特殊机构ID（逗号分隔）

重要字段详细说明

1. 用户名 (username)

字段名：username
数据类型：VARCHAR
验证规则：required;username
说明：用于登录的用户名，必须符合username规则
唯一性：在同一机构内需保证唯一
代码位置：add.html:3-7

2. 密码 (password)

字段名：password
数据类型：VARCHAR
验证规则：required;password
说明：登录密码，需符合密码安全规则
存储方式：加密存储（通常使用MD5或bcrypt）
代码位置：add.html:8-13

3. 医生等级 (doctor_grade)

字段名：doctor_grade
数据类型：INT
取值：
- 1：管理级（查看所有数据）
- 2：科室级（查看医生科室下数据，必须选择科室）
- 3：医生级（查看该医生数据）
业务规则：当选择"科室级"时，department_id字段变为必填
代码位置：add.html:32-37, Doctor.php:131-138

4. 医生角色 (doctor_role)

字段名：doctor_role
数据类型：VARCHAR（逗号分隔的ID）
显示方式：树形多选（jstree插件）
数据来源：doctor_menu 表（医生权限菜单表）
存储格式：逗号分隔的菜单ID，如 "1,2,3,5,8"
联动功能：支持bind_ids联动选择
API接口：/admin/doctor/doctor/doctorRoleTree
说明：
- 树形结构展示所有可选权限
- 支持全选和展开全部
- 父节点选中时子节点自动选中
- 某些权限有bind_ids（绑定权限），选中时会联动选中绑定的权限
代码位置：add.html:44-52, Doctor.php:314-358

5. 报告权限 (is_report)

字段名：is_report
数据类型：INT
取值：
- 1：启用（有报告权限）
- 0：禁用（无报告权限）
说明：控制医生是否有出具报告的权限
代码位置：add.html:54-58

6. 医生分类 (doctor_class)

字段名：doctor_class
数据类型：VARCHAR（逗号分隔）
显示方式：多选下拉（selectpicker）
可选值：
- 1：临床医生
- 2：报告医生
- 3：审核医生
- 4：确认医生
- 5：登记医生
- 6：远程申请医生
- 7：远程报告医生
- 8：远程审核医生
- 9：报告修改医生
- 10：影像检查删除医生
存储方式：逗号分隔存储，如 "2,3,7"
关联表：doctor_department_class 表存储医生-科室-分类的关联关系
说明：医生可以同时拥有多个分类，不同分类对应不同的业务权限
代码位置：add.html:66-70, Doctor.php:46

7. 检查权限 (exam_class)

字段名：exam_class
数据类型：VARCHAR（逗号分隔）
显示方式：多选下拉（selectpicker）
可选值：
- CR：CR（计算机X射线摄影）
- CT：CT（计算机断层扫描）
- DX：DX（数字X射线摄影）
- ES：ES（内窥镜）
- MR：MR（磁共振）
- XA：XA（血管造影）
- ECG：ECG（心电图）
- MG：MG（乳腺摄影）
- PT：PT（正电子发射断层扫描）
- RF：RF（射频透视）
- PETCT：PETCT（正电子发射计算机断层扫描）
- US：US（超声）
存储方式：
- 逗号分隔存储，如 "CT,MR,US"
- * 表示拥有所有检查类型的权限
默认值：全选（所有检查类型）
说明：控制医生可以查看和处理的检查类型
代码位置：add.html:72-76, Doctor.php:45

8. 检查分配权重 (weight)

字段名：weight
数据类型：INT
说明：用于检查自动分配功能，权重越高，分配到的检查越多
应用场景：当机构开启"检查自动分配"功能时使用
代码位置：add.html:102-106

9. 特殊机构 (special_institution)

字段名：special_institution（表单输入字段）
关联表：special_contact（实际存储表）
存储方式：
- 表单提交：逗号分隔的机构ID
- 数据库存储：在 special_contact 表中建立多条关联记录
- 字段：did(医生ID), sid(特殊机构ID), status(状态)
说明：
- 医生可访问的特殊机构列表
- 除了所属机构外，医生还可以访问这些特殊机构的数据
代码位置：add.html:114-118, Doctor.php:255-258

数据处理流程

新增医生时的数据处理

参数接收
```
$params = $this->request->post("row/a");
```
1. 业务验证
2. 检查医生等级：如果是科室级（doctor_grade=2），必须选择科室
3. 代码位置：Doctor.php:131-138
4. 调用Service层处理
```
$res = $this->service->addDoctor($params);
```
Service层处理（DoctorService::addDoctor）
- 格式化参数（formatSaveParams）
- 检查用户名唯一性
- 加密密码
- 插入医生主表（doctors）
- 插入医生分类关联表（doctor_department_class）
- 插入特殊机构关联表（special_contact）
- 返回处理结果
事务处理
- 所有操作在事务中执行
- 任何步骤失败都会回滚
- 代码位置：Doctor.php:130-145

编辑医生时的数据处理

额外处理
- 更新医生分类：updateDoctorClass()
- 更新特殊机构：updateSpecialInstitution()
- 代码位置：Doctor.php:218-227
exam_class 特殊处理
- 读取时：* 转换为所有检查类型的列表
- 保存时：全选转换为 *
- 代码位置：Doctor.php:253

关联数据表

主表

fa_doctors：医生主表

关联表

表名	关联字段	说明
`fa_institution`	`institution_id`	医疗机构表
`fa_department`	`department_id`	科室表
`doctor_menu`	`doctor_role`	医生权限菜单表（树形结构）
`doctor_department_class`	`doctor_id`, `department_id`, `doctor_class`	医生-科室-分类关联表
`special_contact`	`did`(医生ID), `sid`(机构ID)	医生-特殊机构关联表
`device`	`device_ids`	设备表（已注释，暂不使用）

业务规则

1. 用户名唯一性

在同一机构内，用户名必须唯一
新增时检查用户名是否已存在

2. 医生等级与科室的关联

管理级（1）：可查看所有数据，科室可选
科室级（2）：只能查看所属科室数据，必须选择科室
医生级（3）：只能查看自己的数据，科室可选
验证代码：Doctor.php:131-138, 205-211

3. 医生分类的存储

表单提交：数组形式 ['2','3','7']
数据库存储：
- doctors 表不直接存储
- doctor_department_class 表存储每个分类的关联记录
- 每个分类一条记录：(doctor_id, department_id, doctor_class)

4. 检查权限的特殊标记

全选所有检查类型时，存储为 *
读取时 * 展开为所有类型
节省存储空间

5. 密码处理

新增时：必填，加密后存储
编辑时：不填表示不修改密码
加密方式：通常使用MD5或bcrypt

6. 状态字段特殊处理

数据库中 NULL 表示禁用（0）
页面显示时转换：is_null($status) ? '0' : $status
代码位置：Doctor.php:214, 252

7. 医生角色的联动选择

某些权限有 bind_ids 字段
选中某权限时，自动选中其绑定的权限
树形结构支持父子联动

API接口说明

1. 医生角色树形列表

接口：/admin/doctor/doctor/doctorRoleTree
方法：GET/POST
参数：
- id：医生ID（编辑时传入，用于回显已选权限）
返回：jstree格式的树形数据
```
[
{
  "id": "1",
  "parent": "#",
  "text": "权限名称",
  "type": "menu",
  "state": {"selected": false},
  "bind": ["2", "3"]
}
]
```
- 代码位置：Doctor.php:314-358
2. 批量导入医生
- 接口：/admin/doctor/doctor/import
- 方法：POST
- 参数：
- file：Excel文件路径
- 说明：批量导入医生账号信息
- 代码位置：Doctor.php:366-404
配置项说明

1. 检查类型配置
- 定义位置：Doctor.php:45
- 配置项： php protected $exam_class = [ 'CR' => 'CR', 'CT' => 'CT', 'DX' => 'DX', 'ES' => 'ES', 'MR' => 'MR', 'XA' => 'XA', 'ECG' => 'ECG', 'MG' => 'MG', 'PT' => 'PT', 'RF' => 'RF', 'PETCT' => 'PETCT', 'US' => 'US' ];

2. 医生分类配置

定义位置：Doctor.php:46

配置项：

protected $doctor_class = [
1 => '临床医生', 2 => '报告医生',
3 => '审核医生', 4 => '确认医生',
5 => '登记医生', 6 => '远程申请医生',
7 => '远程报告医生', 8 => '远程审核医生',
9 => '报告修改医生', 10 => '影像检查删除医生'
];

3. 医生角色配置（已废弃，改用doctor_role字段）

定义位置：Doctor.php:47
配置项： php protected $doctor_role = [ 1 => '技师', 2 => '本地医生', 3 => '远程医生' ];

说明：此配置项保留，但实际使用的是从 doctor_menu 表动态读取的权限树

数据验证规则

表单验证

用户名：required;username
密码：required;password
真实姓名：required
医疗机构：required
医生角色：required
报告权限：required
状态：required
医生分类：required（多选至少选一个）
检查权限：required（多选至少选一个）

业务验证

医生等级为科室级时，科室必填
用户名在同机构内唯一
医生分类至少选择一个

注意事项

必填字段：username, password, realname, institution_id, doctor_role, is_report, status, doctor_class, exam_class 必须填写
条件必填：当 doctor_grade = 2（科室级）时，department_id 必须填写
字段格式：
- 逗号分隔字段：去除空值，trim处理
- 密码字段：加密存储，不可逆
特殊处理：
- exam_class = * 表示所有检查类型
- status = NULL 等同于 0（禁用）
- doctor_class 存储在关联表中，不在主表
权限控制：
- 医生角色（doctor_role）控制功能权限
- 医生等级（doctor_grade）控制数据权限
- 检查权限（exam_class）控制检查类型权限
- 医生分类（doctor_class）控制业务流程权限
事务处理：
- 所有增删改操作都在事务中执行
- 涉及多表操作，确保数据一致性
- 失败时自动回滚
关联数据处理：
- 医生分类：插入/更新 doctor_department_class 表
- 特殊机构：插入/更新 special_contact 表
- 删除医生时需同步删除关联数据
下拉选择数据来源：
- 医疗机构：从当前用户可访问的机构列表中选择
- 科室：根据选择的机构动态加载
- 特殊机构：从机构表中选择
- 医生角色：从 doctor_menu 表读取树形权限

更新记录

日期	版本	说明	修改人
2025-12-05	v1.0	初始版本，整理医生表单所有字段说明	-

医生表单字段说明.md 15 KB パーマリンク 履歴 Raw

医生表单字段说明文档

文档信息

字段对照表

重要字段详细说明

1. 用户名 (username)

2. 密码 (password)

3. 医生等级 (doctor_grade)

4. 医生角色 (doctor_role)

5. 报告权限 (is_report)

6. 医生分类 (doctor_class)

7. 检查权限 (exam_class)

8. 检查分配权重 (weight)

9. 特殊机构 (special_institution)

数据处理流程

新增医生时的数据处理

编辑医生时的数据处理

关联数据表

主表

关联表

业务规则

1. 用户名唯一性

2. 医生等级与科室的关联

3. 医生分类的存储

4. 检查权限的特殊标记

5. 密码处理

6. 状态字段特殊处理

7. 医生角色的联动选择

API接口说明

1. 医生角色树形列表

2. 批量导入医生

配置项说明

1. 检查类型配置

2. 医生分类配置

3. 医生角色配置（已废弃，改用doctor_role字段）

数据验证规则

表单验证

业务验证

注意事项

相关Service方法

DoctorService 主要方法

更新记录

相关文档

医生表单字段说明.md 15 KB

パーマリンク履歴 Raw