spec.md 9.4 KB

ADDED Requirements

Requirement: 程序可最小化到系统托盘并还原

DRGInterfaceClient SHALL 提供系统托盘图标(NotifyIcon):主界面关闭/最小化时 SHALL 收起到托盘而非退出进程;双击托盘图标或右键菜单「打开主界面」SHALL 还原主界面;右键菜单 SHALL 提供「打开主界面」「立即执行一次」「打开日志」「退出」项。

Scenario: 最小化到托盘后还原

  • WHEN 操作员点击主界面最小化按钮或关闭按钮
  • THEN 程序SHALL收起到系统托盘(进程继续运行),双击托盘图标可还原主界面,且不丢失已选机构与配置

Scenario: 通过托盘菜单退出

  • WHEN 操作员在托盘右键菜单点击「退出」
  • THEN 程序SHALL完全退出进程,托盘图标移除

Requirement: 接口地址可在窗体编辑且非空校验

DRGInterfaceClient 主界面 SHALL 提供「接口地址」输入框(TextBox),初始值取自 appsettings.json 的 Endpoint;操作员 SHALL 可随时修改该地址。每次发起任何 DRG 接口调用前,程序 SHALL 校验地址非空:为空时 SHALL 弹窗提示"接口地址不能为空"并中断本次调用,不得发起 HTTP 请求;非空时 SHALL 以文本框当前值作为请求端点。

Scenario: 地址为空时拦截调用

  • WHEN 操作员清空接口地址输入框后点击「加载机构」「加载配置」或「立即执行一次」
  • THEN 程序SHALL弹窗提示"接口地址不能为空",不向 IRIS 发起任何 HTTP 调用

Scenario: 修改为新地址后生效

  • WHEN 操作员将接口地址改为 http://172.16.2.15:52773/csp/drg/sysInternalMutiple 并点击「加载机构」
  • THEN 程序SHALL以该地址调用 01010064,且后续 02010079/02010067 调用均使用该地址

Scenario: 最小化到托盘后还原

  • WHEN 操作员点击主界面最小化按钮或关闭按钮
  • THEN 程序SHALL收起到系统托盘(进程继续运行),双击托盘图标可还原主界面,且不丢失已选机构与配置

Scenario: 通过托盘菜单退出

  • WHEN 操作员在托盘右键菜单点击「退出」
  • THEN 程序SHALL完全退出进程,托盘图标移除

Requirement: 本地记录并可查看接口调用日志

DRGInterfaceClient SHALL 在程序目录维护本地滚动日志 DRGInterfaceClient.log,对每一次 DRG 接口调用记录时间戳、级别、接口码、HTTP 状态码、耗时(ms)、响应摘要(前 200 字)或异常信息;主界面SHALL内嵌日志面板实时展示,并SHALL提供「打开日志文件」与「清空日志」操作。

Scenario: 每次接口调用写入日志

  • WHEN 程序调用 01010064/02010079/02010067 中任一接口
  • THEN 系统SHALL在 DRGInterfaceClient.log 追加一条含时间戳、接口码、HTTP 状态码、耗时与响应摘要的记录;调用失败SHALL记录 ERROR 级别与异常信息

Scenario: 在界面查看与打开日志

  • WHEN 操作员打开主界面日志面板或点击「打开日志」
  • THEN 系统SHALL在主界面展示实时日志,或调用系统程序打开 DRGInterfaceClient.log 文件

Requirement: 启动后加载机构下拉供选择

DRGInterfaceClient SHALL 在首屏调用 01010064(FindHospDetail)获取医疗机构列表,并以下拉框呈现供操作员选择单个机构;下拉项显示机构名称(descripts),值为 hospCode(同时保留 id/code/MedinsLv 供 session 使用)。启动默认不自动执行同步,需人工选机构并操作。

Scenario: 加载机构列表

  • WHEN 程序启动或操作员点击「加载机构」
  • THEN 系统SHALL调用 01010064 并将返回的机构数组填充至下拉框;若返回为空或失败,SHALL禁用后续按钮并提示

Requirement: 选机构后加载并展示同步配置

当操作员从下拉框选中机构后,DRGInterfaceClient SHALL 调用 02010079(GetSyncConfig,入参 hospCode,请求带已构建的 session)获取该机构同步配置,并在主界面展示 syncType/frequency/scheduledTime/lookbackDays/enabled/synFlag/warningFlag 等字段。

Scenario: 加载并展示 02010079 配置

  • WHEN 操作员选中机构并点击「加载配置」
  • THEN 系统SHALL以该机构构建的 session 调用 02010079,并将返回的同步配置展示在主界面配置区

