说明

本文只讨论系统设计、后端接口、数据库建模和后台管理实现，不涉及疾病诊断、治疗建议或用药指导。

项目适合作为 Java Web、SpringBoot 毕设、校园管理系统和后台管理系统的学习参考。

层级

技术选型

作用

前端

Vue、Vue-Router、Vuex、Element UI、Ajax

页面渲染、路由管理、状态管理、表单交互和接口请求

后端

SpringBoot、Java、MyBatis

提供 REST 接口、业务处理和数据持久化

数据库

MySQL

存储用户、打卡、上报、通行验证、报表等业务数据

可视化

ECharts

实现数据报表、统计图和后台数据分析

架构模式

B/S 架构、MVVM 思想

浏览器访问系统，前后端通过接口交互

// Mermaid 架构图，可复制到 CSDN Markdown
graph TD
    A[浏览器/前端Vue页面] --> B[SpringBoot Controller]
    B --> C[Service业务层]
    C --> D[MyBatis Mapper]
    D --> E[(MySQL数据库)]
    C --> F[ECharts统计数据]
    F --> A

数据表

主要字段

说明

registered_user

registered_user_id、user_no、full_name、gender、identity_type、examine_state、user_id

注册用户信息表，用于保存用户基础资料和审核状态

place_punch

place_punch_id、user_no、full_name、clock_in_area、clock_in_time、reason_for_visit、health_code

场所打卡表，用于记录用户到访地点和打卡信息

data_reporting

data_reporting_id、user_no、full_name、reporting_time、health、measure_body_temperature、health_code、trip_code

数据上报表，用于保存用户每日或阶段性上报数据

passage_verification

passage_verification_id、user_no、full_name、time_of_passage、reasons_for_access、examine_state、examine_reply

通行验证表，用于保存通行申请与审核结果

data_report

data_report_id、title、date、number_of_reported_persons、number_of_persons_not_reported、total_number_of_people

数据报表表，用于统计已上报、未上报和合计人数

data_analysis

data_analysis_id、title、date、analysis_content、analysis_results、remarks

数据分析表，用于保存分析内容与分析结果

模块

接口示例

请求方式

说明

用户注册

/api/user/register

POST

校验用户是否存在，保存加密后的密码

用户登录

/api/user/login

POST

支持用户名、邮箱或手机号登录

场所打卡

/api/place_punch/get_obj

GET

查询打卡详情或列表数据

数据上报

/api/upload

POST

上传健康码、行程码等附件

数据报表

/api/data_report/count

GET

按条件统计数据，用于 ECharts 图表展示

// application.yml
server:
  port: 5000
  servlet:
    context-path: /api

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/campus_epidemic?serverTimezone=GMT%2B8&useSSL=false&characterEncoding=utf-8
    username: root
    password: ${DB_PASSWORD}
    driver-class-name: com.mysql.cj.jdbc.Driver
  jackson:
    time-zone: GMT+8
    date-format: yyyy-MM-dd HH:mm:ss
  servlet:
    multipart:
      max-file-size: 100MB
      max-request-size: 100MB

// Java
@PostMapping("register")
public Map<String, Object> signUp(@RequestBody User user) {
    Map<String, String> query = new HashMap<>();
    query.put("username", user.getUsername());

    List list = service.select(query, new HashMap<>()).getResultList();
    if (list.size() > 0) {
        return error(30000, "用户已存在");
    }

    user.setUserId(null);
    user.setPassword(service.encryption(user.getPassword()));
    service.save(user);
    return success(1);
}

// Java
@PostMapping("login")
public Map<String, Object> login(@RequestBody Map<String, String> data,
                                 HttpServletRequest request) {
    String username = data.get("username");
    String email = data.get("email");
    String phone = data.get("phone");
    String password = data.get("password");

    Map<String, String> query = new HashMap<>();
    if (username != null && !username.isEmpty()) {
        query.put("username", username);
    } else if (email != null && !email.isEmpty()) {
        query.put("email", email);
    } else if (phone != null && !phone.isEmpty()) {
        query.put("phone", phone);
    }

    // 查询用户、校验密码、写入登录状态
    // return success(userInfo);
    return success(1);
}

// Java
@PostMapping("/upload")
public Map<String, Object> upload(@RequestParam("file") MultipartFile file) {
    if (file.isEmpty()) {
        return error(30000, "没有选择文件");
    }

    try {
        String filePath = System.getProperty("user.dir")
                + "\target\classes\static\upload\";
        File targetDir = new File(filePath);
        if (!targetDir.exists()) {
            targetDir.mkdirs();
        }

        String fileName = file.getOriginalFilename();
        File dest = new File(filePath + fileName);
        file.transferTo(dest);

        JSONObject result = new JSONObject();
        result.put("url", "/api/upload/" + fileName);
        return success(result);
    } catch (IOException e) {
        return error(30000, "上传失败");
    }
}

// Java
@RequestMapping(value = {"/count_group", "/count"})
public Map<String, Object> count(HttpServletRequest request) {
    Query count = service.count(
            service.readQuery(request),
            service.readConfig(request)
    );
    return success(count.getResultList());
}

测试模块

测试内容

结果

登录

用户名、密码为空或错误时给出提示；输入正确时进入系统

通过

注册

检测账号是否重复，验证基础字段格式

通过

场所打卡

新增、查询、修改、删除打卡信息

通过

数据上报

新增、查询、修改、删除上报信息，并支持附件上传

通过

数据报表

统计已上报人数、未上报人数和合计人数

通过

优化建议

如果部署到正式环境，可以优先升级带宽、开启静态资源压缩、增加分页查询、优化 SQL 索引。

后台权限建议接入 Spring Security 或 JWT，文件上传建议加入白名单校验与独立对象存储。