启航迎新 · 高校新生报到管理系统（SpringBoot 4 + Vue3 双端）

项目背景

高校迎新季是教务、学工、后勤多部门并行的高峰期：新生名单靠表格传递、报到靠纸质签到、宿舍床位靠电话确认、缴费情况要反复对账。本项目把这条链路收进一个系统——管理端负责建档与调度，新生端负责查询与自助办理，数据同源、状态实时回写。

系统名称为 启航迎新 · 高校新生报到管理平台，采用前后端分离架构，管理端与新生端共用一套接口与权限体系。

系统角色

管理员（教师 / 招生办） 登录后进入后台，负责院系专业班级等基础数据维护、新生建档、现场报到登记、宿舍床位分配、学费缴纳登记与通知公告发布。

新生 注册或由管理员建档后登录，只能查看自己的学籍信息、报到进度、宿舍床位与缴费记录，以及招生办发布的通知公告。

功能清单

模块	主要能力
数据看板	新生总数、已报到、待报到、缴费完成率四项指标；院系分布条形图、报到与缴费环形图、每日报到趋势面积图；床位使用率环形图；最新报到动态列表
新生管理	分页检索（姓名/学号/账号 + 院系 + 报到状态）、增删改、身份证号格式校验、院系→专业→班级三级联动、新生名单导出 CSV
报到签到	现场报到登记与修改，登记后自动回写新生的报到状态，删除记录同步回退状态
宿舍管理	宿舍楼（性别限制、楼层数）、房间（床位数/已用数/楼层）、床位分布图、宿舍分配（校验房间容量与床位占用）
学费缴纳	学费与住宿费明细登记、一键确认缴费并自动记录缴费时间、按缴费状态筛选
通知公告	发布/编辑/删除、置顶排序、按发布时间倒序、新生端卡片式阅读与详情弹窗
个人中心	资料修改、头像上传、修改密码，管理员与新生共用同一页面按角色渲染
基础数据	院系、专业、班级三级维护，注册页下拉数据免登录加载

技术架构

后端：Spring Boot 4.1 + MyBatis-Plus 3.5 + MySQL 8.0 + Hutool，Java 17。分层为 Controller / Mapper / Entity，复杂列表查询通过 Mapper XML 手写多表 LEFT JOIN。

前端：Vue 3.5（script setup）+ Vite 6 + Element Plus 2.9 + Pinia + Vue Router 4.5 + Axios + ECharts 5.6，纯原生 CSS 编写设计系统，未引入 Tailwind 或 UI 框架二次封装。

鉴权：登录成功后由后端生成 UUID Token 存入服务端存储，前端放入 Authorization 请求头，拦截器统一校验；前端路由守卫按 admin / student 角色分流，越权访问自动跳回本角色首页。

关键设计与实现

报到状态双向一致：签到表与新生表不是各写各的——新增报到记录时回写新生的报到状态为「已报到」，删除记录时回退为「未报到」，避免两张表对不上。

床位分配有校验：分配宿舍时先校验房间是否存在、床位是否已满，通过后同步累加房间已用床位数；删除分配时再减回去，所以床位分布图上的数字始终是准的。

床位分布可视化：新增独立页面，按楼栋 → 楼层 → 房间三级展开，每个房间以床位方格展示入住人姓氏，空床用虚框区分，一眼看出哪栋楼还剩多少空位。

全局异常兜底：统一异常处理器把唯一索引冲突翻译成「该学号已存在」「该登录账号已被占用」这类中文提示，参数校验失败直接返回字段错误原因，不再把数据库原始报错抛到前端。

上传目录可移植：文件保存在后端运行目录下的 uploads 文件夹，首次上传自动创建，静态资源通过统一前缀映射访问，换电脑、换盘符都不需要改配置。

响应式与可访问性：侧边栏可折叠，列表页在窄屏自动单列；提供跳转正文的键盘链接、焦点可见样式，并遵循系统「减少动效」偏好。

数据库设计

共 11 张表，均以 t_ 前缀命名：

• t_admin 管理员
• t_student 新生（学号、账号双唯一索引）
• t_department 院系
• t_major 专业
• t_class 班级
• t_checkin 报到签到
• t_dorm_building 宿舍楼
• t_dorm_room 宿舍房间
• t_dorm_allocation 宿舍分配
• t_fee 学费缴纳
• t_notice 通知公告

脚本内置一套可直接演示的完整数据：6 个院系、11 个专业、12 个班级、24 名新生、16 条报到记录、15 间宿舍（60 个床位）、24 条宿舍分配、48 条缴费记录、10 条通知公告，且楼栋性别、房间容量、已用床位与分配记录完全自洽。

交付内容

• 前端完整源码（Vue3 + Vite 工程，含设计系统与全部页面）
• 后端完整源码（SpringBoot 工程，含 Mapper XML 与全局异常处理）
• 数据库脚本 db_freshman.sql（建库建表 + 演示数据，一次导入即可）
• 使用说明文档（启动步骤、默认账号、上传目录说明）

运行说明

1. 导入 db_freshman.sql 建立数据库 db_freshman
2. 后端进入 server 目录执行 mvnw spring-boot:run，默认端口 8080
3. 前端进入 client 目录执行 npm install 与 npm run dev，默认端口 5173
4. 浏览器访问 http://localhost:5173

默认账号：

• 管理员 tanwei / 123456
• 新生 zhangsan / 123456（其余新生密码同为 123456）