# ambika1210/hotel_be architecture

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

- Interactive diagram: https://gitdiagram.com/ambika1210/hotel_be
- Repository: https://github.com/ambika1210/hotel_be

## Overview

Hotel_be is an Express backend for hotel, room, guest, user, and booking administration. Requests enter through the mounted API routes, pass route-configured authentication where required, reach controllers, and are handled by domain services that use repositories for persistence. Booking is a central workflow: the service validates hotel, room, guest, and date availability, creates the booking, and updates room occupancy. The source index identifies repository/model dependencies and service/repository relationships; unsampled modules are represented only where those references support them.

Main entry points: [`src/controller`](https://github.com/ambika1210/hotel_be/tree/main/src/controller) (Request controllers), [`src/services/booking.service.js`](https://github.com/ambika1210/hotel_be/blob/main/src/services/booking.service.js) (Booking service), [`src/repositories/hotel.repository.js`](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/hotel.repository.js) (Hotel repository), [`src/models`](https://github.com/ambika1210/hotel_be/tree/main/src/models) (Mongo models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API layer"]
  node_routes["API routes"]
  node_auth["JWT authorization<br/>[auth.middleware.js]"]
  node_controllers["Request controllers"]
end

subgraph group_domain["Hotel operations"]
  node_booking_service["Booking service<br/>[booking.service.js]"]
  node_hotel_service["Hotel service<br/>[hotel.service.js]"]
  node_room_service["Room service<br/>[room.service.js]"]
  node_guest_service["Guest service<br/>[guest.service.js]"]
  node_user_service["User service<br/>[user.service.js]"]
end

subgraph group_persistence["Persistence"]
  node_booking_repo["Booking repository"]
  node_hotel_repo["Hotel repository"]
  node_room_repo["Room repository<br/>[room.repository.js]"]
  node_guest_repo["Guest repository"]
  node_user_repo["User repository<br/>[user.repository.js]"]
  node_models[("Mongo models")]
end

subgraph group_runtime["Runtime"]
  node_app["Express server<br/>[app.js]"]
  node_connection["Database connection<br/>[connection.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_routes
node_app -->|"connects database"| node_connection
node_routes -->|"authenticates"| node_auth
node_routes -->|"dispatches"| node_controllers
node_controllers -->|"calls"| node_booking_service
node_controllers -->|"calls"| node_hotel_service
node_controllers -->|"calls"| node_room_service
node_controllers -->|"calls"| node_guest_service
node_controllers -->|"calls"| node_user_service
node_booking_service -->|"reads and writes"| node_booking_repo
node_booking_service -->|"validates hotel"| node_hotel_repo
node_booking_service -->|"checks occupancy"| node_room_repo
node_booking_service -->|"validates guest"| node_guest_repo
node_hotel_service -->|"uses"| node_hotel_repo
node_hotel_service -->|"uses"| node_user_repo
node_room_service -->|"uses"| node_room_repo
node_room_service -->|"uses"| node_hotel_repo
node_room_service -->|"checks bookings"| node_booking_service
node_guest_service -->|"uses"| node_guest_repo
node_guest_service -->|"uses"| node_hotel_repo
node_user_service -->|"uses"| node_user_repo
node_booking_repo -->|"queries booking model"| node_models
node_hotel_repo -->|"queries hotel model"| node_models
node_room_repo -->|"queries room model"| node_models
node_guest_repo -->|"queries guest model"| node_models
node_user_repo -->|"queries user model"| node_models

click node_app "https://github.com/ambika1210/hotel_be/blob/main/app.js"
click node_routes "https://github.com/ambika1210/hotel_be/tree/main/src/routes"
click node_auth "https://github.com/ambika1210/hotel_be/blob/main/src/middleware/auth.middleware.js"
click node_controllers "https://github.com/ambika1210/hotel_be/tree/main/src/controller"
click node_booking_service "https://github.com/ambika1210/hotel_be/blob/main/src/services/booking.service.js"
click node_hotel_service "https://github.com/ambika1210/hotel_be/blob/main/src/services/hotel.service.js"
click node_room_service "https://github.com/ambika1210/hotel_be/blob/main/src/services/room.service.js"
click node_guest_service "https://github.com/ambika1210/hotel_be/blob/main/src/services/guest.service.js"
click node_user_service "https://github.com/ambika1210/hotel_be/blob/main/src/services/user.service.js"
click node_booking_repo "https://github.com/ambika1210/hotel_be/blob/main/src/repositories/booking.repository.js"
click node_hotel_repo "https://github.com/ambika1210/hotel_be/blob/main/src/repositories/hotel.repository.js"
click node_room_repo "https://github.com/ambika1210/hotel_be/blob/main/src/repositories/room.repository.js"
click node_guest_repo "https://github.com/ambika1210/hotel_be/blob/main/src/repositories/guest.repository.js"
click node_user_repo "https://github.com/ambika1210/hotel_be/blob/main/src/repositories/user.repository.js"
click node_models "https://github.com/ambika1210/hotel_be/tree/main/src/models"
click node_connection "https://github.com/ambika1210/hotel_be/blob/main/src/db/connection.js"

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_routes,node_auth,node_controllers,node_client toneBlue
class node_booking_service,node_hotel_service,node_room_service,node_guest_service,node_user_service toneAmber
class node_booking_repo,node_hotel_repo,node_room_repo,node_guest_repo,node_user_repo,node_models toneMint
class node_app,node_connection toneRose
```

## Components

### API layer

- [API routes](https://github.com/ambika1210/hotel_be/tree/main/src/routes): `src/routes`
- [JWT authorization](https://github.com/ambika1210/hotel_be/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`
- [Request controllers](https://github.com/ambika1210/hotel_be/tree/main/src/controller): `src/controller`

### Hotel operations

- [Booking service](https://github.com/ambika1210/hotel_be/blob/main/src/services/booking.service.js): `src/services/booking.service.js`
- [Hotel service](https://github.com/ambika1210/hotel_be/blob/main/src/services/hotel.service.js): `src/services/hotel.service.js`
- [Room service](https://github.com/ambika1210/hotel_be/blob/main/src/services/room.service.js): `src/services/room.service.js`
- [Guest service](https://github.com/ambika1210/hotel_be/blob/main/src/services/guest.service.js): `src/services/guest.service.js`
- [User service](https://github.com/ambika1210/hotel_be/blob/main/src/services/user.service.js): `src/services/user.service.js`

### Persistence

- [Booking repository](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/booking.repository.js): `src/repositories/booking.repository.js`
- [Hotel repository](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/hotel.repository.js): `src/repositories/hotel.repository.js`
- [Room repository](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/room.repository.js): `src/repositories/room.repository.js`
- [Guest repository](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/guest.repository.js): `src/repositories/guest.repository.js`
- [User repository](https://github.com/ambika1210/hotel_be/blob/main/src/repositories/user.repository.js): `src/repositories/user.repository.js`
- [Mongo models](https://github.com/ambika1210/hotel_be/tree/main/src/models): `src/models`

### Runtime

- [Express server](https://github.com/ambika1210/hotel_be/blob/main/app.js): `app.js`
- [Database connection](https://github.com/ambika1210/hotel_be/blob/main/src/db/connection.js): `src/db/connection.js`

### Other components

- **API client**

## Connections

- API client → Express server: sends requests (evidence: `app.js`)
- Express server → API routes: mounts routes (evidence: `app.js`)
- Express server → Database connection: connects database (evidence: `app.js`)
- API routes → JWT authorization: authenticates (evidence: `src/routes/booking.routes.js`)
- API routes → Request controllers: dispatches (evidence: `src/routes/booking.routes.js`)
- Request controllers → Booking service: calls (evidence: `src/controller/booking.controller.js`)
- Request controllers → Hotel service: calls (evidence: `src/controller/hotel.controller.js`)
- Request controllers → Room service: calls (evidence: `src/controller/room.controller.js`)
- Request controllers → Guest service: calls (evidence: `src/controller/guest.controller.js`)
- Request controllers → User service: calls (evidence: `src/controller/user.controller.js`)
- Booking service → Booking repository: reads and writes (evidence: `src/services/booking.service.js`)
- Booking service → Hotel repository: validates hotel (evidence: `src/services/booking.service.js`)
- Booking service → Room repository: checks occupancy (evidence: `src/services/booking.service.js`)
- Booking service → Guest repository: validates guest (evidence: `src/services/booking.service.js`)
- Hotel service → Hotel repository: uses (evidence: `src/services/hotel.service.js`)
- Hotel service → User repository: uses (evidence: `src/services/hotel.service.js`)
- Room service → Room repository: uses (evidence: `src/services/room.service.js`)
- Room service → Hotel repository: uses (evidence: `src/services/room.service.js`)
- Room service → Booking service: checks bookings (evidence: `src/services/room.service.js`)
- Guest service → Guest repository: uses (evidence: `src/services/guest.service.js`)
- Guest service → Hotel repository: uses (evidence: `src/services/guest.service.js`)
- User service → User repository: uses (evidence: `src/services/user.service.js`)
- Booking repository → Mongo models: queries booking model (evidence: `src/repositories/booking.repository.js`)
- Hotel repository → Mongo models: queries hotel model (evidence: `src/repositories/hotel.repository.js`)
- Room repository → Mongo models: queries room model (evidence: `src/repositories/room.repository.js`)
- Guest repository → Mongo models: queries guest model (evidence: `src/repositories/guest.repository.js`)
- User repository → Mongo models: queries user model (evidence: `src/repositories/user.repository.js`)
