立项背景:中小型中医馆长期面临药材库存管理混乱、处方流转依赖纸质、抓药效率低易出错等痛点,缺少一体化的数字化运营工具。慧医阁即为解决此类场景而设计,面向系统管理员、医师、药师、库管员四类角色,实现从挂号接诊、开具处方、处方审核、抓药调配到煎药交付的全链路数字化闭环。
核心功能模块:
基础数据管理:药材信息维护、供应商管理、处方模板、治疗项目配置(中药/针灸/推拿/拔罐等 7 大类)、疗程管理、药柜布局配置
库存管理:采购入库(含 Flowable 审批流)、库存查询、库存盘点、退货管理、效期预警(近效期药材自动提醒)、库存预警(低库存阈值告警)、库存流水全量追踪
工作台:患者管理(含过敏史、既往病史档案)、挂号登记、处方管理(开具→药师审核→发药三阶段流转)、处方记录追溯、煎药管理
药柜可视化:上传药柜实拍照片 → AI 自动识别药材位置 → 自动匹配药格编号 → 处方调配时高亮引导目标药格,大幅降低抓药差错率
数据处理:处方提交时自动触发配伍检测规则引擎,校验十八反十九畏等禁忌组合并实时预警;支持标准处方笺格式打印
数据统计:库存、销售、处方、患者四维统计看板
业务流程:患者挂号 → 医师接诊开具处方 → 系统自动配伍检测 → 药师审核处方 → 药柜高亮引导抓药 → 发药/煎药 → 库存自动扣减与流水记录。
整体架构:基于芋道企业级快速开发平台(Spring Boot 3.5 单体架构)进行二次开发。后端分层为 Controller → Service → Mapper,集成 Spring Security + JWT 鉴权、Flowable 工作流引擎驱动采购审批、Redisson 分布式锁保障库存扣减幂等、Quartz 处理效期定时巡检。前端采用 Vue 3 + Vben5 Admin(Ant Design Vue)+ TypeScript,桌面端通过 Electron 打包为 Windows 原生客户端,实现离线可用与本地打印能力。
本人负责模块:独立负责核心业务模块 yudao-module-clinic 的全部开发工作,包括 6 大功能域(药材/库存/患者/处方/药柜/统计)的后端 Controller、Service、Mapper 编码及前端 Vue 页面开发,涉及约 30+ 个业务接口和 20+ 个管理页面。系统支持多租户模式,可同时服务多家中医馆。
技术难点与解决方案:
药柜 AI 识别与高亮引导:药柜照片中药材位置不规则、光照不均。方案:对接 AI 视觉识别接口解析药材坐标,将识别结果与药格编号建立映射关系存入数据库,前端基于处方明细动态渲染高亮覆盖层,引导药师按序抓药。
库存并发扣减:多药师同时发药可能超卖。方案:引入 Redisson 分布式锁对库存扣减操作加锁,结合数据库行级锁双重保障,确保并发场景下库存数据一致性。
配伍检测规则引擎:药材配伍禁忌规则复杂(十八反、十九畏等数十条规则)。方案:将配伍规则抽象为可配置的规则表,处方提交时遍历药材组合逐条匹配,命中则返回具体禁忌说明与警示级别。