# yomileonel/room_booking_system architecture

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

- Interactive diagram: https://gitdiagram.com/yomileonel/room_booking_system
- Repository: https://github.com/yomileonel/room_booking_system

## Overview

Spacio is a room-booking application with a Next.js frontend and Spring Boot REST backend. Customers browse rooms, create bookings, pay through Stripe Checkout, and retrieve invoices; admins manage rooms, bookings, discount codes, users, and dashboard metrics. Authentication and optional AI-assistant workflows are distinct branches. The README documents the main product flows and integrations; source excerpts are limited, so implementation-level links not shown there are omitted.

Main entry points: [`react_frontend/src/app/components/BookingAdd.tsx`](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/components/BookingAdd.tsx) (Booking flow), [`react_frontend/src/app/api/apiClient.ts`](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/api/apiClient.ts) (API client), [`react_frontend/src/app/page.tsx`](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/page.tsx) (Booking interface), [`react_frontend/src/app/rooms/page.tsx`](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/rooms/page.tsx) (Room browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer web app"]
  node_webapp["Booking interface<br/>[page.tsx]"]
  node_roomview["Room browsing<br/>[page.tsx]"]
  node_roomdetail["Room details<br/>[page.tsx]"]
  node_profile["Customer profile<br/>[page.tsx]"]
  node_webapi["API client<br/>[apiClient.ts]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Login and registration<br/>[page.tsx]"]
  node_authcontroller["Authentication API"]
  node_jwt["JWT security<br/>[JwtService.java]"]
  node_users[("User records<br/>[User.java]")]
end

subgraph group_booking["Rooms and bookings"]
  node_roomapi["Room API"]
  node_roomservice["Room management<br/>[RoomService.java]"]
  node_roomstore[("Room data<br/>[Room.java]")]
  node_bookingui["Booking flow<br/>[BookingAdd.tsx]"]
  node_bookingapi["Booking API"]
  node_bookingservice["Booking rules"]
  node_bookings[("Booking records<br/>[Booking.java]")]
  node_discounts["Discount codes"]
  node_storage["Room image storage"]
end

subgraph group_commerce["Payments and billing"]
  node_paymentapi["Payment API"]
  node_paymentservice["Payment processing"]
  node_stripe["Stripe Checkout<br/>[StripeService.java]"]
  node_invoices["Invoice service"]
  node_pdf["Invoice PDF"]
end

subgraph group_operations["Admin and assistant"]
  node_adminui["Admin dashboard<br/>[page.tsx]"]
  node_adminapi["Dashboard metrics"]
  node_assistantui["Assistant chat<br/>[page.tsx]"]
  node_assistantroute["Assistant endpoint<br/>[route.ts]"]
  node_assistantmodel["AI tool-calling<br/>[openai-client.ts]"]
  node_assistanttools["Assistant data tools<br/>[tools.ts]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))
node_stripeext{{"Stripe service"}}
node_backend{{"Spring REST API"}}
node_postgres[("PostgreSQL")]

node_customer -->|"uses"| node_webapp
node_admin -->|"manages"| node_adminui
node_webapp -->|"browses"| node_roomview
node_roomview -->|"selects room"| node_roomdetail
node_roomdetail -->|"starts booking"| node_bookingui
node_webapp -->|"authenticates"| node_authui
node_authui -.->|"requests"| node_webapi
node_webapi -->|"calls REST"| node_backend
node_backend -.->|"routes auth"| node_authcontroller
node_authcontroller -->|"issues tokens"| node_jwt
node_authcontroller -->|"stores accounts"| node_users
node_roomview -.->|"loads rooms"| node_webapi
node_backend -.->|"routes rooms"| node_roomapi
node_roomapi -.->|"manages"| node_roomservice
node_roomservice -.->|"reads rooms"| node_roomstore
node_roomdetail -->|"chooses dates"| node_bookingui
node_bookingui -.->|"submits booking"| node_webapi
node_backend -.->|"routes bookings"| node_bookingapi
node_bookingapi -.->|"handles booking"| node_bookingservice
node_bookingservice -.->|"persists booking"| node_bookings
node_bookingui -.->|"applies code"| node_discounts
node_bookingui -->|"starts payment"| node_paymentapi
node_paymentapi -.->|"processes payment"| node_paymentservice
node_paymentservice -.->|"creates checkout"| node_stripe
node_stripe -->|"uses checkout"| node_stripeext
node_stripeext -.->|"reports payment"| node_paymentapi
node_paymentservice -->|"creates invoice"| node_invoices
node_invoices -->|"generates PDF"| node_pdf
node_profile -.->|"loads account"| node_webapi
node_adminui -.->|"loads metrics"| node_adminapi
node_assistantui -->|"sends question"| node_assistantroute
node_assistantroute -->|"asks model"| node_assistantmodel
node_assistantmodel -->|"executes tools"| node_assistanttools
node_assistanttools -->|"reads booking data"| node_backend
node_assistantroute -->|"stores chat history"| node_backend
node_backend -->|"persists records"| node_postgres
node_roomapi -.->|"handles room photos"| node_storage

click node_webapp "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/page.tsx"
click node_roomview "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/rooms/page.tsx"
click node_roomdetail "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/rooms/%5Bid%5D/page.tsx"
click node_profile "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/profile/page.tsx"
click node_webapi "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/api/apiClient.ts"
click node_authui "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/login/page.tsx"
click node_authcontroller "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/user/Controller/RegistrationLoginController.java"
click node_jwt "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/security/JwtService.java"
click node_users "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/user/model/User.java"
click node_roomapi "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/Controller/RoomController.java"
click node_roomservice "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/service/RoomService.java"
click node_roomstore "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/model/Room.java"
click node_bookingui "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/components/BookingAdd.tsx"
click node_bookingapi "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/Controller/BookingController.java"
click node_bookingservice "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/service/BookingService.java"
click node_bookings "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/model/Booking.java"
click node_discounts "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/discount/Controller/DiscountCodeController.java"
click node_paymentapi "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/Controller/PaymentController.java"
click node_paymentservice "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/service/PaymentService.java"
click node_stripe "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/service/StripeService.java"
click node_invoices "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoiceService.java"
click node_pdf "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoicePdfGenerator.java"
click node_adminui "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/admin/page.tsx"
click node_adminapi "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/admin/AdminDashboardController.java"
click node_assistantui "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/assistant/page.tsx"
click node_assistantroute "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/api/assistant/route.ts"
click node_assistantmodel "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/lib/assistant/openai-client.ts"
click node_assistanttools "https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/lib/assistant/tools.ts"
click node_storage "https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/storage/StorageService.java"

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_webapp,node_roomview,node_roomdetail,node_profile,node_webapi toneBlue
class node_authui,node_authcontroller,node_jwt,node_users,node_postgres toneAmber
class node_roomapi,node_roomservice,node_roomstore,node_bookingui,node_bookingapi,node_bookingservice,node_bookings,node_discounts,node_storage,node_backend toneMint
class node_paymentapi,node_paymentservice,node_stripe,node_invoices,node_pdf toneRose
class node_adminui,node_adminapi,node_assistantui,node_assistantroute,node_assistantmodel,node_assistanttools,node_customer,node_admin,node_stripeext toneIndigo
```

## Components

### Customer web app

- [Booking interface](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/page.tsx): `react_frontend/src/app/page.tsx`
- [Room browsing](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/rooms/page.tsx): `react_frontend/src/app/rooms/page.tsx`
- [Room details](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/rooms/%5Bid%5D/page.tsx): `react_frontend/src/app/rooms/[id]/page.tsx`
- [Customer profile](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/profile/page.tsx): `react_frontend/src/app/profile/page.tsx`
- [API client](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/api/apiClient.ts): `react_frontend/src/app/api/apiClient.ts`

### Identity and access

- [Login and registration](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/login/page.tsx): `react_frontend/src/app/login/page.tsx`
- [Authentication API](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/user/Controller/RegistrationLoginController.java): `bookingssystem/src/main/java/steve/bookingssystem/user/Controller/RegistrationLoginController.java`
- [JWT security](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/security/JwtService.java): `bookingssystem/src/main/java/steve/bookingssystem/security/JwtService.java`
- [User records](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/user/model/User.java): `bookingssystem/src/main/java/steve/bookingssystem/user/model/User.java`

### Rooms and bookings

- [Room API](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/Controller/RoomController.java): `bookingssystem/src/main/java/steve/bookingssystem/room/Controller/RoomController.java`
- [Room management](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/service/RoomService.java): `bookingssystem/src/main/java/steve/bookingssystem/room/service/RoomService.java`
- [Room data](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/room/model/Room.java): `bookingssystem/src/main/java/steve/bookingssystem/room/model/Room.java`
- [Booking flow](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/components/BookingAdd.tsx): `react_frontend/src/app/components/BookingAdd.tsx`
- [Booking API](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/Controller/BookingController.java): `bookingssystem/src/main/java/steve/bookingssystem/booking/Controller/BookingController.java`
- [Booking rules](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/service/BookingService.java): `bookingssystem/src/main/java/steve/bookingssystem/booking/service/BookingService.java`
- [Booking records](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/booking/model/Booking.java): `bookingssystem/src/main/java/steve/bookingssystem/booking/model/Booking.java`
- [Discount codes](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/discount/Controller/DiscountCodeController.java): `bookingssystem/src/main/java/steve/bookingssystem/discount/Controller/DiscountCodeController.java`
- [Room image storage](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/storage/StorageService.java): `bookingssystem/src/main/java/steve/bookingssystem/storage/StorageService.java`

### Payments and billing

- [Payment API](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/Controller/PaymentController.java): `bookingssystem/src/main/java/steve/bookingssystem/payment/Controller/PaymentController.java`
- [Payment processing](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/service/PaymentService.java): `bookingssystem/src/main/java/steve/bookingssystem/payment/service/PaymentService.java`
- [Stripe Checkout](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/payment/service/StripeService.java): `bookingssystem/src/main/java/steve/bookingssystem/payment/service/StripeService.java`
- [Invoice service](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoiceService.java): `bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoiceService.java`
- [Invoice PDF](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoicePdfGenerator.java): `bookingssystem/src/main/java/steve/bookingssystem/invoice/service/InvoicePdfGenerator.java`

### Admin and assistant

- [Admin dashboard](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/admin/page.tsx): `react_frontend/src/app/admin/page.tsx`
- [Dashboard metrics](https://github.com/yomileonel/room_booking_system/blob/main/bookingssystem/src/main/java/steve/bookingssystem/admin/AdminDashboardController.java): `bookingssystem/src/main/java/steve/bookingssystem/admin/AdminDashboardController.java`
- [Assistant chat](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/assistant/page.tsx): `react_frontend/src/app/assistant/page.tsx`
- [Assistant endpoint](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/api/assistant/route.ts): `react_frontend/src/app/api/assistant/route.ts`
- [AI tool-calling](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/lib/assistant/openai-client.ts): `react_frontend/src/app/lib/assistant/openai-client.ts`
- [Assistant data tools](https://github.com/yomileonel/room_booking_system/blob/main/react_frontend/src/app/lib/assistant/tools.ts): `react_frontend/src/app/lib/assistant/tools.ts`

### Other components

- **Customer**
- **Administrator**
- **Stripe service**
- **Spring REST API**
- **PostgreSQL**

## Connections

- Customer → Booking interface: uses (evidence: `README.md`)
- Administrator → Admin dashboard: manages (evidence: `README.md`)
- Booking interface → Room browsing: browses (evidence: `README.md`)
- Room browsing → Room details: selects room (evidence: `README.md`)
- Room details → Booking flow: starts booking (evidence: `README.md`)
- Booking interface → Login and registration: authenticates (evidence: `README.md`)
- Login and registration → API client: requests (evidence: `react_frontend/src/app/login/page.tsx`)
- API client → Spring REST API: calls REST (evidence: `README.md`)
- Spring REST API → Authentication API: routes auth
- Authentication API → JWT security: issues tokens (evidence: `bookingssystem/src/main/java/steve/bookingssystem/user/Controller/RegistrationLoginController.java`)
- Authentication API → User records: stores accounts (evidence: `bookingssystem/src/main/java/steve/bookingssystem/user/Controller/RegistrationLoginController.java`)
- Room browsing → API client: loads rooms
- Spring REST API → Room API: routes rooms
- Room API → Room management: manages
- Room management → Room data: reads rooms (evidence: `bookingssystem/src/main/java/steve/bookingssystem/room/service/RoomService.java`)
- Room details → Booking flow: chooses dates (evidence: `README.md`)
- Booking flow → API client: submits booking
- Spring REST API → Booking API: routes bookings
- Booking API → Booking rules: handles booking
- Booking rules → Booking records: persists booking
- Booking flow → Discount codes: applies code
- Booking flow → Payment API: starts payment (evidence: `README.md`)
- Payment API → Payment processing: processes payment
- Payment processing → Stripe Checkout: creates checkout
- Stripe Checkout → Stripe service: uses checkout (evidence: `README.md`)
- Stripe service → Payment API: reports payment
- Payment processing → Invoice service: creates invoice (evidence: `README.md`)
- Invoice service → Invoice PDF: generates PDF (evidence: `README.md`)
- Customer profile → API client: loads account (evidence: `react_frontend/src/app/profile/page.tsx`)
- Admin dashboard → Dashboard metrics: loads metrics
- Assistant chat → Assistant endpoint: sends question (evidence: `react_frontend/src/app/assistant/page.tsx`)
- Assistant endpoint → AI tool-calling: asks model (evidence: `react_frontend/src/app/api/assistant/route.ts`)
- AI tool-calling → Assistant data tools: executes tools (evidence: `react_frontend/src/app/lib/assistant/openai-client.ts`)
- Assistant data tools → Spring REST API: reads booking data (evidence: `react_frontend/src/app/lib/assistant/tools.ts`)
- Assistant endpoint → Spring REST API: stores chat history (evidence: `react_frontend/src/app/api/assistant/route.ts`)
- Spring REST API → PostgreSQL: persists records (evidence: `README.md`)
- Room API → Room image storage: handles room photos
