[开源] 消毒包追溯断裂紧急决策工具：面向手术室与CSSD的30秒可追溯处置系统

本项目是专为手术室护士、消毒供应中心CSSD人员和院感质控岗位设计的灭菌包追溯中断应急响应工具。当灭菌包追溯码物理断裂、污损或扫码失败时系统在30秒内基于灭菌日期、手术类型、包类属性等多维规则输出「重消毒」「降级使用」或「放行」三类明确建议全程记录决策人、时间、依据并生成可打印卡片彻底替代手写登记与经验判断。我们提供CLI命令行、Web扫码页、护士站大屏视图kiosk模式及标准API接口所有逻辑由TypeScript编写、Node.js运行规则引擎独立封装存储层支持JSON文件或SQLite切换配置全部落于config/decision-rules.json中开箱即用且医院可自主定制。定位与能力范围我们不做通用追溯平台也不覆盖灭菌全过程管理。本工具聚焦一个真实高频痛点追溯码断裂后的“下一秒该怎么做”。它不采集设备数据、不对接HIS/LIS、不替代条码打印机只解决“扫码失败后30秒内必须给出合规结论”这一刚性场景。适用对象非常明确正在手术台边等待器械的护士、在CSSD分拣区发现破损标签的质检员、以及需要回溯当日所有应急决策的院感科人员。能力边界清晰输入是人工补录的关键字段如追溯码、灭菌日期、手术类型输出是带依据的结构化建议操作留痕卡片导出。它不预测失效风险不生成统计报表但确保每一次人工干预都有据可查、有迹可循、有时效闭环。核心功能与决策逻辑系统所有决策均基于三层嵌套规则灭菌有效期、手术类型优先级、追溯状态组合。三者不可拆解共同构成临床安全底线。例如植入物手术implant永远高于清洁手术clean哪怕灭菌日期仍在14天有效期内只要追溯码断裂即触发重消毒而急诊手术emergency在临期如第13天且无其他高危因素时允许降级使用这并非降低标准而是将“保障手术连续性”与“控制感染风险”做动态权衡。追溯异常情形灭菌日期状态手术类型决策结果追溯码无法扫描有效≤14天清洁/污染放行追溯码无法扫描过期14天任意类型重消毒追溯码无法扫描有效植入物重消毒追溯码无法扫描临期10–14天急诊降级使用决策卡片含四项强制信息建议类型、依据条款如“依据规则#3.2急诊临期→降级使用”、操作人签名栏、4小时有效期水印。卡片格式固定支持A6/A7热敏纸直打也兼容常规打印机。所有历史记录按操作人、日期范围、手术类型可查可导出CSV与Excel双格式支持字段完整映射至原始输入参数无信息折损。使用与配置方式我们坚持“不装新软件、不改旧流程”的接入原则。一线人员无需安装客户端扫码即用信息科无需协调厂商接口规则修改只需编辑一个JSON文件。CLI是最轻量入口适合移动PDA或护士站PC快速调用npx tsx src/cli/index.ts decide --trace-code ABC123 --package-type sterile-kit --surgery-type implant --operator 张护士 --package-date 2024-01-15Web端提供三个专用视图web/scan.html是扫码主界面大按钮语音提示扫码框自动聚焦web/kiosk.html专为护士站壁挂大屏优化字体放大200%禁用右键与地址栏全屏沉浸web/history.html提供筛选表格支持按操作人、日期、手术类型、决策结果四维过滤。规则配置完全开放config/decision-rules.json中可调整 -sterilization.validityDays灭菌有效期默认14天 -surgery.priorities手术类型排序数组植入物必须排第一 -traceability.warningThreshold临期警告起始天数默认10天 -decisionValidHours决策结果有效期默认4小时修改后执行npx tsx src/cli/index.ts reload-rules或调用/api/rules/reload即刻生效无需重启服务。工程结构与扩展路径整个系统按关注点分离为六大模块全部位于src/下职责一目了然模块路径职责说明src/engine/规则引擎核心含rule-engine.ts主调度器与rules/下各策略实现src/cli/命令行交互层封装commander.js覆盖decide/history/export/reload全部指令src/web/Express服务与静态页面含API路由、扫码页、历史页、大屏页src/storage/存储抽象层当前实现JSON文件读写SQLite适配器已预留接口src/types/全局类型定义如DecisionResult、SterilePackage、SurgeryTypesrc/utils/通用工具含日期计算、字符串标准化、CSV序列化等这种结构让扩展成本极低若某院已有内部日志系统只需替换src/storage/下的实现若需对接微信扫码仅需在web/scan.html中注入JS-SDK若要求审计级操作留痕可在src/engine/rule-engine.ts的execute()末尾插入自定义钩子。所有模块通过依赖注入连接无硬编码耦合。环境与运行支持本地开发只需Node.js 18与npm零外部依赖。生产环境推荐Docker Compose一键部署./deploy.sh deploy或手动启动docker-compose up -d服务暴露三个标准端点 - Web界面http://localhost:3000- API接口http://localhost:3000/api- 健康检查http://localhost:3000/api/health环境变量通过.env统一管理关键项包括PORT、STORAGE_TYPEjson/sqlite、LOG_LEVEL。日志采用结构化JSON输出可直接接入ELK或Loki。我们不强制要求数据库JSON文件存储已满足中小医院全年决策记录存档需求若日均决策超500条启用SQLite仅需修改两处配置并执行一次迁移脚本。数据与扩展说明所有输入字段均为业务必填项无默认值陷阱。例如--surgery-type必须从预设枚举中选择implant/clean/contaminated/emergency避免自由文本导致规则匹配失败--package-date强制ISO格式YYYY-MM-DD解析失败立即报错而非静默处理。历史记录字段与CLI输入严格对齐导出CSV列头即为traceCode,packageType,surgeryType,operator,packageDate,decision,reason,createdAt,expiresAt无冗余字段无隐藏计算列。扩展新手术类型只需两步一是在config/decision-rules.json的surgery.priorities中追加字符串二是在src/types/index.ts中同步更新SurgeryType联合类型。规则引擎会自动识别并纳入优先级比对无需改动核心逻辑。同理新增包类如endoscope-kit也只需在类型定义与规则配置中声明引擎自动泛化处理。限制与说明本工具不替代灭菌过程质量控制不校验物理包装完整性不检测生物指示剂结果。它仅响应“追溯信息缺失”这一单一信号所有决策前提均为“包体外观完好、无明显污染”。若包体破损、湿包、掉包应直接进入重消毒流程不经过本系统判断。规则引擎不支持模糊匹配或概率推断所有分支均为确定性布尔逻辑。例如“临期”定义为packageDate validityDays - today ≤ warningThreshold结果非真即假不引入置信度评分。决策卡片上显示的“依据条款”直接指向配置文件中的规则ID如#traceability.fallback.emergency方便质控人员逐条核对原文杜绝黑盒解释。项目文档含全部规则说明、字段定义、错误码列表均置于docs/目录HTML与Markdown双格式离线可用。所有CLI命令参数含义、Web端URL路径、API请求示例均在文档中结构化呈现不依赖GitHub README碎片信息。项目地址https://github.com/nexorin9/cssd-emergency-decision