his/MD/design/EMR_MODULE_INTEGRATION_PLAN.md

EMR管理模块与门诊/住院病历打通 Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use compose:subagent (recommended) or compose:execute to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 打通电子病历管理（归档/修订/时效/检索/完整性检查）与门诊医生工作站、住院医生工作站的数据流，实现自动触发和关联查看。

Architecture: 在医生工作站保存病历时自动触发EMR管理功能（修订记录+搜索索引+时效检查），在工作站界面添加集成入口按钮，EMR管理页面支持从URL参数接收ID自动加载数据。

Tech Stack: Vue 3 + Element Plus + Spring Boot + MyBatis-Plus

---

问题清单

#	问题	影响	修复方式
1	revision-history/api.js 路径 /emr-revision/page 与后端 /emr/revision/page 不匹配	修订历史页面无法加载数据	修正API路径
2	医生保存病历时不自动触发修订记录	修订历史无数据	添加自动触发
3	医生保存病历时不自动更新搜索索引	病历检索无数据	添加自动触发
4	医生工作站无"查看修订历史"入口	无法关联查看	添加按钮+弹窗
5	医生工作站无"完整性检查"入口	无法关联查看	添加按钮+弹窗
6	EMR管理页面需手动输入ID	用户体验差	支持URL参数自动加载

---

文件清单

需修改的文件

文件	修改内容
healthlink-his-ui/src/views/emr/revision-history/api.js	修正API路径
healthlink-his-server/.../emr/controller/EmrRevisionController.java	确认路径一致
healthlink-his-server/.../emr/controller/EmrSearchController.java	确认路径一致
healthlink-his-server/.../doctorstation/appservice/impl/DoctorStationEmrAppServiceImpl.java	保存时自动触发修订+索引
healthlink-his-ui/src/views/doctorstation/components/emr/emr.vue	添加集成入口按钮
healthlink-his-ui/src/views/emr/revision-history/index.vue	支持URL参数
healthlink-his-ui/src/views/emr/archive/index.vue	支持URL参数
healthlink-his-ui/src/views/emr/timeliness/index.vue	支持URL参数
healthlink-his-ui/src/views/emr/completeness-check/index.vue	支持URL参数
healthlink-his-ui/src/views/emrsearch/index.vue	支持URL参数

---

Task 1: 修复修订历史API路径

Covers: 问题#1

Files:

• Modify: healthlink-his-ui/src/views/emr/revision-history/api.js

• Step 1: 读取当前文件确认问题

// 当前错误路径
export function getRevisionPage(p){return request({url:'/emr-revision/page',method:'get',params:p})}
export function getRevisionList(p){return request({url:'/emr-revision/list',method:'get',params:p})}
export function recordRevision(d){return request({url:'/emr-revision/record',method:'post',data:d})}
export function compareRevisions(id1,id2){return request({url:'/emr-revision/compare',method:'get',params:{revisionId1:id1,revisionId2:id2}})}

• Step 2: 修正API路径

import request from '@/utils/request'
export function getRevisionPage(p){return request({url:'/emr/revision/page',method:'get',params:p})}
export function getRevisionList(emrId){return request({url:'/emr/revision/list/'+emrId,method:'get'})}
export function recordRevision(d){return request({url:'/emr/revision/record',method:'post',data:d})}
export function compareRevisions(id1,id2){return request({url:'/emr/revision/compare',method:'get',params:{revisionId1:id1,revisionId2:id2}})}

• Step 3: 验证后端路径一致

确认 EmrRevisionController.java 中：

• @RequestMapping("/emr/revision") ✅

• @GetMapping("/page") → /emr/revision/page ✅

• @GetMapping("/list/{emrId}") → /emr/revision/list/{emrId} ✅

• @PostMapping("/record") → /emr/revision/record ✅

• @GetMapping("/compare") → /emr/revision/compare ✅

• Step 4: Commit

git add healthlink-his-ui/src/views/emr/revision-history/api.js
git commit -m "fix(emr): 修正修订历史API路径与后端对齐"

---

Task 2: EMR管理页面支持URL参数自动加载

Covers: 问题#6

Files:

• Modify: healthlink-his-ui/src/views/emr/revision-history/index.vue

• Modify: healthlink-his-ui/src/views/emr/archive/index.vue

