feat(mrhomepage): 病案首页质量校验

- 新增 IMrHomepageQualityAppService + impl,实现 checkQuality/getQualityResults
- 新增 MrHomepageQualityController (POST /quality/check, GET /quality/results/{id})
- 增强 MrHomepageQualityCheckServiceImpl:必填项+逻辑校验+ICD编码+费用一致性
- 新增 MrHomepageQualityCheck.vue 校验结果展示页面
- 更新前端 API 文件添加 checkQuality/getQualityResults 接口
This commit is contained in:
2026-06-17 14:02:42 +08:00
parent 09e43e4b8c
commit 00604b2d01
8 changed files with 420 additions and 36 deletions

View File

@@ -0,0 +1,13 @@
package com.healthlink.his.web.mrhomepage.appservice;
import com.healthlink.his.mrhomepage.domain.MrHomepageQualityCheck;
import java.util.List;
import java.util.Map;
public interface IMrHomepageQualityAppService {
List<MrHomepageQualityCheck> checkQuality(Long homepageId);
Map<String, Object> getQualityResults(Long homepageId);
}

View File

@@ -0,0 +1,54 @@
package com.healthlink.his.web.mrhomepage.appservice.impl;
import com.healthlink.his.mrhomepage.domain.MrHomepage;
import com.healthlink.his.mrhomepage.domain.MrHomepageQualityCheck;
import com.healthlink.his.mrhomepage.service.IMrHomepageQualityCheckService;
import com.healthlink.his.mrhomepage.service.IMrHomepageService;
import com.healthlink.his.web.mrhomepage.appservice.IMrHomepageQualityAppService;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@Service
public class MrHomepageQualityAppServiceImpl implements IMrHomepageQualityAppService {
@Resource
private IMrHomepageService mrHomepageService;
@Resource
private IMrHomepageQualityCheckService mrHomepageQualityCheckService;
@Override
@Transactional
public List<MrHomepageQualityCheck> checkQuality(Long homepageId) {
mrHomepageQualityCheckService.clearByHomepageId(homepageId);
return mrHomepageQualityCheckService.executeAutoCheck(homepageId);
}
@Override
public Map<String, Object> getQualityResults(Long homepageId) {
MrHomepage homepage = mrHomepageService.getById(homepageId);
List<MrHomepageQualityCheck> checks = mrHomepageQualityCheckService.selectByHomepageId(homepageId);
long totalChecks = checks.size();
long passedChecks = checks.stream()
.filter(c -> "PASS".equals(c.getCheckResult()))
.count();
long failedChecks = totalChecks - passedChecks;
double score = totalChecks > 0 ? (double) passedChecks / totalChecks * 100 : 0;
Map<String, Object> results = new HashMap<>();
results.put("homepageId", homepageId);
results.put("qualityStatus", homepage != null ? homepage.getQualityStatus() : null);
results.put("totalChecks", totalChecks);
results.put("passedChecks", passedChecks);
results.put("failedChecks", failedChecks);
results.put("score", Math.round(score * 10.0) / 10.0);
results.put("checks", checks);
return results;
}
}

View File

@@ -0,0 +1,36 @@
package com.healthlink.his.web.mrhomepage.controller;
import com.core.common.core.domain.R;
import com.healthlink.his.mrhomepage.domain.MrHomepageQualityCheck;
import com.healthlink.his.web.mrhomepage.appservice.IMrHomepageQualityAppService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.Map;
@RestController
@RequestMapping("/api/v1/mr-homepage/quality")
@Tag(name = "病案首页质量校验")
public class MrHomepageQualityController {
@Resource
private IMrHomepageQualityAppService mrHomepageQualityAppService;
@PostMapping("/check")
@PreAuthorize("hasAuthority('inpatient:mrhomepage:edit')")
@Operation(summary = "执行质量校验")
public R<List<MrHomepageQualityCheck>> checkQuality(@RequestParam Long homepageId) {
return R.ok(mrHomepageQualityAppService.checkQuality(homepageId));
}
@GetMapping("/results/{homepageId}")
@PreAuthorize("hasAuthority('inpatient:mrhomepage:list')")
@Operation(summary = "获取质量校验结果")
public R<Map<String, Object>> getQualityResults(@PathVariable Long homepageId) {
return R.ok(mrHomepageQualityAppService.getQualityResults(homepageId));
}
}

