立项原因，旨在解决什么产品问题
随着高校办学规模的不断扩大，学生宿舍管理工作面临前所未有的压力。传统的人工管理模式已难以适应现代宿舍管理的需求，存在信息更新滞后、流程繁琐、效率低下、数据难以统计分析等诸多痛点。具体问题包括：学生住宿信息分散难以统一管理；宿舍分配依靠纸质记录，容易出错且查找困难；报修、调宿、请假等申请流程需要学生来回奔波，审批周期长；管理人员难以实时掌握宿舍入住率、床位使用情况等关键数据。因此，开发一套数字化、流程化的宿舍管理系统势在必行。
行业场景，业务背景
本系统面向高校宿舍管理场景，主要服务于宿舍管理人员和在校学生两类用户。系统覆盖宿舍楼与房间信息管理、学生住宿分配、宿舍调换审批、设施报修处理、学生请假管理等核心业务环节，实现宿舍管理工作的全流程线上化。系统的应用将有效提升宿舍管理效率，减少人工操作失误，为学生提供更加便捷的服务体验，同时也为管理层提供准确的数据支撑和决策参考。
本项目包含以下六大核心功能模块：
1. 用户认证与权限管理模块 支持管理员和学生两种角色登录系统，采用JWT实现身份认证。管理员可管理所有学生信息和系统数据，学生可查看个人信息和提交业务申请。系统根据用户角色控制页面访问和API操作权限。
2. 学生信息管理模块 管理员可对学生信息进行增删改查操作，支持按姓名、学号、用户名搜索学生。每位学生的宿舍分配情况（宿舍楼、房间号、床位号、入住日期）可关联查询。系统自动维护学生入住和退宿的历史记录。
3. 宿舍资源管理模块 支持宿舍楼和宿舍房间的二级管理。管理员可创建、编辑、删除宿舍楼和房间，设置房间容量、床位数量、入住人数上限、性别限制（男生/女生/混合）和房间状态（可用/已满/维护中）。系统实时统计各宿舍的入住情况。
4. 报修申请管理模块 学生可在线提交宿舍设施报修申请，选择报修类别（水电类、家具类、网络类、其他）和优先级。报修时可上传现场图片，管理员可查看详情、处理报修、填写处理备注并更新处理状态。学生可查看本人报修记录或取消申请。
5. 调宿申请管理模块 已入住学生可提交调宿申请，选择目标宿舍并说明调宿原因。系统自动校验目标宿舍是否存在、是否有空余床位、是否满足性别限制。管理员审批通过后，系统自动更新学生的住宿分配信息和宿舍入住人数。
6. 请假申请管理模块 学生可提交请假申请，选择请假类型（事假、病假、家庭事务、其他），填写请假原因，设置开始和结束日期。管理员审核请假申请，批准或拒绝申请。学生返校后，管理员确认学生已返校，系统完整记录请假和返校信息。
"我"负责哪些具体任务
本人作为项目开发者，独立完成了宿舍管理系统的需求分析、架构设计、编码实现和测试部署工作。前端使用Vue 3配合Vite构建工具，采用Vue Router实现页面路由和权限守卫，Pinia管理用户登录状态，前端还集成了Element Plus组件库构建界面，ECharts展示数据图表。后端使用Node.js和Express框架搭建RESTful API服务，MySQL数据库存储业务数据，通过JWT实现身份认证和接口权限控制，Multer中间件处理用户头像和报修图片上传。项目采用前后端分离架构，前端开发服务器通过代理将API请求转发至后端服务。
项目使用了哪些技术栈、架构，实现上亮点、难点
技术栈方面，前端采用Vue 3、Vue Router 4、Pinia、Axios、Element Plus、ECharts、Vite等主流技术栈；后端采用Node.js、Express、mysql2、jsonwebtoken、multer等库；数据库采用MySQL 8.0。
实现亮点包括：前后端完全分离的现代化架构设计；JWT实现无状态身份认证；前端实现API响应数据的内存缓存机制，避免重复请求；路由和API双重权限控制保障系统安全；学生调宿申请自动完成住宿关系迁移和宿舍人数更新。
实现难点在于：复杂的多表关联查询（学生、宿舍、宿舍楼的多表联合查询和统计）；调宿业务的原子性处理（需要同时更新学生住宿关系、目标宿舍入住人数、当前宿舍入住人数等多个数据）；业务规则校验（宿舍容量限制、性别限制、申请状态流转控制等）；前端列表操作后的缓存失效处理机制。
评论