design.md 9.6 KB

Context

DRG 医保控费系统需要从 HIS 系统增量同步住院患者就诊数据(接口 02010067,由 src.DRG.HISData.HisDataService.GetInpatientData 实现),用于 DRG/DIP 分组与费用预警。

后端已具备自动同步的"大脑":

  • User.BSHISSyncConfig:同步配置表(HospCode/SyncType/Frequency/ScheduledTime/LookbackDays/Enabled/Status/ErrorMessage)。
  • src.DRG.HISData.SyncTaskService:RunScheduledTasks(02010083) 扫描所有 Enabled=1 的配置,按频率判定后调用 ExecuteScheduledSync → Interface.GetInpatientData(02010067);GetSyncConfig(02010079)/SaveSyncConfig(02010080)/GetSyncStatus(02010081) 供前端配置页与状态页使用;InitScheduleTask(02010084) 注册 IRIS 原生 %SYS.Task。
  • src.DRG.HISData.SyncSchedulerTask:%SYS.Task 子类(IRIS 2019 限制下仅每天一次兜底扫描)。
  • 前端 SyncTaskConfig.tsx 管理配置、SyncLog.tsx + 02010077 查询 BS_HISSyncLog 日志。

缺失的是"心脏起搏器"——一个能周期性调用 02010083 的外部常驻触发器。RunScheduledTasks 本身只负责"被调用时扫描并判定是否该执行",并不自己计时。

系统约束:

  • IRIS 2019.x:原生 %SYS.Task.DailyFrequency 仅 0/1,最高粒度"每天一次",无法承担"每小时"需求(见 InitScheduleTask 注释)。
  • 生产服务器 172.16.2.15,IRIS Web 端口 52773,CSP 路径 /csp/drg/sysInternalMutiple,Basic 鉴权 _SYSTEM:pryk@2020(base64 X1NZU1RFTTpwcnlrQDIwMjA=)。
  • 自动同步失败仅做状态记录 + 日志(BS_HISSyncConfig.Status/ErrorMessage + 02010077),不做主动推送。

Goals / Non-Goals

