1. 项目概述

这个酒店管理系统是一个典型的B/S架构企业级应用，采用前后端分离设计模式。前端基于Vue.js生态链构建，后端采用SpringBoot框架实现业务逻辑，数据持久层使用MyBatis操作MySQL数据库。系统实现了酒店业务的核心流程管理，包括客房预订、入住登记、收银结算、客户管理等模块。

作为全栈项目，它完整覆盖了从数据库设计到前端展示的全链路开发过程。项目源码结构清晰，遵循MVC分层架构，包含完整的权限控制和数据校验机制，可直接作为企业生产环境的基础框架使用。

2. 技术栈选型分析

2.1 后端技术栈

SpringBoot 2.7.x作为基础框架，主要优势在于：

• 自动配置简化了传统SSM框架的XML配置
• 内嵌Tomcat服务器实现开箱即用
• Starter依赖机制统一管理第三方组件
• Actuator提供完善的监控端点

数据访问层采用MyBatis 3.5.x，相比Hibernate：

• SQL编写更灵活，便于复杂查询优化
• 动态SQL支持条件拼接
• 与SpringBoot整合只需配置mybatis-spring-boot-starter

2.2 前端技术栈

Vue 3.x作为核心框架，配合以下生态组件：

• Vue Router管理前端路由
• Vuex进行状态管理
• Element Plus提供UI组件库
• Axios处理HTTP请求

这种组合的优势在于：

• 响应式数据绑定简化DOM操作
• 组件化开发提高代码复用率
• 单页应用(SPA)体验流畅
• 丰富的第三方插件生态

2.3 数据库设计

MySQL 8.0作为关系型数据库，主要表结构包括：

CREATE TABLE `room` ( `id` int NOT NULL AUTO_INCREMENT, `room_number` varchar(20) NOT NULL, `type_id` int NOT NULL, `status` tinyint DEFAULT '0', PRIMARY KEY (`id`) ); CREATE TABLE `reservation` ( `id` int NOT NULL AUTO_INCREMENT, `guest_id` int NOT NULL, `room_id` int NOT NULL, `check_in` datetime NOT NULL, `check_out` datetime NOT NULL, `status` tinyint DEFAULT '0', PRIMARY KEY (`id`) );

3. 核心功能实现

3.1 客房管理模块

后端Controller示例：

@RestController @RequestMapping("/api/room") public class RoomController { @Autowired private RoomService roomService; @GetMapping("/available") public Result<List<Room>> getAvailableRooms( @RequestParam String startDate, @RequestParam String endDate) { return Result.success(roomService.getAvailableRooms(startDate, endDate)); } }

前端页面关键逻辑：

<template> <el-table :data="roomList"> <el-table-column prop="roomNumber" label="房号"/> <el-table-column label="状态"> <template #default="{row}"> <el-tag :type="statusMap[row.status].type"> {{ statusMap[row.status].text }} </el-tag> </template> </el-table-column> </el-table> </template> <script> export default { data() { return { statusMap: { 0: { text: '空闲', type: 'success' }, 1: { text: '已预订', type: 'warning' }, 2: { text: '入住中', type: 'danger' } } } } } </script>

3.2 预订业务流程

1. 客户查询可用房间接口：

GET /api/room/available?startDate=2023-07-01&endDate=2023-07-05

2. 创建预订订单：

@PostMapping("/reserve") public Result reserve(@Valid @RequestBody ReserveDTO dto) { return roomService.reserveRoom(dto); }

3. 订单状态机设计：

stateDiagram [*] --> PENDING PENDING --> CONFIRMED: 支付定金 PENDING --> CANCELLED: 超时未支付 CONFIRMED --> CHECKED_IN: 办理入住 CONFIRMED --> CANCELLED: 提前取消 CHECKED_IN --> COMPLETED: 退房结算

4. 安全防护方案

4.1 SQL注入防护

MyBatis参数处理方式对比：

<!-- 不安全写法 --> <select id="findRoom" parameterType="String"> SELECT * FROM room WHERE number = ${number} </select> <!-- 安全写法 --> <select id="findRoom" parameterType="String"> SELECT * FROM room WHERE number = #{number} </select>

4.2 认证授权设计

JWT认证流程：

1. 用户登录获取token
2. 后续请求携带Authorization头
3. 服务端验证token有效性
4. 注解控制接口权限

Spring Security配置示例：

@Configuration @EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers("/api/auth/**").permitAll() .antMatchers("/api/admin/**").hasRole("ADMIN") .anyRequest().authenticated() .and() .addFilter(new JwtAuthFilter(authenticationManager())); } }

5. 部署实施方案

5.1 开发环境配置

1. 后端依赖安装：

mvn clean install

2. 前端依赖安装：

npm install

3. 数据库初始化：

source init.sql

5.2 生产环境部署

Nginx配置示例：

server { listen 80; server_name hotel.example.com; location / { root /var/www/hotel-frontend; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; } }

SpringBoot应用启动参数：

java -jar -Dspring.profiles.active=prod \ -Xms512m -Xmx1024m \ hotel-system.jar

6. 常见问题排查

6.1 跨域问题解决

后端配置CORS：

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOrigins("*") .allowedMethods("*") .maxAge(3600); } }

6.2 事务管理异常

Spring事务注意事项：

@Service public class ReservationService { @Transactional(rollbackFor = Exception.class) public void confirmReservation(Long id) { // 业务操作1 // 业务操作2 } }

关键提示：事务方法内避免捕获异常后不抛出，会导致事务失效

7. 性能优化建议

1. 数据库层面：

   • 为查询条件添加合适索引
   • 使用连接池控制连接数
   • 大数据量表考虑分库分表

2. 缓存策略：

@Cacheable(value = "room", key = "#id") public Room getRoomDetail(Long id) { return roomMapper.selectById(id); }

3. 前端优化：
   • 路由懒加载
   • 组件异步加载
   • 启用Gzip压缩

8. 扩展功能方向

1. 微信小程序接入
2. 房态可视化看板
3. 智能房价动态调整
4. 客户行为分析系统
5. 对接第三方支付平台

项目源码采用模块化设计，核心业务逻辑与扩展功能解耦，便于后续功能迭代。实体类设计遵循DDD原则，领域模型清晰明确，为复杂业务演进提供良好基础。