宠物医疗行业正处于设备智能化升级阶段，传统宠物医院使用的检测设备（化学发光、生化、血球等）多为本地单机运行，检测结果依赖人工抄录或U盘导出，存在数据易出错、报告出具慢、设备状态不可视、多院区数据无法互通等痛点。随着宠物主对诊疗质量要求提升，医院亟需一套能够将设备数据实时上传云端、自动生成专业报告、支持远程设备运维的统一管理平台。本项目旨在为宠物医疗检测设备提供端到端的云管理能力，覆盖设备接入、数据采集、报告生成、版本分发、多角色运营统计全链路，帮助设备厂商从纯硬件销售向“硬件+SaaS服务”模式转型。
平台围绕设备管理和检测数据闭环设计，主要包含以下功能模块：
1. 设备实时通信系统：基于WebSocket实现设备与云端双向实时通信，支持设备连接管理、心跳保活、上行数据实时接收、下行命令下发（软件升级、日志上传、参数配置等），单机支持千级以上设备并发连接。
2. 检测数据管理：支持化学发光、生化、血球等多种检测类型的数据采集与存储，样本数据完整记录宠物信息、宠主信息、试剂信息、检测结果及参考范围，支持增删改查与批量导出Excel。
3. 智能报告生成系统：根据检测项目数量自动选择报告模板（单项/多项），通过HTML模板引擎渲染报告内容，调用wkhtmltopdf将HTML转换为PDF，支持单份生成、批量合并PDF、批量导出ZIP压缩包，报告包含完整检测结果并自动标注高低异常。
4. 软件版本分发管理：支持固件/软件版本的上传、审核、发布、下发全生命周期管理，分发策略支持按设备型号、指定设备列表、全量设备等多种方式，设备上线自动检查并推送待更新版本，支持强制更新与普通更新两种模式。
5. 二维码分发管理：支持二维码内容的上传、审核、发布、下发流程，采用BoofCV和ZXing双引擎解析二维码内容，支持图像预处理增强识别率，可分发到指定医院或设备。
6. 运营统计看板：面向管理员、渠道商、销售、医院等多角色提供定制化数据看板，支持按省份、城市、渠道商、设备型号、检测项目等多维度数据统计分析，支持图表可视化展示与数据导出。
7. 售后热线管理：支持售后工单的自动/手动分配，根据工程师覆盖区域智能匹配，支持批量分配和取消分配。
8. 系统管理：包含用户管理（多角色RBAC权限）、渠道商管理、医院管理、设备管理、医生管理、安装记录管理、项目配置管理、系统日志管理等完整后台管理功能。
本人独立完成项目整体架构设计、技术选型与全栈开发。
技术栈：
- 后端：Java 17 + Spring Boot 2.7 + Spring Security + Spring Data JPA + WebSocket
- 前端：Vue 3 + Element Plus + Pinia + ECharts + Axios + Vite
- 中间件：Redis（数据队列缓冲/缓存）+ RabbitMQ（消息队列）
- 数据库：MySQL（主库）+ PostgreSQL（备库）+ 阿里云OSS（文件存储）
- 部署：Docker + Docker Compose + Nginx
- 其他：JWT认证、Swagger/OpenAPI、Caffeine本地缓存、Apache POI（Excel导出）、iText/wkhtmltopdf（PDF生成）、BoofCV/ZXing（二维码识别）
核心架构要点：
- WebSocket通信层设计Redis队列缓冲+批量消费机制，将高并发设备上行数据写入缓冲队列，消费者批量聚合后写入数据库，配合死信队列实现降级容错；同时使用Caffeine本地缓存+定时批量刷库策略解决大规模设备心跳带来的数据库写入压力。
- 报告生成采用分层设计：模板层（HTML模板）+ 渲染层（模板引擎）+ 转换层（wkhtmltopdf）+ 组装层（批量合并/导出），实现多模板灵活切换和大批量高效处理。
- 权限体系基于RBAC模型，通过Spring Security + JWT实现接口级权限控制，前端根据角色动态渲染菜单和按钮。
- 部署采用Docker Compose编排多容器服务，Nginx反向代理负载前端静态资源和后端API。
评论