一、项目简介

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

二、技术栈

三、功能模块

管理员端

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

普通用户端（住户）

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

工作人员端

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

公共端（未登录）

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

四、项目总结

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

界面展示

交付内容

本项目为完整交付，包含：

• 完整后端源码
• 完整前端源码
• 数据库初始化脚本（SQL）
• 万字项目文档（设计文档 / 论文，可作课程设计、毕业设计参考）

获取完整源码

完整前后端源码 + 数据库脚本 + 万字项目文档见 Gitee 仓库：https://gitee.com/kangxihuang/src-K113