当前位置：首页 > news >正文

Springboot3+Vue3+MySQL 小区人员出入登记管理系统源码前后端分离实战

news 2026/7/21 18:50:51

一、项目简介

本项目是一套基于 Spring Boot 3 + Vue 3 + MySQL 的小区人员出入登记管理系统，采用前后端分离架构。系统面向管理员、住户、工作人员三种角色，提供人脸识别出入登记、访客预约审批、考勤打卡、数据统计与可视化、批量导入、系统配置等完整功能，覆盖小区人员出入管理的全流程数字化需求。系统后端基于 RESTful API 设计，前端使用 Vue 3 组件化开发，数据库采用 MySQL 存储业务数据，整体结构清晰、易于二次开发。

二、技术栈

技术	说明
后端框架	Spring Boot 3.x
ORM	MyBatis-Plus
权限控制	基于角色的权限管理（RBAC）
前端框架	Vue 3
状态管理	Vuex / Pinia
构建工具	Vite
数据库	MySQL
Excel 处理	Apache POI
人脸识别	自定义人脸识别服务
文件上传	本地文件存储

三、功能模块

管理员端

用户管理：查看用户列表，支持按角色和关键词筛选，可新增、编辑、删除用户，查看用户详情。
住户管理：查看住户列表，支持关键词搜索；导出住户数据为 Excel；下载导入模板，通过 Excel 批量导入住户（字段包括用户名、密码、姓名、电话、身份证、楼栋、单元、房号）。
工作人员管理：查看工作人员列表，支持关键词搜索；导出工作人员数据为 Excel。
访客管理：查看访客预约列表，支持按状态和时间筛选；查看访客预约详情；导出访客数据为 Excel。
出入记录管理：查看所有出入记录，支持按人员类型、出入类型、时间筛选；导出出入记录为 Excel。
考勤管理：查看工作人员的考勤记录，支持按用户和日期范围筛选。
数据可视化：查看今日出入统计（总次数、入、出、访客数）；查看各时段出入量统计；查看高峰时段人员类型分布；查看每日高峰统计；查看出入事由统计。
系统配置管理：查看所有系统配置项，可修改配置项的值。
节假日配置：查看节假日列表，支持按类型筛选；新增或删除节假日。
操作日志管理：查看操作日志列表，支持按用户名、操作类型、时间筛选。
公告管理：查看公告列表，支持按类型和状态筛选；查看公告详情；发布或下架公告。
轮播图管理：查看轮播图列表，支持按状态筛选；新增、编辑、删除轮播图。
人脸管理：为指定用户录入人脸；查询用户人脸录入状态。
权限管理：查看权限树；为角色分配权限（更新角色权限列表）。
批量导入记录：查看批量导入记录列表，支持按导入类型筛选。

普通用户端（住户）

个人资料管理：查看个人资料，可修改手机号和头像。
出入记录查询：查看本人的出入记录列表，支持按时间筛选。
访客预约管理：查看本人相关的访客预约列表，支持按状态筛选；审核访客预约（通过或拒绝并填写备注）。
消息通知管理：查看本人的消息通知列表，支持按类型和已读状态筛选；标记单条消息为已读；标记所有消息为已读；查看未读消息数量。
人脸管理：录入人脸、查询人脸录入状态、删除人脸。
密码修改：修改登录密码，需验证旧密码。

工作人员端

个人资料管理：查看个人资料，可修改手机号和头像。
出入登记：手动添加出入记录（选择人员、出入类型、事由）；查看出入记录列表，支持按人员类型、出入类型、时间筛选。
访客管理：查看访客预约详情（通过二维码）；为访客办理签到或签离；创建临时访客（填写姓名、电话、事由）。
批量导入访客：下载访客导入模板；通过 Excel 批量导入访客（含姓名、电话、事由）。
考勤打卡：上班打卡（生成入记录）；下班打卡（生成出记录）；查看今日考勤状态；查看本人考勤记录列表，支持按日期范围筛选。
住户查询：查看住户列表，支持关键词搜索。
今日统计：查看今日出入统计概览。

公共端（未登录）

轮播图查看：查看已启用的轮播图列表，按排序顺序展示。
公告查看：查看已发布的公告列表；查看公告详情。
住户查询：查看活跃住户的姓名、楼栋、单元、房号信息，用于访客预约。
访客预约：提交访客预约申请，填写访客姓名、电话、来访事由、被访住户。
访客预约查询：通过预约 ID 查看预约详情。
用户注册：注册新账号。
用户登录：通过用户名、密码、角色登录系统。

四、项目总结

本项目技术选型紧跟主流，后端采用 Spring Boot 3 + MyBatis-Plus，前端使用 Vue 3 + Vite，前后端分离、接口清晰。系统覆盖了小区出入管理的核心场景，包含人脸识别、访客预约、考勤打卡、数据统计等实用功能，并支持 Excel 批量导入导出，适合作为毕业设计、课程设计或中小型小区管理系统的二次开发基础。代码结构规范，文档齐全，易于上手和扩展。