1. 项目概述这个基于Vue和Java的酒店客房管理系统项目是我去年为本地一家连锁酒店开发的实战项目。系统采用前后端分离架构前端使用Vue.jsElement UI构建响应式界面后端基于Spring Boot框架开发数据库选用MySQL 8.0。整个系统从需求分析到上线部署历时3个月目前已在6家分店稳定运行。提示酒店管理系统不同于普通CRM需要特别关注实时房态更新、多分店数据同步和夜间审计等酒店行业特有需求。2. 核心功能设计2.1 房态管理模块采用WebSocket实现实时房态看板关键数据结构设计// 房态实体类 public class RoomStatus { private String roomNumber; // 房号 private Integer roomTypeId; // 房型ID private Integer status; // 0-空房 1-已入住 2-待清洁 3-维修中 private LocalDateTime updateTime; // getters setters }前端使用Vuex管理全局房态数据通过颜色区分不同状态template div classroom :class{ vacant: status 0, occupied: status 1, dirty: status 2, maintenance: status 3 } {{ roomNumber }} /div /template2.2 预订入住流程采用状态机模式管理订单生命周期预订 → 确认 → 入住 → 退房 → 完成 ↘ 取消关键业务逻辑处理public class ReservationService { Transactional public void checkIn(Long orderId) { Order order orderRepository.findById(orderId) .orElseThrow(() - new BusinessException(订单不存在)); if (!order.getStatus().equals(OrderStatus.CONFIRMED)) { throw new BusinessException(当前状态不可办理入住); } order.setStatus(OrderStatus.CHECKED_IN); order.setCheckInTime(LocalDateTime.now()); // 关联房态变更 roomService.updateStatus(order.getRoomId(), RoomStatus.OCCUPIED); } }3. 技术实现细节3.1 前后端分离架构技术栈选型对比技术点前端方案后端方案HTTP客户端AxiosRestTemplate状态管理VuexSpring Session路由控制Vue RouterSpring MVC安全认证JWT前端存储Spring Security跨域解决方案Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }3.2 数据库设计要点主要表结构关系图客人表 (guest) ← 订单表 (order) → 房型表 (room_type) → 房间表 (room) ↑ 支付记录表 (payment)索引优化方案-- 高频查询字段添加索引 CREATE INDEX idx_order_status ON order(status); CREATE INDEX idx_room_status ON room(status); CREATE INDEX idx_guest_phone ON guest(phone); -- 组合索引优化 CREATE INDEX idx_order_dates ON order(check_in_date, check_out_date);4. 典型问题解决方案4.1 房态同步延迟问题现象多终端操作时房态显示不一致解决方案采用WebSocket全双工通信后端使用Redis发布订阅模式前端增加手动刷新按钮实现代码RestController RequestMapping(/ws) public class RoomStatusWSController { Autowired private SimpMessagingTemplate messagingTemplate; PostMapping(/updateStatus) public void updateStatus(RequestBody RoomStatusDTO dto) { // 更新数据库 roomService.updateStatus(dto); // 广播通知所有客户端 messagingTemplate.convertAndSend(/topic/roomStatus, dto); } }4.2 并发预订控制使用数据库乐观锁解决超卖问题public class OrderService { Transactional public boolean createOrder(OrderDTO dto) { Room room roomRepository.findById(dto.getRoomId()) .orElseThrow(() - new BusinessException(房间不存在)); // 检查版本号 if (room.getVersion() ! dto.getVersion()) { throw new OptimisticLockException(房间状态已变更); } // 业务逻辑处理 // ... // 更新版本号 room.setVersion(room.getVersion() 1); roomRepository.save(room); return true; } }5. 部署与性能优化5.1 前端部署方案采用Nginx配置多环境部署server { listen 80; server_name hotel-admin.example.com; location / { root /usr/share/nginx/html/hotel-admin; index index.html; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://backend-server:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }5.2 后端性能优化缓存策略Cacheable(value roomTypes, key #hotelId) public ListRoomType getRoomTypesByHotel(Long hotelId) { return roomTypeRepository.findByHotelId(hotelId); }数据库连接池配置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000日志切割配置Logbackappender nameFILE classch.qos.logback.core.rolling.RollingFileAppender filelogs/app.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePatternlogs/app.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender6. 项目演进方向智能排房算法根据客人偏好、房间位置等因素自动分配房间移动端PWA应用支持离线办理基础业务对接OTA平台实现与携程、美团等平台的直连房务人员APP通过扫码实现快速查房、报修在实施这类系统时特别要注意酒店业务流程的特殊性。比如夜间审计(Night Audit)必须在特定时间执行涉及房费计算、报表生成等批量操作我们最终采用Spring BatchQuartz的方案实现处理200间客房的数据约需8分钟
1. 项目概述这个基于Vue和Java的酒店客房管理系统项目是我去年为本地一家连锁酒店开发的实战项目。系统采用前后端分离架构前端使用Vue.jsElement UI构建响应式界面后端基于Spring Boot框架开发数据库选用MySQL 8.0。整个系统从需求分析到上线部署历时3个月目前已在6家分店稳定运行。提示酒店管理系统不同于普通CRM需要特别关注实时房态更新、多分店数据同步和夜间审计等酒店行业特有需求。2. 核心功能设计2.1 房态管理模块采用WebSocket实现实时房态看板关键数据结构设计// 房态实体类 public class RoomStatus { private String roomNumber; // 房号 private Integer roomTypeId; // 房型ID private Integer status; // 0-空房 1-已入住 2-待清洁 3-维修中 private LocalDateTime updateTime; // getters setters }前端使用Vuex管理全局房态数据通过颜色区分不同状态template div classroom :class{ vacant: status 0, occupied: status 1, dirty: status 2, maintenance: status 3 } {{ roomNumber }} /div /template2.2 预订入住流程采用状态机模式管理订单生命周期预订 → 确认 → 入住 → 退房 → 完成 ↘ 取消关键业务逻辑处理public class ReservationService { Transactional public void checkIn(Long orderId) { Order order orderRepository.findById(orderId) .orElseThrow(() - new BusinessException(订单不存在)); if (!order.getStatus().equals(OrderStatus.CONFIRMED)) { throw new BusinessException(当前状态不可办理入住); } order.setStatus(OrderStatus.CHECKED_IN); order.setCheckInTime(LocalDateTime.now()); // 关联房态变更 roomService.updateStatus(order.getRoomId(), RoomStatus.OCCUPIED); } }3. 技术实现细节3.1 前后端分离架构技术栈选型对比技术点前端方案后端方案HTTP客户端AxiosRestTemplate状态管理VuexSpring Session路由控制Vue RouterSpring MVC安全认证JWT前端存储Spring Security跨域解决方案Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }3.2 数据库设计要点主要表结构关系图客人表 (guest) ← 订单表 (order) → 房型表 (room_type) → 房间表 (room) ↑ 支付记录表 (payment)索引优化方案-- 高频查询字段添加索引 CREATE INDEX idx_order_status ON order(status); CREATE INDEX idx_room_status ON room(status); CREATE INDEX idx_guest_phone ON guest(phone); -- 组合索引优化 CREATE INDEX idx_order_dates ON order(check_in_date, check_out_date);4. 典型问题解决方案4.1 房态同步延迟问题现象多终端操作时房态显示不一致解决方案采用WebSocket全双工通信后端使用Redis发布订阅模式前端增加手动刷新按钮实现代码RestController RequestMapping(/ws) public class RoomStatusWSController { Autowired private SimpMessagingTemplate messagingTemplate; PostMapping(/updateStatus) public void updateStatus(RequestBody RoomStatusDTO dto) { // 更新数据库 roomService.updateStatus(dto); // 广播通知所有客户端 messagingTemplate.convertAndSend(/topic/roomStatus, dto); } }4.2 并发预订控制使用数据库乐观锁解决超卖问题public class OrderService { Transactional public boolean createOrder(OrderDTO dto) { Room room roomRepository.findById(dto.getRoomId()) .orElseThrow(() - new BusinessException(房间不存在)); // 检查版本号 if (room.getVersion() ! dto.getVersion()) { throw new OptimisticLockException(房间状态已变更); } // 业务逻辑处理 // ... // 更新版本号 room.setVersion(room.getVersion() 1); roomRepository.save(room); return true; } }5. 部署与性能优化5.1 前端部署方案采用Nginx配置多环境部署server { listen 80; server_name hotel-admin.example.com; location / { root /usr/share/nginx/html/hotel-admin; index index.html; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://backend-server:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }5.2 后端性能优化缓存策略Cacheable(value roomTypes, key #hotelId) public ListRoomType getRoomTypesByHotel(Long hotelId) { return roomTypeRepository.findByHotelId(hotelId); }数据库连接池配置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000日志切割配置Logbackappender nameFILE classch.qos.logback.core.rolling.RollingFileAppender filelogs/app.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePatternlogs/app.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender6. 项目演进方向智能排房算法根据客人偏好、房间位置等因素自动分配房间移动端PWA应用支持离线办理基础业务对接OTA平台实现与携程、美团等平台的直连房务人员APP通过扫码实现快速查房、报修在实施这类系统时特别要注意酒店业务流程的特殊性。比如夜间审计(Night Audit)必须在特定时间执行涉及房费计算、报表生成等批量操作我们最终采用Spring BatchQuartz的方案实现处理200间客房的数据约需8分钟
)
