一、项目简介本项目是一套基于 Spring Boot 3 Vue 3 MySQL 的小区人员出入登记管理系统采用前后端分离架构。系统面向管理员、住户、工作人员三种角色提供人脸识别出入登记、访客预约审批、考勤打卡、数据统计与可视化、批量导入、系统配置等完整功能覆盖小区人员出入管理的全流程数字化需求。系统后端基于 RESTful API 设计前端使用 Vue 3 组件化开发数据库采用 MySQL 存储业务数据整体结构清晰、易于二次开发。二、技术栈技术说明后端框架Spring Boot 3.xORMMyBatis-Plus权限控制基于角色的权限管理RBAC前端框架Vue 3状态管理Vuex / Pinia构建工具Vite数据库MySQLExcel 处理Apache POI人脸识别自定义人脸识别服务文件上传本地文件存储三、功能模块管理员端用户管理查看用户列表支持按角色和关键词筛选可新增、编辑、删除用户查看用户详情。住户管理查看住户列表支持关键词搜索导出住户数据为 Excel下载导入模板通过 Excel 批量导入住户字段包括用户名、密码、姓名、电话、身份证、楼栋、单元、房号。工作人员管理查看工作人员列表支持关键词搜索导出工作人员数据为 Excel。访客管理查看访客预约列表支持按状态和时间筛选查看访客预约详情导出访客数据为 Excel。出入记录管理查看所有出入记录支持按人员类型、出入类型、时间筛选导出出入记录为 Excel。考勤管理查看工作人员的考勤记录支持按用户和日期范围筛选。数据可视化查看今日出入统计总次数、入、出、访客数查看各时段出入量统计查看高峰时段人员类型分布查看每日高峰统计查看出入事由统计。系统配置管理查看所有系统配置项可修改配置项的值。节假日配置查看节假日列表支持按类型筛选新增或删除节假日。操作日志管理查看操作日志列表支持按用户名、操作类型、时间筛选。公告管理查看公告列表支持按类型和状态筛选查看公告详情发布或下架公告。轮播图管理查看轮播图列表支持按状态筛选新增、编辑、删除轮播图。人脸管理为指定用户录入人脸查询用户人脸录入状态。权限管理查看权限树为角色分配权限更新角色权限列表。批量导入记录查看批量导入记录列表支持按导入类型筛选。普通用户端住户个人资料管理查看个人资料可修改手机号和头像。出入记录查询查看本人的出入记录列表支持按时间筛选。访客预约管理查看本人相关的访客预约列表支持按状态筛选审核访客预约通过或拒绝并填写备注。消息通知管理查看本人的消息通知列表支持按类型和已读状态筛选标记单条消息为已读标记所有消息为已读查看未读消息数量。人脸管理录入人脸、查询人脸录入状态、删除人脸。密码修改修改登录密码需验证旧密码。工作人员端个人资料管理查看个人资料可修改手机号和头像。出入登记手动添加出入记录选择人员、出入类型、事由查看出入记录列表支持按人员类型、出入类型、时间筛选。访客管理查看访客预约详情通过二维码为访客办理签到或签离创建临时访客填写姓名、电话、事由。批量导入访客下载访客导入模板通过 Excel 批量导入访客含姓名、电话、事由。考勤打卡上班打卡生成入记录下班打卡生成出记录查看今日考勤状态查看本人考勤记录列表支持按日期范围筛选。住户查询查看住户列表支持关键词搜索。今日统计查看今日出入统计概览。公共端未登录轮播图查看查看已启用的轮播图列表按排序顺序展示。公告查看查看已发布的公告列表查看公告详情。住户查询查看活跃住户的姓名、楼栋、单元、房号信息用于访客预约。访客预约提交访客预约申请填写访客姓名、电话、来访事由、被访住户。访客预约查询通过预约 ID 查看预约详情。用户注册注册新账号。用户登录通过用户名、密码、角色登录系统。四、项目总结本项目技术选型紧跟主流后端采用 Spring Boot 3 MyBatis-Plus前端使用 Vue 3 Vite前后端分离、接口清晰。系统覆盖了小区出入管理的核心场景包含人脸识别、访客预约、考勤打卡、数据统计等实用功能并支持 Excel 批量导入导出适合作为毕业设计、课程设计或中小型小区管理系统的二次开发基础。代码结构规范文档齐全易于上手和扩展。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K113