# seemant-dev/resource-booking-engine architecture

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

- Interactive diagram: https://gitdiagram.com/seemant-dev/resource-booking-engine
- Repository: https://github.com/seemant-dev/resource-booking-engine

## Overview

Resource-Booking-Engine is a Next.js booking interface backed by a Spring API. Its principal user path is sign in, browse resources and dated slots, book or cancel, then review bookings; administrators manage resources and generate slots, and inspect bookings and summary statistics. The backend separates HTTP controllers, domain services, and persistence. The tree documents these capabilities, but sampled UI pages use mock data and the UI API wiring for most flows was not shown, so those links are omitted rather than assumed.

Main entry points: [`SlotEngine-UI/src/api/client.ts`](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/api/client.ts) (API client), [`SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java`](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java) (Slot discovery and generation), [`SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java) (Booking and cancellation), [`SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java`](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Booking interface"]
  node_ui_auth["Sign in / register<br/>[page.tsx]"]
  node_ui_resources["Browse resources<br/>[page.tsx]"]
  node_ui_slots["Resource slots<br/>[page.tsx]"]
  node_ui_bookings["My bookings<br/>[page.tsx]"]
  node_ui_admin["Admin pages<br/>[page.tsx]"]
  node_ui_admin_resources["Manage resources<br/>[page.tsx]"]
  node_ui_admin_slots["Generate slots<br/>[page.tsx]"]
  node_ui_admin_bookings["Booking search<br/>[page.tsx]"]
  node_ui_client["API client<br/>[client.ts]"]
end

subgraph group_api["HTTP and identity"]
  node_auth_controller["Auth endpoints"]
  node_resource_controller["Resource and slot endpoints"]
  node_booking_controller["Booking endpoints"]
  node_admin_controller["Admin endpoints"]
  node_security["JWT security"]
end

subgraph group_domain["Booking domain"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_resource_service["Resource management"]
  node_slot_service["Slot discovery and generation<br/>[SlotService.java]"]
  node_slot_generator["Candidate generation"]
  node_booking_service["Booking and cancellation"]
  node_admin_service["Admin reports<br/>[AdminService.java]"]
  node_refresh_service["Refresh tokens"]
  node_booking_mapper["Booking mapping<br/>[BookingMapper.java]"]
end

subgraph group_data["Persistence"]
  node_slot_repo[("Slot storage")]
  node_booking_repo[("Booking storage")]
  node_user_repo[("User storage")]
  node_resource_repo[("Resource storage")]
  node_admin_repo[("Admin queries")]
  node_refresh_repo[("Refresh-token storage")]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -->|"uses"| node_ui_auth
node_user -->|"browses"| node_ui_resources
node_user -->|"selects slot"| node_ui_slots
node_user -->|"reviews"| node_ui_bookings
node_admin -->|"uses"| node_ui_admin
node_admin -->|"manages"| node_ui_admin_resources
node_admin -->|"generates"| node_ui_admin_slots
node_admin -->|"searches"| node_ui_admin_bookings
node_ui_auth -.->|"requests"| node_ui_client
node_ui_resources -.->|"requests"| node_ui_client
node_ui_slots -.->|"requests"| node_ui_client
node_ui_bookings -.->|"requests"| node_ui_client
node_ui_admin_resources -.->|"requests"| node_ui_client
node_ui_admin_slots -.->|"requests"| node_ui_client
node_ui_admin_bookings -.->|"requests"| node_ui_client
node_ui_client -.->|"HTTP requests"| node_auth_controller
node_ui_client -.->|"HTTP requests"| node_resource_controller
node_ui_client -.->|"HTTP requests"| node_booking_controller
node_ui_client -.->|"HTTP requests"| node_admin_controller
node_auth_controller -->|"delegates"| node_auth_service
node_resource_controller -->|"delegates"| node_resource_service
node_resource_controller -->|"delegates"| node_slot_service
node_admin_controller -->|"delegates"| node_admin_service
node_booking_controller -.->|"delegates"| node_booking_service
node_auth_service -->|"reads/writes users"| node_user_repo
node_auth_service -->|"creates / rotates"| node_refresh_service
node_auth_service -.->|"via token service"| node_refresh_repo
node_slot_service -->|"generates candidates"| node_slot_generator
node_slot_service -->|"loads resource"| node_resource_repo
node_slot_service -->|"reads existing slots"| node_slot_repo
node_slot_service -.->|"maps slots"| node_booking_mapper
node_booking_service -->|"locks / reads slot"| node_slot_repo
node_booking_service -->|"loads user"| node_user_repo
node_booking_service -->|"reads / saves booking"| node_booking_repo
node_booking_service -->|"maps response"| node_booking_mapper
node_admin_service -->|"queries reports"| node_admin_repo
node_admin_service -->|"maps bookings"| node_booking_mapper
node_admin_repo -.->|"queries booking data"| node_booking_repo
node_refresh_service -.->|"stores tokens"| node_refresh_repo

click node_ui_auth "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(auth)/login/page.tsx"
click node_ui_resources "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/resources/page.tsx"
click node_ui_slots "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/resources/%5BresourceId%5D/page.tsx"
click node_ui_bookings "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/bookings/page.tsx"
click node_ui_admin "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/page.tsx"
click node_ui_admin_resources "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/resources/page.tsx"
click node_ui_admin_slots "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/resources/%5BresourceId%5D/slots/new/page.tsx"
click node_ui_admin_bookings "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/bookings/page.tsx"
click node_ui_client "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/api/client.ts"
click node_auth_controller "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java"
click node_resource_controller "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java"
click node_booking_controller "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/BookingController.java"
click node_admin_controller "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java"
click node_security "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/security/JwtAuthenticationFilter.java"
click node_auth_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java"
click node_resource_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/ResourceService.java"
click node_slot_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java"
click node_slot_generator "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotCandidateGenerator.java"
click node_booking_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java"
click node_admin_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java"
click node_refresh_service "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/RefreshTokenService.java"
click node_booking_mapper "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/mapper/BookingMapper.java"
click node_slot_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/SlotRepository.java"
click node_booking_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/BookingRepository.java"
click node_user_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/UserRepository.java"
click node_resource_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/ResourceRepository.java"
click node_admin_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/AdminRepository.java"
click node_refresh_repo "https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/RefreshTokenRepository.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_ui_auth,node_ui_resources,node_ui_slots,node_ui_bookings,node_ui_admin,node_ui_admin_resources,node_ui_admin_slots,node_ui_admin_bookings,node_ui_client,node_user toneBlue
class node_auth_controller,node_resource_controller,node_booking_controller,node_admin_controller,node_security toneAmber
class node_auth_service,node_resource_service,node_slot_service,node_slot_generator,node_booking_service,node_admin_service,node_refresh_service,node_booking_mapper toneMint
class node_slot_repo,node_booking_repo,node_user_repo,node_resource_repo,node_admin_repo,node_refresh_repo toneRose
class node_admin toneIndigo
```

## Components

### Booking interface

- [Sign in / register](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(auth)/login/page.tsx): `SlotEngine-UI/src/app/(auth)/login/page.tsx`
- [Browse resources](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/resources/page.tsx): `SlotEngine-UI/src/app/(user)/resources/page.tsx`
- [Resource slots](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/resources/%5BresourceId%5D/page.tsx): `SlotEngine-UI/src/app/(user)/resources/[resourceId]/page.tsx`
- [My bookings](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(user)/bookings/page.tsx): `SlotEngine-UI/src/app/(user)/bookings/page.tsx`
- [Admin pages](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/page.tsx): `SlotEngine-UI/src/app/(admin)/admin/page.tsx`
- [Manage resources](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/resources/page.tsx): `SlotEngine-UI/src/app/(admin)/admin/resources/page.tsx`
- [Generate slots](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/resources/%5BresourceId%5D/slots/new/page.tsx): `SlotEngine-UI/src/app/(admin)/admin/resources/[resourceId]/slots/new/page.tsx`
- [Booking search](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/app/(admin)/admin/bookings/page.tsx): `SlotEngine-UI/src/app/(admin)/admin/bookings/page.tsx`
- [API client](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-UI/src/api/client.ts): `SlotEngine-UI/src/api/client.ts`

### HTTP and identity

- [Auth endpoints](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java`
- [Resource and slot endpoints](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java`
- [Booking endpoints](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/BookingController.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/BookingController.java`
- [Admin endpoints](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java`
- [JWT security](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/security/JwtAuthenticationFilter.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/security/JwtAuthenticationFilter.java`

### Booking domain

- [Authentication](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java`
- [Resource management](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/ResourceService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/ResourceService.java`
- [Slot discovery and generation](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java`
- [Candidate generation](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotCandidateGenerator.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotCandidateGenerator.java`
- [Booking and cancellation](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`
- [Admin reports](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java`
- [Refresh tokens](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/service/RefreshTokenService.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/RefreshTokenService.java`
- [Booking mapping](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/mapper/BookingMapper.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/mapper/BookingMapper.java`

### Persistence

- [Slot storage](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/SlotRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/SlotRepository.java`
- [Booking storage](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/BookingRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/BookingRepository.java`
- [User storage](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/UserRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/UserRepository.java`
- [Resource storage](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/ResourceRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/ResourceRepository.java`
- [Admin queries](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/AdminRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/AdminRepository.java`
- [Refresh-token storage](https://github.com/seemant-dev/resource-booking-engine/blob/main/SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/RefreshTokenRepository.java): `SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/RefreshTokenRepository.java`

### Other components

- **User**
- **Administrator**

## Connections

- User → Sign in / register: uses
- User → Browse resources: browses
- User → Resource slots: selects slot
- User → My bookings: reviews
- Administrator → Admin pages: uses
- Administrator → Manage resources: manages
- Administrator → Generate slots: generates
- Administrator → Booking search: searches
- Sign in / register → API client: requests
- Browse resources → API client: requests
- Resource slots → API client: requests
- My bookings → API client: requests
- Manage resources → API client: requests
- Generate slots → API client: requests
- Booking search → API client: requests
- API client → Auth endpoints: HTTP requests
- API client → Resource and slot endpoints: HTTP requests
- API client → Booking endpoints: HTTP requests
- API client → Admin endpoints: HTTP requests
- Auth endpoints → Authentication: delegates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java`)
- Resource and slot endpoints → Resource management: delegates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java`)
- Resource and slot endpoints → Slot discovery and generation: delegates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java`)
- Admin endpoints → Admin reports: delegates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java`)
- Booking endpoints → Booking and cancellation: delegates
- Authentication → User storage: reads/writes users (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java`)
- Authentication → Refresh tokens: creates / rotates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java`)
- Authentication → Refresh-token storage: via token service
- Slot discovery and generation → Candidate generation: generates candidates (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java`)
- Slot discovery and generation → Resource storage: loads resource (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java`)
- Slot discovery and generation → Slot storage: reads existing slots (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java`)
- Slot discovery and generation → Booking mapping: maps slots
- Booking and cancellation → Slot storage: locks / reads slot (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`)
- Booking and cancellation → User storage: loads user (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`)
- Booking and cancellation → Booking storage: reads / saves booking (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`)
- Booking and cancellation → Booking mapping: maps response (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java`)
- Admin reports → Admin queries: queries reports (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java`)
- Admin reports → Booking mapping: maps bookings (evidence: `SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java`)
- Admin queries → Booking storage: queries booking data
- Refresh tokens → Refresh-token storage: stores tokens
