MedicalInsurance/openspec/changes/add-year-to-algorithm-tables/design.md

Context

当前 DRG/DIP 算法配置存储在两张独立的 IRIS 表中：

• HB_DRGCoreAlgorithmData: 存储 DRG 分组对应的基准点数、点值、差异系数、支付标准等算法参数
• HB_DIPCoreAlgorithmData: 存储 DIP 分组对应的基准分值、调节系数等算法参数

两张表当前均没有年份维度，所有年度的算法数据混合存储。由于各地 DRG/DIP 分组方案每年都会调整，需要按年度隔离管理。

后端分组查询（GroupDevice.cls）：

• DRG 分组: Device() 方法在分组完成后通过 SQL 查询 HB_DRGCoreAlgorithmData 获取算法参数（Points、PipValue、DGDOV、PayStandard）
• DIP 分组: GetDIPGroupScore() 方法（接口 02010003）通过 SQL 查询 HB_DIPCoreAlgorithmData 获取分值
• 病历保存: SaveMedRecInfo() 方法查询 DRG 指向时也使用 HB_DRGCoreAlgorithmData

前端 DRG/DIP 算法配置页面已实现完整的增删改查、导入导出功能，但缺少年份维度。

Goals / Non-Goals

Goals:

• 在 HB_DRGCoreAlgorithmData 和 HB_DIPCoreAlgorithmData 表中增加 Year 字段（4位年份）
• 将 Year 纳入唯一索引，确保同一年份内业务键唯一
• 分组查询接口（Device、GetDIPGroupScore）按年份查询，支持当年无数据时回退到上一年
• 前端算法配置页面增加年份筛选、展示、新增/编辑必填、导入时必选

Non-Goals:

• 不修改分组规则本身（MDC、ADRG、DRG 分组逻辑不变）
• 不涉及其他表的年份改造
• 不提供跨年份数据对比/分析功能
• 不做自动年份切换的定时任务

Decisions

1. Year 字段设计

决策: Year 使用 %String(MAXLEN=4) 类型，存储4位数字年份（如 "2026"），在独立索引中与现有业务键联合。

原因:

• String 类型简单直观，查询方便（可直接比较）
• 与数据库中 StartDate/StopDate 等日期字段分离，单独管理年份维度
• 不需要日期解析开销

备选方案: 使用 StartDate 年份动态提取 — 但当前表已有 StartDate 表示"生效日期"，语义可能重叠，且已有数据可能不同年份同一 DRG 共用相同 StartDate，导致无法区分。Year 字段职责更单一明确。

2. 索引调整

DRG 表现有索引: Index Index On (DRG, ProvinceDr, CityDr, FixmedinsCode) 调整后: 增加 Year 到索引中 — Index Index On (DRG, ProvinceDr, CityDr, FixmedinsCode, Year) 或创建新的唯一索引。

DIP 表现有索引: Index Index On (PrincipalDiagnosis, MajorProcedure, ProvinceDr, CityDr, MedinsLv) 调整后: 增加 Year — Index Index On (PrincipalDiagnosis, MajorProcedure, ProvinceDr, CityDr, MedinsLv, Year)。

注意: IRIS 中 Index Index 不是唯一索引（没有 Unique 关键字），但实际业务逻辑视其为唯一键。增加 Year 后可确保同一年份内不重复。

3. 分组查询年份回退逻辑

决策: 两步查询策略：

1. 先查询当前年份（$PIECE($ZDATE($HOROLOG, 3), "-", 1)）的算法配置
2. 如果当前年份完全无数据（count=0），回退查询上一年份数据
3. 如果当前年份有数据但具体分组查询无结果，返回错误提示"未维护当年 DRG/DIP 分组数据"

回退限制: 仅回退到上一年，不无限回退。避免查找到过期配置。

原因:

• 新年伊始（如1月1日）可能当年数据尚未维护完毕，回退到上一年保证系统可用
• 当年已有部分数据说明当前维护中，不应再使用旧数据

备选方案: 多级回退（直到找到数据）— 但风险太高，可能误用到多年前的配置。单级回退更安全可控。

4. 前端年份字段处理

决策:

• 查询条件：Select 下拉选择年份（动态生成近5年 + "全部"选项，"全部"时不传Year参数）
• 表格列：显示"年份"列（宽度80，位于DRG编码/名称之后）
• 新增/编辑：年份必填，默认值为当前年份，使用 Select 下拉
• 导入：导入弹窗增加年份必选下拉（统一为导入的年份，不逐行指定）

原因: 导入时统一指定年份避免逐行解析年份的复杂性，符合批量导入场景。

5. 存量数据兼容

决策: 存量数据不自动填充 Year，而是在查询时判断 Year 为 NULL 或空的数据视为兼容模式（不参与年份过滤），后续更新维护时逐步补充。

原因: 无法自动推断存量数据的年份归属，人工介入更可靠。

Risks / Trade-offs

• [风险] 存量数据无 Year 值 → 查询逻辑兼容 Year 为空的记录（视为通用/不参与年份过滤），各管理员可逐步补填
• [风险] 索引变更导致表锁 → 在低峰期执行 ALTER TABLE，或在测试环境验证后操作
• [风险] 回退到上一年数据可能有业务差异 → 回退逻辑记录日志，前端显示提示"当前年份无数据，已使用 XXXX 年配置"
• [风险] 前端导入模板需更新 → 导入模板不需要增加年份列（年份由导入弹窗统一选择），避免模板变更影响已有流程

Migration Plan

1. 在 IRIS 中执行 DDL 添加 Year 字段
2. 更新 GroupDevice.cls 中相关查询逻辑
3. 更新后端算法配置接口（查询、保存、导入）支持 Year
4. 更新前端 DRG/DIP 算法配置页面
5. 在测试环境验证分组查询的正确性
6. 通知管理员逐步补填存量数据的年份信息

回滚方案：Year 字段为可选添加，如出问题可快速注释年份过滤逻辑，系统回退到原有行为。

Open Questions

• 存量数据中是否有跨年份共用的通用配置？如何处理？