药房管理系统毕业设计：从需求分析到高内聚低耦合架构的完整实现

最近在帮学弟学妹们看毕业设计发现“药房管理系统”是个热门选题但很多项目都卡在了“功能实现了但代码一团糟”的尴尬境地。今天我就结合自己的经验从技术科普的角度聊聊如何把一个药房管理系统从零开始做成一个结构清晰、可维护、符合工程规范的毕业设计。1. 毕业设计常见痛点为什么你的系统“跑不起来”很多同学一开始就急着写代码忽略了设计导致后期问题频出。以下几个坑看看你踩过没有模块耦合严重药品管理、销售、库存的代码你中有我我中有你。想改一下销售逻辑可能不小心把库存扣减的规则也破坏了。这种“牵一发而动全身”的代码维护起来简直是噩梦。权限控制形同虚设很多系统只在登录时做个简单判断后台接口几乎没有防护。药剂师能操作财务结算实习生能删除药品记录这在实际应用中是完全不可接受的。库存“超卖”问题这是最经典的并发问题。当多个顾客同时购买最后一件商品时如果没有正确处理库存可能会变成负数。你的系统是否经得起“双十一”式的并发考验数据一致性差比如一个销售操作需要同时更新“销售记录表”和“药品库存表”。如果更新库存时失败销售记录却已经生成就会导致数据对不上。代码风格混乱一个方法几百行没有注释变量名用拼音缩写异常随处抛却从不处理。这样的代码别说答辩老师自己过两个月再看也看不懂。2. 技术选型Spring Boot 还是 Django这是很多同学纠结的第一步。两者都是优秀的快速开发框架但侧重点不同。Java Spring Boot MyBatis 组合优势生态极其庞大企业级应用首选。Spring 的 IOC控制反转和 AOP面向切面编程思想能帮你天然地构建出低耦合的架构。事务管理Transactional功能强大且声明式使用简单。MyBatis 灵活对复杂 SQL 掌控力强。适用场景项目复杂度较高需要精细化的事务控制和权限管理你希望代码结构非常清晰、规范并且未来有扩展为大型系统的可能。学习曲线相对较陡需要理解 Spring 的核心概念。Python Django DRF (Django REST Framework) 组合优势“开箱即用”自带强大的 Admin 后台、ORM 和用户认证系统。DRF 能让你快速构建出规范的 RESTful API。开发速度极快适合快速原型验证。适用场景希望快速实现核心业务逻辑对开发效率要求极高项目规模中等或者你更熟悉 Python 生态。学习曲线相对平缓更容易上手。如何选择如果你的目标是深入学习企业级后端开发规范锻炼工程化思维强烈推荐 Spring Boot。它能逼着你思考分层、解耦和设计模式。如果时间紧、任务重想快速出成果Django 是更友好的选择。下文我们将以Spring Boot为例进行讲解。3. 核心模块设计与Clean Code实践我们采用领域驱动设计DDD的简化思想按业务职能划分模块而不是按技术分层Controller, Service, Dao。例如我们可以划分出medicine药品、prescription处方、sale销售、inventory库存等核心领域包。以“药品销售”这个核心用例为例看看如何写出健壮的代码// 在 SaleService 中 Service Transactional(rollbackFor Exception.class) // 关键1声明式事务任何异常都回滚 Slf4j public class SaleService { Autowired private MedicineRepository medicineRepository; Autowired private InventoryService inventoryService; Autowired private SaleRecordRepository saleRecordRepository; /** * 创建销售记录包含库存扣减 * param request 销售请求DTO包含药品ID、数量等 * return 销售记录ID * throws BusinessException 当库存不足、药品不存在时抛出 */ public Long createSale(SaleCreateRequest request) throws BusinessException { // 关键2参数校验前置使用Spring Validation或手动校验 if (request null || request.getMedicineId() null || request.getQuantity() 0) { log.warn(销售请求参数无效: {}, request); throw new IllegalArgumentException(无效的销售请求参数); } // 关键3业务逻辑清晰分步每一步都有明确含义 // 1. 获取药品信息并加锁防止超卖 Medicine medicine medicineRepository.findByIdWithLock(request.getMedicineId()) .orElseThrow(() - new BusinessException(药品不存在)); // 2. 扣减库存核心防超卖逻辑在InventoryService内 inventoryService.reduceStock(medicine.getId(), request.getQuantity()); // 3. 创建销售记录 SaleRecord record new SaleRecord(); record.setMedicineId(medicine.getId()); record.setMedicineName(medicine.getName()); record.setQuantity(request.getQuantity()); record.setUnitPrice(medicine.getPrice()); record.setTotalAmount(medicine.getPrice().multiply(BigDecimal.valueOf(request.getQuantity()))); record.setCreateTime(LocalDateTime.now()); SaleRecord savedRecord saleRecordRepository.save(record); log.info(销售记录创建成功ID: {}, 药品: {}, 数量: {}, savedRecord.getId(), medicine.getName(), request.getQuantity()); // 关键4返回明确的结果 return savedRecord.getId(); } } // InventoryService 中的扣减库存方法 Service public class InventoryService { Autowired private InventoryRepository inventoryRepository; public void reduceStock(Long medicineId, Integer quantity) throws BusinessException { // 使用数据库悲观锁SELECT ... FOR UPDATE或乐观锁版本号控制 Inventory inventory inventoryRepository.findByMedicineIdForUpdate(medicineId); // 悲观锁示例 if (inventory.getCurrentStock() quantity) { throw new BusinessException(药品库存不足); } inventory.setCurrentStock(inventory.getCurrentStock() - quantity); inventoryRepository.save(inventory); // 更新库存 } }处方审核流转模块的关键点设计一个状态机如DRAFT(草稿)、PHARMACIST_REVIEW(药师审核)、DOCTOR_CONFIRM(医生确认)、DISPENSED(已发药)、REJECTED(已拒绝)使用枚举来管理状态。审核时不仅要检查权限是否是药师角色还要校验状态流转是否合法比如不能从“已拒绝”直接跳到“已发药”。4. 安全与性能让系统更可靠安全性考量防SQL注入坚持使用 MyBatis 的#{}预编译占位符绝对不要用字符串拼接 SQL${}慎用。RBAC权限模型实现基于角色的访问控制。为用户分配角色如ADMIN,PHARMACIST,CASHIER为角色分配接口访问权限sale:create,medicine:delete。在拦截器或过滤器中校验每个请求的权限。Spring Security 是完成这项任务的利器。输入校验与输出脱敏所有 API 入参都要校验使用Valid和NotBlank等注解。返回给前端的敏感信息如用户手机号、身份证号要进行脱敏处理如138****1234。会话安全使用 JWT Token 或 Session 管理登录状态设置合理的过期时间。密码必须加盐哈希存储使用 BCrypt。性能优化Redis缓存热点数据将经常被查询、很少变动的数据放入缓存如药品分类字典、热门药品信息。Service public class MedicineService { Autowired private RedisTemplateString, MedicineInfoDTO redisTemplate; private static final String CACHE_KEY_PREFIX “medicine:info:”; public MedicineInfoDTO getMedicineInfo(Long id) { String cacheKey CACHE_KEY_PREFIX id; // 1. 先查缓存 MedicineInfoDTO cachedInfo redisTemplate.opsForValue().get(cacheKey); if (cachedInfo ! null) { return cachedInfo; } // 2. 缓存未命中查数据库 MedicineInfoDTO dbInfo medicineRepository.findDetailById(id); if (dbInfo ! null) { // 3. 写入缓存设置过期时间如5分钟 redisTemplate.opsForValue().set(cacheKey, dbInfo, 5, TimeUnit.MINUTES); } return dbInfo; } // 当药品信息更新时记得删除或更新对应缓存 }数据库索引优化在medicine表的name药品名、category_id分类ID上建立索引在sale_record表的create_time销售时间上建立索引能极大提升查询效率。避免N1查询问题在 MyBatis 中使用collection或association进行关联查询或者使用EntityGraphJPA一次性拉取所需数据而不是在循环中频繁查询数据库。5. 生产环境避坑指南毕业设计也要有“工程味”数据库字段命名规范统一使用小写蛇形命名法如medicine_name,current_stock。表名用复数如medicines。建立created_at,updated_at字段记录时间戳。日志规范使用 SLF4J Logback。区分INFO,WARN,ERROR级别。记录关键业务操作如“用户登录”、“药品入库”、“销售创建”并务必对日志中的用户手机号、身份证号进行脱敏。统一的异常处理定义业务异常类如BusinessException并利用 Spring 的ControllerAdvice编写全局异常处理器将异常转换为友好的 JSON 格式返回给前端。接口文档使用 Swagger 或 Knife4j 自动生成 API 文档这是你项目专业度的重要体现。单元测试为你的核心 Service 方法编写单元测试使用 JUnit Mockito这不仅能验证逻辑也是对你代码可测试性即低耦合的检验。总结与思考通过以上步骤你应该能搭建出一个结构清晰、功能完整、安全可靠的药房管理系统核心后端。这不仅仅是一个毕业设计更是一次完整的软件工程实践。最后留一个思考题如何将这个单体的药房管理系统扩展为一个支持多门店、多租户的SaaS软件即服务架构你可以从这几个方向入手数据库层面引入“租户ID”tenant_id字段到所有业务表实现数据隔离。或者在数据库层面就进行物理隔离每个租户独立数据库。架构层面将系统拆分为微服务比如“用户中心服务”、“药品目录服务”、“订单服务”、“库存服务”。服务间通过 API 或消息队列通信。缓存与路由需要设计更复杂的缓存策略避免不同门店数据混淆。网关需要根据请求头或域名将流量路由到正确的租户上下文。计费与订阅需要增加套餐管理、租户订阅、用量统计等功能模块。把这个思考过程写在你的毕业设计报告里绝对是一个巨大的加分项希望这篇笔记能帮你理清思路做出一个让导师眼前一亮的作品。