his/迁移记录-DB变更记录/医生患者多对多关系实现说明.md

医生患者多对多关系实现说明

一、背景分析

1.1 当前系统现状

经过深入分析，当前系统中医生和患者的关系主要通过以下两种间接方式实现：

方式1：通过就诊记录关联（主要方式）

• adm_encounter：就诊表，记录患者的就诊信息
• adm_encounter_participant：就诊参与者表，记录医生参与就诊的信息
• 关系路径：患者 → 就诊记录 → 参与者（医生）

方式2：通过手术记录关联（特定场景）

• cli_surgery：手术表，包含患者ID和多个医生ID
• 支持的医生角色：主刀医生、助手1、助手2、麻醉医生、巡回护士
• 关系路径：患者 → 手术记录 → 多个医生

1.2 存在的问题

1. 缺乏长期医患关系管理

   • 无法管理固定的主治医生、签约医生等长期关系
   • 每次就诊都需要重新关联医生和患者

2. 查询效率低下

   • 需要通过多层关联查询才能获取某医生的所有患者
   • 无法快速查询某患者的所有就诊医生

3. 缺乏关系类型区分

   • 无法区分主治医生、签约医生、管床医生、家庭医生等不同关系类型
   • 无法满足家庭医生、慢病管理等需要长期医患关系的业务场景

4. 无法支持复杂业务需求

   • 家庭医生签约服务
   • 慢病随访管理
   • 患者分组管理
   • 医生工作量统计

二、解决方案

2.1 设计思路

创建独立的医生患者关系表 adm_practitioner_patient，建立医生和患者之间的直接多对多关系，支持：

• 多种关系类型（主治医生、签约医生、管床医生、家庭医生等）
• 关系的时间范围（开始时间、结束时间）
• 关系的状态管理（有效、无效）
• 机构维度管理

2.2 数据库设计

表结构：adm_practitioner_patient

字段名	类型	说明
id	int8	主键ID
practitioner_id	int8	医生ID，关联adm_practitioner表
patient_id	int8	患者ID，关联adm_patient表
relationship_type	int4	关系类型：1-主治医生，2-签约医生，3-管床医生，4-家庭医生，5-会诊医生，6-随访医生
organization_id	int8	机构ID，关联adm_organization表
start_date	timestamptz	关系开始时间
end_date	timestamptz	关系结束时间
status	int4	状态：1-有效，0-无效
remark	varchar(500)	备注信息
tenant_id	int4	租户ID
delete_flag	bpchar(1)	删除标志
create_by	varchar(32)	创建人
create_time	timestamptz	创建时间
update_by	varchar(32)	更新人
update_time	timestamptz	更新时间

索引设计

• idx_practitioner_patient_practitioner_id：按医生ID查询
• idx_practitioner_patient_patient_id：按患者ID查询
• idx_practitioner_patient_org_id：按机构ID查询
• idx_practitioner_patient_type：按关系类型查询

2.3 业务逻辑

1. 创建医患关系

• 检查是否已存在相同的关系
• 如果存在，先终止旧关系
• 创建新的有效关系
• 记录关系开始时间

2. 终止医患关系

• 设置关系结束时间为当前时间
• 更新状态为无效（status=0）

3. 查询有效关系

• 查询条件：status=1 且 delete_flag='0'
• 支持按医生、患者、机构、关系类型等多维度查询

4. 批量创建关系

• 支持批量创建医患关系
• 适用于科室分组、团队管理等场景

三、功能实现

3.1 后端实现

实体类

• PractitionerPatient.java：医生患者关系实体

数据访问层

• PractitionerPatientMapper.java：Mapper接口
• PractitionerPatientMapper.xml：MyBatis映射文件

业务逻辑层

• IPractitionerPatientService.java：Service接口
• PractitionerPatientServiceImpl.java：Service实现
  • getValidPatientsByPractitioner()：获取医生的所有有效患者
  • getValidPractitionersByPatient()：获取患者的所有有效医生
  • getRelationship()：获取特定关系
  • createRelationship()：创建医患关系
  • terminateRelationship()：终止医患关系
  • batchCreateRelationships()：批量创建医患关系

控制层

• PractitionerPatientController.java：控制器
  • /list：查询医患关系列表
  • /{id}：获取医患关系详情
  • /practitioner/{practitionerId}/patients：获取医生的所有患者
  • /patient/{patientId}/practitioners：获取患者的所有医生
  • /：新增医患关系
  • /：修改医患关系
  • /terminate/{id}：终止医患关系
  • /{ids}：删除医患关系
  • /batch：批量创建医患关系

数据传输对象

• PractitionerPatientDto.java：医患关系DTO

3.2 前端实现

API接口

• practitionerPatient.js：前端API封装
  • listPractitionerPatient()：查询医患关系列表
  • getPractitionerPatient()：查询医患关系详情
  • getPatientsByPractitioner()：获取医生的所有患者
  • getPractitionersByPatient()：获取患者的所有医生
  • addPractitionerPatient()：新增医患关系
  • updatePractitionerPatient()：修改医患关系
  • terminatePractitionerPatient()：终止医患关系
  • delPractitionerPatient()：删除医患关系
  • batchAddPractitionerPatient()：批量创建医患关系

