高校抗疫物资管理系统开发实践与优化

1. 项目背景与需求分析

2020年新冠疫情暴发后，高校疫情防控管理面临前所未有的挑战。作为一名经历过三次校园封控的技术人员，我深刻体会到传统Excel表格+微信群接龙的管理方式存在诸多痛点：物资申领流程繁琐、健康上报数据滞后、信息孤岛现象严重。这正是我选择开发这套抗疫物资管理系统的初衷。

现有高校防疫系统主要存在三个典型问题：

1. 功能僵化：健康上报字段无法根据各院系实际需求灵活调整，导致辅导员需要额外人工统计
2. 性能瓶颈：高峰期并发访问时系统响应缓慢，我们学校就曾出现过3000人同时申报导致服务器崩溃的情况
3. 流程割裂：物资申请、审批、发放等环节分散在不同平台，缺乏全链路追踪

2. 系统架构设计

2.1 技术选型决策

经过对三个技术方案的对比测试，最终确定采用SSM+Vue的全栈方案：

选择SSM(Spring+SpringMVC+MyBatis)作为后端框架，主要基于以下考虑：

• Spring的IoC容器便于管理各类防疫物资服务组件
• MyBatis的二级缓存可显著提升物资库存查询效率
• 与学校现有LDAP认证系统集成更方便

前端选用Vue3+ElementPlus的组合，实测比React方案减少30%的代码量，特别适合快速迭代的管理系统开发。

2.2 核心模块设计

系统采用微内核架构，核心模块包括：

java复制// 领域模型示例
public class EpidemicMaterial {
    private String materialId;  // 物资ID
    private String name;        // 物资名称
    private Integer stock;      // 当前库存
    private Integer safetyStock;// 安全库存阈值
    // 省略getter/setter
}

public class MaterialApplication {
    private String applicationId;
    private String userId;
    private List<MaterialItem> items; 
    private Integer status;     // 0-待审核 1-已通过 2-已发放
    // 关联查询方法
    public List<MaterialApplication> findByUser(String userId) {
        return materialMapper.selectByUser(userId);
    }
}

3. 关键技术实现

3.1 高并发库存管理

物资抢购场景下的库存超卖问题是系统最大挑战。我们采用三级防护策略：

1. 前端限流：通过Vue的v-throttle指令限制提交频率

javascript复制// 物资加入申请车按钮
<el-button 
  v-throttle="1000" 
  @click="addToCart">
  加入申请
</el-button>

2. 中间层拦截：Redis分布式锁控制并发

java复制public boolean deductStock(String materialId, int num) {
    String lockKey = "lock:material:" + materialId;
    try {
        // 获取分布式锁
        Boolean locked = redisTemplate.opsForValue()
            .setIfAbsent(lockKey, "1", 10, TimeUnit.SECONDS);
        if(locked) {
            // 实际扣减逻辑
            return materialMapper.updateStock(materialId, num) > 0;
        }
        return false;
    } finally {
        redisTemplate.delete(lockKey);
    }
}

3. 底层保障：MySQL乐观锁兜底

sql复制UPDATE material_stock 
SET stock = stock - #{num},
    version = version + 1
WHERE material_id = #{materialId} 
AND version = #{version}

3.2 动态表单引擎

为满足各院系不同的健康上报需求，设计了可配置表单系统：

1. 元数据管理：将表单字段配置存储在JSONB类型的数据库字段中

json复制{
  "fields": [
    {
      "type": "input",
      "label": "体温",
      "unit": "℃",
      "required": true,
      "validator": "number|min:35|max:42"
    },
    {
      "type": "select",
      "label": "症状",
      "options": ["咳嗽", "发热", "乏力"]
    }
  ]
}

2. 动态渲染：Vue递归组件实现表单生成器

vue复制<template>
  <div v-for="field in schema.fields" :key="field.key">
    <component 
      :is="`form-${field.type}`" 
      v-model="formData[field.key]"
      v-bind="field" />
  </div>
</template>

4. 系统部署与优化

4.1 性能调优记录

在JMeter压力测试中发现的三个性能瓶颈及解决方案：

1. N+1查询问题：

• 现象：物资列表页查询耗时2.8s
• 排查：MyBatis懒加载导致多次查询
• 解决：添加@FetchType.EAGER注解并重构SQL

2. 大文件上传超时：

• 现象：供应商上传5MB+的质检报告失败
• 解决：Nginx增加client_max_body_size配置

nginx复制http {
    client_max_body_size 20M;
}

3. 首页加载缓慢：

• 优化前：首屏资源1.2MB，加载时间4.5s
• 优化措施：
  • Vue路由懒加载
  • 启用Brotli压缩
  • 关键CSS内联

4.2 安全防护方案

针对高校系统的特殊安全需求，实施以下措施：

1. 认证安全：

• 集成学校LDAP的同时，本地存储加密后的密码哈希
• 采用BCryptPasswordEncoder进行密码加密

java复制@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder(12);
}

2. 数据安全：

• 敏感字段如身份证号进行AES加密存储
• 数据库定时备份到私有OSS存储桶

3. 防注入措施：

• MyBatis全部使用#{}参数绑定
• 增加XSS过滤器处理用户输入

5. 开发经验总结

5.1 踩坑实录

1. 日期处理问题：

• 现象：健康上报记录的日期在iOS和Android端显示不一致
• 原因：未统一时区处理
• 解决：后端统一返回UTC时间戳，前端使用moment-timezone转换

2. 微信浏览器兼容：

• 现象：ElementPlus的日期选择器在微信内无法弹出
• 解决：引入vant-wechat作为fallback组件

3. 事务失效场景：

java复制// 错误示例
public void applyMaterial() {
    updateStock(); // 内部调用了this.deductStock()
    createOrder();
}

private void updateStock() {
    transactionTemplate.execute(status -> {
        deductStock(); // 事务不生效
        return null;
    });
}

• 原因：自调用导致Spring AOP代理失效
• 解决：将updateStock()方法移到单独Service中

5.2 效果评估

系统在本校试运行三个月后的关键指标：

特别在2023年12月的疫情反弹期间，系统平稳支撑了单日1.2万次的健康上报和3000+的并发物资申请，没有出现服务中断情况。