毕业设计实战：基于Spring Boot+Vue的酒店客房管理系统设计与实现

一、项目背景：酒店运营数字化下的客房管理痛点破解

在旅游行业复苏与酒店业竞争加剧的背景下，传统酒店客房管理模式的低效问题愈发突出——人工登记易出错、客房状态同步不及时、预约退房流程繁琐、清洁任务分配混乱等痛点，严重影响客户体验与运营效率。据行业调研显示，超过65%的中小型酒店仍依赖Excel或纸质档案管理客房与订单，近70%的前台人员反馈“高峰期查询客房状态需反复核对”，60%的客户抱怨“预约后无法实时跟踪审核进度”。

随着“智慧酒店”理念的推进，基于Spring Boot+Vue的酒店客房管理系统成为解决传统困境的核心方案。该系统采用B/S架构，整合“管理员统筹-用户便捷预订-会员专属服务-清洁人员高效执行”四角色需求，实现从客房管理、预约审核到入住退房、清洁跟踪的全流程数字化闭环。本毕业设计以酒店实际运营需求为导向，构建了功能完善的客房管理体系，为酒店业降本增效与服务升级提供了可落地的技术方案。

二、核心技术栈：酒店客房系统的技术支撑体系

项目以“稳定性、易用性、可扩展性”为核心目标，选用前后端分离架构与开源技术栈，确保系统适配酒店多场景使用需求，同时降低开发与运维成本：

技术模块	具体工具/技术	核心作用
后端框架	Spring Boot	简化项目配置，实现业务逻辑分层开发（如预约审核、入住管理模块），提升代码可维护性与接口响应效率
前端框架	Vue.js + Bootstrap	构建响应式交互界面，适配管理员PC端管控、用户手机端预订，支持组件化开发，优化界面加载速度
数据库	MySQL 8.0	存储四角色信息、客房台账、预约订单、清洁记录等核心业务数据，保证数据完整性（如客房号与订单强关联）
架构模式	B/S结构	支持跨设备、跨场景访问，无需安装客户端，浏览器即可完成客房预订、清洁任务接收等操作
开发工具	Eclipse（后端）+ VS Code（前端）+ Navicat	分工协作提升开发效率，Navicat实现数据库可视化管理，便于客房数据与订单维护
服务器	Tomcat 9.0	部署后端Web应用，处理HTTP请求（如预约提交、清洁状态更新），保障多用户并发操作稳定性
安全技术	四角色权限控制 + 数据校验 + MD5加密	区分管理员、用户、会员、清洁人员操作权限，用户密码加密存储，防止越权访问与隐私泄露

三、项目全流程：7步搭建完整酒店客房管理系统

3.1 第一步：需求分析——明确系统核心功能边界

针对传统酒店客房管理痛点，系统围绕“管理员高效管控、多角色协同操作”目标，明确功能性与非功能性需求：

3.1.1 功能性需求（四角色权限体系）

1. 管理员角色：系统最高权限，负责全局运营管控

   • 个人中心：修改账号密码与个人信息，保障管理权限安全；
   • 人员管理：
     • 用户管理：新增/编辑/删除用户账号，维护用户姓名、联系方式等信息；
     • 会员管理：审核用户会员申请，维护会员等级与专属权益；
     • 清洁人员管理：配置清洁人员账号，分配清洁区域，跟踪任务完成情况；
   • 核心业务管理：
     • 客房信息管理：维护客房编号、类型、床型、价格、状态（可约/已住/待清洁），上传客房图片与介绍；
     • 预约管理：审核用户/会员预约申请，处理取消预约请求，反馈审核意见；
     • 入住退房管理：查看用户/会员入住记录，审核退房申请，管理押金退还；
     • 清洁管理：分配客房清洁任务，查看清洁进度，审核清洁完成情况；
   • 辅助管理：发布酒店资讯（如促销活动、入住须知），管理留言板与在线客服回复，维护系统基础配置。

