Java项目实训药店管理系统：从零开始构建完整功能的药品管理平台
在软件工程教育中，Java项目实训是学生将理论知识转化为实际开发能力的重要环节。而药店管理系统作为典型的业务场景之一，不仅涵盖了数据库设计、前后端交互、权限控制等核心技术点，还贴近现实中的医疗健康行业需求。本文将详细阐述如何基于Java技术栈完成一个完整的药店管理系统实训项目，包括需求分析、系统架构设计、模块实现、测试部署以及教学建议，帮助初学者和教师明确方向，高效落地。
一、项目背景与意义
随着我国医药行业的快速发展，传统人工管理模式已难以满足现代药店对药品库存精准控制、销售数据统计、处方审核等多方面的需求。因此，开发一套高效的药店管理系统具有重要的现实意义。对于高校计算机相关专业的学生而言，该系统不仅是Java语言编程能力的综合演练，更是理解企业级应用开发流程（如需求分析→设计→编码→测试→部署）的绝佳实践案例。
通过本项目实训，学生能够掌握以下核心技能：
- 熟练使用Java基础语法及面向对象思想进行模块化开发
- 掌握Spring Boot框架搭建后端服务，提升开发效率
- 理解MySQL数据库设计原则，实现表结构优化与关联查询
- 学习前后端分离架构（如Vue.js或Thymeleaf），增强全栈思维
- 了解权限控制机制（RBAC模型）、日志记录、异常处理等生产级特性
二、需求分析与功能规划
在开始编码前，需明确系统的用户角色与核心功能。典型药店管理系统应包含以下几类用户：管理员、药师、收银员。各角色权限不同，系统需具备良好的权限隔离能力。
1. 功能模块划分
- 药品管理模块：支持药品信息录入、修改、删除、分类查询、库存预警等功能。
- 库存管理模块：实时更新库存数量，支持进货入库、出库记录，生成库存报表。
- 销售管理模块：实现商品扫码/手动输入销售，自动生成订单并结算，支持会员积分抵扣。
- 用户权限模块：基于角色的角色权限分配（RBAC），确保数据安全。
- 报表统计模块：提供按天/周/月的销售额、热销药品排行、过期药品提醒等可视化图表。
- 基础设置模块：如药品类别、单位、供应商信息维护。
2. 非功能性需求
- 系统响应时间小于2秒
- 支持至少50并发用户操作
- 具备基本的日志记录和错误提示机制
- 界面简洁友好，符合药店工作人员使用习惯
三、技术选型与系统架构设计
为保证项目可扩展性和稳定性，推荐采用主流Java生态技术栈：
1. 后端技术栈
- 开发框架：Spring Boot 2.x + MyBatis-Plus（简化CRUD操作）
- 数据库：MySQL 8.0，用于存储药品、订单、用户等核心数据
- API文档：Swagger UI，便于接口调试与协作
- 安全框架：Spring Security + JWT（Token认证），实现无状态登录鉴权
- 日志管理：Logback + ELK（可选），方便问题追踪
2. 前端技术栈（可选）
- 前端框架：Vue.js + Element UI（组件化开发，快速搭建页面）
- 通信方式：RESTful API + JSON格式传输
- 构建工具：Webpack / Vite（前端资源打包优化）
3. 系统架构图（伪代码示意）
┌─────────────┐
│ 前端界面 │ ←─ HTTP请求 → │ Spring Boot后端 │
└─────────────┘ └─────────────────────┘
│
▼
┌──────────────────────┐
│ MySQL数据库 │
└──────────────────────┘
│
▼
┌──────────────────────┐
│ Redis缓存层 │ (可选，用于高频访问数据)
└──────────────────────┘
四、核心模块实现详解
1. 数据库设计
合理设计数据库表结构是整个项目的基石。以下是几个关键表的设计示例：
药品表（medicine）
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | INT PK | 主键，自增 |
| name | VARCHAR(50) | 药品名称 |
| category_id | INT FK | 外键关联类别表 |
| price | DECIMAL(10,2) | 单价 |
| stock | INT | 当前库存 |
| expiration_date | DATE | 有效期 |
| created_at | DATETIME | 创建时间 |
用户表（user）
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | INT PK | 主键 |
| username | VARCHAR(30) | 用户名（唯一） |
| password | VARCHAR(64) | 加密后的密码 |
| role | ENUM('admin','pharmacist','cashier') | 角色 |
| enabled | TINYINT | 是否启用（0禁用，1启用） |
2. 核心业务逻辑实现
药品入库逻辑
当新增一批药品时，需验证是否已存在相同药品，若存在则累加库存；否则插入新记录。同时触发库存预警机制（如库存低于阈值发送通知）。
@Service
public class MedicineService {
@Autowired
private MedicineMapper medicineMapper;
public void addMedicine(Medicine medicine) {
Medicine existing = medicineMapper.selectByName(medicine.getName());
if (existing != null) {
existing.setStock(existing.getStock() + medicine.getStock());
medicineMapper.updateById(existing);
} else {
medicineMapper.insert(medicine);
}
// 触发库存预警（可调用邮件或短信服务）
checkStockAlert(medicine.getId());
}
}
销售订单生成逻辑
用户选择药品后，系统自动计算总价，并扣除对应库存。若库存不足则提示失败。
@PostMapping("/sale")
public ResponseEntity<String> createSale(@RequestBody SaleRequest request) {
List<OrderItem> items = request.getItems();
for (OrderItem item : items) {
Medicine medicine = medicineMapper.selectById(item.getMedicineId());
if (medicine.getStock() < item.getCount()) {
return ResponseEntity.badRequest().body("库存不足");
}
medicine.setStock(medicine.getStock() - item.getCount());
medicineMapper.updateById(medicine);
}
// 创建订单记录
orderMapper.insert(new Order(request.getUserId(), items));
return ResponseEntity.ok("success");
}
3. 权限控制实现（RBAC模型）
通过Spring Security配置不同角色的访问路径限制，例如管理员可以访问所有页面，而收银员只能查看销售记录和执行下单操作。
@Configuration
@EnableWebSecurity
public class SecurityConfig {
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
http.authorizeHttpRequests(auth -> auth
.requestMatchers("/admin/**").hasRole("ADMIN")
.requestMatchers("/pharmacist/**").hasAnyRole("ADMIN", "PHARMACIST")
.requestMatchers("/cashier/**").hasAnyRole("ADMIN", "CASHIER")
.anyRequest().authenticated()
);
return http.build();
}
}
五、测试与部署策略
1. 单元测试与集成测试
使用JUnit 5编写单元测试，覆盖核心方法（如药品入库、销售扣减库存）。利用Mockito模拟数据库行为，提高测试效率。
@Test
void testAddMedicine_Existing() {
when(medicineMapper.selectByName(anyString())).thenReturn(new Medicine());
medicineService.addMedicine(new Medicine("阿莫西林", 10, 1));
verify(medicineMapper).updateById(any());
}
2. 部署方案
- 本地开发环境：IDEA + Maven + MySQL + Redis（可选）
- 生产环境：Docker容器化部署（Nginx反向代理 + Spring Boot JAR包运行）
- 持续集成：GitHub Actions或Jenkins自动化构建与部署流程
六、教学建议与常见问题解答
1. 教师指导建议
- 分阶段布置任务：第一周完成数据库设计，第二周实现基础CRUD，第三周添加权限控制，第四周做UI美化与文档整理
- 鼓励小组合作，每组3~5人，分工明确（前端+后端+测试+文档）
- 引入Code Review机制，培养团队协作与代码规范意识
2. 学生常见问题及解决方案
- 问题1：登录后跳转404？ → 检查URL映射是否正确，确认是否有拦截器未放行
- 问题2：数据库连接失败？ → 查看application.yml中数据库配置是否正确，MySQL是否启动
- 问题3：权限无效？ → 检查Spring Security配置文件是否生效，是否启用了@EnableWebSecurity注解
- 问题4：前端报错Cannot read property 'xxx' of undefined？ → 检查接口返回格式是否一致，前端变量命名是否匹配
七、总结与展望
通过本次Java项目实训，学生不仅能深入掌握Spring Boot、MyBatis、数据库设计等核心技术，还能锻炼解决实际问题的能力。药店管理系统作为一个贴近生活的应用场景，有助于激发学习兴趣，为未来从事软件开发工作打下坚实基础。
未来可进一步拓展功能，如接入电子处方、对接医保系统、引入AI辅助用药建议等，使项目更具实用价值和社会意义。