四、使用场景

4.1 家庭医生签约

// 为患者签约家庭医生
const relationship = {
  practitionerId: 123,  // 医生ID
  patientId: 456,        // 患者ID
  relationshipType: 4,   // 家庭医生
  organizationId: 789,   // 机构ID
  remark: '年度家庭医生签约'
}
await addPractitionerPatient(relationship)

4.2 慢病随访管理

// 获取需要随访的患者列表
const patients = await getPatientsByPractitioner(123)
const followUpPatients = patients.filter(p =>
  p.relationshipType === 6 &&  // 随访医生
  new Date(p.startDate) < new Date() &&
  !p.endDate
)

4.3 住院患者管床

// 为住院患者分配管床医生
const relationship = {
  practitionerId: 123,  // 医生ID
  patientId: 456,        // 患者ID
  relationshipType: 3,   // 管床医生
  organizationId: 789,   // 机构ID
  remark: '住院期间管床'
}
await addPractitionerPatient(relationship)

4.4 科室医生团队管理

// 批量创建医患关系（科室分组）
const relationships = [
  { practitionerId: 123, patientId: 456, relationshipType: 1, organizationId: 789 },
  { practitionerId: 123, patientId: 457, relationshipType: 1, organizationId: 789 },
  { practitionerId: 124, patientId: 458, relationshipType: 1, organizationId: 789 }
]
await batchAddPractitionerPatient(relationships)

4.5 医生工作量统计

// 统计医生管理的患者数量
const patients = await getPatientsByPractitioner(doctorId)
const patientCount = patients.length
console.log(`该医生管理了 ${patientCount} 位患者`)

// 按关系类型统计
const主治医生Count = patients.filter(p => p.relationshipType === 1).length
const签约医生Count = patients.filter(p => p.relationshipType === 2).length
const管床医生Count = patients.filter(p => p.relationshipType === 3).length

五、关系类型说明

关系类型	类型值	说明	使用场景
主治医生	1	患者的主要治疗医生	门诊、住院患者的常规管理
签约医生	2	与患者签订服务协议的医生	家庭医生签约、慢病管理
管床医生	3	负责管理住院患者的医生	住院患者管理
家庭医生	4	负责家庭医疗服务的医生	家庭医生签约服务
会诊医生	5	参与会诊的医生	多学科会诊
随访医生	6	负责患者随访的医生	慢病随访、术后随访

六、执行步骤

6.1 数据库变更

# 执行SQL脚本创建表
psql -U postgres -d his -f "迁移记录-DB变更记录/202601020000 add_table_adm_practitioner_patient.sql"

6.2 后端部署

1. 将以下文件复制到对应目录：

   • PractitionerPatient.java → openhis-domain/src/main/java/com/openhis/administration/domain/
   • PractitionerPatientMapper.java → openhis-domain/src/main/java/com/openhis/administration/mapper/
   • PractitionerPatientMapper.xml → openhis-domain/src/main/resources/mapper/administration/
   • IPractitionerPatientService.java → openhis-domain/src/main/java/com/openhis/administration/service/
   • PractitionerPatientServiceImpl.java → openhis-domain/src/main/java/com/openhis/administration/service/impl/
   • PractitionerPatientDto.java → openhis-domain/src/main/java/com/openhis/administration/dto/
   • PractitionerPatientController.java → openhis-application/src/main/java/com/openhis/web/administration/controller/

2. 重新编译并启动后端服务

6.3 前端部署

1. 将以下文件复制到对应目录：

   • practitionerPatient.js → openhis-ui-vue3/src/api/administration/

2. 重新编译并启动前端服务

七、注意事项

1. 数据一致性

   • 创建关系前先检查是否已存在相同的关系
   • 如果存在，先终止旧关系再创建新关系

2. 时间管理

   • 关系开始时间默认为当前时间
   • 终止关系时需要设置结束时间

3. 权限控制

   • 创建医患关系需要相应权限
   • 终止医患关系需要相应权限

4. 业务规则

   • 同一医生对同一患者可以存在多种关系类型
   • 关系状态为无效时不能用于业务查询
   • 删除操作使用逻辑删除（delete_flag）

5. 性能优化

   • 已创建合适的索引
   • 查询时使用条件过滤（status=1, delete_flag='0'）

八、后续扩展

1. 医患关系历史记录

   • 记录医患关系变更历史
   • 支持回溯查看历史关系

2. 医患关系评价

   • 患者对医生的评价
   • 医生对患者的评价

3. 医患关系可视化

   • 医患关系图谱
   • 医生患者网络分析

4. 医患关系提醒

   • 关系到期提醒
   • 随访提醒
   • 复诊提醒

5. 数据统计

   • 医生工作量统计
   • 患者分布统计
   • 关系类型统计