1. 医院药品管理系统概述与核心需求医院药品管理系统是医疗机构信息化建设的重要组成部分它直接关系到药品流通安全、库存管理效率和医疗服务水平。传统的人工管理模式存在诸多弊端药品批次难以追踪、库存盘点效率低下、处方审核依赖人工经验等。我们基于SpringBoot框架开发的这套系统正是为了解决这些痛点而生。从技术架构来看系统采用B/S模式实现跨科室、跨岗位的协同工作。前端使用Thymeleaf模板引擎配合Bootstrap框架后端基于SpringBoot 2.7.3构建数据持久层采用MyBatis-Plus 3.5.1操作MySQL 8.0数据库。这种技术选型在保证系统稳定性的同时也兼顾了开发效率和后期维护成本。关键设计原则系统遵循四分开原则——药库与药房分开、门诊与住院分开、特殊药品与普通药品分开、中西药分开。这种设计既符合医疗机构管理规范又能实现精细化的权限控制。2. 系统架构设计与技术实现2.1 分层架构设计系统采用经典的三层架构但在实现上做了针对性优化表现层通过Spring MVC处理HTTP请求使用自定义注解实现接口权限校验业务层采用领域驱动设计(DDD)思想将药品管理拆分为库存、采购、处方等子域数据层利用MySQL事务特性保证数据一致性针对药品流水表做了分库分表设计// 典型的Controller层代码结构 RestController RequestMapping(/drug) RequiredArgsConstructor public class DrugController { private final DrugService drugService; PostMapping(/stock-in) PreAuthorize(hasRole(PHARMACIST)) public Result? stockIn(Valid RequestBody StockInDTO dto) { return Result.success(drugService.stockIn(dto)); } }2.2 数据库关键设计药品管理系统的数据库设计有几个需要特别注意的点药品主表(drug)包含批准文号、规格、剂型等23个字段建立了复合索引库存表(inventory)采用药品ID批次号作为联合主键记录效期和库存量处方明细表(prescription_detail)与收费系统关联包含用药频次、剂量等医嘱信息CREATE TABLE drug ( id bigint NOT NULL AUTO_INCREMENT, code varchar(20) COLLATE utf8mb4_bin NOT NULL COMMENT 药品编码, name varchar(100) COLLATE utf8mb4_bin NOT NULL, spec varchar(50) COLLATE utf8mb4_bin NOT NULL COMMENT 规格, unit varchar(10) COLLATE utf8mb4_bin NOT NULL COMMENT 单位, approval_no varchar(50) COLLATE utf8mb4_bin DEFAULT NULL COMMENT 批准文号, manufacturer varchar(200) COLLATE utf8mb4_bin DEFAULT NULL, category_id int DEFAULT NULL COMMENT 分类ID, type tinyint DEFAULT 1 COMMENT 1-西药 2-中药, status tinyint DEFAULT 1 COMMENT 1-启用 0-停用, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_code (code), KEY idx_category (category_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_bin;3. 核心业务模块实现3.1 药品库存管理库存管理采用双校验机制保证数据准确性入库时需扫描药品条形码与系统基础数据匹配出库时系统自动检查库存量并提示近效期药品每日定时生成库存预警报表低于安全库存或近效期实现库存扣减的Service层关键代码Transactional(rollbackFor Exception.class) public void deductStock(Long drugId, String batchNo, BigDecimal quantity) { // 悲观锁防止超卖 Inventory inventory inventoryMapper.selectForUpdate(drugId, batchNo); if(inventory null || inventory.getStock().compareTo(quantity) 0) { throw new BusinessException(库存不足); } inventory.setStock(inventory.getStock().subtract(quantity)); inventoryMapper.updateById(inventory); // 记录库存流水 InventoryFlow flow new InventoryFlow(); flow.setDrugId(drugId); flow.setBatchNo(batchNo); flow.setQuantity(quantity.negate()); flow.setType(OUTBOUND); flowMapper.insert(flow); }3.2 处方审核模块系统内置了基于规则的处方审核引擎剂量检查对比药品说明书的最大最小剂量配伍禁忌调用药品相互作用知识库过敏史检查对接患者健康档案系统特殊药品管控麻醉药品需双重审核审核流程的状态机实现public class PrescriptionStateMachine extends StateMachinePrescriptionStatus, PrescriptionEvent { public PrescriptionStateMachine() { super(PrescriptionStatus.INIT); addTransition(INIT, CHECKING, PrescriptionEvent.SUBMIT); addTransition(CHECKING, REJECTED, PrescriptionEvent.REJECT); addTransition(CHECKING, APPROVED, PrescriptionEvent.APPROVE); addTransition(APPROVED, DISPENSED, PrescriptionEvent.DISPENSE); addTransition(DISPENSED, COMPLETED, PrescriptionEvent.CONFIRM); } }4. 系统安全与性能优化4.1 安全控制措施基于Spring Security的RBAC模型细粒度到按钮级别敏感操作日志全记录包括修改前/后的数据快照药品价格变动需要财务科二次确认采用JWTRedis实现分布式会话管理安全配置示例Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/drug/**).hasAnyRole(PHARMACIST,ADMIN) .antMatchers(/prescription/approve).hasRole(CHIEF_PHARMACIST) .anyRequest().authenticated() .and() .addFilter(new JwtAuthenticationFilter(authenticationManager())) .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS); } }4.2 性能优化实践药品基础信息缓存使用Caffeine本地缓存Redis二级缓存库存查询优化建立覆盖索引对大表进行水平分片报表生成采用EasyExcel进行异步导出接口限流对收费接口使用Guava RateLimiter控制并发缓存配置示例Configuration EnableCaching public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineCacheManager manager new CaffeineCacheManager(); manager.setCaffeine(Caffeine.newBuilder() .initialCapacity(100) .maximumSize(1000) .expireAfterWrite(30, TimeUnit.MINUTES)); return manager; } }5. 部署与运维方案5.1 持续集成部署采用JenkinsDocker实现自动化部署流水线代码提交触发Git Hook执行Maven构建和单元测试使用SpotBugs进行静态代码分析构建Docker镜像推送到Harbor仓库通过Ansible滚动更新生产环境Jenkinsfile关键片段pipeline { agent any stages { stage(Build) { steps { sh mvn clean package -DskipTests } } stage(Test) { steps { sh mvn test junit **/target/surefire-reports/*.xml } } stage(Deploy) { steps { sh docker build -t drug-system . sh docker-compose up -d } } } }5.2 监控与告警使用SpringBoot Admin监控服务状态PrometheusGrafana实现指标可视化关键业务指标监控处方审核耗时、库存同步延迟等建立三级告警机制企业微信-短信-电话6. 开发中的典型问题与解决方案6.1 药品编码冲突问题初期采用自增ID导致多院区部署时编码冲突。最终解决方案编码规则院区号(2位)分类码(2位)序列号(6位)使用Redis原子操作生成序列号建立编码映射表处理历史数据6.2 高并发库存扣减在促销活动期间出现的超卖问题解决方案采用SELECT FOR UPDATE悲观锁引入Redis分布式锁作为二级防护数据库层设置库存字段无符号校验6.3 大数据量导出OOM处理百万级药品流水导出时的内存溢出采用MyBatis流式查询使用EasyExcel的分段写入机制增加服务器内存并调整JVM参数public void exportDrugFlow(HttpServletResponse response) { // 流式查询 MyBatisCursorItemReaderDrugFlow reader new MyBatisCursorItemReader(); reader.setSqlSessionFactory(sqlSessionFactory); reader.setQueryId(com.example.mapper.DrugFlowMapper.selectForExport); // 分段写入Excel ExcelWriter excelWriter EasyExcel.write(response.getOutputStream()) .head(DrugFlowExportVO.class) .build(); int pageSize 1000; ListDrugFlowExportVO data new ArrayList(pageSize); DrugFlow flow; while ((flow reader.read()) ! null) { data.add(convertToVO(flow)); if (data.size() pageSize) { excelWriter.write(data, EasyExcel.writerSheet(药品流水).build()); data.clear(); } } if (!data.isEmpty()) { excelWriter.write(data); } excelWriter.finish(); }7. 项目演进方向在实际运行过程中我们发现系统还可以在以下方面进行增强智能预警基于历史数据预测药品需求提前生成采购计划移动端支持开发小程序实现药品扫码快速入库医保对接与医保系统深度对接实现实时报销计算冷链监控接入温湿度传感器实现特殊药品运输监控这个项目的完整实现涉及120多个功能点开发周期约6个月。技术选型上SpringBoot展现了极大的优势其自动配置特性让我们能快速集成各种中间件而丰富的Starter库则简化了技术组件的接入过程。特别是在与医院HIS系统对接时Spring Integration提供的通道机制大大降低了系统耦合度。
1. 医院药品管理系统概述与核心需求医院药品管理系统是医疗机构信息化建设的重要组成部分它直接关系到药品流通安全、库存管理效率和医疗服务水平。传统的人工管理模式存在诸多弊端药品批次难以追踪、库存盘点效率低下、处方审核依赖人工经验等。我们基于SpringBoot框架开发的这套系统正是为了解决这些痛点而生。从技术架构来看系统采用B/S模式实现跨科室、跨岗位的协同工作。前端使用Thymeleaf模板引擎配合Bootstrap框架后端基于SpringBoot 2.7.3构建数据持久层采用MyBatis-Plus 3.5.1操作MySQL 8.0数据库。这种技术选型在保证系统稳定性的同时也兼顾了开发效率和后期维护成本。关键设计原则系统遵循四分开原则——药库与药房分开、门诊与住院分开、特殊药品与普通药品分开、中西药分开。这种设计既符合医疗机构管理规范又能实现精细化的权限控制。2. 系统架构设计与技术实现2.1 分层架构设计系统采用经典的三层架构但在实现上做了针对性优化表现层通过Spring MVC处理HTTP请求使用自定义注解实现接口权限校验业务层采用领域驱动设计(DDD)思想将药品管理拆分为库存、采购、处方等子域数据层利用MySQL事务特性保证数据一致性针对药品流水表做了分库分表设计// 典型的Controller层代码结构 RestController RequestMapping(/drug) RequiredArgsConstructor public class DrugController { private final DrugService drugService; PostMapping(/stock-in) PreAuthorize(hasRole(PHARMACIST)) public Result? stockIn(Valid RequestBody StockInDTO dto) { return Result.success(drugService.stockIn(dto)); } }2.2 数据库关键设计药品管理系统的数据库设计有几个需要特别注意的点药品主表(drug)包含批准文号、规格、剂型等23个字段建立了复合索引库存表(inventory)采用药品ID批次号作为联合主键记录效期和库存量处方明细表(prescription_detail)与收费系统关联包含用药频次、剂量等医嘱信息CREATE TABLE drug ( id bigint NOT NULL AUTO_INCREMENT, code varchar(20) COLLATE utf8mb4_bin NOT NULL COMMENT 药品编码, name varchar(100) COLLATE utf8mb4_bin NOT NULL, spec varchar(50) COLLATE utf8mb4_bin NOT NULL COMMENT 规格, unit varchar(10) COLLATE utf8mb4_bin NOT NULL COMMENT 单位, approval_no varchar(50) COLLATE utf8mb4_bin DEFAULT NULL COMMENT 批准文号, manufacturer varchar(200) COLLATE utf8mb4_bin DEFAULT NULL, category_id int DEFAULT NULL COMMENT 分类ID, type tinyint DEFAULT 1 COMMENT 1-西药 2-中药, status tinyint DEFAULT 1 COMMENT 1-启用 0-停用, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_code (code), KEY idx_category (category_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_bin;3. 核心业务模块实现3.1 药品库存管理库存管理采用双校验机制保证数据准确性入库时需扫描药品条形码与系统基础数据匹配出库时系统自动检查库存量并提示近效期药品每日定时生成库存预警报表低于安全库存或近效期实现库存扣减的Service层关键代码Transactional(rollbackFor Exception.class) public void deductStock(Long drugId, String batchNo, BigDecimal quantity) { // 悲观锁防止超卖 Inventory inventory inventoryMapper.selectForUpdate(drugId, batchNo); if(inventory null || inventory.getStock().compareTo(quantity) 0) { throw new BusinessException(库存不足); } inventory.setStock(inventory.getStock().subtract(quantity)); inventoryMapper.updateById(inventory); // 记录库存流水 InventoryFlow flow new InventoryFlow(); flow.setDrugId(drugId); flow.setBatchNo(batchNo); flow.setQuantity(quantity.negate()); flow.setType(OUTBOUND); flowMapper.insert(flow); }3.2 处方审核模块系统内置了基于规则的处方审核引擎剂量检查对比药品说明书的最大最小剂量配伍禁忌调用药品相互作用知识库过敏史检查对接患者健康档案系统特殊药品管控麻醉药品需双重审核审核流程的状态机实现public class PrescriptionStateMachine extends StateMachinePrescriptionStatus, PrescriptionEvent { public PrescriptionStateMachine() { super(PrescriptionStatus.INIT); addTransition(INIT, CHECKING, PrescriptionEvent.SUBMIT); addTransition(CHECKING, REJECTED, PrescriptionEvent.REJECT); addTransition(CHECKING, APPROVED, PrescriptionEvent.APPROVE); addTransition(APPROVED, DISPENSED, PrescriptionEvent.DISPENSE); addTransition(DISPENSED, COMPLETED, PrescriptionEvent.CONFIRM); } }4. 系统安全与性能优化4.1 安全控制措施基于Spring Security的RBAC模型细粒度到按钮级别敏感操作日志全记录包括修改前/后的数据快照药品价格变动需要财务科二次确认采用JWTRedis实现分布式会话管理安全配置示例Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/drug/**).hasAnyRole(PHARMACIST,ADMIN) .antMatchers(/prescription/approve).hasRole(CHIEF_PHARMACIST) .anyRequest().authenticated() .and() .addFilter(new JwtAuthenticationFilter(authenticationManager())) .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS); } }4.2 性能优化实践药品基础信息缓存使用Caffeine本地缓存Redis二级缓存库存查询优化建立覆盖索引对大表进行水平分片报表生成采用EasyExcel进行异步导出接口限流对收费接口使用Guava RateLimiter控制并发缓存配置示例Configuration EnableCaching public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineCacheManager manager new CaffeineCacheManager(); manager.setCaffeine(Caffeine.newBuilder() .initialCapacity(100) .maximumSize(1000) .expireAfterWrite(30, TimeUnit.MINUTES)); return manager; } }5. 部署与运维方案5.1 持续集成部署采用JenkinsDocker实现自动化部署流水线代码提交触发Git Hook执行Maven构建和单元测试使用SpotBugs进行静态代码分析构建Docker镜像推送到Harbor仓库通过Ansible滚动更新生产环境Jenkinsfile关键片段pipeline { agent any stages { stage(Build) { steps { sh mvn clean package -DskipTests } } stage(Test) { steps { sh mvn test junit **/target/surefire-reports/*.xml } } stage(Deploy) { steps { sh docker build -t drug-system . sh docker-compose up -d } } } }5.2 监控与告警使用SpringBoot Admin监控服务状态PrometheusGrafana实现指标可视化关键业务指标监控处方审核耗时、库存同步延迟等建立三级告警机制企业微信-短信-电话6. 开发中的典型问题与解决方案6.1 药品编码冲突问题初期采用自增ID导致多院区部署时编码冲突。最终解决方案编码规则院区号(2位)分类码(2位)序列号(6位)使用Redis原子操作生成序列号建立编码映射表处理历史数据6.2 高并发库存扣减在促销活动期间出现的超卖问题解决方案采用SELECT FOR UPDATE悲观锁引入Redis分布式锁作为二级防护数据库层设置库存字段无符号校验6.3 大数据量导出OOM处理百万级药品流水导出时的内存溢出采用MyBatis流式查询使用EasyExcel的分段写入机制增加服务器内存并调整JVM参数public void exportDrugFlow(HttpServletResponse response) { // 流式查询 MyBatisCursorItemReaderDrugFlow reader new MyBatisCursorItemReader(); reader.setSqlSessionFactory(sqlSessionFactory); reader.setQueryId(com.example.mapper.DrugFlowMapper.selectForExport); // 分段写入Excel ExcelWriter excelWriter EasyExcel.write(response.getOutputStream()) .head(DrugFlowExportVO.class) .build(); int pageSize 1000; ListDrugFlowExportVO data new ArrayList(pageSize); DrugFlow flow; while ((flow reader.read()) ! null) { data.add(convertToVO(flow)); if (data.size() pageSize) { excelWriter.write(data, EasyExcel.writerSheet(药品流水).build()); data.clear(); } } if (!data.isEmpty()) { excelWriter.write(data); } excelWriter.finish(); }7. 项目演进方向在实际运行过程中我们发现系统还可以在以下方面进行增强智能预警基于历史数据预测药品需求提前生成采购计划移动端支持开发小程序实现药品扫码快速入库医保对接与医保系统深度对接实现实时报销计算冷链监控接入温湿度传感器实现特殊药品运输监控这个项目的完整实现涉及120多个功能点开发周期约6个月。技术选型上SpringBoot展现了极大的优势其自动配置特性让我们能快速集成各种中间件而丰富的Starter库则简化了技术组件的接入过程。特别是在与医院HIS系统对接时Spring Integration提供的通道机制大大降低了系统耦合度。
