药房管理系统毕业设计：从零实现一个高内聚低耦合的入门级架构-编程实验室

药房管理系统毕业设计：从零实现一个高内聚低耦合的入门级架构

1. 背景痛点：为什么“能跑就行”的代码在答辩时总被怼？

做毕业设计时，很多同学把“药房管理系统”当成“药品 CRUD 大合集”：一个DrugController里塞满增删改查，SQL 拼在 Java 字符串里，前端把表格数据一股脑儿v-for出来。结果演示时老师一句“如果药库管理员和售药师权限分开怎么做？”直接原地社死。

典型症状总结如下：

功能堆砌：业务代码、权限判断、数据校验全写在 Controller，方法行数飙到 300+。
硬编码：数据库连接、文件上传路径、角色名称直接static final写死，换环境就崩。
安全裸奔：拼接 SQL、返回全字段实体、未做参数过滤，Postman 一把梭就能删库。
无扩展点：药品字段加个“保质期”要改 5 张表 3 层代码，牵一发动全身。

毕业设计不是“能跑就行”，而是“跑得快、改得动、讲得清”。下面给出一条最小可运行、又足够拆分的架构路线，Spring Boot + MyBatis + Vue，3 天可搭出骨架，1 周能写 PPT。

2. 技术选型：为什么不是 Django / JSP / 纯 SSR？

技术	放弃理由	选择理由
Django	Python 语法简洁，但国内药房项目主流是 Java 技术栈，后续二开、接入医保接口时 Java 生态更香	无
JSP + Servlet	模板与后端高耦合，前端同学无法并行开发；IDE 支持弱，调试效率低	无
Spring Boot	自带 IOC、AOP、Starter，一键跑起内嵌 Tomcat，Maven 依赖管理成熟	选
MyBatis	比 JPA 易控 SQL，药房报表字段多且复杂，需要手写多表关联	选
Vue3 + ElementPlus	组件化开发，双向数据绑定，打包后纯静态文件，与后端仅通过 JSON 交互，真正做到前后端分离	选

一句话：Java 系毕业设计，Spring Boot 是“默认答案”；MyBatis 让你写 SQL 不慌；Vue 让页面不再刷新全屏白。

3. 核心模块拆解：高内聚低耦合从“分包”开始

3.1 项目结构（仅列关键目录）

text com.example.pharmacy ├─ common // 全局异常、分页、常量 ├─ config // MyBatis、Swagger、Cors、RBAC 配置 ├─ controller // 仅接收与校验参数，一行代码不写业务 ├─ service // 接口 + 实现，事务在此层开 ├─ mapper // MyBatis XML 与接口 ├─ domain // PO + DTO + VO，每层只看到自己需要的数据 └─ security // SpringSecurity + JWT，RBAC 模型

3.2 药品库存管理——“只写库存，不管卖”

业务场景：药库管理员做采购入库、盘亏盘盈；售药师做销售出库。两个角色看到的数据一样，但操作按钮不同。

表设计
drug（药品字典） ← 1:N →drug_stock（批次库存，含生产日期、有效期、数量）
关键接口
- POST /api/stock/in入库
- PUT /api/stock/check盘点
- GET /api/stock/page库存列表（带有效期预警 ≤ 90 天）
代码片段（Java）

@RestController @RequestMapping("/api/stock") @RequiredArgsConstructor public class StockController { private final StockService stockService; @PostMapping("/in") public R<Void> stockIn(@Valid @RequestBody StockInDTO dto){ // 1. 参数校验由 @Valid + DTO 注解完成 // 2. 业务逻辑下沉到 service，Controller 仅做路由 stockService.saveStockIn(dto); return R.ok(); } } @Service public class StockServiceImpl implements StockService { private final DrugStockMapper drugStockMapper; private final DrugMapper drugMapper; @Override @Transactional(rollbackFor = Exception.class) public void saveStockIn(StockInDTO dto){ // 1. 根据药品 ID 查字典，不存在抛 BizException Drug drug = drugMapper.selectById(dto.getDrugId()); if (drug == null) throw new BizException("药品不存在"); // 2. 构造库存记录 DrugStock stock = new DrugStock(); stock.setDrugId(dto.getDrugId()); stock.setBatchNo(dto.getBatchNo()); stock.setQuantity(dto.getQuantity()); stock.setExpireDate(dto.getExpireDate()); drugStockMapper.insert(stock); } }

前端 Vue 调用

// api/stock.js import request from '@/utils/request' export function stockIn(data) { return request({ url: '/api/stock/in', method: 'post', data }) } // views/stock/In.vue import { stockIn } from '@/api/stock' const submit = async () => { await stockIn(formModel) ElMessage.success('入库成功') }

Controller、Service、Mapper 各管一摊，后期想加“库存预警”只需在 Service 层写定时任务，不动 Controller。

4. 用户权限：RBAC 最简实现

五张表
user—role—permission，中间表user_role、role_permission。
用户表存username、password(BCrypt)、enabled。
SpringSecurity 配置要点

@Configuration @EnableGlobalMethodSecurity(prePostEnabled = true) public class SecurityConfig { @Bean public PasswordEncoder passwordEncoder(){ return new BCryptPasswordEncoder(); } }

方法级鉴权——售药师不能入库

@PreAuthorize("hasAuthority('stock:in')") @PostMapping("/in") public R<Void> stockIn(@Valid @RequestBody StockInDTO dto){ ... }

Vue 侧动态菜单
登录后GET /api/user/info返回permissions: ['stock:in','drug:sale']，前端根据权限过滤路由表，按钮级用v-has自定义指令。

5. 安全性三板斧

参数校验：DTO +javax.validation注解，拒绝 SQL 拼接。
SQL 注入：MyBatis#{}占位，杜绝${}拼接。
越权访问：RBAC +@PreAuthorize，并在 XML 层加tenant_id等字段隔离数据。

6. 生产环境避坑指南

数据库连接池
默认HikariCP足够，毕业设计并发低，但一定把minimum-idle设 5 以上，避免 MySQL 8 小时自动断开。
静态资源缓存
Vue 打包后dist/放 Nginx，location ~* \.(js|css|png)$ { expires 30d; }，回锅肉式提速。
配置外置
application.yml里spring.datasource.url用${DB_URL}，服务器启动脚本加-DDB_URL=xxx，防止账号密码提交到 GitHub。
日志分级
logback-spring.xml里com.example.pharmacy.mapper=DEBUG，生产环境改为 INFO，避免控制台刷 SQL 暴露字段。