Build a Hotel Management ERD Using PlantUML & VPasCode

在为酒店业等复杂领域设计稳健的数据库架构时，清晰地可视化关系至关重要。无论你是绘制客户档案、跟踪客房库存，还是管理账单，一个结构良好的实体关系图（ERD）都能在开发过程中节省无数小时。在这堂大师课中，我将带你一步步了解我如何使用PlantUML在“”中从零开始构建一个全面的酒店管理ERD。免费的PlantUML编辑器, VPasCode.

1. 初始化PlantUML环境

我首先设置脚本的基础结构。在处理包含大量属性的复杂模式时，布局的可读性至关重要。我配置PlantUML以隐藏不必要的杂乱信息，并优化图表的布局方向：


@startuml 
title 酒店管理ERD

hide circle
left to right direction

为什么采用这种方法？隐藏默认的属性圆圈可以使实体框保持简洁现代。将方向设置为从左到右方向有助于防止宽幅ERD变得在垂直方向上难以管理，使多表关系得以逻辑性地展开。

2. 定义核心实体和属性

接下来，我需要定义代表我们业务领域的核心实体。我为每个实体结构化其主键、唯一性约束和类型化属性。让我们看看我是如何设置核心Customer和RoomType实体：


entity "Customer" as customer {
  * customer_id : UUID <<PK>>
  --
  first_name : VARCHAR(50)
  last_name : VARCHAR(50)
  email : VARCHAR(100) <<UK>>
  phone : VARCHAR(20)
  address : TEXT
  loyalty_points : INTEGER
  total_stays : INTEGER
  date_registered : TIMESTAMP
  date_of_birth : DATE
  nationality : VARCHAR(50)
}

entity "RoomType" as roomtype {
  * room_type_id : UUID <<PK>>
  --
  type_name : VARCHAR(50) <<UK>>
  description : TEXT
  standard_capacity : INTEGER
  base_price : DECIMAL(10,2)
  extra_bed_charge : DECIMAL(10,2)
  has_kitchenette : BOOLEAN
  has_balcony : BOOLEAN
}

通过定义诸如<<PK>>和<<UK>>之类的显式标记，任何审查代码的人都能在数据库迁移脚本编写之前立即理解索引和唯一性规则。

3. 映射操作性实体（客房、预订和员工）

在参考数据就位后，我转向酒店管理系统的事务核心：客房、预订和员工工作流程。每个实体都使用外键与我们的基础表关联：


entity "Room" as room {
  * room_id : UUID <<PK>>
  --
  room_number : VARCHAR(10) <<UK>>
  floor_number : INTEGER
  room_type_id : UUID <<FK>>
  capacity : INTEGER
  base_price : DECIMAL(10,2)
  is_available : BOOLEAN
  has_view : BOOLEAN
  square_feet : INTEGER
  last_renovated : DATE
}

entity "Reservation" as reservation {
  * reservation_id : UUID <<PK>>
  --
  customer_id : UUID <<FK>>
  room_id : UUID <<FK>>
  check_in_date : DATE
  check_out_date : DATE
  number_of_guests : INTEGER
  total_amount : DECIMAL(10,2)
  status : VARCHAR(20)
  special_requests : TEXT
  created_at : TIMESTAMP
  updated_at : TIMESTAMP
  confirmation_code : VARCHAR(20) <<UK>>
}

4. 建立财务和服务关系

为了完善整个架构，我绘制了账单记录（付款和发票）以及由酒店员工处理的辅助服务（如客房服务）。为了将所有内容连接起来，我使用标准的PlantUML符号显式定义了基数关系：


