济南大胖子1. 项目概述与核心价值
药品商城管理系统是一个典型的医药行业垂直领域解决方案，它基于SpringBoot框架实现了药品全生命周期管理。这个系统最核心的价值在于将传统医药流通中的采购、库存、销售三大核心业务环节数字化，同时引入监管模块满足医药行业特殊合规要求。
我在实际开发中发现，医药行业管理系统与普通电商系统存在显著差异：首先药品作为特殊商品，其批次号、有效期、处方药标识等属性必须严格管理；其次需要符合GSP（药品经营质量管理规范）要求，实现全程可追溯；最后还需处理复杂的药品分类体系（如OTC/处方药/医疗器械等）。这些特性决定了系统在设计时需要特别关注数据完整性和审计追踪功能。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计解析
2.1 SpringBoot框架选型优势
选择SpringBoot作为基础框架主要基于以下考量：
- 快速启动：通过starter依赖可快速集成MyBatis、Redis等组件，相比传统SSM框架减少70%以上的配置工作量
- 内嵌容器：Tomcat容器开箱即用，特别适合需要快速演示的毕业设计场景
- 健康检查：Actuator端点天然适合药品系统需要的服务监控需求
典型依赖配置示例：
xml复制<dependencies>
<!-- 核心启动器 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 数据访问 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!-- 缓存支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
</dependencies>
2.2 分层架构设计
系统采用经典三层架构，但针对医药行业特性做了特殊调整：
- 表现层：增加药品图片安全过滤组件，防止XSS攻击
- 业务层：独立设计药品批次日志服务，满足GSP要求
- 数据层：采用多数据源设计，将交易数据与日志数据物理隔离
重要提示：药品管理系统必须实现操作日志的完整留存，建议采用AOP方式统一记录关键业务操作，这是毕业设计答辩时的加分点。
3. 核心业务模块实现
3.1 药品采购管理
采购模块需要处理的核心业务场景：
- 供应商资质审核（营业执照、GSP证书等）
- 采购订单审批流设计
- 药品基础信息录入规范
关键代码实现 - 采购订单实体设计：
java复制@Entity
@Table(name = "drug_purchase_order")
public class PurchaseOrder {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
// 药品批次号（关键字段）
@Column(nullable = false, length = 50)
private String batchNumber;
// 药品有效期
@Column(nullable = false)
private LocalDate expiryDate;
// 审批状态机设计
@Enumerated(EnumType.STRING)
private ApprovalStatus status;
// 关联供应商
@ManyToOne
private Supplier supplier;
// 动态计算字段（非持久化）
@Transient
public BigDecimal getTotalAmount() {
return items.stream()
.map(item -> item.getPrice().multiply(BigDecimal.valueOf(item.getQuantity())))
.reduce(BigDecimal.ZERO, BigDecimal::add);
}
}
3.2 库存智能管理
药品库存管理的特殊要求：
- 批次管理：必须支持先进先出(FIFO)策略
- 效期预警：自动预警临期药品（通常设置3个月阈值）
- 库存盘点：支持动态盘点不影响正常销售
库存预警算法实现逻辑：
java复制public List<DrugStock> checkExpiryWarning() {
LocalDate warningDate = LocalDate.now().plusMonths(3);
return drugStockRepository.findAll()
.stream()
.filter(stock -> stock.getExpiryDate().isBefore(warningDate))
.sorted(Comparator.comparing(DrugStock::getExpiryDate))
.collect(Collectors.toList());
}
3.3 药品销售控制
处方药销售的特殊业务流程：
- 处方审核：对接医疗机构HIS系统验证处方真伪
- 限量控制：对麻黄碱类等特殊药品实施销售限制
- 销售追溯：完整记录销售人员和购买者信息
销售控制核心逻辑示例：
java复制@Transactional
public SaleRecord createSale(SaleDTO dto) {
// 1. 检查药品属性
Drug drug = drugRepository.findById(dto.getDrugId())
.orElseThrow(() -> new BusinessException("药品不存在"));
// 2. 处方药特殊处理
if (drug.getPrescriptionRequired()) {
validatePrescription(dto.getPrescriptionImage());
}
// 3. 库存扣减（按批次顺序）
deductStockByFIFO(drug.getId(), dto.getQuantity());
// 4. 生成销售记录（包含审计字段）
SaleRecord record = new SaleRecord();
record.setOperator(SecurityUtils.getCurrentUser());
// ...其他字段设置
return saleRecordRepository.save(record);
}
4. 监管合规功能实现
4.1 数据追溯设计
药品监管的核心是全程追溯，系统采用以下技术方案：
- 操作日志：使用Spring AOP记录所有修改操作
- 数据快照：关键业务变更时保存变更前后数据
- 区块链存证：对重要数据计算Hash值并上链
审计日志切面示例：
java复制@Aspect
@Component
public class AuditLogAspect {
@Autowired
private AuditLogService logService;
@Pointcut("@annotation(com.medicare.audit.Auditable)")
public void auditableMethod() {}
@Around("auditableMethod()")
public Object aroundAuditableMethod(ProceedingJoinPoint pjp) throws Throwable {
Method method = ((MethodSignature)pjp.getSignature()).getMethod();
Auditable auditable = method.getAnnotation(Auditable.class);
// 记录操作前参数
Object[] args = pjp.getArgs();
String operation = auditable.value();
try {
Object result = pjp.proceed();
logService.logSuccess(operation, args);
return result;
} catch (Exception e) {
logService.logFailure(operation, args, e);
throw e;
}
}
}
4.2 报表统计功能
医药行业典型报表需求：
- 近效期药品统计表
- 药品销售TOP10分析
- 供应商供货质量分析
使用EasyExcel实现导出示例：
java复制@GetMapping("/export/expiry")
public void exportExpiryDrugs(HttpServletResponse response) {
List<ExpiryWarningDTO> data = stockService.getExpiryWarningList();
response.setContentType("application/vnd.ms-excel");
response.setCharacterEncoding("utf-8");
String fileName = URLEncoder.encode("近效期药品", "UTF-8");
response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
EasyExcel.write(response.getOutputStream(), ExpiryWarningDTO.class)
.sheet("近效期药品")
.doWrite(data);
}
5. 系统部署与调优
5.1 生产环境配置建议
药品系统部署特殊要求：
- 数据库：建议使用MariaDB Galera集群保证数据高可用
- 缓存：Redis配置持久化策略，防止药品价格等关键数据丢失
- 安全：配置HTTPS并定期更新SSL证书
典型application-prod.yml配置：
yaml复制spring:
datasource:
url: jdbc:mariadb:aurora://cluster-endpoint:3306/medicare
hikari:
maximum-pool-size: 20
connection-timeout: 30000
redis:
cluster:
nodes: redis-node1:6379,redis-node2:6379,redis-node3:6379
timeout: 5000
lettuce:
pool:
max-active: 20
5.2 性能优化实战技巧
- 药品图片处理：使用Thumbnailator实现图片压缩和缩略图生成
- 批量操作：采用MyBatis批处理提升库存盘点效率
- 缓存策略：对药品基础信息使用二级缓存
批量库存更新示例：
java复制@Transactional
public void batchUpdateStock(List<StockUpdateDTO> updates) {
SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
DrugStockMapper mapper = session.getMapper(DrugStockMapper.class);
updates.forEach(dto -> {
mapper.updateStock(dto.getDrugId(), dto.getBatchNo(), dto.getQuantity());
});
session.commit();
} finally {
session.close();
}
}
6. 毕业设计扩展建议
- 智能预警：集成机器学习算法预测药品需求趋势
- 移动端适配：开发基于Uniapp的药店店员APP
- 电子处方：对接医院HIS系统实现处方流转
- 冷链监控：集成物联网设备实现温湿度监控
在实现基础功能后，可以考虑使用SpringBoot集成HanLP实现药品说明书关键词提取：
java复制public List<String> extractKeywords(String text) {
List<String> termList = new ArrayList<>();
List<Term> terms = HanLP.segment(text);
for (Term term : terms) {
if (term.nature.toString().startsWith("n")) { // 提取名词
termList.add(term.word);
}
}
return termList.stream()
.distinct()
.collect(Collectors.toList());
}
7. 常见问题解决方案
- 药品编码冲突：建议采用69码作为药品唯一标识
- 库存不同步问题：使用Redis分布式锁保证库存扣减原子性
- 事务失效场景：注意@Transactional在自调用时的失效问题
分布式锁实现示例：
java复制public boolean deductStockWithLock(Long drugId, int quantity) {
String lockKey = "stock_lock:" + drugId;
String requestId = UUID.randomUUID().toString();
try {
// 尝试获取锁
boolean locked = redisTemplate.opsForValue()
.setIfAbsent(lockKey, requestId, 30, TimeUnit.SECONDS);
if (locked) {
return stockService.deductStock(drugId, quantity);
}
return false;
} finally {
// 释放锁
if (requestId.equals(redisTemplate.opsForValue().get(lockKey))) {
redisTemplate.delete(lockKey);
}
}
}
在开发过程中，我特别建议做好药品基础数据的初始化工作，包括：
- 药品分类树形结构预置
- 常见药品规格单位预设
- 典型供应商测试数据准备
这些基础数据的完善程度直接影响系统演示效果和毕业设计答辩评分。