2. 用户角色：聚焦便捷预订与基础服务

   • 个人中心：维护个人姓名、身份证、联系方式，修改登录密码；
   • 客房交互：浏览客房列表（按类型/价格筛选），查看客房详情（图片、面积、设施），收藏心仪客房；
   • 预约管理：提交客房预约申请（选择入住时间、填写入住人数），跟踪审核进度，取消未通过预约；
   • 入住退房：查看预约通过通知，提交入住登记信息，申请退房并跟踪押金退还状态。

3. 会员角色：享受专属服务与权益

   • 个人中心：维护会员等级信息，查看积分与专属优惠；
   • 预约管理：提交会员专属预约（优先审核、会员折扣），查看历史预约记录；
   • 入住退房：享受会员快速入住通道，查看会员专属押金政策，优先处理退房申请；
   • 取消管理：提交预约取消申请，查看取消原因审核结果，享受会员取消违约金减免权益。

4. 清洁人员角色：专注客房清洁任务执行

   • 个人中心：维护个人联系方式、工作区域，修改登录密码；
   • 清洁任务管理：接收管理员分配的客房清洁任务（含客房号、清洁标准），更新清洁进度（待清洁/清洁中/已完成）；
   • 记录管理：提交清洁完成报告，上传清洁后客房照片，查看历史清洁任务记录。

3.1.2 非功能性需求

• 系统性能：支持至少50个用户同时在线操作（如高峰期预约、入住登记），页面加载时间≤3秒，预约提交与审核响应时间≤1秒；
• 数据安全性：用户身份证、会员信息等敏感数据加密存储，仅授权角色可见；操作日志全程记录（如客房删除、订单取消），便于问题追溯；
• 数据完整性：客房状态、预约订单、清洁记录实时同步，确保信息不重复、不缺失（如已入住客房自动标记为“不可约”）；
• 易用性：界面布局贴合用户习惯（如用户预订仅需“选客房→填信息→提交预约”3步），新用户无需培训即可上手，清洁人员任务界面直观易懂。

3.2 第二步：系统分析——验证项目可行性与性能目标

3.2.1 可行性分析

• 技术可行性：Spring Boot与Vue.js框架成熟且文档丰富，开发团队掌握前后端分离开发技术，能独立完成预约审核、清洁任务分配等核心模块；B/S架构适配酒店多角色跨设备使用场景，技术风险低；
• 经济可行性：所用开发工具与技术框架均为开源版本，无软件采购成本；系统对服务器配置要求低（普通办公电脑即可部署），降低酒店IT投入；
• 操作可行性：前端界面采用Bootstrap响应式设计，适配电脑、手机、平板；管理员操作流程符合酒店管理习惯，用户预订步骤简洁，清洁人员任务接收直观，各角色平均5分钟可掌握核心操作。

3.2.2 系统性能分析

• 安全性：用户登录需验证账号密码与角色身份，四角色权限严格隔离（如清洁人员无法修改客房价格）；关键操作（如订单删除、押金退还）需二次确认，防止误操作；
• 稳定性：通过MySQL数据库连接池优化数据访问，避免高峰期（如节假日预订）连接超时；Tomcat线程池管理请求，确保多用户同时提交预约时系统稳定运行。

3.3 第三步：系统设计——构建架构与数据库模型

3.3.1 系统总体架构（前后端分离+三层架构）

1. 前端层（Vue.js）：通过组件化页面呈现四角色操作界面，调用后端API接口实现数据交互，如用户提交预约、清洁人员更新任务状态；
2. 后端层：
   • 表现层（Controller）：接收前端请求，返回处理结果（如预约审核状态、客房列表数据）；
   • 业务逻辑层（Service）：实现核心业务逻辑，如预约合法性校验、客房状态同步、清洁任务分配；
   • 数据访问层（DAO）：基于MyBatis实现数据库交互，编写SQL语句完成数据增删改查；
