本项目是临床路径卡牌化培训系统Pathway-Deck专为医院医保办工作人员、临床科室教学负责人及新入职医师设计将卫健委临床路径、DRG/DIP支付规则、医保负面清单等确定性规范转化为可拖拽、可构筑、可验证的视觉化卡牌。核心机制是确定性规则引擎非LLM驱动的四类检查器互斥组合识别、必选项目校验、分类与总价限价判断、诊断-项目匹配验证主线能力覆盖模板加载、卡组交互构筑、实时合规反馈、假设分析对比、PDF/CSV双格式报告生成交付形态包括Web界面ViteReact、命令行工具CLI、REST API三端统一技术栈采用TypeScript全栈严格模式、Express后端、dnd-kit拖拽框架、Vitest全覆盖测试395用例规则引擎语句覆盖率100%。定位与能力范围我们不做通用医疗知识图谱也不做临床决策辅助本系统只解决一个具体问题让临床路径规则“看得见、摸得着、试得出”。它不替代HIS或EMR而是作为独立培训沙盒存在医保办用它组织路径宣贯会科室教学秘书用它带教新人理解“为什么这个药不能和那个检查一起开”质控人员用它快速验证某条路径变体是否仍符合支付政策。所有规则逻辑均来自预置模板肺炎、糖尿病、髋关节置换等6个病种全部基于国家卫健委路径文本、抗菌药物指导原则、医保分担比例公式等公开字段映射而来无黑箱推理无概率输出。规则引擎四大能力边界清晰 -互斥检查识别如“腹腔镜阑尾切除术中不可同时使用两种不同品牌止血夹”这类硬性冲突 -必选检查支持严格必选必须含血常规CRP、柔性必选至少选2项血糖监测方式、多选一头孢曲松或哌拉西林他唑巴坦三选一 -限价检查按病种设定总价上限如剖宫产¥12,000、耗材单项上限如支架¥35,000、医保报销后自付部分是否超限 -诊断匹配依据Allow/Disallow模式判定项目适配性例如冠心病介入治疗中仅允许使用药物洗脱支架禁止使用裸金属支架。这些能力不依赖外部服务全部在本地运行保障培训现场断网可用、规则响应毫秒级反馈。核心功能从模板到报告的完整闭环系统围绕“选择→构筑→检查→报告”四步形成教学闭环每步都针对培训场景做了针对性设计步骤关键动作教学价值选择模板点击预置病种卡片如“急性阑尾炎腹腔镜”查看规则详情弹窗快速建立病种路径认知锚点避免从零阅读冗长文本构筑卡组拖拽8类卡牌手术/检查/药品/耗材等进构筑区支持按科室、关键词、类型筛选将抽象路径条目转化为具象操作强化项目间关系感知合规检查卡组变动500ms后自动触发违规项高亮闪烁橘色脉冲角标标出error/warning/info等级实时暴露规则违反点比传统文档划线标注更直观、更可逆生成报告一键输出含卡组概览、违规详情表色标分级、卡牌清单违规行高亮、费用汇总的PDF提供可存档、可分发、可打印的教学交付物满足院内归档与考核要求特别地“假设分析模式”是培训利器点击「规则编辑」临时调高某项限价立即对比修改前后违规项变化帮助学员理解“为什么这条限价如此设置”。使用与配置开箱即用的三类入口无论你是想快速演示、批量校验还是嵌入工作流系统都提供对应入口Web界面适合现场教学访问 http://localhost:5173 即可使用全部交互功能CLI命令行适合批量处理或集成进自动化脚本无需启动浏览器REST API适合已有内部系统希望调用合规检查能力所有端点均经supertest验证。环境要求极简Node.js 18、npm 9。安装与启动只需三步cd pathway-deck npm install npm run dev启动后前端监听http://localhost:5173后端API监听http://localhost:3001开发服务器自动代理请求零配置即可开始使用。CLI常用命令如下全部支持--help命令用途示例npx pathway-deck template:list查看所有预置病种模板template:list --json输出结构化数据npx pathway-deck template:apply pneumonia -o ./my.json应用肺炎模板生成初始卡组文件支持指定输出路径npx pathway-deck deck:check ./my.json -t pneumonia对JSON卡组执行合规检查-j参数输出JSON结果供程序解析npx pathway-deck report:generate ./my.json -t pneumonia -o ./report.md生成Markdown格式合规摘要兼容WPS/Excel打开的CSV导出也已内置工程结构模块职责分明规则与界面解耦整个系统按关注点分离为五层每层职责明确、接口稳定层级模块职责说明类型定义src/types/index.ts全局数据契约MedicalItem原始诊疗项、Card可视化卡牌、Deck卡组、Template路径模板、ComplianceResult检查结果数据层src/core/medical-item-store.ts加载data/medical-items.json82条项目支持AND多条件过滤、去重分类统计规则层src/core/rule-engine/四个独立检查器互斥/必选/限价/诊断匹配 协调器orchestrator输入Deck与Template输出标准化Violation数组接口层src/api/routes/REST端点/api/cards查卡牌、/api/decks管卡组、/api/check跑检查、/api/templates读模板界面层src/frontend/components/所有UI组件Card带翻转动画、CardPool带分类Tab与搜索、DeckArea拖拽排序、RulePanel违规列表高亮联动、ComplianceReport全屏报告这种结构确保新增一个病种模板只需补充JSON文件增加一类检查规则只需实现checkXxx(deck, rules): Violation[]签名函数更换前端框架不影响规则引擎运行。数据与扩展真实字段驱动开放格式兼容所有业务数据均来自两个开放JSON文件 -data/medical-items.json82条诊疗项目覆盖呼吸内科、内分泌科、骨科等6科室每项含名称、类型、价格、医保类别、适用诊断等字段 -data/templates/目录下6个病种模板每个JSON明确定义必选项目列表、互斥组合数组、限价数值、Allow/Disallow诊断匹配规则。扩展方式透明 - 新增病种复制任一模板JSON修改病种名、规则数组、限价数值放入templates/目录即可被系统识别 - 补充诊疗项目在medical-items.json中追加对象字段结构与现有项一致 - 导出卡组点击「导出JSON」获得完整结构化数据含所有元信息 - 导出摘要「导出CSV」生成合规摘要表列含卡牌名、类型、价格、违规级别、违规代码直接导入Excel/WPS分析。所有数据格式、字段含义、扩展方法均在项目文档中有对照说明不设隐藏约定。限制与说明明确边界专注核心价值我们明确不覆盖以下场景以保障系统轻量、可靠、可解释 - 不接入HIS或EMR实时数据所有项目与规则均为静态JSON加载不依赖数据库或外部API - 不做自然语言理解拒绝“把这段医嘱转成卡组”类需求所有输入必须是结构化卡牌操作 - 不支持动态规则生成限价、互斥等规则必须预先定义在模板中不提供GUI规则编辑器 - 不处理患者个体差异系统校验的是路径层面的群体规则不涉及具体患者禁忌症、过敏史等个性化判断。这些限制不是能力缺失而是主动取舍正因放弃泛化才能做到规则100%可追溯、检查结果100%可复现、教学过程100%可回放。项目地址https://github.com/nexorin9/pathway-deck
