# tanish-hub717/campus-booking architecture

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

- Interactive diagram: https://gitdiagram.com/tanish-hub717/campus-booking
- Repository: https://github.com/tanish-hub717/campus-booking

## Overview

Campus venue-booking application: faculty discover venues, check availability, submit bookings, and manage their reservations; administrators manage venues and directories, review bookings, and view operational dashboards. The React app routes user journeys and shares authentication state, while Java controllers delegate to services that enforce booking rules and persist domain records. The source index confirms several backend dependencies; unsampled controller and page behavior is represented at directory or module level, so uncertain connections are omitted.

Main entry points: [`backend/src/main/java/com/campus/booking/service/BookingService.java`](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/BookingService.java) (Booking rules and review), [`frontend/src/services/api.js`](https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/App.jsx) (Routed application), [`backend/src/main/java/com/campus/booking/service/AuthService.java`](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Routed application<br/>[App.jsx]"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_bookingui["Booking and calendar"]
  node_adminui["Admin workflows"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Authentication endpoints"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[JwtService.java]"]
  node_firebase["Firebase token sync"]
  node_userrepo[("User persistence")]
end

subgraph group_booking["Booking operations"]
  node_bookingcontroller["Booking endpoints"]
  node_bookingservice["Booking rules and review"]
  node_bookingrepo[("Booking persistence")]
  node_bookingmodel["Booking lifecycle<br/>[Booking.java]"]
  node_email["Booking notifications<br/>[EmailService.java]"]
end

subgraph group_catalog["Venue and directories"]
  node_venuecontroller["Venue endpoints"]
  node_venueservice["Venue and availability<br/>[VenueService.java]"]
  node_venuerepo[("Venue persistence")]
  node_venueadmin["Venue administration"]
  node_directory["Department and designation"]
end

subgraph group_platform["Backend platform"]
  node_exception["API error mapping"]
  node_securityconfig["Security configuration"]
end

node_faculty(("Faculty or admin"))

node_faculty -->|"opens"| node_app
node_app -->|"routes to"| node_bookingui
node_app -->|"routes to"| node_adminui
node_app -->|"provides session"| node_authstate
node_authstate -->|"calls"| node_api
node_api -.->|"sends requests"| node_authcontroller
node_api -.->|"sends requests"| node_bookingcontroller
node_api -.->|"sends requests"| node_venuecontroller
node_api -.->|"sends requests"| node_venueadmin
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"uses tokens"| node_jwt
node_authservice -->|"verifies tokens"| node_firebase
node_authservice -->|"reads and writes"| node_userrepo
node_bookingcontroller -->|"delegates to"| node_bookingservice
node_bookingservice -->|"reads and writes"| node_bookingrepo
node_bookingservice -->|"checks venues"| node_venuerepo
node_bookingservice -->|"reads users"| node_userrepo
node_bookingservice -->|"sends notifications"| node_email
node_bookingservice -->|"creates and updates"| node_bookingmodel
node_venuecontroller -.->|"delegates to"| node_venueservice
node_venueservice -->|"reads and writes"| node_venuerepo
node_venueservice -->|"checks reservations"| node_bookingrepo

click node_app "https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/services/api.js"
click node_bookingui "https://github.com/tanish-hub717/campus-booking/tree/main/frontend/src/pages"
click node_adminui "https://github.com/tanish-hub717/campus-booking/tree/main/frontend/src/pages/admin"
click node_authcontroller "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/AuthController.java"
click node_authservice "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/AuthService.java"
click node_jwt "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/security/JwtService.java"
click node_firebase "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/FirebaseTokenService.java"
click node_bookingcontroller "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/BookingController.java"
click node_bookingservice "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/BookingService.java"
click node_bookingrepo "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/BookingRepository.java"
click node_bookingmodel "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/entity/Booking.java"
click node_email "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/EmailService.java"
click node_venuecontroller "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/VenueController.java"
click node_venueservice "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/VenueService.java"
click node_venuerepo "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/VenueRepository.java"
click node_venueadmin "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/AdminController.java"
click node_directory "https://github.com/tanish-hub717/campus-booking/tree/main/backend/src/main/java/com/campus/booking/controller"
click node_userrepo "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/UserRepository.java"
click node_exception "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/exception/GlobalExceptionHandler.java"
click node_securityconfig "https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/config/SecurityConfig.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_app,node_authstate,node_api,node_bookingui,node_adminui toneBlue
class node_authcontroller,node_authservice,node_jwt,node_firebase,node_userrepo toneAmber
class node_bookingcontroller,node_bookingservice,node_bookingrepo,node_bookingmodel,node_email toneMint
class node_venuecontroller,node_venueservice,node_venuerepo,node_venueadmin,node_directory toneRose
class node_exception,node_securityconfig,node_faculty toneIndigo
```

## Components

### Web client

- [Routed application](https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session state](https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/tanish-hub717/campus-booking/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Booking and calendar](https://github.com/tanish-hub717/campus-booking/tree/main/frontend/src/pages): `frontend/src/pages`
- [Admin workflows](https://github.com/tanish-hub717/campus-booking/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`

### Identity and access

- [Authentication endpoints](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/AuthController.java): `backend/src/main/java/com/campus/booking/controller/AuthController.java`
- [Authentication service](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/AuthService.java): `backend/src/main/java/com/campus/booking/service/AuthService.java`
- [JWT security](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/security/JwtService.java): `backend/src/main/java/com/campus/booking/security/JwtService.java`
- [Firebase token sync](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/FirebaseTokenService.java): `backend/src/main/java/com/campus/booking/service/FirebaseTokenService.java`
- [User persistence](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/UserRepository.java): `backend/src/main/java/com/campus/booking/repository/UserRepository.java`

### Booking operations

- [Booking endpoints](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/BookingController.java): `backend/src/main/java/com/campus/booking/controller/BookingController.java`
- [Booking rules and review](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/BookingService.java): `backend/src/main/java/com/campus/booking/service/BookingService.java`
- [Booking persistence](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/BookingRepository.java): `backend/src/main/java/com/campus/booking/repository/BookingRepository.java`
- [Booking lifecycle](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/entity/Booking.java): `backend/src/main/java/com/campus/booking/entity/Booking.java`
- [Booking notifications](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/EmailService.java): `backend/src/main/java/com/campus/booking/service/EmailService.java`

### Venue and directories

- [Venue endpoints](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/VenueController.java): `backend/src/main/java/com/campus/booking/controller/VenueController.java`
- [Venue and availability](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/service/VenueService.java): `backend/src/main/java/com/campus/booking/service/VenueService.java`
- [Venue persistence](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/repository/VenueRepository.java): `backend/src/main/java/com/campus/booking/repository/VenueRepository.java`
- [Venue administration](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/controller/AdminController.java): `backend/src/main/java/com/campus/booking/controller/AdminController.java`
- [Department and designation](https://github.com/tanish-hub717/campus-booking/tree/main/backend/src/main/java/com/campus/booking/controller): `backend/src/main/java/com/campus/booking/controller`

### Backend platform

- [API error mapping](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/exception/GlobalExceptionHandler.java): `backend/src/main/java/com/campus/booking/exception/GlobalExceptionHandler.java`
- [Security configuration](https://github.com/tanish-hub717/campus-booking/blob/main/backend/src/main/java/com/campus/booking/config/SecurityConfig.java): `backend/src/main/java/com/campus/booking/config/SecurityConfig.java`

### Other components

- **Faculty or admin**

## Connections

- Faculty or admin → Routed application: opens (evidence: `frontend/src/App.jsx`)
- Routed application → Booking and calendar: routes to (evidence: `frontend/src/App.jsx`)
- Routed application → Admin workflows: routes to (evidence: `frontend/src/App.jsx`)
- Routed application → Session state: provides session (evidence: `frontend/src/App.jsx`)
- Session state → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → Authentication endpoints: sends requests
- API client → Booking endpoints: sends requests
- API client → Venue endpoints: sends requests
- API client → Venue administration: sends requests
- Authentication endpoints → Authentication service: delegates to (evidence: `backend/src/main/java/com/campus/booking/controller/AuthController.java`)
- Authentication service → JWT security: uses tokens (evidence: `backend/src/main/java/com/campus/booking/service/AuthService.java`)
- Authentication service → Firebase token sync: verifies tokens (evidence: `backend/src/main/java/com/campus/booking/service/AuthService.java`)
- Authentication service → User persistence: reads and writes (evidence: `backend/src/main/java/com/campus/booking/service/AuthService.java`)
- Booking endpoints → Booking rules and review: delegates to (evidence: `backend/src/main/java/com/campus/booking/controller/BookingController.java`)
- Booking rules and review → Booking persistence: reads and writes (evidence: `backend/src/main/java/com/campus/booking/service/BookingService.java`)
- Booking rules and review → Venue persistence: checks venues (evidence: `backend/src/main/java/com/campus/booking/service/BookingService.java`)
- Booking rules and review → User persistence: reads users (evidence: `backend/src/main/java/com/campus/booking/service/BookingService.java`)
- Booking rules and review → Booking notifications: sends notifications (evidence: `backend/src/main/java/com/campus/booking/service/BookingService.java`)
- Booking rules and review → Booking lifecycle: creates and updates (evidence: `backend/src/main/java/com/campus/booking/service/BookingService.java`)
- Venue endpoints → Venue and availability: delegates to (evidence: `backend/src/main/java/com/campus/booking/controller/VenueController.java`)
- Venue and availability → Venue persistence: reads and writes (evidence: `backend/src/main/java/com/campus/booking/service/VenueService.java`)
- Venue and availability → Booking persistence: checks reservations (evidence: `backend/src/main/java/com/campus/booking/service/VenueService.java`)