3. 数据层（MySQL）：存储所有业务数据，通过外键关联确保表间数据一致性（如订单表关联客房表与用户表）。

3.3.2 核心数据库设计

系统设计18张核心数据表，覆盖四角色业务全链路，关键表结构如下：

表名	核心字段	作用
管理员表（admin）	id（主键）、username、password（MD5加密）、role、addtime	存储管理员账号信息，控制系统全局管理权限
用户表（user）	id（主键）、zhanghao（账号）、mima（加密密码）、xingming（姓名）、shouji（手机）、shenfenzheng（身份证）	记录普通用户信息，关联用户预约与入住记录
会员表（member）	id（主键）、zhanghao（账号）、mima（加密密码）、xingming（姓名）、shouji（手机）、shenfenzheng（身份证）、huiyuandengji（会员等级）	存储会员信息，关联会员专属预约与优惠
清洁人员表（cleaner）	id（主键）、qingjiezhanghao（账号）、mima（加密密码）、qingjiexingming（姓名）、shouji（手机）、gongzuoquyu（工作区域）	记录清洁人员信息，关联清洁任务
客房信息表（room_info）	id（主键）、kefanghao（客房号）、kefangleixing（类型）、chuangxing（床型）、fangjianmianji（面积）、jiage（价格）、kefangzhuangtai（状态）、kefangtupian（图片）	维护客房基础台账，支撑预约与清洁管理
用户预约表（user_reserve）	id（主键）、yuyuebianhao（预约编号）、kefanghao（客房号）、zhanghao（用户账号）、ruzhushijian（入住时间）、tianshu（天数）、zongjia（总价）、sfsh（审核状态）	跟踪用户预约全流程，记录审核与支付状态
会员预约表（member_reserve）	id（主键）、yuyuebianhao（预约编号）、kefanghao（客房号）、zhanghao（会员账号）、huiyuanhuodong（会员活动）、sfsh（审核状态）	存储会员预约信息，关联会员专属权益
清洁任务表（clean_task）	id（主键）、kefanghao（客房号）、qingjiezhanghao（清洁账号）、shifoudasao（是否打扫）、dasaoshijian（打扫时间）、qingjiezhuangtai（清洁状态）	分配与跟踪客房清洁任务，确保客房及时复用
入住表（check_in）	id（主键）、dingdanbianhao（订单编号）、kefanghao（客房号）、zhanghao（用户/会员账号）、ruzhuyajin（押金）、ruzhushijian（入住时间）、ispay（支付状态）	记录入住信息，关联押金与支付记录
退房表（check_out）	id（主键）、dingdanbianhao（订单编号）、kefanghao（客房号）、zhanghao（用户/会员账号）、tuifangshijian（退房时间）、yajintuikuan（押金退还）	跟踪退房流程，记录押金退还状态

3.4 第四步：系统详细实现——核心模块代码与界面开发

3.4.1 核心业务模块实现（代码示例）

以“用户预约审核（管理员模块）”和“清洁任务更新（清洁人员模块）”为例，展示后端核心业务逻辑：

1. 用户预约审核（管理员模块）：管理员审核用户提交的客房预约，同步更新客房状态，关键代码如下：

@Service
public class UserReserveServiceImpl implements UserReserveService {
    @Autowired
    private UserReserveMapper userReserveMapper;

    @Autowired
    private RoomInfoMapper roomInfoMapper;

