# theaykac/room-booking architecture

> Architecture diagram of the GitHub repository theaykac/room-booking, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/theaykac/room-booking
- Repository: https://github.com/theaykac/room-booking

## Overview

Room Booking is a Spring-based hotel reservation backend. Its documented workflow covers hotel registration and administrator approval, room management and fault reporting, customer registration and date-based booking, campaign discounts, optional saved cards, payment, and invoicing. The README describes an API/business/data-access/entity architecture and names PostgreSQL, but no source excerpts were provided; edges therefore reflect documented product relationships, not verified method calls.

Main entry points: [`hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomBookingController.java`](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomBookingController.java) (Room Booking), [`hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/SystemManagementController.java`](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/SystemManagementController.java) (Hotel Approval), [`hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/business/concretes`](https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/business/concretes) (Business Services), [`hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/HotelController.java`](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/HotelController.java) (Hotel Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Hotel Operations"]
  node_hotel_api["Hotel Registration"]
  node_approval["Hotel Approval"]
  node_room_ops["Room Management"]
  node_faults["Fault Records"]
end

subgraph group_booking["Customer Booking"]
  node_customer_reg["Customer Registration"]
  node_room_booking["Room Booking"]
end

subgraph group_commerce["Payment and Billing"]
  node_campaigns["Campaign Discounts"]
  node_cards["Saved Cards"]
  node_payment["Payment"]
  node_invoice["Invoice"]
end

subgraph group_platform["Application Layers"]
  node_business["Business Services"]
  node_data_access["Data Access"]
  node_entities["Domain Entities"]
  node_postgres[("PostgreSQL")]
end

node_hotel_admin(("Hotel Manager"))
node_system_admin(("System Administrator"))
node_customer(("Customer"))

node_hotel_admin -->|"registers hotel"| node_hotel_api
node_hotel_api -->|"awaits approval"| node_approval
node_system_admin -->|"approves hotel"| node_approval
node_approval -->|"enables room setup"| node_room_ops
node_hotel_admin -->|"manages rooms"| node_room_ops
node_hotel_admin -->|"reports faults"| node_faults
node_customer -->|"registers"| node_customer_reg
node_customer -->|"books by date"| node_room_booking
node_room_booking -->|"applies code"| node_campaigns
node_room_booking -->|"requires payment"| node_payment
node_customer -->|"may save card"| node_cards
node_payment -->|"creates invoice"| node_invoice
node_business -.-> node_data_access
node_data_access -.-> node_postgres
node_business -.-> node_entities

click node_hotel_api "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/HotelController.java"
click node_approval "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/SystemManagementController.java"
click node_room_ops "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomController.java"
click node_faults "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomRenovationController.java"
click node_customer_reg "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CustomerController.java"
click node_room_booking "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomBookingController.java"
click node_campaigns "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CampaignController.java"
click node_cards "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CreditCardController.java"
click node_payment "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/PaymentController.java"
click node_invoice "https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/InvoiceCotroller.java"
click node_business "https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/business/concretes"
click node_data_access "https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/dataAccess"
click node_entities "https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/entity/concretes"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_hotel_api,node_approval,node_room_ops,node_faults toneBlue
class node_customer_reg,node_room_booking toneAmber
class node_campaigns,node_cards,node_payment,node_invoice toneMint
class node_business,node_data_access,node_entities,node_postgres toneRose
class node_hotel_admin,node_system_admin,node_customer toneIndigo
```

## Components

### Hotel Operations

- [Hotel Registration](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/HotelController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/HotelController.java`
- [Hotel Approval](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/SystemManagementController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/SystemManagementController.java`
- [Room Management](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomController.java`
- [Fault Records](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomRenovationController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomRenovationController.java`

### Customer Booking

- [Customer Registration](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CustomerController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CustomerController.java`
- [Room Booking](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomBookingController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/RoomBookingController.java`

### Payment and Billing

- [Campaign Discounts](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CampaignController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CampaignController.java`
- [Saved Cards](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CreditCardController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/CreditCardController.java`
- [Payment](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/PaymentController.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/PaymentController.java`
- [Invoice](https://github.com/theaykac/room-booking/blob/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/InvoiceCotroller.java): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/api/controllers/InvoiceCotroller.java`

### Application Layers

- [Business Services](https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/business/concretes): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/business/concretes`
- [Data Access](https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/dataAccess): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/dataAccess`
- [Domain Entities](https://github.com/theaykac/room-booking/tree/main/hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/entity/concretes): `hotelBooking/hotelBooking/src/main/java/com/example/hotelBooking/entity/concretes`
- **PostgreSQL**

### Other components

- **Hotel Manager**
- **System Administrator**
- **Customer**

## Connections

- Hotel Manager → Hotel Registration: registers hotel (evidence: `README.md`)
- Hotel Registration → Hotel Approval: awaits approval (evidence: `README.md`)
- System Administrator → Hotel Approval: approves hotel (evidence: `README.md`)
- Hotel Approval → Room Management: enables room setup (evidence: `README.md`)
- Hotel Manager → Room Management: manages rooms (evidence: `README.md`)
- Hotel Manager → Fault Records: reports faults (evidence: `README.md`)
- Customer → Customer Registration: registers (evidence: `README.md`)
- Customer → Room Booking: books by date (evidence: `README.md`)
- Room Booking → Campaign Discounts: applies code (evidence: `README.md`)
- Room Booking → Payment: requires payment (evidence: `README.md`)
- Customer → Saved Cards: may save card (evidence: `README.md`)
- Payment → Invoice: creates invoice (evidence: `README.md`)
- Business Services → Data Access
- Data Access → PostgreSQL
- Business Services → Domain Entities
