摘 要
针对传统公寓报修流程不透明、响应效率低、任务调度无序及信息不对称等痛点，本文设计并实现了一款基于SpringBoot的公寓报修管理系统。系统采用前后端分离架构，后端以SpringBoot为核心框架，搭配MySQL数据库保障数据安全存储，前端依托Vue.js构建便捷交互界面，构建住户、维修工、管理员三大角色协同体系。住户可在线提交报修申请、标记紧急故障、查询进度并评价服务；维修工能接收任务、更新维修状态、统计工作量；管理员可完成用户管控、智能调度、数据可视化分析与系统配置。系统通过全流程数字化管控，打通报修申请、派单、维修、评价闭环，解决了传统模式下调度低效、进度不透明等问题，显著提升公寓运维效率与住户满意度。该系统操作便捷、扩展性强，为公寓物业管理提供了高效的数字化解决方案，具备良好的实用价值与推广前景。
关键词：公寓报修管理系统；SpringBoot；多角色协同；数字化运维
目 录
[++++1 绪论++++](#1 绪论)
[++++1.1 选题背景及意义++++](#1.1 选题背景及意义)
[++++1.1.1 选题的背景++++](#1.1.1 选题的背景)
[++++1.1.2 研究现状++++](#1.1.2 研究现状)
[++++1.1.3 研究意义++++](#1.1.3 研究意义)
[++++1.2 论文主要工作++++](#1.2 论文主要工作)
[++++1.2.1 研究内容++++](#1.2.1 研究内容)
[++++1.2.2 研究方法++++](#1.2.2 研究方法)
[++++1.3 本章小结++++](#1.3 本章小结)
[++++2 相关技术及理论基础++++](#2 相关技术及理论基础)
[++++2.1 前端++++](#2.1 前端)
[++++2.1.1 Vue++++](#2.1.1 Vue)
[++++2.2 后端++++](#2.2 后端)
[++++2.2.1 SpringBoot 框架++++](#2.2.1 SpringBoot 框架)
[++++2.2.2 B/S架构++++](#2.2.2 B/S架构)
[++++2.3 数据库++++](#2.3 数据库)
[++++2.3.1 MySQL++++](#2.3.1 MySQL)
[++++2.4 本章小结++++](#2.4 本章小结)
[++++3 系统分析++++](#3 系统分析)
[++++3.1 可行性分析++++](#3.1 可行性分析)
[++++3.1.1 经济可行性++++](#3.1.1 经济可行性)
[++++3.1.2 技术可行性++++](#3.1.2 技术可行性)
[++++3.1.3 操作可行性++++](#3.1.3 操作可行性)
[++++3.2 需求分析++++](#3.2 需求分析)
[++++3.2.1 功能需求分析++++](#3.2.1 功能需求分析)
[++++3.2.2 业务需求分析++++](#3.2.2 业务需求分析)
[++++3.2.3 数据需求分析++++](#3.2.3 数据需求分析)
[++++3.3 本章小结++++](#3.3 本章小结)
[++++4 概要设计++++](#4 概要设计)
[++++4.1 体系结构设计++++](#4.1 体系结构设计)
[++++4.2 功能模块概要设计++++](#4.2 功能模块概要设计)
[++++4.2.1 前台报修服务模块++++](#4.2.1 前台报修服务模块)
[++++4.2.2 后台管理模块++++](#4.2.2 后台管理模块)
[++++4.3 数据库概要设计++++](#4.3 数据库概要设计)
[++++4.3.1 E-R图设计++++](#4.3.1 E-R图设计)
[++++4.4 本章小结++++](#4.4 本章小结)
[++++5 详细设计++++](#5 详细设计)
[++++5.1 功能模块详细设计++++](#5.1 功能模块详细设计)
[++++5.1.1 用户管理功能++++](#5.1.1 用户管理功能)
[++++5.1.3 任务接单操作++++](#5.1.3 任务接单操作)
[++++5.1.4 数据统计模块++++](#5.1.4 数据统计模块)
[++++5.1.5 系统管理模块++++](#5.1.5 系统管理模块)
[++++5.2 系统类和接口设计++++](#5.2 系统类和接口设计)
[++++5.3 数据库的详细设计++++](#5.3 数据库的详细设计)
[++++5.3.1 数据库的逻辑设计++++](#5.3.1 数据库的逻辑设计)
[++++5.3.2 数据库的物理设计++++](#5.3.2 数据库的物理设计)
[++++5.4 本章小结++++](#5.4 本章小结)
[++++6 系统实现++++](#6 系统实现)
[++++6.1 用户功能实现++++](#6.1 用户功能实现)
[++++6.1.1 注册登录++++](#6.1.1 注册登录)
[++++6.1.2 智能客服++++](#6.1.2 智能客服)
[++++6.1.3 个人中心++++](#6.1.3 个人中心)
[++++6.1.4 报修申请++++](#6.1.4 报修申请)
[++++6.2 维修工功能实现++++](#6.2 维修工功能实现)
[++++6.2.1 报修申请++++](#6.2.1 报修申请)
[++++6.2.2 报修接单++++](#6.2.2 报修接单)
[++++6.2.3 维修完成++++](#6.2.3 维修完成)
[++++6.2.4 异常上报++++](#6.2.4 异常上报)
[++++6.3 管理员功能实现++++](#6.3 管理员功能实现)
[++++5.3.1 用户管理++++](#5.3.1 用户管理)
[++++6.3.2 报修申请++++](#6.3.2 报修申请)
[++++6.3.3 报修接单++++](#6.3.3 报修接单)
[++++6.3.2 日志管理模块++++](#6.3.2 日志管理模块)
[++++6.4 本章小结++++](#6.4 本章小结)
[++++7 系统测试++++](#7 系统测试)
[++++7.1 测试任务及目标++++](#7.1 测试任务及目标)
[++++7.1.1 测试任务++++](#7.1.1 测试任务)
[++++7.1.2 测试目标++++](#7.1.2 测试目标)
[++++7.1.3 测试方法++++](#7.1.3 测试方法)
[++++7.1.4 测试工具++++](#7.1.4 测试工具)
[++++7.2 测试用例++++](#7.2 测试用例)
[++++7.3 非功能测试++++](#7.3 非功能测试)
[++++7.4 本章小结++++](#7.4 本章小结)
[++++8 结论++++](#8 结论)
[++++致 谢++++](#致 谢)
1 绪论
1.1 选题背景及意义
1.1.1 选题的背景
随着城市化进程加快，公寓居住模式日益普及，住户对居住舒适度与运维服务效率的要求持续提升。传统公寓报修依赖电话沟通、纸质登记等方式，存在流程不透明、响应滞后、任务调度无序、信息不对称等突出痛点：住户无法实时追踪报修进度，维修工任务分配缺乏科学依据，管理员难以统筹管控运维全流程，导致维修效率低下、住户满意度偏低。在数字经济推动下，物业行业数字化转型成为必然趋势，而现有多数公寓运维系统功能单一、多角色协同不足，难以满足精细化管理需求。SpringBoot、Vue.js等技术的成熟应用，为构建高效、便捷的报修管理系统提供了坚实技术支撑，在此背景下，开发一款覆盖全流程、多角色协同的公寓报修管理系统，成为解决传统运维痛点、提升服务质量的迫切需求。
研究意义
本研究的实践意义在于，通过构建基于SpringBoot的公寓报修管理系统，打通报修申请、派单、维修、评价全流程闭环，解决传统模式下的效率低、流程乱、信息不透明等问题。系统可实现多角色高效协同，提升公寓运维效率与住户满意度，为物业企业提供数字化管理工具，降低人力与管理成本。理论意义方面，本研究丰富了SpringBoot框架在物业运维领域的应用案例，完善了多角色协同系统的设计思路，为同类轻量化运维系统的开发提供技术参考与实践范式，助力物业行业数字化转型进程。
需求分析
3.2.1 功能需求分析
1.住户角色功能
- 注册与登录：使用手机号实名注册，支持短信验证码登录，密码采用MD5加密存储。
- 个人信息管理：维护姓名、所属公寓楼号、房间号、联系电话、租期等基本信息。
- 报修类型浏览：查看系统预设的报修分类（如水电、门窗、网络、家具、卫浴、家电、安防等）及说明。
- 在线报修提交：选择报修类型，填写故障描述，上传现场照片或视频作为凭证，提交报修申请。
- 报修进度查询：实时查看已提交报修单的状态（待处理、已接单、维修中、已完成）。
- 维修评价反馈：维修完成后可对服务进行1-5星评分，并填写文字评价。
- 历史记录查看：查阅个人所有历史报修记录，支持按时间、状态筛选。
- 消息通知接收：接收系统推送的接单通知、维修完成提醒、超时预警等消息。
- 紧急报修标记：对影响安全或生活的严重故障（如漏水、断电、燃气异味），可标记为"紧急"，优先处理。
- 报修取消：在维修员未接单前，可取消已提交的报修申请。
- 智能客服：接入AI客服，解答常见问题（如"维修多久上门？""是否收费？"）。用户用例图如图3-1所示。
维修工角色功能
- 注册与登录：由管理员分配工号，支持账号密码登录。
- 任务列表查看：查看分配至本人的所有报修任务，按状态（待接单、进行中、已完成）分类展示。
- 任务接单操作：点击"接单"确认受理报修，系统通知住户。
- 维修状态更新：在维修过程中可更新状态为"维修中"，并添加处理备注（如"需更换配件，明日送达"）。
- 完工提交：维修完成后上传维修后照片，点击"完成"，住户可进行评价。
- 任务详情查看：查看报修单的完整信息，包括住户房间、故障描述、上传图片、报修时间。
- 消息通知接收：接收新派单、紧急任务、系统公告等通知。
- 工作量统计：查看个人当日/当月已完成任务数、用户评分等数据。
- 异常上报：对无法修复、需更换配件或非职责范围内的报修，可标记为"异常"并说明原因。
个人信息维护：更新联系方式、技能标签（如"擅长电路""精通水管""会修空调"）。维修工用例图如图3.2所示。
管理员角色功能
- 用户管理：增删改查住户与维修工账号，重置密码，冻结违规账户（如恶意报修）。
- 报修单管理：查看全公寓所有报修单，支持按楼栋、报修类型、状态、时间多条件筛选。
- 维修工调度：根据任务紧急程度、维修工位置及技能标签，手动调整任务分配。
- 公寓楼信息维护：管理园区内所有公寓楼、单元、房间号基础数据。
- 公告管理：发布系统通知。
- 评价审核：查看所有维修评价，对恶意差评或虚假评价进行复核处理。
- 数据统计与可视化：利用ECharts生成图表，展示日均报修量趋势；各楼栋故障类型分布。
- 系统配置与安全：管理操作日志，记录关键行为；定期备份数据库。管理员用例图如图3.3所示。
功能模块概要设计
公寓报修管理系统主体分为前台报修服务模块以及后台管理模块，住户、维修工无需复杂操作即可进入前台模块完成核心业务交互，简化报修与维修流程；管理员通过后台管理模块实现全系统的权限管控、数据管理与业务调度，保障系统高效运转。
在前台报修服务模块中，面向住户端核心功能围绕 "报修全流程操作" 展开：住户无需登录即可浏览报修指南、常见故障解决方案，登录后可提交报修申请（填写故障类型、紧急程度、故障描述，上传故障图片凭证），实时查看报修进度（待审核 / 待接单 / 维修中 / 已完成），维修完成后可对服务质量进行评价，同时支持查询个人历史报修记录、接收系统推送的维修进度通知。面向维修工端核心功能聚焦 "维修任务处理"：维修工登录后可查看待接单任务列表（按紧急程度排序），接单后更新维修状态（待维修 / 维修中 / 已完成），上报维修异常（故障无法解决、需配件更换等），上传维修完工凭证（完工图片、维修备注），查询个人维修工作量统计、接收管理员调度指令与紧急任务提醒。
在后台管理模块中，管理员可进行的操作大致有：用户管理：添加、编辑、删除住户 / 维修工账号信息，配置角色权限（如普通住户 / VIP 住户 / 普通维修工 / 高级维修工），冻结 / 解锁异常账号；报修管理：审核住户报修申请（通过 / 驳回并备注原因），手动调度维修任务至指定维修工，查看全量报修数据（按楼栋 / 故障类型 / 紧急程度筛选），处理报修异常申诉；维修管理：管理维修工技能标签（添加 / 编辑 / 删除），统计维修工工作量与完成率，审核维修工异常上报申请；数据统计：生成多维度统计报表（日均报修量、楼栋故障分布、维修完成率、用户满意度等），支持报表导出与可视化展示（柱状图 / 折线图 / 饼图）；系统管理：发布系统公告（如维修停服通知、故障预警），配置系统参数（报修紧急程度规则、评价计分规则），管理操作日志与登录日志（日志包含账号信息、操作模块、操作类型、操作时间 / 登录时间，支持日志搜索、筛选、下载）；同时支持公告管理（添加 / 编辑 / 删除公告）、数据备份与恢复，保障系统数据安全与业务连续性。
数据库的物理设计
- 报修接单表：用于记录公寓报修接单全流程信息，含所属楼号、房间号、报修编号、维修状态等核心字段，支撑接单与进度跟踪。如表5-1所示。
表5-1 报修接单表（baoxiujiedan）
|--------------------|-----------|-----|----|----|------------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识报修接单记录 |
| addtime | timestamp | - | 否 | 是 | 数据创建时间 |
| suoshulouhao | varchar | 16 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
| baoxiubianhao | varchar | 16 | 否 | 否 | 报修编号 |
| guzhangmiaoshu | longtext | - | 否 | 否 | 故障描述 |
| baoxiushijian | datetime | - | 否 | 否 | 报修时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
| yonghuming | varchar | 16 | 否 | 否 | 用户名 |
| yonghuxingming | varchar | 200 | 否 | 否 | 用户姓名 |
| tupian | longtext | - | 否 | 否 | 图片 |
| jinjizhuangtai | varchar | 200 | 否 | 否 | 紧急状态 |
| jiedanshijian | datetime | - | 否 | 否 | 接单时间 |
| weixiuzhuangtai | varchar | 200 | 否 | 否 | 维修状态 |
| weixiugonggonghao | varchar | 200 | 否 | 否 | 维修工工号 |
| weixiugongxingming | varchar | 200 | 否 | 否 | 维修工姓名 |
- 报修类型表：用于存储系统预设报修分类，核心字段为报修类型名称，为住户报修选择与后台分类管理提供数据支撑。如表5-2所示。
表5-2 报修类型表（baoxiuleixing）
|---------------|-----------|----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识报修类型 |
| addtime | timestamp | - | 否 | 是 | 类型创建时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
- 报修申请表：用于存储住户报修申请原始信息，含故障描述、紧急状态、图片等字段，支撑申请审核与后续流转。如表5-3所示。
表5-3 报修申请表（baoxiushenqing）
|-----------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识报修申请 |
| addtime | timestamp | - | 否 | 是 | 申请创建时间 |
| suoshulouhao | varchar | 16 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
| baoxiubianhao | varchar | 16 | 否 | 否 | 报修编号 |
| guzhangmiaoshu | longtext | - | 否 | 否 | 故障描述 |
| baoxiushijian | datetime | - | 否 | 否 | 报修时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
| yonghuming | varchar | 16 | 否 | 否 | 用户名 |
| yonghuxingming | varchar | 200 | 否 | 否 | 用户姓名 |
| sfsh | varchar | 200 | 否 | 否 | 是否审核 |
| shhf | longtext | - | 否 | 否 | 回复内容 |
| tupian | longtext | - | 否 | 否 | 图片 |
| jinjizhuangtai | varchar | 200 | 否 | 否 | 紧急状态 |
| baoxiuzhuangtai | varchar | 200 | 否 | 否 | 报修状态 |
- 智能客服表：用于记录住户与客服的对话数据，含提问内容、回复内容、用户ID等字段，支撑智能咨询服务。如表5-5所示。
表5-5 智能客服表（chat）
|------------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识客服对话 |
| addtime | timestamp | - | 否 | 是 | 对话创建时间 |
| adminid | bigint | 20 | 否 | 否 | 管理员id |
| ask | longtext | - | 否 | 否 | 提问内容 |
| reply | longtext | - | 否 | 否 | 回复内容 |
| isreply | int | 11 | 否 | 否 | 是否回复 |
| admin_table_name | varchar | 200 | 否 | 否 | 管理表 |
| user_table_name | varchar | 200 | 否 | 否 | 用户表 |
| is_read | int | 11 | 否 | 否 | 已读状态 |
| user_name | varchar | 200 | 否 | 否 | 用户名 |
| user_image | longtext | - | 否 | 否 | 用户头像 |
| type | int | 11 | 否 | 否 | 内容类型 |
| userid | bigint | 20 | 否 | 是 | 用户id |
- 轮播图表：用于存储系统轮播图配置信息，含名称、链接、图片等字段，支撑首页轮播展示功能。如表5-5所示。
表5-5 轮播图表（config）
|---------|-----------|-----|----|----|---------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识轮播图 |
| addtime | timestamp | - | 否 | 是 | 轮播图添加时间 |
| name | varchar | 200 | 否 | 是 | 名称 |
| value | longtext | - | 否 | 否 | 值 |
| url | longtext | - | 否 | 否 | 链接 |
- 维修完成评论表：用于存储住户维修评价数据，含评分、评论内容、关联维修记录ID等字段，支撑服务质量反馈。如表5-6所示。
表5-6 维修完成评论表（discussweixiuwancheng）
|-------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识评论记录 |
| addtime | timestamp | - | 否 | 是 | 评论提交时间 |
| refid | bigint | 20 | 否 | 是 | 关联表id |
| userid | bigint | 20 | 否 | 是 | 用户id |
| avatarurl | longtext | - | 否 | 否 | 头像 |
| nickname | varchar | 200 | 否 | 否 | 用户名 |
| score | double | - | 否 | 否 | 评分 |
| content | longtext | - | 否 | 是 | 评论内容 |
| reply | longtext | - | 否 | 否 | 回复内容 |
| thumbsupnum | int | 11 | 否 | 否 | 赞 |
| crazilynum | int | 11 | 否 | 否 | 踩 |
| istop | int | 11 | 否 | 否 | 置顶 |
| tuserids | longtext | - | 否 | 否 | 赞用户ids |
| cuserids | longtext | - | 否 | 否 | 踩用户ids |
- 公寓楼信息表：用于存储公寓楼基础数据，含公寓楼号、单元、房间号等字段，支撑住户归属与地址管理。如表5-7所示。
表5-7 公寓楼信息表（gongyulouxinxi）
|-------------|-----------|----|----|----|-----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识公寓楼信息 |
| addtime | timestamp | - | 否 | 是 | 信息添加时间 |
| gongyulou | varchar | 16 | 否 | 否 | 公寓楼 |
| danyuan | varchar | 16 | 否 | 否 | 单元 |
| fangjianhao | varchar | 16 | 否 | 否 | 房间号 |
- 消息通知表：用于存储系统公告与通知信息，含标题、内容、图片等字段，支撑管理员向用户推送重要信息。如表5-8所示。
表5-8 消息通知表（news）
|--------------|-----------|----|----|----|--------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识通知 |
| addtime | timestamp | - | 否 | 是 | 通知发布时间 |
| title | varchar | 32 | 否 | 是 | 标题 |
| introduction | longtext | - | 否 | 否 | 简介 |
| picture | longtext | - | 否 | 是 | 图片 |
| content | longtext | - | 否 | 是 | 内容 |
- 管理员表：用于存储管理员账户信息，含用户名、密码、角色等字段，支撑系统后台权限管控与操作。如表5-9所示。
表5-9 管理员表（users）
|----------|-----------|-----|----|----|---------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识管理员 |
| addtime | timestamp | - | 否 | 是 | 账号创建时间 |
| username | varchar | 200 | 否 | 是 | 用户名 |
| password | varchar | 200 | 否 | 是 | 密码 |
| role | varchar | 200 | 否 | 否 | 角色 |
- 维修工表：用于存储维修工账户与技能信息，含工号、密码、维修标签等字段，支撑维修任务分配与管理。如表5-10所示。
表5-10 维修工表（weixiugong）
|--------------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识维修工 |
| addtime | timestamp | - | 否 | 是 | 账号创建时间 |
| touxiang | longtext | - | 否 | 否 | 头像 |
| weixiugonggonghao | varchar | 16 | 否 | 是 | 维修工工号 |
| mima | varchar | 200 | 否 | 是 | 密码 |
| weixiugongxingming | varchar | 16 | 否 | 是 | 维修工姓名 |
| nianling | varchar | 200 | 否 | 否 | 年龄 |
| xingbie | varchar | 16 | 否 | 否 | 性别 |
| lianxifangshi | varchar | 32 | 否 | 否 | 联系方式 |
| pquestion | varchar | 200 | 否 | 否 | 密保问题 |
| panswer | varchar | 200 | 否 | 否 | 密保答案 |
| max_password_wrong | int | 11 | 否 | 是 | 最大密码输错次数 |
| is_locked | int | 11 | 否 | 是 | 用户锁定状态 |
| weixiubiaoqian | varchar | 200 | 否 | 否 | 维修标签 |
- 维修完成表：用于记录维修完成后的归档信息，含完成图片、维修备注等字段，支撑维修成果留存与核查。如表5-11所示。
表5-11 维修完成表（weixiuwancheng）
|--------------------|-----------|-----|----|----|------------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识维修完成记录 |
| addtime | timestamp | - | 否 | 是 | 记录创建时间 |
| suoshulouhao | varchar | 16 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
| baoxiubianhao | varchar | 16 | 否 | 否 | 报修编号 |
| guzhangmiaoshu | longtext | - | 否 | 否 | 故障描述 |
| baoxiushijian | datetime | - | 否 | 否 | 报修时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
| yonghuming | varchar | 16 | 否 | 否 | 用户名 |
| yonghuxingming | varchar | 200 | 否 | 否 | 用户姓名 |
| jinjizhuangtai | varchar | 200 | 否 | 否 | 紧急状态 |
| jiedanshijian | datetime | - | 否 | 否 | 接单时间 |
| weixiugonggonghao | varchar | 200 | 否 | 否 | 维修工工号 |
| weixiugongxingming | varchar | 200 | 否 | 否 | 维修工姓名 |
| wanchengtupian | longtext | - | 否 | 否 | 完成图片 |
| weixiubeizhu | varchar | 200 | 否 | 否 | 维修备注 |
| discuss_number | int | 11 | 否 | 否 | 评论数 |
- 维修信息表：用于跟踪维修全流程状态，含维修时间、状态更新、备注等字段，支撑维修进度实时管控。如表5-12所示。
表5-12 维修信息表（weixiuxinxi）
|--------------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识维修信息 |
| addtime | timestamp | - | 否 | 是 | 记录创建时间 |
| suoshulouhao | varchar | 16 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
| baoxiubianhao | varchar | 16 | 否 | 否 | 报修编号 |
| guzhangmiaoshu | longtext | - | 否 | 否 | 故障描述 |
| baoxiushijian | datetime | - | 否 | 否 | 报修时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
| yonghuming | varchar | 16 | 否 | 否 | 用户名 |
| yonghuxingming | varchar | 200 | 否 | 否 | 用户姓名 |
| jinjizhuangtai | varchar | 200 | 否 | 否 | 紧急状态 |
| jiedanshijian | datetime | - | 否 | 否 | 接单时间 |
| weixiuzhuangtai | varchar | 200 | 否 | 否 | 维修状态 |
| weixiugonggonghao | varchar | 200 | 否 | 否 | 维修工工号 |
| weixiugongxingming | varchar | 200 | 否 | 否 | 维修工姓名 |
| weixiushijian | datetime | - | 否 | 否 | 维修时间 |
| beizhu | varchar | 200 | 否 | 否 | 备注 |
- 异常上报表：用于记录维修中的异常情况，含异常原因、上报时间等字段，支撑特殊问题处理与审核。如表5-13所示。
表5-13 异常上报表（yichangshangbao）
|--------------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识异常上报 |
| addtime | timestamp | - | 否 | 是 | 上报记录创建时间 |
| suoshulouhao | varchar | 16 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
| baoxiubianhao | varchar | 16 | 否 | 否 | 报修编号 |
| guzhangmiaoshu | longtext | - | 否 | 否 | 故障描述 |
| baoxiushijian | datetime | - | 否 | 否 | 报修时间 |
| baoxiuleixing | varchar | 16 | 否 | 否 | 报修类型 |
| yonghuming | varchar | 16 | 否 | 否 | 用户名 |
| yonghuxingming | varchar | 200 | 否 | 否 | 用户姓名 |
| sfsh | varchar | 200 | 否 | 否 | 是否审核 |
| shhf | longtext | - | 否 | 否 | 回复内容 |
| jinjizhuangtai | varchar | 200 | 否 | 否 | 紧急状态 |
| jiedanshijian | datetime | - | 否 | 否 | 接单时间 |
| weixiuzhuangtai | varchar | 200 | 否 | 否 | 维修状态 |
| weixiugonggonghao | varchar | 200 | 否 | 否 | 维修工工号 |
| weixiugongxingming | varchar | 200 | 否 | 否 | 维修工姓名 |
| yuanyin | longtext | - | 否 | 否 | 原因 |
| shangbaoshijian | datetime | - | 否 | 否 | 上报时间 |
- 用户表：用于存储住户账户与个人信息，含用户名、密码、所属楼号、房间号等字段，支撑住户身份认证与管理。如表5-15所示。
表5-15 用户表（yonghu）
|--------------------|-----------|-----|----|----|----------|
| 列名 | 数据类型 | 长度 | 主键 | 非空 | 备注 |
| id | bigint | 20 | 是 | 是 | 唯一标识住户 |
| addtime | timestamp | - | 否 | 是 | 账号创建时间 |
| yonghuming | varchar | 10 | 否 | 是 | 用户名 |
| mima | varchar | 200 | 否 | 是 | 密码 |
| yonghuxingming | varchar | 10 | 否 | 否 | 用户姓名 |
| touxiang | longtext | - | 否 | 否 | 头像 |
| xingbie | varchar | 16 | 否 | 否 | 性别 |
| nianling | int | 11 | 否 | 否 | 年龄 |
| shoujihao | varchar | 50 | 否 | 否 | 手机号 |
| youxiang | varchar | 200 | 否 | 否 | 邮箱 |
| dizhi | varchar | 200 | 否 | 否 | 地址 |
| pquestion | varchar | 200 | 否 | 否 | 密保问题 |
| panswer | varchar | 200 | 否 | 否 | 密保答案 |
| max_password_wrong | int | 11 | 否 | 是 | 最大密码输错次数 |
| is_locked | int | 11 | 否 | 是 | 用户锁定状态 |
| suoshulouhao | varchar | 200 | 否 | 否 | 所属楼号 |
| fangjianhao | varchar | 200 | 否 | 否 | 房间号 |
用户功能实现
6.1.1 注册登录
页面是系统统一身份认证入口，展示账号、密码、验证码输入框，还设注册、忘记密码入口，前端路由卫士会将未登录访问请求自动跳转至页。后端通过/login接口实现登录逻辑，先查询YonghuEntity校验账号是否锁定，再对比MD5加密后的密码，密码错误累计超3次则锁定账号，验证通过后生成token返回，前端将token存入LocalStore，完成身份认证，为后续功能访问做权限支撑。如图6.1所示。
智能客服
页面为用户提供智能咨询交互界面，展示聊天时间与对话内容，支持用户输入问题并接收系统智能回复。后端通过/lists接口实现对话数据查询，创建EntityWrapper对象，通过MPUtil处理查询条件，调用chatService.selectListView获取聊天记录并返回，前端渲染数据展示交互内容，为用户解决系统使用中的各类疑问，提供便捷咨询渠道。如图5-3所示。
维修工功能实现
6.2.1 报修申请
页面是维修工查看分配任务的核心界面，展示所属楼号、房间号、报修类型、用户信息等任务详情，支持按报修时间、用户姓名筛选。后端通过/info/{id}接口根据报修ID查询BaoxiushenqingEntity，脱敏后调用baoxiushenqingService.selectView返回数据，为维修工快速查看、筛选待处理任务提供数据支撑。如图5-7所示。
维修完成
页面是维修工完成维修后的信息提交页，支持上传维修后图片、填写维修备注，补充故障处理详情。后端通过/detail/{id}接口根据维修ID查询WeixiuwanchengEntity，脱敏后调用weixiuwanchengService.selectView返回数据，维修工提交信息后，系统更新维修状态，触发住户评价流程。如图5-10所示。
管理员功能实现
5.3.1 用户管理
页面是管理员管控住户账号的核心页，展示住户用户名、姓名、联系方式、所属楼号等信息，支持新增、修改、删除、禁用账号及搜索功能。后端通过/query接口创建YonghuEntity的查询条件，经MPUtil处理后调用yonghuService.selectView获取数据，管理员执行操作时，后端对应接口完成数据增删改存，实现住户账号精细化管控。如图5-13所示。
报修申请
页面是管理员审核全系统报修申请的页面，含报修统计图表与申请列表，支持按楼号、报修状态多条件筛选，设审核、删除按钮。后端通过/shBatch接口批量更新报修单审核状态与回复内容，调用baoxiushenqingService.updateBatchById同步数据库，管理员可在完成报修申请的集中审核与管控。如图5-15所示。
结论
本研究设计并实现的基于SpringBoot的公寓报修管理系统，精准聚焦传统公寓报修流程不透明、响应滞后、调度无序等痛点，以多角色协同为核心，构建了覆盖住户、维修工、管理员的全流程数字化管理体系。系统采用前后端分离架构，后端依托SpringBoot框架保障业务逻辑高效运行，前端通过Vue.js搭建简洁易用的交互界面，MySQL数据库提供稳定的数据存储支撑，技术选型成熟适配、架构设计科学合理。功能层面，系统实现了报修申请、接单处理、状态跟踪、评价反馈等核心流程闭环，支持紧急报修优先级划分、异常情况上报、数据统计可视化等特色功能，全方位满足公寓运维精细化管理需求。经测试验证，系统功能完整、运行稳定，数据交互准确，操作便捷无门槛，有效提升了报修响应效率与住户满意度，降低了物业运维管理成本，为中小规模公寓提供了轻量化、高扩展性的数字化解决方案，具备较强的实用价值与推广前景。
展望未来，系统可从多维度迭代优化：一是引入AI智能调度算法，结合维修工技能、位置等因素实现任务自动最优分配；二是完善移动端适配，开发小程序或APP，满足用户碎片化使用需求；三是集成IoT设备监测功能，实现水电故障自动预警与报修；四是深化数据挖掘分析，为公寓设施维护、服务优化提供更精准的决策支撑；五是拓展多场景适配，将系统功能延伸至商业公寓、产业园区等运维场景，进一步扩大应用范围。