• Modify: healthlink-his-ui/src/views/emr/timeliness/index.vue

• Modify: healthlink-his-ui/src/views/emr/completeness-check/index.vue

• Modify: healthlink-his-ui/src/views/emrsearch/index.vue

• Step 1: 修改 revision-history/index.vue 支持URL参数

在 <script setup> 中添加：

import { ref, onMounted } from 'vue'
import { useRoute } from 'vue-router'
import { getRevisionPage } from './api'

const route = useRoute()
const tableData = ref([])
const total = ref(0)
const q = ref({pageNo:1, pageSize:20, emrId:'', operatorName:''})

const loadData = async () => {
  const r = await getRevisionPage(q.value)
  tableData.value = r.data?.records || []
  total.value = r.data?.total || 0
}

onMounted(() => {
  // 支持URL参数自动加载
  if (route.query.emrId) {
    q.value.emrId = route.query.emrId
  }
  loadData()
})

• Step 2: 修改 archive/index.vue 支持URL参数

import { useRoute } from 'vue-router'
const route = useRoute()

onMounted(() => {
  if (route.query.encounterId) {
    q.value.encounterId = route.query.encounterId
  }
  if (route.query.patientName) {
    q.value.patientName = route.query.patientName
  }
  loadData()
  loadStats()
})

• Step 3: 修改 timeliness/index.vue 支持URL参数

import { useRoute } from 'vue-router'
const route = useRoute()

onMounted(() => {
  if (route.query.encounterId) {
    queryParams.encounterId = route.query.encounterId
  }
  if (route.query.departmentName) {
    queryParams.departmentName = route.query.departmentName
  }
  getList()
})

• Step 4: 修改 completeness-check/index.vue 支持URL参数

import { useRoute } from 'vue-router'
const route = useRoute()

onMounted(() => {
  if (route.query.emrId) {
    checkForm.emrId = route.query.emrId
  }
  if (route.query.encounterId) {
    checkForm.encounterId = route.query.encounterId
  }
  // 如果有参数自动执行检查
  if (checkForm.emrId && checkForm.encounterId) {
    handleCheck()
  }
})

• Step 5: 修改 emrsearch/index.vue 支持URL参数

import { useRoute } from 'vue-router'
const route = useRoute()

onMounted(() => {
  if (route.query.patientName) {
    queryParams.patientName = route.query.patientName
  }
  if (route.query.emrType) {
    queryParams.emrType = route.query.emrType
  }
  handleSearch()
})

• Step 6: Commit

git add healthlink-his-ui/src/views/emr/revision-history/index.vue \
        healthlink-his-ui/src/views/emr/archive/index.vue \
        healthlink-his-ui/src/views/emr/timeliness/index.vue \
        healthlink-his-ui/src/views/emr/completeness-check/index.vue \
        healthlink-his-ui/src/views/emrsearch/index.vue
git commit -m "feat(emr): EMR管理页面支持URL参数自动加载"

---

Task 3: 医生工作站添加EMR集成入口

Covers: 问题#4, #5

Files:

• Modify: healthlink-his-ui/src/views/doctorstation/components/emr/emr.vue

• Step 1: 读取 emr.vue 确认现有结构

找到病历详情展示区域，在操作按钮区域添加集成入口。

• Step 2: 添加集成按钮

在病历详情弹窗或操作区域添加：

<template>
  <!-- 在现有病历操作按钮区域添加 -->
  <el-button type="info" link @click="viewRevisionHistory">
    <el-icon><Document /></el-icon> 修订历史
  </el-button>
  <el-button type="info" link @click="viewArchiveStatus">
    <el-icon><Folder /></el-icon> 归档状态
  </el-button>
  <el-button type="info" link @click="checkCompleteness">
    <el-icon><Checked /></el-icon> 完整性检查
  </el-button>
</template>

<script setup>
import { useRouter } from 'vue-router'
import { checkCompleteness as checkEmrCompleteness } from '@/api/emr'
import { ElMessage } from 'element-plus'

const router = useRouter()

// 当前病历数据（从父组件传入或从store获取）
const currentEmr = defineModel('emr', { type: Object, default: () => ({}) })

