How yj87/subook works
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: App.jsx Route application · bookings.js Booking routes · index.js HTTP API server · supabaseClient.js Supabase client
Components 27
Access and profiles
- Route application
frontend/src/App.jsx - Sign-in and callback
frontend/src/pages/AuthCallback.jsx - Role route guard
frontend/src/components/ProtectedRoute.jsx - Profile management
frontend/src/components/ProfileModal.jsx
Venue and booking
- Venue catalogue and details
frontend/src/pages/VenueCatalogue.jsx - Venue API client
frontend/src/config/api.js - Availability selection
frontend/src/pages/AvailabilityPlaceholder.jsx - Booking request
frontend/src/pages/BookingRequestPlaceholder.jsx - Booking confirmation
frontend/src/pages/BookingConfirmationPage.jsx - Club booking approval
frontend/src/pages/ClubBookingApproval.jsx - Club event management
frontend/src/pages/ClubDashboard.jsx
MPP operations
- Calendar calculations
frontend/src/utils/bookingCalendar.js - MPP dashboard
frontend/src/pages/MPPDashboard.jsx - Pending requests
frontend/src/pages/MPPPendingRequests.jsx - Booking calendar
frontend/src/pages/MPPCalendarPage.jsx - All bookings
frontend/src/pages/MPPAllBookingsPage.jsx - Reports and analytics
Backend services
- HTTP API server
backend/index.js - Booking routes
backend/routes/bookings.js - Venue routes
backend/routes/venues.js - OCR endpoint
backend/routes/ocr.js - MPP authorization
backend/middleware/auth.js - Recommendation chatbot
External services
- Supabase client
frontend/src/supabaseClient.js - Supabase platform
- HitPay payments
Other components
- Campus users
Connections 36
- Campus users → Route application: use
- Route application → Sign-in and callback: routes to
frontend/src/App.jsx - Route application → Role route guard: protects routes
frontend/src/App.jsx - Route application → Venue catalogue and details: routes to
frontend/src/App.jsx - Route application → Availability selection: routes to
frontend/src/App.jsx - Route application → Booking request: routes to
frontend/src/App.jsx - Route application → Booking confirmation: routes to
frontend/src/App.jsx - Route application → Club booking approval: routes to
frontend/src/App.jsx - Route application → MPP dashboard: routes to
frontend/src/App.jsx - Route application → Pending requests: routes to
frontend/src/App.jsx - Route application → Booking calendar: routes to
frontend/src/App.jsx - Route application → All bookings: routes to
frontend/src/App.jsx - Sign-in and callback → Supabase client: authenticates with
frontend/src/pages/AuthCallback.jsx - Profile management → Supabase client: uses
frontend/src/components/ProfileModal.jsx - Venue catalogue and details → Venue API client: fetches venue data
- Availability selection → Venue API client: loads venue data
frontend/src/pages/AvailabilityPlaceholder.jsx - Booking request → Supabase client: uses
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
frontend/src/pages/MPPCalendarPage.jsx - All bookings → Calendar calculations: uses calculations
frontend/src/pages/MPPAllBookingsPage.jsx - HTTP API server → Booking routes: mounts routes
backend/index.js - HTTP API server → Venue routes: mounts routes
backend/index.js - HTTP API server → OCR endpoint: mounts routes
backend/index.js - Booking routes → MPP authorization: checks admin access
backend/routes/bookings.js - Booking routes → Supabase platform: reads and writes
- MPP authorization → Supabase platform: verifies user and role
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
frontend/src/supabaseClient.js