Spring Boot+Vue3构建中药材全生命周期管理系统实践

markdown复制## 1. 项目背景与核心需求解析

去年参与某中医药企业的数字化改造时，我深刻体会到传统药材库存管理的痛点：手工台账导致三七和黄芪库存混淆、虫草等贵重药材损耗难以追踪、采购销售数据严重滞后。这正是我们开发这套系统的初衷——用Spring Boot+Vue3构建一个能解决以下核心问题的中药材全生命周期管理系统：

1. **药材特性适配**：必须支持性状（片状/粉状）、含水量、虫蛀风险等专业字段
2. **批次精细管理**：实现陈货/新货的先进先出（FIFO）自动提醒
3. **多维度预警**：对临近保质期的茯苓、易挥发的薄荷等特殊品类设置差异阈值
4. **GSP合规性**：严格遵循《药品经营质量管理规范》的追溯要求

## 2. 技术架构设计要点

### 2.1 后端Spring Boot关键配置

采用多模块Maven项目结构，其中几个特殊设计值得注意：

```java
// 药材实体类添加GSP必要字段
@Entity
public class ChineseHerb {
    @Id
    @GeneratedValue(strategy=GenerationType.IDENTITY)
    private Long id;
    
    @Column(length = 50)
    private String herbCode; // 药材编码规则：品类首字母+产地代码
    
    @Enumerated(EnumType.STRING)
    private StorageCondition condition; // 阴凉/冷藏/常温
    
    @Embedded
    private GSPInfo gspInfo; // 单独嵌入GSP信息组件
}

特别注意：JPA审计功能必须启用@EnableJpaAuditing，自动记录操作人、时间等GSP必要信息

2.2 Vue3前端特殊处理

针对药材管理的特殊性，前端做了这些优化：

1. 智能表单验证：

javascript复制// 根据药材类型动态变更校验规则
const rules = {
  moistureContent: (herbType) => ({
    required: he