const viewRevisionHistory = () => {
  if (!currentEmr.value?.id) {
    ElMessage.warning('请先选择病历')
    return
  }
  router.push({
    path: '/emr/revision-history',
    query: { emrId: currentEmr.value.id }
  })
}

const viewArchiveStatus = () => {
  if (!currentEmr.value?.encounterId) {
    ElMessage.warning('请先选择病历')
    return
  }
  router.push({
    path: '/emr/archive',
    query: {
      encounterId: currentEmr.value.encounterId,
      patientName: currentEmr.value.patientName
    }
  })
}

const checkCompleteness = async () => {
  if (!currentEmr.value?.id || !currentEmr.value?.encounterId) {
    ElMessage.warning('请先选择病历')
    return
  }
  try {
    const res = await checkEmrCompleteness(currentEmr.value.id, currentEmr.value.encounterId)
    const data = res.data || res
    if (data.isComplete) {
      ElMessage.success('病历完整性检查通过')
    } else {
      ElMessage.warning(`病历完整性检查未通过，${data.requiredFailed}项必填项未填写`)
    }
  } catch (e) {
    ElMessage.error('检查失败')
  }
}
</script>

• Step 3: 验证编译

cd healthlink-his-ui && npm run build:dev

• Step 4: Commit

git add healthlink-his-ui/src/views/doctorstation/components/emr/emr.vue
git commit -m "feat(emr): 医生工作站添加修订历史/归档/完整性检查入口"

---

Task 4: 住院医生工作站添加EMR集成入口

Covers: 问题#4, #5

Files:

• Modify: healthlink-his-ui/src/views/inpatientDoctor/home/emr/index.vue

• Step 1: 读取住院EMR页面确认结构

• Step 2: 添加集成按钮

<template>
  <!-- 在现有病历操作按钮区域添加 -->
  <el-button type="info" link @click="viewRevisionHistory">
    修订历史
  </el-button>
  <el-button type="info" link @click="viewTimeliness">
    时效监控
  </el-button>
  <el-button type="info" link @click="checkCompleteness">
    完整性检查
  </el-button>
</template>

<script setup>
import { useRouter } from 'vue-router'
import { checkCompleteness as checkEmrCompleteness } from '@/api/emr'
import { ElMessage } from 'element-plus'

const router = useRouter()
const currentEmr = defineModel('emr', { type: Object, default: () => ({}) })

const viewRevisionHistory = () => {
  if (!currentEmr.value?.id) {
    ElMessage.warning('请先选择病历')
    return
  }
  router.push({
    path: '/emr/revision-history',
    query: { emrId: currentEmr.value.id }
  })
}

const viewTimeliness = () => {
  if (!currentEmr.value?.encounterId) {
    ElMessage.warning('请先选择病历')
    return
  }
  router.push({
    path: '/emr/timeliness',
    query: { encounterId: currentEmr.value.encounterId }
  })
}

const checkCompleteness = async () => {
  if (!currentEmr.value?.id || !currentEmr.value?.encounterId) {
    ElMessage.warning('请先选择病历')
    return
  }
  try {
    const res = await checkEmrCompleteness(currentEmr.value.id, currentEmr.value.encounterId)
    const data = res.data || res
    if (data.isComplete) {
      ElMessage.success('病历完整性检查通过')
    } else {
      ElMessage.warning(`病历完整性检查未通过，${data.requiredFailed}项必填项未填写`)
    }
  } catch (e) {
    ElMessage.error('检查失败')
  }
}
</script>

• Step 3: 验证编译

cd healthlink-his-ui && npm run build:dev

• Step 4: Commit

git add healthlink-his-ui/src/views/inpatientDoctor/home/emr/index.vue
git commit -m "feat(emr): 住院医生工作站添加修订历史/时效/完整性检查入口"

---

Task 5: 保存病历时自动触发修订记录

Covers: 问题#2

Files:

• Modify: healthlink-his-server/.../doctorstation/appservice/impl/DoctorStationEmrAppServiceImpl.java

• Step 1: 读取现有保存逻辑

找到 saveEmr 或类似方法，确认保存流程。

• Step 2: 添加自动触发修订记录

在保存EMR成功后添加：

@Resource
private IEmrRevisionService emrRevisionService;

