苏三公子1. 项目概述与背景
隔离人员管理系统是公共卫生应急管理中的重要工具，尤其在近年来的特殊时期更凸显其价值。这个基于SpringBoot的B/S架构系统，本质上是一个针对特定人群的精细化管控平台。我在2020年参与某地级市防疫系统开发时，就深刻体会到传统Excel表格管理方式的局限性——数据不同步、信息滞后、统计困难等问题频出。
这个系统采用Java+MySQL的技术栈，核心要解决三个痛点：一是隔离人员信息的实时采集与更新，二是多级部门间的数据协同，三是自动化状态监测与预警。与普通CRM系统不同，它对时效性和准确性的要求近乎苛刻，比如隔离期倒计时误差必须控制在分钟级，这直接关系到防控政策的执行效果。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计
2.1 整体技术选型
选择SpringBoot 2.7.x作为基础框架，主要考虑其快速启动特性和丰富的Starter依赖。数据库采用MySQL 8.0而非5.7版本，看中的是其JSON字段支持和更好的窗口函数性能——这对处理隔离人员的行程轨迹数据特别有用。前端使用Thymeleaf+AdminLTE模板，这种组合在开发管理后台时效率极高，我曾用这套技术栈在3天内完成过原型开发。
系统架构上采用经典的三层模式：
- 表现层：Restful API + 模板渲染
- 业务层：Spring事务管理 + 自定义校验规则
- 数据层：JPA + QueryDSL动态查询
特别要说明的是没有选用微服务架构，因为在多数隔离管理场景中，单应用部署更利于快速响应和运维管控。实测在4核8G服务器上，这套架构能稳定支撑5000+并发请求。
2.2 核心功能模块设计
系统包含6个核心模块：
- 人员档案管理（含OCR身份证识别）
- 隔离地点管理（GIS地图集成）
- 健康监测（定时任务+消息提醒）
- 权限管理（RBAC+数据权限）
- 统计报表（ECharts可视化）
- 系统对接（与健康码平台API通信）
每个模块都采用独立的Package结构，通过Maven模块化构建。这种设计在后期扩展时优势明显，比如某次需要新增核酸检测模块，只需添加新的子模块即可。
3. 数据库设计与优化
3.1 关键表结构
核心的隔离人员表(isolated_person)设计值得细说：
sql复制CREATE TABLE `isolated_person` (
`id` BIGINT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(50) NOT NULL COMMENT '加密存储',
`id_card_md5` CHAR(32) NOT NULL COMMENT '身份证MD5',
`phone` VARCHAR(20) NOT NULL COMMENT '加密存储',
`isolation_type` TINYINT NOT NULL COMMENT '1居家 2集中',
`start_time` DATETIME NOT NULL,
`end_time` DATETIME NOT NULL,
`address_json` JSON NOT NULL COMMENT '结构化地址',
`health_status` TINYINT DEFAULT 0,
`creator_id` BIGINT NOT NULL,
`create_time` DATETIME DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `idx_id_card` (`id_card_md5`),
KEY `idx_time_range` (`start_time`,`end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
注意几个设计要点：
- 敏感字段加密存储，但保留MD5值用于去重
- 地址使用JSON类型存储省市区街道等结构化数据
- 建立复合索引优化时间范围查询
3.2 性能优化实践
在高并发登记场景下，我们遇到过严重的锁表现象。通过EXPLAIN分析发现，问题出在地址关联查询上。最终采用三种方案组合解决：
- 添加覆盖索引：
ALTER TABLE isolation_location ADD INDEX idx_cover (province, city, district, address) - 使用本地缓存：Caffeine缓存热点地点数据
- 优化事务范围：将非核心操作移到事务外部
实测优化后，批量导入速度从原来的200条/分钟提升到2000条/分钟。这里有个重要经验：MySQL的JSON字段虽然方便，但查询性能较差，对JSON内的字段查询最好建立生成列索引。
4. 核心功能实现细节
4.1 隔离状态自动更新
通过Spring的@Scheduled实现定时任务：
java复制@Scheduled(cron = "0 0/10 * * * ?")
public void autoUpdateIsolationStatus() {
LocalDateTime now = LocalDateTime.now();
// 使用批量更新减少数据库压力
jdbcTemplate.batchUpdate(
"UPDATE isolated_person SET health_status = ? WHERE end_time <= ? AND health_status != ?",
new BatchPreparedStatementSetter() {
@Override
public void setValues(PreparedStatement ps, int i) throws SQLException {
ps.setInt(1, HEALTH_STATUS_RELEASED);
ps.setTimestamp(2, Timestamp.valueOf(now));
ps.setInt(3, HEALTH_STATUS_RELEASED);
}
@Override
public int getBatchSize() {
return 1000; // 分批提交
}
}
);
}
关键点：
- 使用批处理而非单条更新
- 添加status条件避免重复更新
- 频率设置为10分钟一次，平衡实时性和性能
4.2 健康打卡提醒
采用责任链模式实现多通道通知：
java复制public interface NotificationHandler {
void send(NotificationRequest request);
boolean canHandle(NotificationType type);
}
@Component
@RequiredArgsConstructor
public class NotificationDispatcher {
private final List<NotificationHandler> handlers;
public void dispatch(NotificationRequest request) {
handlers.stream()
.filter(h -> h.canHandle(request.getType()))
.forEach(h -> h.send(request));
}
}
// 短信处理器示例
@Component
@Slf4j
class SmsNotificationHandler implements NotificationHandler {
@Override
public void send(NotificationRequest request) {
// 调用短信网关API
log.info("发送短信至{}", request.getPhone());
}
@Override
public boolean canHandle(NotificationType type) {
return type == NotificationType.SMS;
}
}
这种设计使新增通知渠道（如企业微信）时，只需添加新Handler而不用修改原有代码。
5. 安全防护方案
5.1 数据加密处理
采用国密SM4算法加密敏感字段：
java复制public class Sm4Util {
private static final String ALGORITHM_NAME = "SM4";
private static final String DEFAULT_KEY = "..."; // 实际应从配置读取
public static String encrypt(String plainText) {
// 实现细节省略...
}
@Converter
public static class CryptoConverter implements AttributeConverter<String, String> {
@Override
public String convertToDatabaseColumn(String attribute) {
return encrypt(attribute);
}
@Override
public String convertToEntityAttribute(String dbData) {
return decrypt(dbData);
}
}
}
// 实体类应用
@Entity
public class IsolatedPerson {
@Convert(converter = Sm4Util.CryptoConverter.class)
private String phone;
}
5.2 接口防刷策略
结合Guava RateLimiter实现API限流：
java复制@Aspect
@Component
@RequiredArgsConstructor
public class RateLimitAspect {
private final ConcurrentHashMap<String, RateLimiter> limiterMap = new ConcurrentHashMap<>();
@Around("@annotation(rateLimit)")
public Object around(ProceedingJoinPoint joinPoint, RateLimit rateLimit) throws Throwable {
HttpServletRequest request = ((ServletRequestAttributes)
RequestContextHolder.getRequestAttributes()).getRequest();
String key = request.getRemoteAddr() + ":" + request.getRequestURI();
RateLimiter limiter = limiterMap.computeIfAbsent(key,
k -> RateLimiter.create(rateLimit.value()));
if (!limiter.tryAcquire()) {
throw new BusinessException("操作过于频繁");
}
return joinPoint.proceed();
}
}
6. 典型问题排查实录
6.1 内存泄漏问题
在压力测试时发现Old区内存持续增长，通过MAT分析发现是JPA的缓存问题。解决方案：
- 配置spring.jpa.properties.hibernate.cache.use_second_level_cache=false
- 对大数据集查询添加@QueryHints注解：
java复制@QueryHints(value = {
@QueryHint(name = "org.hibernate.cacheable", value = "false"),
@QueryHint(name = "org.hibernate.readOnly", value = "true")
})
@Query("select p from IsolatedPerson p where ...")
Page<IsolatedPerson> findExpiredPersons(...);
6.2 并发更新冲突
多人同时修改隔离人员信息时出现版本冲突，采用乐观锁解决：
java复制@Entity
public class IsolatedPerson {
@Version
private Integer version;
//...
}
// 捕获异常后重试
@Retryable(value = ObjectOptimisticLockingFailureException.class,
maxAttempts = 3, backoff = @Backoff(delay = 100))
public void updatePerson(Long id, PersonDTO dto) {
// 更新逻辑
}
7. 部署与监控方案
7.1 生产环境配置
推荐使用Docker Compose部署：
yaml复制version: '3'
services:
app:
image: openjdk:11-jre
volumes:
- ./app.jar:/app.jar
- ./config:/config
command: java -jar /app.jar --spring.config.location=/config/
ports:
- "8080:8080"
depends_on:
- mysql
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
volumes:
- mysql_data:/var/lib/mysql
volumes:
mysql_data:
关键配置项：
- 使用JRE而非JDK镜像
- 外挂配置文件便于修改
- 独立数据卷持久化MySQL数据
7.2 监控指标配置
通过Spring Boot Actuator暴露关键指标：
properties复制# application-prod.properties
management.endpoints.web.exposure.include=health,info,metrics,prometheus
management.metrics.export.prometheus.enabled=true
management.metrics.tags.application=${spring.application.name}
配合Grafana仪表板监控：
- JVM内存/线程使用情况
- 接口响应时间P99
- 数据库连接池状态
- 定时任务执行情况
8. 项目演进方向
在实际运行中，我们持续迭代了几个重要功能：
- 智能分配算法：根据隔离人员住址自动分配最近的管理人员，采用Haversine公式计算经纬度距离：
java复制public static double calculateDistance(double lat1, double lon1, double lat2, double lon2) {
double R = 6371; // 地球半径(km)
double dLat = Math.toRadians(lat2 - lat1);
double dLon = Math.toRadians(lon2 - lon1);
lat1 = Math.toRadians(lat1);
lat2 = Math.toRadians(lat2);
double a = Math.pow(Math.sin(dLat/2),2) +
Math.pow(Math.sin(dLon/2),2) * Math.cos(lat1) * Math.cos(lat2);
double c = 2 * Math.asin(Math.sqrt(a));
return R * c;
}
-
离线模式支持：通过Service Worker实现PWA应用，在网络中断时仍能进行基础操作，数据恢复连接后自动同步。
-
语音填报功能：集成阿里云智能语音服务，支持通过语音快速填报体温等数据，特别适合老年人使用。