从桌面软件到内网页面:院感数据质控工具改造记录

院感数据质控工具

📦 6 Parts + Conclusion

👉 滑动

这次改造的核心目标

把技术参数留在服务器，把日期选择留给使用者。

最终，使用者只需要做三件事。

参数不直观

使用者需要了解数据库连接参数，每次操作还要重复填写相同信息。

密码易暴露

数据库密码可能在多人使用过程中暴露，不适合放在普通操作流程里反复出现。

版本难统一

软件需要复制到不同电脑，版本不容易统一；报告执行时间较长时，也看不到具体进度。

内网依赖困难

内网服务器不能访问互联网，依赖安装也比较困难。

院感老师真正关心的，其实只有“我要查询哪个时间段的数据”。

浏览器选择日期 → 服务器执行质控 SQL → 生成报告 → 浏览器下载结果

查询完成后，系统会生成三类文件：Word整体报告用于一览数据；Excel 明细报告，便于筛选、统计和进一步处理；HTML 汇总报告，便于快速查看每项质控的执行结果。

现在页面会显示

当前完成百分比、已完成多少项、当前正在执行哪项质控、实时成功和失败数量，以及 Word、Excel 及 HTML 报告生成阶段。

需要说明的是，进度按照 98 项查询的完成数量计算。如果某一条 SQL 本身耗时较长，进度会暂时停留在当前项目，待数据库返回结果后继续增长。

依赖无法在线安装

服务器无法访问互联网，Python 依赖无法直接下载安装。最终将程序和数据库驱动一起打包成免安装的 Windows 可执行程序，服务器不再需要额外安装运行环境。

脚本兼容性问题

不同 Windows 环境对批处理文件的编码和换行格式处理并不完全一致。中文程序名和非标准换行可能导致启动脚本被错误解析，因此最终将核心程序名、启动脚本内容统一调整为兼容性更好的格式。

连接成功不等于能查业务数据

还有一次比较典型的问题：数据库“测试连接”显示成功，但 98 项查询全部失败。排查后发现，账号可以连接数据库服务，但连接的是默认管理库，而业务数据实际位于另一个数据库中。修改为正确的业务数据库后，质控查询才正常执行。

“数据库能连接”并不等于“业务数据能查询”。

一个日期选择框、一个生成按钮、一条进度条

当它能减少重复输入、降低使用门槛、统一程序版本时，这个小工具就有了存在的意义。

如果你觉得这篇有帮助，欢迎点一下右下角的在看，也可以转给需要的同事。