Requirement: 业务接口调用必须带 session 且机构字段来自 01010064

DRGInterfaceClient 调用 02010079 与 02010067 时 SHALL 在请求体中包含 session 数组;session 中机构字段 hospYBCode/hospCode/hospDesc/hospID/medinsLv SHALL 取自所选机构的 01010064 返回(code/hospCode/descripts/id/MedinsLv),其余非机构字段 SHALL 取自 appsettings.json 的系统默认值。机构字段为必填:未选中机构时,任何业务接口调用SHALL被拦截并提示"请先选择医疗机构",不得发起 HTTP 请求。

Scenario: session 机构字段正确映射

  • WHEN 已选中某机构并调用 02010067
  • THEN 请求 session 中 hospYBCode=机构.code、hospCode=机构.hospCode、hospDesc=机构.descripts、hospID=机构.id、medinsLv=机构.MedinsLv,其余字段取 appsettings 默认值

Scenario: 未选机构时拦截调用

  • WHEN 操作员未选中机构即点击「加载配置」或「立即执行一次」
  • THEN 系统SHALL拦截请求、写日志提示"请先选择医疗机构",且不向 IRIS 发起任何 HTTP 调用

Requirement: 手动触发 02010067 住院数据同步

当操作员选中机构、加载配置后点击「立即执行一次」,DRGInterfaceClient SHALL 调用 02010067(GetInpatientData),参数 admID=''、hospID=机构.hospCode、SynFlag=配置.synFlag,日期区间 stDate/endDate 依据 02010079 的 syncType 与 lookbackDays 计算(增量:endDate=今天、stDate=今天-LookbackDays;全量:endDate=今天、stDate=今天-FullSyncStartDays),并携带上述 session;调用结果SHALL写入日志。

Scenario: 立即执行一次同步

  • WHEN 操作员选中机构、加载配置后点击「立即执行一次」
  • THEN 系统SHALL以正确 session 与日期区间调用 02010067,并在日志中记录本次调用的状态码、耗时与结果摘要

Requirement: 支持外部 Windows 任务计划定时调用(--sync 模式)

DRGInterfaceClient SHALL 支持以 --sync 命令行参数启动的无头模式:启动时读取 appsettings.json 的 ScheduledHospCode,调用 01010064 匹配机构 → 构建 session → 调用 02010079 → 计算日期区间 → 调用 02010067 一次 → 写日志 → 以退出码 0(成功)/1(失败) 结束;若 ScheduledHospCode 为空或匹配不到机构,SHALL写错误日志并以退出码 1 结束。该模式 SHALL 适合被 Windows 任务计划程序周期触发。

Scenario: 计划任务触发一次同步

  • WHEN Windows 任务计划程序以 --sync 启动本程序且 ScheduledHospCode 有效
  • THEN 程序SHALL完成一次完整的"加载机构→构建session→加载配置→调02010067"流程并以退出码 0 结束,日志中留有完整调用记录

Scenario: 定时机构未配置时失败退出

  • WHEN 以 --sync 启动但 ScheduledHospCode 为空或按 code(医保机构编码)匹配不到机构
  • THEN 程序SHALL写明确错误日志并以退出码 1 结束,不发起业务调用

Requirement: 点「开始调度」按 02010079 配置启用对应调度

当操作员选中机构、加载配置后点击「开始调度」,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显示下一次运行时间。

Scenario: hourly 配置启用程序内整点轮询

  • WHEN 当前机构 02010079 配置为 frequency=hourly,操作员点击「开始调度」
  • THEN 程序SHALL启动内部定时器,在下一个整点首次触发、之后每小时整点调用一次 02010067(带 session 与增量日期区间),托盘显示"下次运行 HH:00";程序退出则轮询停止

Scenario: daily 配置注册外部计划任务

  • WHEN 当前机构 02010079 配置为 frequency=daily、scheduledTime=02:30,操作员点击「开始调度」
  • THEN 程序SHALL注册/更新 Windows 计划任务 DRGInterfaceClientSync,触发频率为每日 02:30,操作为 "<程序目录>\DRGInterfaceClient.exe" --sync;程序可关闭,真正定时由任务计划程序承担

Scenario: manual 配置不启用自动调度

  • WHEN 当前机构 02010079 配置为 frequency=manual,操作员点击「开始调度」
  • THEN 程序SHALL不启动内部定时器、不注册计划任务,仅保留手动「立即执行一次」通道,并提示"manual 配置仅支持手动执行"