' 关系
customer ||--o{ reservation : "创建"
room ||--o{ reservation : "分配给"
reservation ||--|| payment : "拥有"
reservation ||--|| invoice : "生成"
reservation ||--o{ roomservice : "请求"
staff ||--o{ roomservice : "完成"
roomtype ||--o{ room : "分类"

@enduml

设计选择： 使用精确的乌鸦足符号（例如||--o{ 表示强制到可选的一对多关系）可以确保业务逻辑规则——例如预订必须关联客户，但客户可能拥有多个或零个活跃预订——被准确建模。

完整的 PlantUML 脚本

以下是我们的酒店管理 ERD 的完整组装源代码。您可以直接将此代码复制并粘贴到您最喜欢的免费 PlantUML 编辑器 中进行编辑或渲染矢量图形：

Plantuml

在 VPasCode 中编辑 Plantuml

Plantuml Edit Plantuml in VPasCode

@startuml 

title 酒店管理 ERD

hide circle
left to right direction

' 定义实体及其属性
entity "客户" as customer {
  * customer_id : UUID <>
  --
  first_name : VARCHAR(50)
  last_name : VARCHAR(50)
  email : VARCHAR(100) <>
  phone : VARCHAR(20)
  address : TEXT
  loyalty_points : INTEGER
  total_stays : INTEGER
  date_registered : TIMESTAMP
  date_of_birth : DATE
  nationality : VARCHAR(50)
}

entity "房间" as room {
  * room_id : UUID <>
  --
  room_number : VARCHAR(10) <>
  floor_number : INTEGER
  room_type_id : UUID <>
  capacity : INTEGER
  base_price : DECIMAL(10,2)
  is_available : BOOLEAN
  has_view : BOOLEAN
  square_feet : INTEGER
  last_renovated : DATE
}

entity "房型" as roomtype {
  * room_type_id : UUID <>
  --
  type_name : VARCHAR(50) <>
  description : TEXT
  standard_capacity : INTEGER
  base_price : DECIMAL(10,2)
  extra_bed_charge : DECIMAL(10,2)
  has_kitchenette : BOOLEAN
  has_balcony : BOOLEAN
}

entity "预订" as reservation {
  * reservation_id : UUID <>
  --
  customer_id : UUID <>
  room_id : UUID <>
  check_in_date : DATE
  check_out_date : DATE
  number_of_guests : INTEGER
  total_amount : DECIMAL(10,2)
  status : VARCHAR(20)
  special_requests : TEXT
  created_at : TIMESTAMP
  updated_at : TIMESTAMP
  confirmation_code : VARCHAR(20) <>
}

entity "支付" as payment {
  * payment_id : UUID <>
  --
  reservation_id : UUID <>
  amount : DECIMAL(10,2)
  payment_date : TIMESTAMP
  payment_method : VARCHAR(30)
  transaction_id : VARCHAR(50) <>
  status : VARCHAR(20)
  receipt_url : TEXT
  refund_amount : DECIMAL(10,2)
}

entity "发票" as invoice {
  * invoice_id : UUID <>
  --
  reservation_id : UUID <>
  invoice_number : VARCHAR(20) <>
  issued_date : DATE
  due_date : DATE
  subtotal : DECIMAL(10,2)
  tax : DECIMAL(10,2)
  service_charge : DECIMAL(10,2)
  total_amount : DECIMAL(10,2)
  status : VARCHAR(20)
}

entity "员工" as staff {
  * staff_id : UUID <>
  --
  first_name : VARCHAR(50)
  last_name : VARCHAR(50)
  email : VARCHAR(100) <>
  phone : VARCHAR(20)
  role : VARCHAR(30)
  hire_date : DATE
  salary : DECIMAL(10,2)
  shift_schedule : VARCHAR(50)
  is_active : BOOLEAN
}

entity "客房服务" as roomservice {
  * service_id : UUID <>
  --
  reservation_id : UUID <>
  staff_id : UUID <>
  service_type : VARCHAR(50)
  description : TEXT
  request_time : TIMESTAMP
  completion_time : TIMESTAMP
  status : VARCHAR(20)
  price : DECIMAL(10,2)
}

' 关系
customer ||--o{ reservation : "创建"
room ||--o{ reservation : "分配给"
reservation ||--|| payment : "拥有"
reservation ||--|| invoice : "生成"
reservation ||--o{ roomservice : "请求"
staff ||--o{ roomservice : "完成"
roomtype ||--o{ room : "分类"

@enduml

Edit Plantuml in VPasCode

在 VPasCode 中编辑 Plantuml