夜雨聆风在医院日常管理中，病区质量控制指标长期依赖纸质台账、Excel 表格或后台系统报表。数据更新滞后、查看路径繁琐、异常响应不及时，导致“重填报、轻整改”“有指标、无盯控”的现象普遍存在。而一线护士长和质控科人员真正需要的，不是一份静态报告，而是一块始终亮着的屏幕，上面跳动着手卫生依从率、压疮发生率、跌倒次数、导管相关感染率等核心指标，红黄绿三色直观标识状态，趋势箭头一目了然，超标即弹窗提醒。这就是「病区质控指标实时白板展示系统」诞生的出发点：把分散的数据变成护士站墙上的战情室，让质量管理从“事后翻查”走向“实时感知”。
项目概述：轻量、开源、即装即用的临床质控可视化工具
病区质控指标实时白板展示系统是一个面向医院护理与质控场景的开源前端+后端一体化应用。它不依赖复杂HIS或EMR系统集成，无需数据库部署，采用内存模拟数据起步，支持快速验证与本地演示；同时具备完整的生产级部署能力，可运行于树莓派、Docker容器或通用Linux服务器，最终通过LCD大屏、电视或投影仪呈现。
系统以「指标卡片」为基本单元，每个卡片包含三项核心信息：当前数值、红黄绿状态标识、趋势箭头（↑下降、↓上升、→平稳），并内置30日迷你折线图，帮助判断短期波动是否属于趋势性变化。全界面专为远距离观看优化，支持1920×1080分辨率下的大字模式，3至5米外清晰可读；支持F键一键全屏，适配TV及会议白板场景。
整个系统完全开源，MIT协议，代码结构清晰，无前端框架依赖，便于二次开发与定制化适配。它不是替代专业质控系统的庞大数据平台，而是填补“最后一公里”感知空白的轻量级工具，让关键指标真正走到一线管理者眼前。
技术亮点：简洁架构支撑可靠交付
该项目的技术选型兼顾开发效率、运行稳定与部署灵活，体现出对医疗边缘计算场景的精准理解。
零前端框架依赖前端全部使用原生 HTML/CSS/JavaScript 实现，不引入 Vue、React 等大型框架。这意味着启动快、体积小、兼容性强，尤其适合树莓派等资源受限设备运行，也大幅降低学习与维护门槛。
Node.js + Express 构建稳健后端服务后端基于 Node.js 生态中最成熟的 Web 框架 Express，提供标准化 RESTful API 接口。路由设计清晰，涵盖指标获取、科室列表、历史数据查询、告警管理等完整能力，且全部接口支持参数过滤，例如
/api/metrics?dept=ICU&status=red可直接筛选出 ICU 病区红色预警指标。多环境部署方案全覆盖项目提供三种主流部署方式：树莓派裸机部署、Docker 容器化部署、以及 PM2 进程守护的生产服务器部署。其中 Docker 方案尤为推荐，仅需一条
docker-compose up -d命令即可完成服务启动与环境隔离，.env配置文件统一管理刷新频率、端口、告警阈值等关键参数，避免硬编码风险。内存数据 + 模拟生成机制保障开箱即用默认使用内存存储与定时模拟数据生成器，无需配置数据库即可运行。开发者可快速验证 UI 效果与交互逻辑；医院信息科在接入真实数据源前，也能先用模拟数据培训护士长熟悉看板操作流程。
API 设计规范，便于未来对接真实系统所有数据接口均遵循 REST 风格，返回标准 JSON 格式。当医院具备对接条件时，只需替换
src/data/目录下的数据模块，将模拟函数改为调用院内 API 或数据库查询，即可平滑过渡到真实业务数据驱动。
应用场景：可用于多种医院质控与护理管理环节
该系统并非通用大屏平台，而是聚焦于临床一线高频、高敏的质量监控需求，适合以下典型场景：
护士站墙面白板在各病区护士站安装一台树莓派连接LCD屏幕，常驻显示本病区核心质控指标。护士长每日晨会前扫一眼，即可掌握手卫生依从率是否下滑、近3日跌倒事件是否集中发生，实现“抬头就管”。
质控科集中监控大屏质控科办公室部署一台高性能主机，通过科室下拉菜单切换查看全院所有病区指标，点击任意卡片进入30日趋势分析页，辅助识别共性问题与薄弱环节。
院内质量改进项目看板针对手卫生专项提升、压疮预防攻坚等阶段性任务，可临时启用该系统作为项目进度可视化工具，将改善目标、当前值、达标状态实时投射，增强团队目标感与紧迫感。
新入职护士质控意识培养工具在示教室或培训室部署，配合讲解各指标含义与临床意义，让年轻护士直观理解“为什么手卫生依从率要≥95%”“压疮发生率升高意味着什么”，推动质量文化落地。
需要注意的是，系统当前默认使用模拟数据，如需接入真实业务系统，需由医院信息科或第三方开发商基于其 API 或数据库进行适配开发。项目本身不提供数据采集硬件或院内系统对接服务，但提供了清晰的扩展入口与文档指引。
使用指南：从本地试跑到生产上线
快速体验（开发模式）
适合开发者或信息科技术人员快速上手验证功能：
git clone https://github.com/nexorin9/ward-qc-whiteboardcd ward-qc-whiteboardnpm installnpm run dev打开浏览器访问 http://localhost:3000，即可看到默认模拟数据驱动的白板界面。
树莓派部署（边缘终端首选）
适用于病区护士站等空间有限、功耗敏感场景：
# 登录树莓派（建议使用 Raspberry Pi OS 64-bit）git clone https://github.com/nexorin9/ward-qc-whiteboardcd ward-qc-whiteboardnpm install --productionnpm start建议配合 raspi-config 设置开机自启，并将浏览器设为kiosk模式自动全屏加载页面。
Docker 容器化部署（推荐用于测试与准生产环境）
# 复制环境配置cp .env.example .env# 编辑 .env 修改 PORT、REFRESH_INTERVAL 等参数nano .env# 启动服务docker-compose up -d服务启动后，可通过宿主机IP加端口（如 http://192.168.1.100:3000）访问。docker-compose logs -f 可实时跟踪运行日志，便于排查问题。
生产环境部署（虚拟机/物理服务器）
推荐使用 PM2 进行进程管理，确保服务长期稳定运行：
npm install -g pm2cp .env.production .envpm2 start src/index.js --name ward-qc-whiteboardpm2 savepm2 startup如需通过域名访问，建议搭配 Nginx 反向代理。项目文档中已提供完整 Nginx 配置示例，支持 WebSocket 升级，确保告警弹窗实时推送不中断。
总结：小工具，大价值；开源不等于简陋
病区质控指标实时白板展示系统证明了一件事：真正解决临床痛点的工具，未必需要庞大架构与复杂集成。它用极简技术栈实现了高可用性、强可读性与易部署性，在“数据可见性”这一关键维度上补上了重要一环。红黄绿状态标识不只是视觉装饰，而是将抽象指标转化为管理语言；30日趋势图不是炫技组件，而是帮助区分偶发异常与系统性风险的决策依据；10秒自动刷新不是性能堆砌，而是让“实时”二字落在每一次刷新的毫秒之间。
项目保持高度开放性：所有代码公开、文档详尽、部署路径明确、扩展接口清晰。无论是基层医院信息科自主部署，还是区域医联体统一建设质控看板体系，它都可作为起点，而非终点。
项目当前免费开源，若您对项目有疑问、使用上的困惑或想深入交流，欢迎私信我们，或加入社群讨论。
项目地址：https://github.com/nexorin9/ward-qc-whiteboard