    // 审核用户预约申请
    @Override
    public int auditUserReserve(Long reserveId, String auditResult, String auditReply) {
        // 1. 查询预约记录是否存在
        UserReserve reserve = userReserveMapper.selectByPrimaryKey(reserveId);
        if (reserve == null) {
            throw new RuntimeException("该用户预约记录不存在");
        }
        // 2. 校验预约当前状态（仅“待审核”可操作）
        if (!"否".equals(reserve.getSfsh())) {
            throw new RuntimeException("预约已审核，无需重复操作");
        }
        // 3. 更新审核状态与回复
        reserve.setSfsh(auditResult); // "是"（通过）或"否"（拒绝）
        reserve.setShhf(auditReply);
        reserve.setUpdateTime(new Date());
        // 4. 若审核通过，同步更新客房状态为“已预约”
        if ("是".equals(auditResult)) {
            RoomInfo room = roomInfoMapper.selectByRoomNo(reserve.getKefanghao());
            if (room != null) {
                room.setKefangzhuangtai("已预约");
                roomInfoMapper.updateByPrimaryKeySelective(room);
            }
        }
        // 5. 保存审核结果
        return userReserveMapper.updateByPrimaryKeySelective(reserve);
    }

    // 管理员查询待审核用户预约
    @Override
    public PageInfo<UserReserve> getPendingUserReserves(int pageNum, int pageSize) {
        UserReserveExample example = new UserReserveExample();
        example.createCriteria().andSfshEqualTo("否");
        example.setOrderByClause("yuyueshijian desc"); // 按预约时间倒序
        PageHelper.startPage(pageNum, pageSize);
        List<UserReserve> reserveList = userReserveMapper.selectByExample(example);
        return new PageInfo<>(reserveList);
    }
}

2. 清洁任务更新（清洁人员模块）：清洁人员接收并更新客房清洁状态，关键代码如下：

@Service
public class CleanTaskServiceImpl implements CleanTaskService {
    @Autowired
    private CleanTaskMapper cleanTaskMapper;

    @Autowired
    private RoomInfoMapper roomInfoMapper;

    // 更新清洁任务状态（待清洁→清洁中→已完成）
    @Override
    public int updateCleanStatus(Long taskId, String cleanStatus, String cleanerAccount) {
        // 1. 查询清洁任务是否存在
        CleanTask task = cleanTaskMapper.selectByPrimaryKey(taskId);
        if (task == null) {
            throw new RuntimeException("该清洁任务不存在");
        }
        // 2. 校验任务归属（仅分配的清洁人员可操作）
        if (!cleanerAccount.equals(task.getQingjiezhanghao())) {
            throw new RuntimeException("无权限操作其他清洁人员的任务");
        }
        // 3. 更新清洁状态与时间
        task.setQingjiezhuangtai(cleanStatus);
        if ("已完成".equals(cleanStatus)) {
            task.setDasaoshijian(new Date());
            // 4. 清洁完成后同步更新客房状态为“可约”
            RoomInfo room = roomInfoMapper.selectByRoomNo(task.getKefanghao());
            if (room != null) {
                room.setKefangzhuangtai("可约");
                room.setWeishengqingkuang("清洁完成");
                roomInfoMapper.updateByPrimaryKeySelective(room);
            }
        }
        // 5. 保存更新结果
        return cleanTaskMapper.updateByPrimaryKeySelective(task);
    }

    // 清洁人员查询个人任务
    @Override
    public List<CleanTask> getMyCleanTasks(String cleanerAccount) {
        CleanTaskExample example = new CleanTaskExample();
        example.createCriteria().andQingjiezhanghaoEqualTo(cleanerAccount);
        example.setOrderByClause("addtime desc");
        return cleanTaskMapper.selectByExample(example);
    }
}

3.4.2 关键界面设计