View File

@@ -10,4 +10,6 @@ public interface IMrHomepageQualityCheckService extends IService<MrHomepageQuali
List<MrHomepageQualityCheck> selectByHomepageId(Long homepageId);
List<MrHomepageQualityCheck> executeAutoCheck(Long homepageId);
void clearByHomepageId(Long homepageId);
}

View File

@@ -1,5 +1,6 @@
package com.healthlink.his.mrhomepage.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.healthlink.his.mrhomepage.domain.MrHomepage;
import com.healthlink.his.mrhomepage.domain.MrHomepageQualityCheck;
@@ -10,15 +11,19 @@ import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import java.util.regex.Pattern;
@Service
public class MrHomepageQualityCheckServiceImpl
extends ServiceImpl<MrHomepageQualityCheckMapper, MrHomepageQualityCheck>
implements IMrHomepageQualityCheckService {
private static final Pattern ICD10_PATTERN = Pattern.compile("^[A-Z]\\d{2}(\\.\\d{1,4})?$");
@Resource
private IMrHomepageService mrHomepageService;
@@ -27,51 +32,150 @@ public class MrHomepageQualityCheckServiceImpl
return baseMapper.selectByHomepageId(homepageId);
}
@Override
@Transactional
public void clearByHomepageId(Long homepageId) {
remove(new LambdaQueryWrapper<MrHomepageQualityCheck>()
.eq(MrHomepageQualityCheck::getHomepageId, homepageId));
}
@Override
@Transactional
public List<MrHomepageQualityCheck> executeAutoCheck(Long homepageId) {
MrHomepage homepage = mrHomepageService.getById(homepageId);
if (homepage == null) {
return List.of();
}
List<MrHomepageQualityCheck> checks = new ArrayList<>();
Date now = new Date();
// 主诊断编码检查
MrHomepageQualityCheck diagnosisCheck = new MrHomepageQualityCheck()
.setHomepageId(homepageId)
.setCheckItem("主诊断编码完整性")
.setCheckCategory("基础信息")
.setCheckResult(homepage.getPrimaryDiagnosisCode() != null ? "PASS" : "FAIL")
.setCheckDetail("主诊断编码: " + homepage.getPrimaryDiagnosisCode())
.setSuggestion(homepage.getPrimaryDiagnosisCode() == null ? "请填写主诊断编码" : null)
.setChecker("AUTO")
.setCheckTime(new Date());
save(diagnosisCheck);
checks.add(diagnosisCheck);
checkRequiredField(checks, homepageId, "患者ID", "基础信息",
homepage.getPatientId() != null, "患者ID", now);
checkRequiredField(checks, homepageId, "就诊ID", "基础信息",
homepage.getEncounterId() != null, "就诊ID", now);
checkRequiredField(checks, homepageId, "入院日期", "日期信息",
homepage.getAdmissionDate() != null, "入院日期", now);
checkRequiredField(checks, homepageId, "出院日期", "日期信息",
homepage.getDischargeDate() != null, "出院日期", now);
checkRequiredField(checks, homepageId, "主诊断编码", "诊断信息",
homepage.getPrimaryDiagnosisCode() != null, "主诊断编码", now);
checkRequiredField(checks, homepageId, "主诊断名称", "诊断信息",
homepage.getPrimaryDiagnosisName() != null, "主诊断名称", now);
checkRequiredField(checks, homepageId, "出院情况", "出院信息",
homepage.getDischargeCondition() != null, "出院情况", now);
checkRequiredField(checks, homepageId, "出院去向", "出院信息",
homepage.getDischargeDestination() != null, "出院去向", now);
// 主手术编码检查
MrHomepageQualityCheck procedureCheck = new MrHomepageQualityCheck()
.setHomepageId(homepageId)
.setCheckItem("主手术编码完整性")
.setCheckCategory("基础信息")
.setCheckResult(homepage.getPrimaryProcedureCode() != null ? "PASS" : "FAIL")
.setCheckDetail("主手术编码: " + homepage.getPrimaryProcedureCode())
.setSuggestion(homepage.getPrimaryProcedureCode() == null ? "请填写主手术编码" : null)
.setChecker("AUTO")
.setCheckTime(new Date());
save(procedureCheck);
checks.add(procedureCheck);
if (homepage.getAdmissionDate() != null && homepage.getDischargeDate() != null) {
boolean dateValid = !homepage.getAdmissionDate().after(homepage.getDischargeDate());
addCheck(checks, homepageId, "入院日期≤出院日期", "逻辑校验",
dateValid ? "PASS" : "FAIL",
"入院: " + homepage.getAdmissionDate() + ", 出院: " + homepage.getDischargeDate(),
dateValid ? null : "入院日期不能晚于出院日期", "AUTO", now);
}
// 入院日期检查
MrHomepageQualityCheck admissionCheck = new MrHomepageQualityCheck()
.setHomepageId(homepageId)
.setCheckItem("入院日期完整性")
.setCheckCategory("日期信息")
.setCheckResult(homepage.getAdmissionDate() != null ? "PASS" : "FAIL")
.setCheckDetail("入院日期: " + homepage.getAdmissionDate())
.setSuggestion(homepage.getAdmissionDate() == null ? "请填写入院日期" : null)
.setChecker("AUTO")
.setCheckTime(new Date());
save(admissionCheck);
checks.add(admissionCheck);
if (homepage.getAdmissionDate() != null && homepage.getDischargeDate() != null
&& homepage.getLosDays() != null) {
long diffMs = homepage.getDischargeDate().getTime() - homepage.getAdmissionDate().getTime();
long expectedDays = Math.max(1, diffMs / (1000 * 60 * 60 * 24) + 1);
boolean losValid = homepage.getLosDays().intValue() == expectedDays;
addCheck(checks, homepageId, "住院天数一致性", "逻辑校验",
losValid ? "PASS" : "FAIL",
"记录天数: " + homepage.getLosDays() + ", 计算天数: " + expectedDays,
losValid ? null : "住院天数应为" + expectedDays + "", "AUTO", now);
}
if (homepage.getPrimaryDiagnosisCode() != null) {
boolean icdValid = ICD10_PATTERN.matcher(homepage.getPrimaryDiagnosisCode()).matches();
addCheck(checks, homepageId, "主诊断ICD编码格式", "ICD编码",
icdValid ? "PASS" : "FAIL",
"编码: " + homepage.getPrimaryDiagnosisCode(),
icdValid ? null : "ICD-10编码格式应为: 字母+2位数字(.可选小数)", "AUTO", now);
}
if (homepage.getPrimaryProcedureCode() != null) {
boolean icdValid = ICD10_PATTERN.matcher(homepage.getPrimaryProcedureCode()).matches();
addCheck(checks, homepageId, "主手术ICD编码格式", "ICD编码",
icdValid ? "PASS" : "FAIL",
"编码: " + homepage.getPrimaryProcedureCode(),
icdValid ? null : "ICD-9-CM-3编码格式应为: 字母+2位数字(.可选小数)", "AUTO", now);
}
checkCostNonNegative(checks, homepageId, "总费用", homepage.getTotalCost(), now);
checkCostNonNegative(checks, homepageId, "自费费用", homepage.getSelfPayCost(), now);
checkCostNonNegative(checks, homepageId, "医保费用", homepage.getInsuranceCost(), now);
checkCostNonNegative(checks, homepageId, "药品费", homepage.getDrugCost(), now);
checkCostNonNegative(checks, homepageId, "检查费", homepage.getExaminationCost(), now);
checkCostNonNegative(checks, homepageId, "化验费", homepage.getLabCost(), now);
checkCostNonNegative(checks, homepageId, "治疗费", homepage.getTreatmentCost(), now);
checkCostNonNegative(checks, homepageId, "材料费", homepage.getMaterialCost(), now);
if (homepage.getTotalCost() != null && homepage.getTotalCost().compareTo(BigDecimal.ZERO) > 0) {
BigDecimal sum = BigDecimal.ZERO;
sum = safeAdd(sum, homepage.getDrugCost());
sum = safeAdd(sum, homepage.getExaminationCost());
sum = safeAdd(sum, homepage.getLabCost());
sum = safeAdd(sum, homepage.getTreatmentCost());
sum = safeAdd(sum, homepage.getMaterialCost());
boolean costValid = homepage.getTotalCost().compareTo(sum) == 0;
addCheck(checks, homepageId, "费用构成一致性", "逻辑校验",
costValid ? "PASS" : "FAIL",
"总费用: " + homepage.getTotalCost() + ", 分项合计: " + sum,
costValid ? null : "总费用应等于药品费+检查费+化验费+治疗费+材料费", "AUTO", now);
}
if (homepage.getSelfPayCost() != null && homepage.getInsuranceCost() != null
&& homepage.getTotalCost() != null && homepage.getTotalCost().compareTo(BigDecimal.ZERO) > 0) {
BigDecimal paySum = safeAdd(homepage.getSelfPayCost(), homepage.getInsuranceCost());
boolean payValid = homepage.getTotalCost().compareTo(paySum) == 0;
addCheck(checks, homepageId, "费用分担一致性", "逻辑校验",
payValid ? "PASS" : "FAIL",
"总费用: " + homepage.getTotalCost() + ", 自费+医保: " + paySum,
payValid ? null : "总费用应等于自费费用+医保费用", "AUTO", now);
}
return checks;
}
private void checkRequiredField(List<MrHomepageQualityCheck> checks, Long homepageId,
String itemName, String category, boolean isValid,
String fieldName, Date now) {
addCheck(checks, homepageId, itemName + "完整性", category,
isValid ? "PASS" : "FAIL",
fieldName + ": " + (isValid ? "已填写" : "未填写"),
isValid ? null : "请填写" + fieldName, "AUTO", now);
}
private void checkCostNonNegative(List<MrHomepageQualityCheck> checks, Long homepageId,
String costName, BigDecimal value, Date now) {
if (value != null) {
boolean valid = value.compareTo(BigDecimal.ZERO) >= 0;
addCheck(checks, homepageId, costName + "非负", "费用信息",
valid ? "PASS" : "FAIL",
costName + ": " + value,
valid ? null : costName + "不能为负数", "AUTO", now);
}
}
private void addCheck(List<MrHomepageQualityCheck> checks, Long homepageId,
String checkItem, String category, String result,
String detail, String suggestion, String checker, Date now) {
MrHomepageQualityCheck check = new MrHomepageQualityCheck()
.setHomepageId(homepageId)
.setCheckItem(checkItem)
.setCheckCategory(category)
.setCheckResult(result)
.setCheckDetail(detail)
.setSuggestion(suggestion)
.setChecker(checker)
.setCheckTime(now);
save(check);
checks.add(check);
}
private BigDecimal safeAdd(BigDecimal a, BigDecimal b) {
if (a == null) return b != null ? b : BigDecimal.ZERO;
if (b == null) return a;
return a.add(b);
}
}

