DRGInterfaceClient SHALL 提供系统托盘图标(NotifyIcon):主界面关闭/最小化时 SHALL 收起到托盘而非退出进程;双击托盘图标或右键菜单「打开主界面」SHALL 还原主界面;右键菜单 SHALL 提供「打开主界面」「立即执行一次」「打开日志」「退出」项。
DRGInterfaceClient 主界面 SHALL 提供「接口地址」输入框(TextBox),初始值取自 appsettings.json 的 Endpoint;操作员 SHALL 可随时修改该地址。每次发起任何 DRG 接口调用前,程序 SHALL 校验地址非空:为空时 SHALL 弹窗提示"接口地址不能为空"并中断本次调用,不得发起 HTTP 请求;非空时 SHALL 以文本框当前值作为请求端点。
http://172.16.2.15:52773/csp/drg/sysInternalMutiple 并点击「加载机构」01010064,且后续 02010079/02010067 调用均使用该地址DRGInterfaceClient SHALL 在程序目录维护本地滚动日志 DRGInterfaceClient.log,对每一次 DRG 接口调用记录时间戳、级别、接口码、HTTP 状态码、耗时(ms)、响应摘要(前 200 字)或异常信息;主界面SHALL内嵌日志面板实时展示,并SHALL提供「打开日志文件」与「清空日志」操作。
01010064/02010079/02010067 中任一接口DRGInterfaceClient.log 追加一条含时间戳、接口码、HTTP 状态码、耗时与响应摘要的记录;调用失败SHALL记录 ERROR 级别与异常信息DRGInterfaceClient.log 文件DRGInterfaceClient SHALL 在首屏调用 01010064(FindHospDetail)获取医疗机构列表,并以下拉框呈现供操作员选择单个机构;下拉项显示机构名称(descripts),值为 hospCode(同时保留 id/code/MedinsLv 供 session 使用)。启动默认不自动执行同步,需人工选机构并操作。
01010064 并将返回的机构数组填充至下拉框;若返回为空或失败,SHALL禁用后续按钮并提示当操作员从下拉框选中机构后,DRGInterfaceClient SHALL 调用 02010079(GetSyncConfig,入参 hospCode,请求带已构建的 session)获取该机构同步配置,并在主界面展示 syncType/frequency/scheduledTime/lookbackDays/enabled/synFlag/warningFlag 等字段。
02010079,并将返回的同步配置展示在主界面配置区DRGInterfaceClient 调用 02010079 与 02010067 时 SHALL 在请求体中包含 session 数组;session 中机构字段 hospYBCode/hospCode/hospDesc/hospID/medinsLv SHALL 取自所选机构的 01010064 返回(code/hospCode/descripts/id/MedinsLv),其余非机构字段 SHALL 取自 appsettings.json 的系统默认值。机构字段为必填:未选中机构时,任何业务接口调用SHALL被拦截并提示"请先选择医疗机构",不得发起 HTTP 请求。
02010067hospYBCode=机构.code、hospCode=机构.hospCode、hospDesc=机构.descripts、hospID=机构.id、medinsLv=机构.MedinsLv,其余字段取 appsettings 默认值当操作员选中机构、加载配置后点击「立即执行一次」,DRGInterfaceClient SHALL 调用 02010067(GetInpatientData),参数 admID=''、hospID=机构.hospCode、SynFlag=配置.synFlag,日期区间 stDate/endDate 依据 02010079 的 syncType 与 lookbackDays 计算(增量:endDate=今天、stDate=今天-LookbackDays;全量:endDate=今天、stDate=今天-FullSyncStartDays),并携带上述 session;调用结果SHALL写入日志。
02010067,并在日志中记录本次调用的状态码、耗时与结果摘要DRGInterfaceClient SHALL 支持以 --sync 命令行参数启动的无头模式:启动时读取 appsettings.json 的 ScheduledHospCode,调用 01010064 匹配机构 → 构建 session → 调用 02010079 → 计算日期区间 → 调用 02010067 一次 → 写日志 → 以退出码 0(成功)/1(失败) 结束;若 ScheduledHospCode 为空或匹配不到机构,SHALL写错误日志并以退出码 1 结束。该模式 SHALL 适合被 Windows 任务计划程序周期触发。
--sync 启动本程序且 ScheduledHospCode 有效0 结束,日志中留有完整调用记录--sync 启动但 ScheduledHospCode 为空或按 code(医保机构编码)匹配不到机构1 结束,不发起业务调用当操作员选中机构、加载配置后点击「开始调度」,DRGInterfaceClient SHALL 依据当前 02010079 配置的 frequency 启用调度机制:hourly→启动程序内整点轮询(常驻托盘,内部定时器在下一个整点首次触发、之后每小时整点触发一次 02010067);daily→注册 Windows 计划任务(/SC DAILY /ST HH:mm,操作指向 --sync);weekly→注册 Windows 计划任务(/SC WEEKLY /D MON /ST HH:mm,操作指向 --sync);manual→不启用任何自动调度,仅保留手动「立即执行一次」。点「停止调度」SHALL 对应停止(hourly 停内部定时器 / daily|weekly 删除计划任务)。托盘SHALL显示下一次运行时间。
02010079 配置为 frequency=hourly,操作员点击「开始调度」02010067(带 session 与增量日期区间),托盘显示"下次运行 HH:00";程序退出则轮询停止02010079 配置为 frequency=daily、scheduledTime=02:30,操作员点击「开始调度」DRGInterfaceClientSync,触发频率为每日 02:30,操作为 "<程序目录>\DRGInterfaceClient.exe" --sync;程序可关闭,真正定时由任务计划程序承担02010079 配置为 frequency=manual,操作员点击「开始调度」