// 在saveEmr方法中，保存成功后添加：
// 自动记录修订历史
EmrRevision revision = new EmrRevision();
revision.setEmrId(savedEmr.getId());
revision.setEncounterId(savedEmr.getEncounterId());
revision.setOperatorName(operatorName); // 从SecurityUtils获取
revision.setOperationType("SAVE");
revision.setSnapshotContent(savedEmr.getContextJson());
revision.setCreateTime(new Date());
emrRevisionService.save(revision);

• Step 3: 验证编译

mvn clean compile -DskipTests -pl healthlink-his-application

• Step 4: Commit

git add healthlink-his-server/healthlink-his-application/src/main/java/com/healthlink/his/web/doctorstation/appservice/impl/DoctorStationEmrAppServiceImpl.java
git commit -m "feat(emr): 保存病历时自动创建修订记录"

---

Task 6: 保存病历时自动更新搜索索引

Covers: 问题#3

Files:

• Modify: healthlink-his-server/.../doctorstation/appservice/impl/DoctorStationEmrAppServiceImpl.java

• Step 1: 添加搜索索引服务注入

@Resource
private IEmrSearchIndexService emrSearchIndexService;

• Step 2: 保存成功后自动更新索引

// 在saveEmr方法中，保存成功后添加：
// 自动更新搜索索引
EmrSearchIndex searchIndex = new EmrSearchIndex();
searchIndex.setEmrId(savedEmr.getId());
searchIndex.setEncounterId(savedEmr.getEncounterId());
searchIndex.setPatientName(patientName);
searchIndex.setEmrType(emrType);
searchIndex.setEmrTitle(title);
searchIndex.setDiagnosisText(diagnosis);
searchIndex.setDoctorName(doctorName);
searchIndex.setDepartmentName(departmentName);
searchIndex.setCreateTime(new Date());

// 检查是否已存在索引
LambdaQueryWrapper<EmrSearchIndex> wrapper = new LambdaQueryWrapper<>();
wrapper.eq(EmrSearchIndex::getEmrId, savedEmr.getId());
EmrSearchIndex existing = emrSearchIndexService.getOne(wrapper);
if (existing != null) {
    existing.setPatientName(patientName);
    existing.setEmrType(emrType);
    existing.setEmrTitle(title);
    existing.setDiagnosisText(diagnosis);
    existing.setDoctorName(doctorName);
    existing.setDepartmentName(departmentName);
    existing.setUpdateTime(new Date());
    emrSearchIndexService.updateById(existing);
} else {
    emrSearchIndexService.save(searchIndex);
}

• Step 3: 验证编译

mvn clean compile -DskipTests -pl healthlink-his-application

• Step 4: Commit

git add healthlink-his-server/healthlink-his-application/src/main/java/com/healthlink/his/web/doctorstation/appservice/impl/DoctorStationEmrAppServiceImpl.java
git commit -m "feat(emr): 保存病历时自动更新搜索索引"

---

Task 7: 全量验证

Covers: 全部问题

• Step 1: 后端编译验证

mvn clean compile -DskipTests

Expected: BUILD SUCCESS

• Step 2: 前端编译验证

cd healthlink-his-ui && npm run build:dev

Expected: Build successful

• Step 3: 接口测试

# 测试修订历史接口
curl http://localhost:18082/emr/revision/page?pageNo=1&pageSize=10

# 测试搜索接口
curl http://localhost:18082/emr-search/search?keyword=test

# 测试归档接口
curl http://localhost:18082/emr-archive/page?pageNo=1&pageSize=10

Expected: 返回 {code:200, data:...}

• Step 4: 提交代码

git add -A
git commit -m "feat(emr): 打通EMR管理模块与门诊/住院病历集成"
git push origin develop

---

验证检查清单

检查项	验证方式	预期结果
修订历史API路径	访问 /emr/revision/page	返回数据
URL参数支持	访问 /emr/revision-history?emrId=1	自动加载该病历修订记录
医生工作站入口	打开病历详情	显示修订历史/归档/完整性检查按钮
保存自动触发	保存病历后查询 emr_revision 表	有新记录
搜索索引更新	保存病历后查询 emr_search_index 表	有新记录
完整性检查	点击完整性检查按钮	显示检查结果

---

Plan Version: v1.0 Created: 2026-06-21 Estimated Effort: 2-3小时