View File

@@ -1,3 +1,5 @@
import request from "@/utils/request"
export function executeQualityCheck(id) { return request({ url: "/api/v1/mr-homepage/quality-check/" + id, method: "post" }) }
export function submitHomepage(id) { return request({ url: "/api/v1/mr-homepage/submit/" + id, method: "put" }) }
export function checkQuality(homepageId) { return request({ url: "/api/v1/mr-homepage/quality/check", method: "post", params: { homepageId } }) }
export function getQualityResults(homepageId) { return request({ url: "/api/v1/mr-homepage/quality/results/" + homepageId, method: "get" }) }

View File

@@ -6,3 +6,5 @@ export function executeQualityCheck(id) { return request({ url: '/api/v1/mr-home
export function getQualityCheck(homepageId) { return request({ url: '/api/v1/mr-homepage/quality-check/' + homepageId, method: 'get' }) }
export function getStatistics(params) { return request({ url: '/api/v1/mr-homepage/statistics', method: 'get', params }) }
export function submitHomepage(id) { return request({ url: '/api/v1/mr-homepage/submit/' + id, method: 'put' }) }
export function checkQuality(homepageId) { return request({ url: '/api/v1/mr-homepage/quality/check', method: 'post', params: { homepageId } }) }
export function getQualityResults(homepageId) { return request({ url: '/api/v1/mr-homepage/quality/results/' + homepageId, method: 'get' }) }

View File

@@ -0,0 +1,171 @@
<template>
<div class="app-container">
<el-card shadow="never">
<template #header>
<div class="card-header">
<span>病案首页质量校验</span>
<div>
<el-input
v-model="homepageId"
placeholder="请输入首页ID"
style="width: 200px; margin-right: 12px"
@keyup.enter="handleCheck"
/>
<el-button
type="primary"
:loading="checking"
@click="handleCheck"
>
执行校验
</el-button>
</div>
</div>
</template>
<div v-if="results">
<el-row :gutter="20" style="margin-bottom: 20px">
<el-col :span="6">
<el-statistic title="校验总数" :value="results.totalChecks" />
</el-col>
<el-col :span="6">
<el-statistic title="通过数" :value="results.passedChecks">
<template #suffix>
<span style="color: #67c23a"> </span>
</template>
</el-statistic>
</el-col>
<el-col :span="6">
<el-statistic title="不合格数" :value="results.failedChecks">
<template #suffix>
<span style="color: #f56c6c"> </span>
</template>
</el-statistic>
</el-col>
<el-col :span="6">
<el-statistic title="质量评分">
<template #default>
<div :style="{ color: scoreColor, fontSize: '28px', fontWeight: 'bold' }">
{{ results.score }}
</div>
</template>
</el-statistic>
</el-col>
</el-row>
<el-tabs v-model="activeTab">
<el-tab-pane label="全部" name="all" />
<el-tab-pane label="不合格项" name="FAIL" />
<el-tab-pane label="合格项" name="PASS" />
</el-tabs>
<el-table
:data="filteredChecks"
stripe
border
style="width: 100%"
>
<el-table-column
prop="checkCategory"
label="校验类别"
width="120"
/>
<el-table-column
prop="checkItem"
label="校验项目"
width="180"
/>
<el-table-column
prop="checkResult"
label="结果"
width="80"
align="center"
>
<template #default="scope">
<el-tag :type="scope.row.checkResult === 'PASS' ? 'success' : 'danger'" size="small">
{{ scope.row.checkResult === 'PASS' ? '合格' : '不合格' }}
</el-tag>
</template>
</el-table-column>
<el-table-column
prop="checkDetail"
label="详情"
show-overflow-tooltip
/>
<el-table-column
prop="suggestion"
label="整改建议"
show-overflow-tooltip
/>
<el-table-column
prop="checkTime"
label="校验时间"
width="170"
/>
</el-table>
</div>
<el-empty v-if="!results && !loading" description="请输入首页ID并执行校验" />
</el-card>
</div>
</template>
<script setup>
import { ref, computed } from 'vue'
import { checkQuality, getQualityResults } from '@/api/mrhomepage'
import { ElMessage } from 'element-plus'
const homepageId = ref('')
const loading = ref(false)
const checking = ref(false)
const results = ref(null)
const activeTab = ref('all')
const scoreColor = computed(() => {
if (!results.value) return '#909399'
if (results.value.score >= 90) return '#67c23a'
if (results.value.score >= 70) return '#e6a23c'
return '#f56c6c'
})
const filteredChecks = computed(() => {
if (!results.value?.checks) return []
if (activeTab.value === 'all') return results.value.checks
return results.value.checks.filter(c => c.checkResult === activeTab.value)
})
const handleCheck = async () => {
if (!homepageId.value) {
ElMessage.warning('请输入首页ID')
return
}
checking.value = true
try {
await checkQuality(homepageId.value)
await loadResults()
ElMessage.success('质量校验完成')
} catch (e) {
ElMessage.error('校验失败: ' + (e.message || '未知错误'))
} finally {
checking.value = false
}
}
const loadResults = async () => {
loading.value = true
try {
results.value = await getQualityResults(homepageId.value)
} catch (e) {
ElMessage.error('获取结果失败')
} finally {
loading.value = false
}
}
</script>
<style scoped>
.card-header {
display: flex;
justify-content: space-between;
align-items: center;
}
</style>