proposal.md 3.2 KB

Why

广州 DIP 分组分值匹配严重依赖入参 oprnInfo / diseInfo 的字段规范性。实测发现 HIS 传入的数据存在字段错位:oprnInfo 第 2、3 条的 oprnCode 被填成日期(2026-09-22)和医生姓名(沙翔垠),真正的手术编码 13.7100x001 被填进了 oprnName。这类脏数据会让患者被错误地分入"保守治疗"病种(分值 288 而非 482),导致分组分值、支付标准、费用预警全链路失真。

后端虽已加入手术池清洗(丢弃非编码形态的项),但用户看不到异常:弹框上分组结果看起来正常,无法察觉"结果其实已经不准"。因此需要在 DIP 分组分值查询弹框(ScorePopup)中把数据规则性错误高亮暴露出来,让 HIS/院方人员一眼发现并回源头修数据。

What Changes

  • 后端新增入参数据质量校验:在 src.DRG.GroupDevice 增加共享校验方法 CheckDIPInputQuality(params),按规则检测诊断/手术信息的数据问题,返回问题清单。
  • 接口返回新增 dataIssues 字段:02010003(GetDIPGroupScore)与 02010008(GetDIPGroupScoreFeeWarning)的 result 中新增 dataIssues 数组(纯新增字段,既有字段不变)。
  • 校验规则(本期范围):
    1. 手术编码形态错误:oprnInfo[].oprnCode 为空、或不符合手术编码形态(日期、中文姓名、无小数点等)
    2. 手术名称疑似编码:oprnInfo[].oprnName 符合手术编码形态 → 判定为编码与名称字段错位
  • 前端弹框高亮:frontend/src/pages/DIP/ScorePopup.tsx
    1. 诊断/手术表格中异常行整行红色背景,问题单元格加 Tooltip 说明原因(如"oprnCode 疑似日期/姓名,应为手术编码")
    2. 分组分值结果区提示"入参存在数据异常,分组结果可能不准",提醒人工复核

Capabilities

New Capabilities

  • dip-input-data-quality:DIP 分组入参数据规则性校验(后端判定 + 接口返回 dataIssues)与弹框高亮展示(表格行标红 + Tooltip + 结果区提示)的完整契约与规则清单。

Modified Capabilities

Impact

后端

  • src/src/DRG/GroupDevice.cls:新增 CheckDIPInputQuality 共享校验方法;通用分支结果装配处附加 dataIssues
  • src/src/DRG/GroupScheme/Guangzhou.cls:广州分支结果装配处调用同一共享方法附加 dataIssues
  • src/src/DRG/GroupDevice.cls 的 GetDIPGroupScoreFeeWarning(02010008):将 dataIssues 透传到自身返回

接口

  • 02010003、02010008:result 新增 dataIssues 数组(纯新增,前端与 HIS 既有解析不受影响)

前端

  • frontend/src/pages/DIP/ScorePopup.tsx:诊断/手术表格行高亮 + Tooltip + 结果区提示
  • frontend/src/api/dip.ts:DIPGroupResult 类型新增可选 dataIssues

数据

  • 不新增表、不改表结构;校验规则为纯逻辑判断

不在本期范围

  • 诊断编码形态校验、mainFlag 一致性、手术日期/级别/医生字段错位检测(后续按需补充)
  • DRG 分组弹框(GroupPopup)的同类高亮