一、行业业务背景
本系统面向三级甲等医院，具体服务于肾脏移植、骨髓移植等术前术后检测环节。
在移植医学中，HLA（人类白细胞抗原）配型与HLA抗体检测是决定移植物存活率的核心指标。实验室通常使用Luminex流式荧光技术进行检测，生成大量的荧光数值（MFI）与基因位点数据。检验科需将这些原始实验数据转化为结构化的临床诊断报告，用于临床医生进行免疫风险评估和用药决策。
二、立项原因
高度依赖人工转录，错误率高
既往流程中，实验人员需从分析软件导出的报告中人工复制抗体/基因数据，手动粘贴至Word报告模板，再逐一填入患者姓名、床号、送检科室等基本信息。一张报告涉及数十个数据点，人为错漏频发。
报告格式要求严苛，处理复杂
有的医院需要所输出结果能满足对接lis的格式，有的需要满足能同时生成word存档文件与PDF打印文件，并且每间医院的报告内容需要不一，需要个性化定制
样本追踪与编号管理混乱
上机列表缺乏标准化编号规则，手动编排除易重复外，无法通过编号快速反查患者信息。
一、核心功能模块
1. 主控台与配置模块
系统导航：提供“LSA抗体报告系统”和“HLA分型报告系统”两个独立入口，支持一键切换。
路径与数据库管理：集中配置SQL Server连接信息、报告/数据/模板文件夹路径，“上机列表”路径管理，支持设置记忆与重置默认。
2. LSA抗体报告子系统
数据自动拉取：输入样本号后，自动连接数据库读取SQL数据库中分析好的实验原始数据。
复杂逻辑处理：自动进行等位基因的血清学映射、α/β链表位标注，并支持对临床关注的特定等位基因进行单元格加粗提醒。
报告输出：一键生成符合医院规范的Word报告文档，并自动转换为PDF文件存档。
3. HLA分型报告子系统
基因数据处理：输入样本号后，自动解析高分辨等位基因数据，执行等位基因展开/合并、高分辨转低分辨，并连接数据库查询对应的血清学特异性。
数据闭环：自动将最终分型结果回填至SSO实验记录表（Excel），确保实验台账的完整性与可追溯性。
报告输出：依据标准化模板生成带高/低分辨双展示的Word报告，并自动生成PDF。
4. 辅助工具模块
上机编号自动生成：基于“姓名拼音 + 日期 + 序号”规则（如zhangsan26072801），一键批量更新上机列表，彻底解决人工编排除错与重复问题。
二、主要功能描述
本程序打通了从“数据库原始结果”到“临床正式报告”的最后一公里。它替代了检验人员手动复制粘贴数据、人工判读强弱阳性、手动排版及反复核对的繁重工作，将单份报告的处理时间从15-20分钟压缩至2-3分钟。同时，通过固化判读标准与自动化的数据映射，有效杜绝了转录性差错，确保移植配型结果的严谨性，是医院移植中心提升信息化水平重要辅助工具。
这是一个基于 Python 开发的桌面端（GUI）自动化报告系统，技术选型成熟稳健，已经在多个医院落地使用，全程由我个人独立开发。
技术栈：Python 3.11 + Tkinter（GUI）+ python-docx+ pandas+ openpyxl/xlsxwriter+ pyodbc+ docx2pdf+ PyInstaller
系统架构采用模块化分层设计，主入口 main_app.py作为调度中心，下辖 9 个功能模块：config_manager（配置管理）、db_utils（支持 SQL Server 多驱动自动适配的连接函数）、utils（Excel 日期解析、空值格式化）、hla_utils（HLA 报告基础功能）、lsa_utils（LSA报告基础功能）、settings_window（三标签页系统设置 UI）、lsa_subsystem（LSA 报告定制）、hla_subsystem（HLA 报告定制）。模块间通过组合关系传递 main_app 实例实现配置共享，无循环依赖。
实现亮点：一是 LSA 三种表格模式通过 UI 勾选框独立开关控制，权重和页面宽度可在系统设置中实时配置，无需改代码；二是 HLA 模块支持 Excel 公式自动解析——通过 openpyxl 读取公式文本中的 Sheet2!$D:$D 列字母，自动转换为列索引匹配 Sheet2 表头，再按条码查找，换任何 SSO 文件格式都能自动适配，无需手写映射。
难点：一是 Word 模板中"检测结果"段落的精确定位和内容插入，需在 python-docx 的 XML 层级操作 content_elements 列表并在锚点段落后重建 DOM 顺序；二是 HLA 双等位基因（如 05:01/135:01）的低分转换需逐个检出 : 前的字段值并分别带上位点前缀；
评论