Spring Boot 版新生报到可视化系统

[1. 新生报到可视化系统说明](#1. 新生报到可视化系统说明)
- [1.1 系统概述](#1.1 系统概述)
- [1.2 启动系统](#1.2 启动系统)
- [1.3 后台管理](#1.3 后台管理)
- [1.4 样例数据](#1.4 样例数据)
- [1.5 可视化页面](#1.5 可视化页面)
- [1.6 技术说明](#1.6 技术说明)
- [1.7 数据表结构](#1.7 数据表结构)
[2. 新生报到可视化系统演示](#2. 新生报到可视化系统演示)
- [2.1 新生报到可视化](#2.1 新生报到可视化)
- [2.2 辅导员注册](#2.2 辅导员注册)
- [2.3 管理员审核](#2.3 管理员审核)

1. 新生报到可视化系统说明

本系统面向泸州职业技术学院2026级新生报到场景，基于Spring Boot、Thymeleaf、Bootstrap和MySQL构建，提供一站式迎新数据可视化展示与后台管理功能。首页以总览卡片和六个选项卡呈现报到情况、性别比例、学院分布、生源地分布、专业与年龄及新生明细，支持深链接直达。后台设管理员与辅导员两级账号，支持用户审核、Excel批量导入、数据检索与权限隔离。系统启动自动建库并生成5020条样例数据，图表采用自研轻量前端库，无需外部依赖，适合离线演示与教学实训。

双击 run.bat（端口自动选择：从 8080 起，被占用则依次 8081、8082......，控制台打印实际端口；

application.yml 中的 8082 仅作默认值），或手动：
bash 复制代码
```
mvn -DskipTests package
java -jar target/welcome_visualization.jar
```
数据库：MySQL welcome_freshman（首次运行自动建库建表 ，并写入 5020 条 泸州职业技术学院 2026 级样例数据）
连接参数在 src/main/resources/application.yml 或 run.bat 顶部修改（默认 root / 903213 / 3306）
在项目根目录运行run.bat批处理文件
自动显示首页 - http://localhost:8080/

访问首页右上角「后台管理」，或直接打开 /login。

角色	登录方式	能做什么
管理员	内置账号 admin / 123456（全系统唯一），可修改自己的密码	用户管理：直接添加辅导员（免审核）、编辑辅导员（登录名/姓名/重置口令）、删除辅导员、审核注册申请（通过/拒绝）、查看新生总数
辅导员	自行注册（登录名 3-20 位字母/数字/下划线，口令 ≥6 位），注册后需管理员审核通过才能登录；也可由管理员直接添加	添加单个学生、Excel 批量导入学生、下载导入模板、检索/删除自己录入的学生；修改个人信息（姓名、修改密码------需验证原口令）

辅导员只能看到和操作自己录入的学生；可视化大屏统计全部数据。
Excel 导入：用「下载导入模板」生成的 .xlsx 填写后上传，表头为

学号 / 姓名 / 性别 / 年龄 / 学院 / 专业 / 生源省份 / 报到状态 / 报到时间(可选)；

逐行校验（性别、年龄、报到状态、时间格式、学号重复------系统内或文件内重号均跳过），结果与失败明细在页面上提示。
表为空或仍是 2025 级旧数据时，启动会自动重建为 2026 级样例。

泸州职业技术学院 2026 级新生，共 5020 人
9 个招生二级学院 / 37 个专业（二级学院名称与学校官网一致）：人工智能与大数据学院（780）、智能制造与汽车工程学院（740）、成渝地区双城经济圈（泸州）商学院（660）、电气与电子工程学院（620）、师范学院（600）、智能建造学院（440）、数字创意学院（420）、中国酒业学院（380）、文旅学院（380）；专业为高职真实设置（如软件技术、数控技术、大数据与会计、酿酒技术、学前教育、建筑工程技术等）。通识教育学院、马克思主义学院不承担专科招生，未纳入样例
26 个生源省（区、市）：本省（四川省）约 61%，重庆、贵州、云南次之，其余向全国辐射
性别比例按院系设定（如智能制造学院男多、人文与教育学院女多），全校 3046 男 / 1974 女
报到率约 93.7%：已报到记录带报到时间（2026 年 8 月 30 日 --- 9 月 1 日，白天为主）
姓名：按真实姓氏/用字频次加权随机生成，全校 5020 人无重名
学号规则：2026 + 学院序号(2位) + 专业序号(2位) + 流水号(3位)

数据不为 5020 人时，启动会自动重建样例；想手动重建：DELETE FROM student; 后重启应用。

下方 6 个选项卡：

选项卡	内容
报到情况	报到状态环形图（中心显示总人数）、各学院报到率横向条形图（≥92% 绿 / ≥88% 蓝 / 其余橙）、各学院已报到/未报到堆叠柱状图
性别比例	全校男女人数环形图、各学院男女生堆叠柱状图
学院分布	各学院人数柱状图 + 人数占比饼图（带图例百分比）
生源地分布	生源省份 TOP12 横向条形图、前 9 省 + 其他占比饼图
专业与年龄	各专业人数 TOP15 横向条形图、新生年龄分布柱状图
新生明细	全部新生记录：学院下拉、报到状态下拉、关键字搜索（姓名/学号/专业/生源地），报到状态徽章着色

后端：Spring Boot 3.3 / Thymeleaf / spring-jdbc（JdbcTemplate 聚合查询）/ Apache POI（Excel 模板与导入）
数据接口：/api/overview、/api/gender、/api/sign、/api/college、/api/college-gender、/api/college-sign-rate、/api/province、/api/major、/api/age、/api/students
认证：HttpSession（角色 ADMIN / COUNSELOR），/admin/**、/counselor/** 由拦截器守卫；口令 SHA-256 存储
前端：Bootstrap 5（本地 vendor）、static/js/charts.js 自研轻量图表库（环形饼图 conic-gradient、分组/堆叠柱状图、横向条形图），打印时自动展开全部选项卡
统一异常处理：接口异常返回 JSON 并记录日志，页面错误显示友好中文提示

学生表和系统用户表

表	说明
student	新生：student_no / name / gender / age / college / major / province / sign_status（已报到/未报到）/ sign_time / created_by（录入辅导员）
sys_user	后台用户：username / password(SHA-256) / name / role（ADMIN/COUNSELOR）/ status（PENDING/APPROVED/REJECTED）/ created_at