1. 管理员-客房信息管理界面：展示客房编号、类型、价格、状态等核心信息，支持“新增”“修改”“删除”操作，可按客房状态筛选（可约/已预约/待清洁），界面关联预约记录，点击“详情”可查看客房历史订单（如图5.3所示）；
2. 用户-客房预约界面：用户浏览客房列表（含图片、价格、床型），点击“预约”填写入住时间与天数，提交后显示“待审核”状态，可实时查看审核进度（如图5.4所示）；
3. 清洁人员-清洁任务界面：展示分配的客房清洁任务（含客房号、工作区域），下拉选择“清洁中/已完成”更新状态，清洁完成后可上传客房照片，界面实时同步客房状态至管理员端（如图5.6所示）；
4. 会员-会员预约界面：会员享受专属折扣价，预约表单自动填充会员信息，提交后优先进入审核队列，界面展示会员积分与取消违约金减免提示（如图5.2所示）；
5. 管理员-入住管理界面：查看用户/会员入住记录（含订单编号、押金金额、支付状态），支持“审核退房”操作，退房后自动生成清洁任务分配给对应区域清洁人员（如图5.5所示）。

3.5 第五步：系统测试——全面验证功能与性能

采用“功能测试+可用性测试+性能测试”三维测试策略，模拟酒店实际运营场景，确保系统满足多角色使用需求：

3.5.1 功能测试

设计50组测试用例，覆盖四角色核心业务场景，部分测试结果如下：

测试场景	预期结果	实际结果	是否通过
用户提交客房预约	预约生成并标记“待审核”，管理员可查看	预约创建成功，数据无缺失，审核通知及时	是
管理员审核用户预约	通过后客房状态更新为“已预约”，用户可查结果	状态同步准确，无重复预约问题	是
清洁人员更新清洁状态	清洁完成后客房状态更新为“可约”	状态实时同步，客房可重新预约	是
会员提交预约	享受折扣价，审核优先级高于普通用户	价格计算准确，审核耗时缩短50%	是
管理员处理退房	退房后生成清洁任务，押金状态更新为“待退还”	流程顺畅，任务分配无偏差	是

3.5.2 可用性测试

验证界面操作的便捷性与合理性，适配不同角色用户的操作习惯，测试结果如下：

测试项	测试结果
跨设备操作（电脑/手机）	界面自适应调整，手机端预约、清洁状态更新操作流畅
模块布局与文字描述	布局贴合业务流程（如“预约→入住→退房→清洁”），按钮命名无歧义（如“审核预约”“更新清洁状态”）
数据录入验证	关键字段（身份证、入住时间）有格式校验，避免错误输入
操作流程合理性	用户从“选房→预约→入住”仅需4步，清洁人员从“接收任务→完成清洁”仅需2步

3.5.3 性能测试

• 并发测试：模拟40个用户同时在线操作（如预约提交、清洁任务接收），系统响应正常，无数据丢失或状态偏差；
• 响应时间：局域网内页面加载时间≤2秒，预约审核、清洁状态更新响应时间≤0.8秒；外网（手机4G）响应时间≤5秒，符合用户心理预期；
• 数据承载：数据库存储500+客房记录、2000+预约订单、1000+清洁任务时，查询与统计操作无明显性能下降，满足中型酒店1-2年数据管理需求。

3.6 第六步：问题优化——解决开发中的关键难点

1. 客房状态同步延迟：初期存在“审核通过后客房仍显示‘可约’”的漏洞，通过在预约审核逻辑中添加“状态实时同步”代码，确保审核结果即时更新客房状态，避免重复预约；
2. 清洁任务分配混乱：初期清洁任务未按区域分配，导致效率低下，通过在清洁人员表添加“工作区域”字段，任务分配时匹配客房区域与清洁人员区域，提升清洁效率；
3. 用户密码安全问题：初期密码明文存储，存在隐私泄露风险，通过采用MD5加密算法存储密码，登录时解密校验，保障账户安全；
4. 预约查询效率低：管理员查询月度预约记录时加载缓慢，通过在“zhanghao”“yuyueshijian”字段建立索引，优化SQL查询语句，将加载时间从3秒缩短至0.6秒。

3.7 第七步：系统部署——确保稳定上线