Goals:

  • 在生产服务器实现 HIS 数据的每小时自动同步(整点触发,可配置)。
  • 复用并修复现有 SyncTaskService,不重复造轮子、不新增后端接口与表。
  • 提供两种可独立部署、可互为兜底的外部触发器(C# 服务 + Windows 任务计划)。
  • 多触发器并发调用 02010083 时,由 IRIS 端去重,绝不对同一配置重复执行。
  • 触发器自身具备可运维性:运行状态可见、启停可控、有本地日志。

Non-Goals:

  • 不引入 IRIS 原生 %SYS.Task 分钟级调度(IRIS 2019 不支持;InitScheduleTask 仅保留为可选的每日兜底,本次不部署)。
  • 不做同步失败的主动告警/推送(仅状态 + 日志)。
  • 不改动前端页面与配置表结构。
  • 不实现实时/秒级同步(粒度固定为"每小时",由 Frequency=hourly 表达)。

Decisions

决策1:触发机制选型——外部常驻进程,且部署两种形态互为兜底

选择:在生产服务器部署两个互补的外部触发器,均周期性调用 02010083:

  1. C# Windows 服务 + 托盘程序(主用,常驻、开机自启、运维友好)。
  2. Windows 任务计划 + PowerShell 脚本(兜底,零编译、易排错)。

备选方案对比:

方案 优点 缺点 结论
A. C# 托盘/Windows 服务 常驻、开机自启、有 UI 与日志、易运维 需 .NET 运行时、需编译部署一个新项目 采用(主用)
B. Windows 任务计划 + PowerShell 零新代码、最快落地、不依赖运行时 依赖任务计划程序、无 UI、单次进程无状态 采用(兜底)
C. 仅 A + B 都部署 任一失效另一仍可触发,最高可用 部署略多 采用(两者都部署)
D. IRIS 后台 Job 死循环 sleep 无需外部进程 IRIS 重启易丢、保活复杂、不推荐 不采用
E. IRIS 原生 %SYS.Task 原生、无需外部进程 IRIS 2019 只能每天一次,无法满足每小时 不采用(仅作注释保留)

幂等保证(关键):两个触发器都只"敲门"(02010083),真正是否执行由 RunScheduledTasks 内的 ShouldRunNow 判定 + 全局变量 ^DRG.HIS.SyncConfig.LastRunTime(freqKey, hospCode) 记录上次执行 $h。即使 C# 服务与计划任务在同一分钟各调一次,第二次会因 LastRunTime 已更新而判定"本小时已跑"跳过,绝不会重复同步。


决策2:修复 ShouldRunNow 的 hourly 跨天去重 bug

问题:当前 hourly 分支(第 464–475 行)用 $p(pNowH,",",2)'=$p(pLastRunH,",",2) 比较"一天内的秒数"判等。若昨天 14:00 跑过、今天 14:00 再次触发,两者秒数相同 → 误判"本小时已跑" → 今天不执行。这与"每小时整点跑一次"的预期相悖。

修复:hourly 分支直接比较完整 $h 时间戳去重(因已在 nowMM=0 时进入,时间戳唯一标识"某天的某整点"):

if pFreqKey = "hourly"
{
    quit:(+pNowMM)'=0 shouldRun          // 仅整点(分钟为0)考虑执行
    if pLastRunH = "" { set shouldRun = 1  quit }
    if pNowH '= pLastRunH { set shouldRun = 1  quit }   // 完整时间戳去重,根治跨天 bug
    quit shouldRun
}

daily/weekly 增加 ±2 分钟容错窗口:当前要求 nowMM == schedMM 精确相等,若触发器在整点时刻抖动 1 分钟即漏跑;改为 |$NowMM - schedMM| <= 2,并在日期判重后执行,提升健壮性(不影响 hourly)。


决策3:诊断日志 debugOn 默认关闭

问题:RunScheduledTasks 第 335 行 set debugOn = 1 硬编码,每次扫描(每分钟可能多次)都会向 ^DRG.HIS.SyncConfig.Debug 写入大量全局变量,长期运行会膨胀数据库。

修复:debugOn 默认 0,仅在 ^DRG.HIS.SyncConfig.DebugOn = 1 时开启,便于排错期临时打开:

set debugOn = $g(^DRG.HIS.SyncConfig.DebugOn, 0)

排错完毕后置回 0 或 kill ^DRG.HIS.SyncConfig.DebugOn 即可。


决策4:C# 触发器技术设计(无第三方依赖)

项目结构(HISAutoSyncService/):

  • HISAutoSyncService.csproj:输出 Windows 可执行文件,TargetFramework net48(已与用户确认使用 .NET Framework 4.8,Windows 系统自带、无需额外安装运行时),<OutputType>Exe</OutputType>,引用 System.Windows.Forms、System.ServiceProcess、System.Net.Http(均为框架自带,无第三方 NuGet 包)。
  • Program.cs:入口。若 Environment.UserInteractive 为 false 或带 --service 参数 → 进入 ServiceBase.Run(new AutoSyncService());否则启动托盘(WinForms Application.Run + NotifyIcon)。
  • AutoSyncService.cs:继承 ServiceBase,OnStart 启动 System.Timers.Timer(默认 Interval=60000),Elapsed 事件调用 SchedulerClient.TriggerAsync()。
  • SchedulerClient.cs:HTTP 客户端。POST http://127.0.0.1:52773/csp/drg/sysInternalMutiple,Body {"code":"02010083","params":[{}]},Header Authorization: Basic <token>、Content-Type: application/json;把响应状态码/耗时/返回摘要写入本地日志。
  • TrayForm.cs / TrayIcon.cs:托盘图标、右键菜单(启动/停止/立即执行一次/打开日志/退出)、显示上次运行时间与下一次倒计时。
  • appsettings.json:可配置 Endpoint、IntervalSeconds、AuthToken(默认即上述生产值,便于迁移/测试)。

安装/卸载:

  • Install-Service.bat:sc create "DRGHISAutoSync" binPath= "%~dp0HISAutoSyncService.exe --service" start= auto DisplayName= "DRG HIS 自动同步服务" && sc start DRGHISAutoSync。
  • Uninstall-Service.bat:sc stop DRGHISAutoSync && sc delete DRGHISAutoSync。

兜底 PowerShell:Invoke-HisSyncScheduler.ps1 用 Invoke-RestMethod 发同样请求,带 Basic 头;Register-TaskScheduler.ps1 用 schtasks /Create /SC MINUTE /MO 1 /TN "DRGHISAutoSyncPS" /TR "powershell -File ...\Invoke-HisSyncScheduler.ps1" 注册每分钟任务。

Risks / Trade-offs

Risk 1:两个触发器并发导致日志噪声或瞬时重复

风险:C# 服务与计划任务在同一分钟各调一次 02010083,理论上第二次会被 ShouldRunNow 去重跳过(安全),但会多一次无意义的 IRIS 调用与一行扫描日志。 缓解:去重逻辑保证不会重复同步;噪声极低(每分钟至多一次空扫描);必要时可在 RunScheduledTasks 结果中区分 executedCount 与 scannedCount 便于监控。

Risk 2:HIS 接口在整点时刻不可用

风险:hourly 在整点执行,若 HIS 接口临时故障,UpdateConfigStatus 写 error,本轮错过需等下一整点。 缓解:BS_HISSyncConfig 记录 Status=error 与 ErrorMessage,前端 SyncLog.tsx(02010077)可见;运维可手动在 SyncTaskConfig.tsx 立即触发一次。

Risk 3:C# 服务进程崩溃

风险:服务异常退出导致自动同步停摆。 缓解:Windows 服务"恢复"策略设为"第一次失败后自动重启"(sc failure 或安装脚本配置);同时计划任务 PowerShell 作为独立兜底仍会触发。

Risk 4:IRIS 端点/鉴权变更

风险:若生产端点或令牌变化,触发器调用失败。 缓解:端点与令牌集中在 appsettings.json 与 PS1 顶部变量,便于一处修改;本地日志会记录 HTTP 非 200 便于及时发现。

Open Questions

  1. .NET 运行时:已确认使用 .NET Framework 4.8(Windows 系统自带,无需安装),csproj 指向 net48。(已确认)
  2. 调用地址:已确认 C# 服务与计划任务都固定指向本机 127.0.0.1:52773(/csp/drg/sysInternalMutiple),更安全、不依赖 Web 端口。(已确认)
  3. 整点粒度:已确认"每小时一次"为固定整点触发(nowMM=0,即 00/01/…/23 点整),不扩展偏移分钟字段。(已确认)