# yj87/subook architecture

> Architecture diagram of the GitHub repository yj87/subook, 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/yj87/subook
- Repository: https://github.com/yj87/subook

## Overview

SUBook is a university venue-booking and campus-event platform for students, club representatives, and MPP administrators. Users authenticate and browse venues and availability before submitting booking requests; club representatives and MPP administrators manage approvals, while administrators also review bookings and calendars. The repository shows the React route map, booking API registration, role-check middleware, and Supabase use. Payments, events, OCR, recommendations, and reports are documented capabilities, but their full runtime flows are not established by the sampled source, so those links are marked as documented or unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/yj87/subook/blob/main/frontend/src/App.jsx) (Route application), [`backend/routes/bookings.js`](https://github.com/yj87/subook/blob/main/backend/routes/bookings.js) (Booking routes), [`backend/index.js`](https://github.com/yj87/subook/blob/main/backend/index.js) (HTTP API server), [`frontend/src/supabaseClient.js`](https://github.com/yj87/subook/blob/main/frontend/src/supabaseClient.js) (Supabase client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and profiles"]
  node_app["Route application<br/>[App.jsx]"]
  node_authui["Sign-in and callback<br/>[AuthCallback.jsx]"]
  node_guard["Role route guard<br/>[ProtectedRoute.jsx]"]
  node_profile["Profile management<br/>[ProfileModal.jsx]"]
end

subgraph group_booking["Venue and booking"]
  node_venues["Venue catalogue and details<br/>[VenueCatalogue.jsx]"]
  node_venueapi["Venue API client<br/>[api.js]"]
  node_availability["Availability selection"]
  node_bookingrequest["Booking request"]
  node_confirmation["Booking confirmation"]
  node_clubapproval["Club booking approval"]
  node_campusclubs["Club event management<br/>[ClubDashboard.jsx]"]
end

subgraph group_admin["MPP operations"]
  node_calendarlogic["Calendar calculations<br/>[bookingCalendar.js]"]
  node_adminui["MPP dashboard<br/>[MPPDashboard.jsx]"]
  node_pending["Pending requests"]
  node_calendar["Booking calendar"]
  node_allbookings["All bookings"]
  node_reports["Reports and analytics"]
end

subgraph group_services["Backend services"]
  node_backend["HTTP API server<br/>[index.js]"]
  node_bookingapi["Booking routes<br/>[bookings.js]"]
  node_venuebackend["Venue routes<br/>[venues.js]"]
  node_ocr["OCR endpoint<br/>[ocr.js]"]
  node_adminauth["MPP authorization<br/>[auth.js]"]
  node_recommendations["Recommendation chatbot"]
end

subgraph group_integrations["External services"]
  node_supabaseclient["Supabase client<br/>[supabaseClient.js]"]
  node_supabase[("Supabase platform")]
  node_hitpay["HitPay payments"]
end

node_users(("Campus users"))

node_users -->|"use"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"protects routes"| node_guard
node_app -->|"routes to"| node_venues
node_app -->|"routes to"| node_availability
node_app -->|"routes to"| node_bookingrequest
node_app -->|"routes to"| node_confirmation
node_app -->|"routes to"| node_clubapproval
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_pending
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_allbookings
node_authui -->|"authenticates with"| node_supabaseclient
node_profile -->|"uses"| node_supabaseclient
node_venues -.->|"fetches venue data"| node_venueapi
node_availability -->|"loads venue data"| node_venueapi
node_bookingrequest -.->|"uses"| node_supabaseclient
node_bookingrequest -.->|"submits request"| node_bookingapi
node_adminui -.->|"requests booking data"| node_bookingapi
node_pending -.->|"manages requests"| node_bookingapi
node_calendar -.->|"loads bookings"| node_bookingapi
node_allbookings -.->|"loads bookings"| node_bookingapi
node_calendar -->|"uses calculations"| node_calendarlogic
node_allbookings -->|"uses calculations"| node_calendarlogic
node_backend -->|"mounts routes"| node_bookingapi
node_backend -->|"mounts routes"| node_venuebackend
node_backend -->|"mounts routes"| node_ocr
node_bookingapi -->|"checks admin access"| node_adminauth
node_bookingapi -.->|"reads and writes"| node_supabase
node_adminauth -->|"verifies user and role"| node_supabase
node_venueapi -.->|"calls API"| node_backend
node_users -.->|"pays online"| node_hitpay
node_campusclubs -.->|"organizes events"| node_users
node_users -.->|"requests suggestions"| node_recommendations
node_adminui -.->|"views reports"| node_reports
node_supabaseclient -->|"connects to"| node_supabase

click node_app "https://github.com/yj87/subook/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/yj87/subook/blob/main/frontend/src/pages/AuthCallback.jsx"
click node_guard "https://github.com/yj87/subook/blob/main/frontend/src/components/ProtectedRoute.jsx"
click node_profile "https://github.com/yj87/subook/blob/main/frontend/src/components/ProfileModal.jsx"
click node_supabaseclient "https://github.com/yj87/subook/blob/main/frontend/src/supabaseClient.js"
click node_venues "https://github.com/yj87/subook/blob/main/frontend/src/pages/VenueCatalogue.jsx"
click node_venueapi "https://github.com/yj87/subook/blob/main/frontend/src/config/api.js"
click node_availability "https://github.com/yj87/subook/blob/main/frontend/src/pages/AvailabilityPlaceholder.jsx"
click node_bookingrequest "https://github.com/yj87/subook/blob/main/frontend/src/pages/BookingRequestPlaceholder.jsx"
click node_confirmation "https://github.com/yj87/subook/blob/main/frontend/src/pages/BookingConfirmationPage.jsx"
click node_clubapproval "https://github.com/yj87/subook/blob/main/frontend/src/pages/ClubBookingApproval.jsx"
click node_calendarlogic "https://github.com/yj87/subook/blob/main/frontend/src/utils/bookingCalendar.js"
click node_adminui "https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPDashboard.jsx"
click node_pending "https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPPendingRequests.jsx"
click node_calendar "https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPCalendarPage.jsx"
click node_allbookings "https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPAllBookingsPage.jsx"
click node_backend "https://github.com/yj87/subook/blob/main/backend/index.js"
click node_bookingapi "https://github.com/yj87/subook/blob/main/backend/routes/bookings.js"
click node_venuebackend "https://github.com/yj87/subook/blob/main/backend/routes/venues.js"
click node_ocr "https://github.com/yj87/subook/blob/main/backend/routes/ocr.js"
click node_adminauth "https://github.com/yj87/subook/blob/main/backend/middleware/auth.js"
click node_campusclubs "https://github.com/yj87/subook/blob/main/frontend/src/pages/ClubDashboard.jsx"

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_authui,node_guard,node_profile,node_users toneBlue
class node_venues,node_venueapi,node_availability,node_bookingrequest,node_confirmation,node_clubapproval,node_campusclubs toneAmber
class node_calendarlogic,node_adminui,node_pending,node_calendar,node_allbookings,node_reports toneMint
class node_backend,node_bookingapi,node_venuebackend,node_ocr,node_adminauth,node_recommendations toneRose
class node_supabaseclient,node_supabase,node_hitpay toneIndigo
```

## Components

### Access and profiles

- [Route application](https://github.com/yj87/subook/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in and callback](https://github.com/yj87/subook/blob/main/frontend/src/pages/AuthCallback.jsx): `frontend/src/pages/AuthCallback.jsx`
- [Role route guard](https://github.com/yj87/subook/blob/main/frontend/src/components/ProtectedRoute.jsx): `frontend/src/components/ProtectedRoute.jsx`
- [Profile management](https://github.com/yj87/subook/blob/main/frontend/src/components/ProfileModal.jsx): `frontend/src/components/ProfileModal.jsx`

### Venue and booking

- [Venue catalogue and details](https://github.com/yj87/subook/blob/main/frontend/src/pages/VenueCatalogue.jsx): `frontend/src/pages/VenueCatalogue.jsx`
- [Venue API client](https://github.com/yj87/subook/blob/main/frontend/src/config/api.js): `frontend/src/config/api.js`
- [Availability selection](https://github.com/yj87/subook/blob/main/frontend/src/pages/AvailabilityPlaceholder.jsx): `frontend/src/pages/AvailabilityPlaceholder.jsx`
- [Booking request](https://github.com/yj87/subook/blob/main/frontend/src/pages/BookingRequestPlaceholder.jsx): `frontend/src/pages/BookingRequestPlaceholder.jsx`
- [Booking confirmation](https://github.com/yj87/subook/blob/main/frontend/src/pages/BookingConfirmationPage.jsx): `frontend/src/pages/BookingConfirmationPage.jsx`
- [Club booking approval](https://github.com/yj87/subook/blob/main/frontend/src/pages/ClubBookingApproval.jsx): `frontend/src/pages/ClubBookingApproval.jsx`
- [Club event management](https://github.com/yj87/subook/blob/main/frontend/src/pages/ClubDashboard.jsx): `frontend/src/pages/ClubDashboard.jsx`

### MPP operations

- [Calendar calculations](https://github.com/yj87/subook/blob/main/frontend/src/utils/bookingCalendar.js): `frontend/src/utils/bookingCalendar.js`
- [MPP dashboard](https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPDashboard.jsx): `frontend/src/pages/MPPDashboard.jsx`
- [Pending requests](https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPPendingRequests.jsx): `frontend/src/pages/MPPPendingRequests.jsx`
- [Booking calendar](https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPCalendarPage.jsx): `frontend/src/pages/MPPCalendarPage.jsx`
- [All bookings](https://github.com/yj87/subook/blob/main/frontend/src/pages/MPPAllBookingsPage.jsx): `frontend/src/pages/MPPAllBookingsPage.jsx`
- **Reports and analytics**

### Backend services

- [HTTP API server](https://github.com/yj87/subook/blob/main/backend/index.js): `backend/index.js`
- [Booking routes](https://github.com/yj87/subook/blob/main/backend/routes/bookings.js): `backend/routes/bookings.js`
- [Venue routes](https://github.com/yj87/subook/blob/main/backend/routes/venues.js): `backend/routes/venues.js`
- [OCR endpoint](https://github.com/yj87/subook/blob/main/backend/routes/ocr.js): `backend/routes/ocr.js`
- [MPP authorization](https://github.com/yj87/subook/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- **Recommendation chatbot**

### External services

- [Supabase client](https://github.com/yj87/subook/blob/main/frontend/src/supabaseClient.js): `frontend/src/supabaseClient.js`
- **Supabase platform**
- **HitPay payments**

### Other components

- **Campus users**

## Connections

- Campus users → Route application: use
- Route application → Sign-in and callback: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Role route guard: protects routes (evidence: `frontend/src/App.jsx`)
- Route application → Venue catalogue and details: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Availability selection: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Booking request: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Booking confirmation: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Club booking approval: routes to (evidence: `frontend/src/App.jsx`)
- Route application → MPP dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Pending requests: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Booking calendar: routes to (evidence: `frontend/src/App.jsx`)
- Route application → All bookings: routes to (evidence: `frontend/src/App.jsx`)
- Sign-in and callback → Supabase client: authenticates with (evidence: `frontend/src/pages/AuthCallback.jsx`)
- Profile management → Supabase client: uses (evidence: `frontend/src/components/ProfileModal.jsx`)
- Venue catalogue and details → Venue API client: fetches venue data
- Availability selection → Venue API client: loads venue data (evidence: `frontend/src/pages/AvailabilityPlaceholder.jsx`)
- Booking request → Supabase client: uses (evidence: `frontend/src/pages/BookingRequestPlaceholder.jsx`)
- Booking request → Booking routes: submits request
- MPP dashboard → Booking routes: requests booking data
- Pending requests → Booking routes: manages requests
- Booking calendar → Booking routes: loads bookings
- All bookings → Booking routes: loads bookings
- Booking calendar → Calendar calculations: uses calculations (evidence: `frontend/src/pages/MPPCalendarPage.jsx`)
- All bookings → Calendar calculations: uses calculations (evidence: `frontend/src/pages/MPPAllBookingsPage.jsx`)
- HTTP API server → Booking routes: mounts routes (evidence: `backend/index.js`)
- HTTP API server → Venue routes: mounts routes (evidence: `backend/index.js`)
- HTTP API server → OCR endpoint: mounts routes (evidence: `backend/index.js`)
- Booking routes → MPP authorization: checks admin access (evidence: `backend/routes/bookings.js`)
- Booking routes → Supabase platform: reads and writes
- MPP authorization → Supabase platform: verifies user and role (evidence: `backend/middleware/auth.js`)
- Venue API client → HTTP API server: calls API
- Campus users → HitPay payments: pays online
- Club event management → Campus users: organizes events
- Campus users → Recommendation chatbot: requests suggestions
- MPP dashboard → Reports and analytics: views reports
- Supabase client → Supabase platform: connects to (evidence: `frontend/src/supabaseClient.js`)