1. 部署环境：采用Windows Server 2019（服务器）/Windows 10（客户端）操作系统，Tomcat 9.0部署后端，Nginx部署前端静态资源，MySQL 8.0存储数据；
2. 数据备份：配置MySQL定时备份（每日凌晨3点），将备份文件存储至本地与云端，防止客房数据、订单记录丢失；
3. 安全配置：服务器设置防火墙，仅开放80（前端）、8080（后端）、3306（MySQL）端口；敏感操作（如订单删除、押金退还）需二次确认，用户身份证等信息加密存储；
4. 用户培训：编写《管理员操作手册》《清洁人员使用指南》《用户预订教程》，含流程图解；为酒店员工提供1.5小时操作培训，确保各角色快速上手。

四、毕业设计复盘：经验与成长

4.1 开发过程中的挑战与突破

1. 四角色权限边界划分：初期管理员与清洁人员功能交叉（如均能查看入住记录），通过绘制“角色-功能矩阵图”，明确管理员“全局管控权”与清洁人员“任务执行权”，实现权限精准隔离；
2. 前后端数据交互适配：初期前端Vue请求后端接口时出现数据格式不匹配，通过统一JSON数据格式、定义接口文档规范，解决前后端联调问题；
3. 客房状态逻辑复杂：客房存在“可约→已预约→已入住→待清洁→可约”多状态流转，通过梳理状态流转图，在代码中添加状态校验，确保流转逻辑无漏洞；
4. 测试场景覆盖不全：初期未测试“用户重复预约同一客房”“清洁任务超时未完成”等异常场景，通过补充25组异常测试用例，提升系统容错能力。

4.2 给学弟学妹的建议

1. 聚焦业务实际需求：酒店系统需贴近运营场景（如清洁人员移动端操作、会员专属服务），避免“为技术而技术”，可实地调研酒店痛点，确保系统落地可用；
2. 善用框架简化开发：Spring Boot的自动配置减少冗余代码，Vue的组件化开发提升前端效率，PageHelper实现分页查询，合理使用工具可大幅节省开发时间；
3. 重视数据关联性设计：客房、订单、清洁任务存在强关联，数据库设计时需合理设置外键，避免数据孤立，便于后期统计与追溯；
4. 测试兼顾“功能”与“性能”：除测试正常流程，需重点测试高并发场景（如节假日预约高峰），避免上线后出现卡顿或数据错误；
5. 文档记录规范：及时记录接口文档、数据库表结构、核心业务逻辑，便于后期维护或功能迭代（如新增智能门锁对接模块）。

五、项目资源与未来展望

5.1 项目核心资源

本项目提供完整的开发与部署资源，便于酒店直接使用或二次开发：

• 源码资源：后端Spring Boot源码（含接口代码、配置文件）、前端Vue源码（含页面组件、交互逻辑）；
• 数据库脚本：MySQL建表语句、测试数据（如50条客房记录、100条预约订单）；
• 文档资源：需求分析文档、系统设计文档、接口文档、测试用例、四角色操作手册；
• 界面原型：各核心模块Axure原型图（如客房预约、清洁任务界面），便于快速理解设计逻辑。

5.2 系统扩展方向

1. 智能设备对接：集成智能门锁、智能灯控接口，实现入住后自动发送门锁密码、退房后自动断电，提升酒店智能化水平；
2. 支付功能集成：对接微信支付、支付宝接口，实现预约押金在线支付、退房押金自动退还，减少人工操作；
3. 数据分析功能：集成ECharts图表，展示客房出租率、预约高峰时段、会员消费趋势，为管理员提供运营决策支持；
4. 多酒店连锁管理：新增酒店管理模块，支持多门店数据隔离与统一管控，为连锁酒店提供SaaS化解决方案；
5. AI客服集成：添加智能客服功能，自动回复用户常见问题（如入住须知、押金政策），降低人工客服压力。

如果本文对您的Spring Boot+Vue学习、酒店客房系统开发或毕业设计有帮助，欢迎点赞 + 收藏 + 关注，后续会分享更多JavaWeb与前后端分离项目实战案例！