1. 项目背景与核心需求乡镇卫生所作为基层医疗服务的重要节点其医用物资管理一直面临着诸多痛点。我在实地调研中发现许多乡镇卫生所仍在使用纸质台账记录物资进出不仅效率低下还容易出现人为差错。某次走访时亲眼目睹护士长翻找半小时才确认某批次纱布的库存情况这种场景促使我决心开发这套系统。医用物资进销存系统需要解决三个核心问题实时库存可视化避免因库存不清导致的临床物资短缺效期智能预警对近效期药品自动提醒减少过期浪费多维度统计分析为采购决策提供数据支持优化资金使用效率2. 技术选型与架构设计2.1 前后端分离架构优势采用SpringBootVue的分离架构主要基于以下考量迭代效率前端可独立部署更新不影响后端服务性能优化静态资源由Nginx直接分发减轻应用服务器压力团队协作前后端开发人员可并行工作通过API文档对接实践建议使用Swagger UI自动生成API文档我在项目中配置了knife4j增强版调试效率提升40%2.2 后端技术栈详解2.2.1 SpringBoot关键配置# 应用配置示例 spring: datasource: url: jdbc:mysql://localhost:3306/medical_inventory?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 加密密码建议使用Jasypt redis: host: 127.0.0.1 port: 6379 password:2.2.2 缓存策略设计采用多级缓存架构本地Caffeine缓存高频访问的物资基础信息Redis缓存库存变动记录和效期数据MySQL持久化所有业务数据缓存更新采用先删后更策略避免脏读问题。实测显示该方案使库存查询响应时间从800ms降至120ms。2.3 前端工程化实践2.3.1 Vue项目结构优化src/ ├── api/ # 接口统一管理 ├── assets/ # 静态资源 ├── components/ # 业务组件 │ ├── inventory/ │ │ ├── StockWarning.vue # 效期预警组件 │ │ └── RealtimeChart.vue # 实时库存图表 ├── router/ # 动态路由 └── store/ # Vuex状态管理2.3.2 性能优化要点使用Vue异步组件实现路由懒加载采用keep-alive缓存高频访问页面对Element UI按需引入打包体积减少65%3. 核心功能实现细节3.1 智能预警模块3.1.1 效期计算算法// 效期预警核心逻辑 public ListMaterial checkExpiryWarning(LocalDate checkDate) { return materialMapper.selectList(new QueryWrapperMaterial() .le(expiry_date, checkDate.plusMonths(3)) // 3个月内到期 .eq(is_deleted, 0)); }3.1.2 预警推送机制定时任务每天8:00扫描近效期物资实时检测每次入库操作后触发检查推送方式站内消息短信提醒集成阿里云短信服务3.2 库存管理设计3.2.1 并发控制方案采用乐观锁解决库存超卖问题Transactional public boolean reduceStock(Long materialId, Integer quantity) { Material material materialMapper.selectById(materialId); if (material.getStock() quantity) { throw new BusinessException(库存不足); } int rows materialMapper.updateStock(materialId, quantity, material.getVersion()); return rows 0; }3.2.2 批次管理实现每个入库批次记录生产批号生产日期有效期至供应商信息入库人员支持先进先出FIFO出库策略通过SQL实现SELECT * FROM material_batch WHERE material_id #{materialId} AND stock 0 ORDER BY production_date ASC FOR UPDATE4. 系统安全与稳定性保障4.1 安全防护措施4.1.1 权限控制矩阵角色物资查看入库操作出库操作报表导出管理员✓✓✓✓药剂师✓✓✓✗护士长✓✗✓✗4.1.2 审计日志设计记录关键操作操作时间操作人员IP地址操作类型业务数据快照使用AOP统一处理AfterReturning(pointcut annotation(operLog), returning result) public void afterReturning(JoinPoint joinPoint, OperLog operLog, Object result) { // 记录操作日志逻辑 }4.2 高可用方案4.2.1 数据库备份策略每日全量备份23:00每小时增量备份备份文件自动上传至OSS4.2.2 服务降级方案当Redis不可用时自动切换本地缓存关键查询走数据库非关键功能暂时禁用5. 部署与运维实践5.1 容器化部署使用Docker Compose编排服务version: 3 services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} volumes: - ./mysql/data:/var/lib/mysql - ./mysql/conf:/etc/mysql/conf.d redis: image: redis:6 ports: - 6379:6379 volumes: - ./redis/data:/data app: build: . ports: - 8080:8080 depends_on: - mysql - redis5.2 监控方案Spring Boot Actuator暴露健康指标Prometheus收集性能数据Grafana展示监控仪表盘异常告警通过Webhook通知钉钉群6. 典型问题排查实录6.1 库存不同步问题现象前台显示有库存但出库时报库存不足排查过程检查Redis与MySQL数据一致性发现本地缓存未及时失效追踪到CacheEvict注解未生效解决方案在事务提交后手动清除缓存Transactional public void updateStock(...) { // 业务逻辑 TransactionSynchronizationManager.registerSynchronization( new TransactionSynchronization() { Override public void afterCommit() { cacheManager.evict(material, id); } }); }6.2 效期预警漏报现象部分近效期药品未触发预警原因分析发现时区配置错误导致日期计算偏差MySQL的time_zone与系统不一致修复方案-- 统一设置时区 SET GLOBAL time_zone 8:00;7. 项目优化方向移动端适配开发微信小程序版本支持扫码盘点智能采购预测基于历史消耗数据训练预测模型物联网集成对接智能药柜实现自动库存同步多机构协同支持乡镇卫生院与上级医院物资调配在实际部署过程中我们发现乡镇卫生所的网络条件差异较大。针对网络不稳定的卫生所特别开发了离线模式本地缓存关键数据网络恢复后自动同步。这个改进使系统在偏远地区的可用性从75%提升至98%。
