How sajiv8/p_g20 works
CampusRSO is a multi-tenant campus resource-sharing platform. Users authenticate in the React app, browse campus and peer-owned resources, create bookings or borrow requests, and manage profiles; administrators manage tenants, users, roles, and approvals. The backend separates identity, tenant, catalog, booking/optimization, and notification responsibilities, with shared auth and persistence infrastructure. README capabilities include token-gated student bookings, peer-to-peer lending, optimization, and event-driven in-app/email notifications. Some service-to-service wiring is documented but not shown in sampled source, so those links are dashed.
Main entry points: api.ts API client · App.tsx App routing · src Shared service utilities · routes.ts User and roles
Components 23
Client application
- App routing
frontend/src/App.tsx - Auth experience
frontend/src/contexts/AuthContext.tsx - API client
frontend/src/lib/api.ts - Booking workflow
frontend/src/pages/bookings/NewBookingPage.tsx - Resource catalog UI
frontend/src/pages/resources/ResourceDetailPage.tsx - Peer lending UI
frontend/src/pages/st-resources/STResourceListPage.tsx - Profile management
frontend/src/pages/profile/ProfilePage.tsx - User administration
frontend/src/pages/admin/AdminUsersPage.tsx - Notification center
frontend/src/pages/notifications/NotificationPage.tsx
Identity and tenancy
- Tenant management
backend/services/tenant-service/src/routes.ts - User and roles
backend/services/user-service/src/routes.ts
Campus operations
- Resource catalog
backend/services/resource-service/src/routes.ts - Peer resource sharing
backend/services/resource-service/src/stRoutes.ts - Peer borrowing
backend/services/resource-service/src/stBookingRoutes.ts - Bookings and optimization
backend/services/booking-service/src/routes.ts - Booking rules
backend/services/booking-service/src/booking-rules.ts - Notifications
backend/services/notification-service/src/routes.ts - Email dispatch
backend/services/notification-service/src/mail/mailer.ts
Shared platform
- Shared service utilities
backend/services/shared/src - Firebase Authentication
- Supabase database
- Redis Streams
Other components
- Campus user
Connections 36
- Campus user → App routing: uses
frontend/src/App.tsx - App routing → Auth experience: provides auth
frontend/src/App.tsx - App routing → Booking workflow: routes to
frontend/src/App.tsx - App routing → Resource catalog UI: routes to
frontend/src/App.tsx - App routing → Peer lending UI: routes to
frontend/src/App.tsx - Auth experience → Firebase Authentication: authenticates
frontend/src/contexts/AuthContext.tsx - Auth experience → API client: loads profile
frontend/src/contexts/AuthContext.tsx - Booking workflow → API client: submits requests
frontend/src/pages/bookings/NewBookingPage.tsx - Resource catalog UI → API client: loads resources
frontend/src/pages/resources/ResourceDetailPage.tsx - Peer lending UI → API client: requests data
- Profile management → API client: updates profile
frontend/src/pages/profile/ProfilePage.tsx - Profile management → User administration: not connected
- User administration → API client: manages users
frontend/src/pages/admin/AdminUsersPage.tsx - Notification center → API client: loads notifications
frontend/src/pages/notifications/NotificationPage.tsx - API client → User and roles: calls API
- API client → Bookings and optimization: calls API
- API client → Resource catalog: calls API
- API client → Peer resource sharing: calls API
- API client → Peer borrowing: calls API
- API client → Notifications: calls API
- User and roles → Tenant management: uses tenant data
- User and roles → Shared service utilities: publishes events
backend/services/user-service/src/routes.ts - Bookings and optimization → Booking rules: uses rules
backend/services/booking-service/src/routes.ts - Bookings and optimization → Shared service utilities: publishes events
backend/services/booking-service/src/routes.ts - Notifications → Shared service utilities: consumes events
backend/services/notification-service/src/routes.ts - Notifications → Email dispatch: sends email
backend/services/notification-service/src/routes.ts - Shared service utilities → Redis Streams: streams events
- Shared service utilities → Supabase database: provides database client
- User and roles → Supabase database: reads and writes
- Tenant management → Supabase database: reads and writes
- Resource catalog → Supabase database: reads and writes
- Peer resource sharing → Supabase database: reads and writes
- Peer borrowing → Supabase database: reads and writes
- Bookings and optimization → Supabase database: reads and writes
backend/services/booking-service/src/routes.ts - Notifications → Supabase database: reads and writes
backend/services/notification-service/src/routes.ts - Email dispatch → Campus user: emails