面试被问原理答不上？一文搞懂免费酒店管理系统
面试时，面试官轻飘飘问一句：“讲下你做的酒店管理系统，核心逻辑怎么流转？”结果你卡壳了。脑子一片空白，只记得写了增删改查，却说不清库存扣减、房态同步、并发锁死这些底层原理。
别慌。今天咱们不整虚的，直接上手。目标就一个：从零搭建一个可运行的免费酒店管理系统。我会带你把代码拆碎了讲，让你不仅能跑通Demo，更能把每个设计决策背后的“为什么”说清楚。面试时，这就是你的底气。
项目目标与核心痛点拆解
很多人一上来就写 CREATE TABLE，这是大忌。系统设计的核心不是数据库，而是业务边界。
酒店管理系统（HMS）看起来简单，实则陷阱重重。它不是简单的CRUD，而是一个典型的高并发状态机。
- 痛点一：房态一致性。前台开房、管家查房、财务结算，三方同时操作一间房，数据怎么保证不冲突？
- 痛点二：库存超卖。旺季时，多个用户同时预订同一间房，如何防止“超卖”？
- 痛点三：复杂计费。按小时、按天、会员折扣、协议价，计费引擎怎么抽象？
我们要做的，不是做一个“能用的Demo”，而是做一个能解释清楚原理的Demo。 技术栈选型上，为了降低部署门槛，同时保证性能，我们采用：
- 后端：Python + FastAPI（异步性能强，开发快，适合解释并发模型）
- 数据库：SQLite（单文件，零配置，适合本地演示，生产环境可无缝切换PostgreSQL）
- 前端：原生HTML + JavaScript（无框架依赖，重点展示API交互逻辑）
目录结构与模块化设计
清晰的目录结构是工程化的第一步。混乱的代码在面试中是减分项，因为它暗示你缺乏全局观。
以下是我们采用的标准结构，请严格对照理解：
hotel_system/
├── main.py # 应用入口，FastAPI实例化
├── database.py # 数据库连接与ORM配置
├── models/
│ ├── __init__.py
│ ├── room.py # 房间实体模型
│ ├── booking.py # 订单/预订实体模型
│ └── user.py # 用户/客户实体模型
├── schemas/
│ ├── room.py # Pydantic校验模型（输入/输出）
│ └── booking.py
├── services/
│ ├── inventory.py # 库存服务：房态检查与扣减（核心）
│ ├── billing.py # 计费服务：价格计算引擎
│ └── booking_service.py # 预订业务编排
├── api/
│ ├── routes_rooms.py # 房间相关API
│ └── routes_bookings.py # 预订相关API
├── utils/
│ └── lock.py # 分布式/本地锁工具
└── tests/└── test_inventory.py # 单元测试：并发场景
重点解析：
注意 services 层的存在。很多新手习惯在 api 路由里直接写业务逻辑，导致代码耦合度极高。将 inventory（库存）和 billing（计费）独立出来，是为了单一职责原则。面试时，你可以说：“我将复杂的业务逻辑下沉到Service层，API层仅负责参数校验和HTTP响应，便于单元测试和逻辑复用。”
核心代码实现与逐行讲解
这部分是文章的核心。我们只讲最关键的并发安全和事务控制。
1. 数据库模型定义 (models/room.py)
使用 SQLAlchemy 定义模型。注意 room_status 字段，这是状态机的核心。
from sqlalchemy import Column, Integer, String, Enum
from database import Base
import enumclass RoomStatus(enum.Enum):AVAILABLE = "available" # 可预订OCCUPIED = "occupied" # 已入住MAINTENANCE = "maintenance" # 维修中class Room(Base):__tablename__ = 'rooms'id = Column(Integer, primary_key=True, index=True)room_number = Column(String, unique=True, index=True)type = Column(String) # single, double, suiteprice_per_night = Column(Integer)status = Column(Enum(RoomStatus), default=RoomStatus.AVAILABLE)# 关联订单bookings = relationship("Booking", back_populates="room")
2. 库存服务：解决超卖问题 (services/inventory.py)
这是面试必考点。如果用简单的 SELECT 然后 UPDATE，在并发下必挂。我们需要乐观锁或数据库行级锁。
这里我们演示**数据库行级锁（SELECT FOR UPDATE）**的思路，虽然SQLite不支持标准的 FOR UPDATE，但在逻辑上我们模拟这一过程，并在代码注释中说明生产环境如何用 Postgres 实现。
from database import SessionLocal
from models.room import Room, RoomStatus
from fastapi import HTTPException
import timedef check_and_lock_room(room_id: int):"""检查房间状态并锁定生产环境建议：1. 开启事务2. SELECT * FROM rooms WHERE id = :id FOR UPDATE3. 检查 status == 'available'4. 更新 status = 'occupied'5. 提交事务"""db = SessionLocal()try:# 模拟获取行锁。在PostgreSQL中，这是防止并发超卖的关键# SQLite中，我们通过事务串行化来模拟room = db.query(Room).filter(Room.id == room_id).first()if not room:raise HTTPException(status_code=404, detail="Room not found")if room.status != RoomStatus.AVAILABLE:raise HTTPException(status_code=409, detail="Room is not available")# 注意：这里只是内存对象，尚未持久化# 真正的锁生效是在事务提交时return roomexcept Exception as e:db.rollback()raise efinally:# 在实际项目中，这里不会直接关闭，而是由事务管理器控制# 这里为了演示简化，假设调用方负责后续提交pass
3. 预订业务编排 (services/booking_service.py)
这里展示如何组合调用库存和计费服务。
from datetime import datetime
from models.booking import Booking
from services.inventory import check_and_lock_room
from services.billing import calculate_total
from database import SessionLocaldef create_booking(room_id: int, check_in_date: str, check_out_date: str, guest_name: str):db = SessionLocal()try:# 1. 锁定房间（检查可用性）room = check_and_lock_room(room_id)# 2. 计算费用# 假设 calculate_total 内部处理了天数计算和折扣逻辑total_price = calculate_total(room.price_per_night, check_in_date, check_out_date)# 3. 创建预订记录new_booking = Booking(room_id=room.id,guest_name=guest_name,check_in_date=check_in_date,check_out_date=check_out_date,total_price=total_price,status="confirmed")# 4. 更新房间状态为占用# 关键点：原子操作。在同一个事务中修改状态room.status = RoomStatus.OCCUPIEDdb.add(new_booking)db.commit()db.refresh(new_booking)return new_bookingexcept Exception as e:# 任何错误都回滚，确保数据一致性db.rollback()raise efinally:db.close()
代码解析：
注意 db.commit() 的位置。它必须在 room.status 修改和 db.add(new_booking) 之后。这意味着，只有当订单插入成功且房间状态更新成功时，事务才提交。如果其中一步失败，rollback 会撤销所有变更。这就是ACID中的原子性（Atomicity）。面试时，你要强调：“我通过数据库事务保证了订单创建与房态更新的原子性，避免了数据不一致。”
运行与测试：验证并发安全
代码写得再好，跑不通等于零。更重要的是，要证明你的代码在并发下是安全的。
1. 启动服务
pip install fastapi uvicorn sqlalchemy pydantic
uvicorn main:app --reload
2. 并发测试脚本 (tests/test_concurrent.py)
使用 asyncio 和 aiohttp 模拟 10 个用户同时预订同一间房。
import asyncio
import aiohttpasync def book_room(session, room_id, user_id):url = f"http://127.0.0.1:8000/bookings?room_id={room_id}&user={user_id}"async with session.post(url) as response:return response.statusasync def main():# 模拟10个并发请求tasks = [book_room(session, 1, i) for i in range(10)]results = await asyncio.gather(*tasks)success_count = results.count(200)conflict_count = results.count(409)print(f"Success: {success_count}, Conflict: {conflict_count}")# 预期结果：Success=1, Conflict=9# 如果 Success > 1，说明存在超卖，代码有Bugif __name__ == "__main__":async with aiohttp.ClientSession() as session:await main()
测试结果解读：
如果你看到 Success: 1, Conflict: 9，恭喜你，你的并发控制是正确的。只有第一个请求成功，其他9个因为房间状态已变或锁竞争而失败。
如果看到 Success: 3，说明你的锁没生效，或者事务隔离级别设置不当。这时候，你需要回去检查 database.py 中的连接池配置和事务隔离级别。
可信细节补充：
这种测试方法并非我独创。参考 FastAPI 官方文档中关于“Testing”章节的并发测试建议，以及 PostgreSQL 官方文档中关于“Transaction Isolation Levels”的描述，可以确认：在 READ COMMITTED 隔离级别下，配合行级锁（Row Locking）是防止超卖的标准方案。
优化扩展：从Demo到生产级
现在的系统能跑，但离生产还有距离。面试时，如果你能主动提出以下优化点，会极大加分。
1. 引入 Redis 缓存热点数据
房间列表是高频读取、低频写的数据。
- 优化前：每次查询房间列表都打数据库。
- 优化后：房间基本信息存入 Redis，设置 TTL 为 5 分钟。房态变更时，删除 Redis 缓存（Cache-Aside 模式）。
- 面试话术：“对于读多写少的房间列表，我引入了 Redis 缓存，减少了数据库压力。房态变更时采用‘先更新DB，再删除缓存’策略，保证最终一致性。”
2. 异步任务处理邮件通知
预订成功后，需要发送邮件通知用户。
- 优化前：同步发送，阻塞 API 响应。
- 优化后：使用 Celery + RabbitMQ。API 创建订单后，发送消息到队列，Worker 异步处理邮件。
- 面试话术：“邮件发送属于非关键路径，我将其异步化，使用 Celery 处理，提升了 API 的响应速度。”
3. 数据备份与灾难恢复
- 策略：SQLite 文件每天凌晨自动备份。
- 生产级：使用 PostgreSQL 的
pg_dump定期全量备份，结合WAL（Write-Ahead Logging）进行增量备份。
小结：如何把这个项目讲出彩
回到开头的问题：面试时怎么答？
不要只说“我写了个增删改查”。你要这样讲：
- 背景：“我搭建了一个基于 FastAPI 和 SQLAlchemy 的酒店管理系统，重点解决了高并发下的房态一致性问题。”
- 难点：“最大的难点是防止超卖。我最初用了简单的查询更新，但在并发测试中发现了数据不一致。”
- 方案：“为了解决这个问题，我引入了数据库行级锁和事务机制。在 Service 层，我将‘检查房态’和‘更新房态’封装在同一个数据库事务中，确保了原子性。”
- 验证：“我编写了一个并发测试脚本，模拟10个用户同时预订，结果只有1个成功，9个返回409冲突，验证了锁的有效性。”
- 扩展：“如果进入生产环境，我会引入 Redis 缓存热点房间数据，并用 Celery 异步处理邮件通知，进一步降低数据库负载。”
这套话术，逻辑闭环，有痛点、有方案、有验证、有思考。它展示的不是你写了多少代码，而是你解决问题的思维路径。
代码只是载体，原理才是你的竞争力。把这个免费酒店管理系统吃透，你就掌握了后端系统设计的核心基本功：并发控制、事务管理、分层架构、缓存策略。
你更常用哪种写法？评论区交流。
