# sajiv8/p_g20 architecture

> Architecture diagram of the GitHub repository sajiv8/p_g20, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sajiv8/p_g20
- Repository: https://github.com/sajiv8/p_g20

## Overview

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: [`frontend/src/lib/api.ts`](https://github.com/sajiv8/p_g20/blob/main/frontend/src/lib/api.ts) (API client), [`frontend/src/App.tsx`](https://github.com/sajiv8/p_g20/blob/main/frontend/src/App.tsx) (App routing), [`backend/services/shared/src`](https://github.com/sajiv8/p_g20/tree/main/backend/services/shared/src) (Shared service utilities), [`backend/services/user-service/src/routes.ts`](https://github.com/sajiv8/p_g20/blob/main/backend/services/user-service/src/routes.ts) (User and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["App routing<br/>[App.tsx]"]
  node_authui["Auth experience<br/>[AuthContext.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_bookingui["Booking workflow<br/>[NewBookingPage.tsx]"]
  node_resourceui["Resource catalog UI"]
  node_peerui["Peer lending UI"]
  node_profileui["Profile management<br/>[ProfilePage.tsx]"]
  node_adminui["User administration<br/>[AdminUsersPage.tsx]"]
  node_noticeui["Notification center"]
end

subgraph group_identity["Identity and tenancy"]
  node_tenant["Tenant management<br/>[routes.ts]"]
  node_users["User and roles<br/>[routes.ts]"]
end

subgraph group_campus["Campus operations"]
  node_resources["Resource catalog<br/>[routes.ts]"]
  node_peerresources["Peer resource sharing<br/>[stRoutes.ts]"]
  node_peerborrow["Peer borrowing<br/>[stBookingRoutes.ts]"]
  node_bookings["Bookings and optimization<br/>[routes.ts]"]
  node_bookingrules["Booking rules<br/>[booking-rules.ts]"]
  node_notifications["Notifications<br/>[routes.ts]"]
  node_mailer["Email dispatch<br/>[mailer.ts]"]
end

subgraph group_platform["Shared platform"]
  node_shared["Shared service utilities"]
  node_auth["Firebase Authentication"]
  node_db[("Supabase database")]
  node_redis["Redis Streams"]
end

node_user(("Campus user"))

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_bookingui
node_app -->|"routes to"| node_resourceui
node_app -->|"routes to"| node_peerui
node_authui -->|"authenticates"| node_auth
node_authui -->|"loads profile"| node_api
node_bookingui -->|"submits requests"| node_api
node_resourceui -->|"loads resources"| node_api
node_peerui -->|"requests data"| node_api
node_profileui -->|"updates profile"| node_api
node_profileui -.->|"not connected"| node_adminui
node_adminui -->|"manages users"| node_api
node_noticeui -->|"loads notifications"| node_api
node_api -.->|"calls API"| node_users
node_api -.->|"calls API"| node_bookings
node_api -.->|"calls API"| node_resources
node_api -.->|"calls API"| node_peerresources
node_api -.->|"calls API"| node_peerborrow
node_api -.->|"calls API"| node_notifications
node_users -.->|"uses tenant data"| node_tenant
node_users -->|"publishes events"| node_shared
node_bookings -->|"uses rules"| node_bookingrules
node_bookings -->|"publishes events"| node_shared
node_notifications -->|"consumes events"| node_shared
node_notifications -->|"sends email"| node_mailer
node_shared -.->|"streams events"| node_redis
node_shared -.->|"provides database client"| node_db
node_users -.->|"reads and writes"| node_db
node_tenant -.->|"reads and writes"| node_db
node_resources -.->|"reads and writes"| node_db
node_peerresources -.->|"reads and writes"| node_db
node_peerborrow -.->|"reads and writes"| node_db
node_bookings -.->|"reads and writes"| node_db
node_notifications -->|"reads and writes"| node_db
node_mailer -.->|"emails"| node_user

click node_app "https://github.com/sajiv8/p_g20/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_api "https://github.com/sajiv8/p_g20/blob/main/frontend/src/lib/api.ts"
click node_bookingui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/bookings/NewBookingPage.tsx"
click node_resourceui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/resources/ResourceDetailPage.tsx"
click node_peerui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/st-resources/STResourceListPage.tsx"
click node_profileui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/profile/ProfilePage.tsx"
click node_adminui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/admin/AdminUsersPage.tsx"
click node_noticeui "https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/notifications/NotificationPage.tsx"
click node_tenant "https://github.com/sajiv8/p_g20/blob/main/backend/services/tenant-service/src/routes.ts"
click node_users "https://github.com/sajiv8/p_g20/blob/main/backend/services/user-service/src/routes.ts"
click node_resources "https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/routes.ts"
click node_peerresources "https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/stRoutes.ts"
click node_peerborrow "https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/stBookingRoutes.ts"
click node_bookings "https://github.com/sajiv8/p_g20/blob/main/backend/services/booking-service/src/routes.ts"
click node_bookingrules "https://github.com/sajiv8/p_g20/blob/main/backend/services/booking-service/src/booking-rules.ts"
click node_notifications "https://github.com/sajiv8/p_g20/blob/main/backend/services/notification-service/src/routes.ts"
click node_mailer "https://github.com/sajiv8/p_g20/blob/main/backend/services/notification-service/src/mail/mailer.ts"
click node_shared "https://github.com/sajiv8/p_g20/tree/main/backend/services/shared/src"

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_api,node_bookingui,node_resourceui,node_peerui,node_profileui,node_adminui,node_noticeui,node_user toneBlue
class node_tenant,node_users toneAmber
class node_resources,node_peerresources,node_peerborrow,node_bookings,node_bookingrules,node_notifications,node_mailer toneMint
class node_shared,node_auth,node_db,node_redis toneRose
```

## Components

### Client application

- [App routing](https://github.com/sajiv8/p_g20/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth experience](https://github.com/sajiv8/p_g20/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [API client](https://github.com/sajiv8/p_g20/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Booking workflow](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/bookings/NewBookingPage.tsx): `frontend/src/pages/bookings/NewBookingPage.tsx`
- [Resource catalog UI](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/resources/ResourceDetailPage.tsx): `frontend/src/pages/resources/ResourceDetailPage.tsx`
- [Peer lending UI](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/st-resources/STResourceListPage.tsx): `frontend/src/pages/st-resources/STResourceListPage.tsx`
- [Profile management](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/profile/ProfilePage.tsx): `frontend/src/pages/profile/ProfilePage.tsx`
- [User administration](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/admin/AdminUsersPage.tsx): `frontend/src/pages/admin/AdminUsersPage.tsx`
- [Notification center](https://github.com/sajiv8/p_g20/blob/main/frontend/src/pages/notifications/NotificationPage.tsx): `frontend/src/pages/notifications/NotificationPage.tsx`

### Identity and tenancy

- [Tenant management](https://github.com/sajiv8/p_g20/blob/main/backend/services/tenant-service/src/routes.ts): `backend/services/tenant-service/src/routes.ts`
- [User and roles](https://github.com/sajiv8/p_g20/blob/main/backend/services/user-service/src/routes.ts): `backend/services/user-service/src/routes.ts`

### Campus operations

- [Resource catalog](https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/routes.ts): `backend/services/resource-service/src/routes.ts`
- [Peer resource sharing](https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/stRoutes.ts): `backend/services/resource-service/src/stRoutes.ts`
- [Peer borrowing](https://github.com/sajiv8/p_g20/blob/main/backend/services/resource-service/src/stBookingRoutes.ts): `backend/services/resource-service/src/stBookingRoutes.ts`
- [Bookings and optimization](https://github.com/sajiv8/p_g20/blob/main/backend/services/booking-service/src/routes.ts): `backend/services/booking-service/src/routes.ts`
- [Booking rules](https://github.com/sajiv8/p_g20/blob/main/backend/services/booking-service/src/booking-rules.ts): `backend/services/booking-service/src/booking-rules.ts`
- [Notifications](https://github.com/sajiv8/p_g20/blob/main/backend/services/notification-service/src/routes.ts): `backend/services/notification-service/src/routes.ts`
- [Email dispatch](https://github.com/sajiv8/p_g20/blob/main/backend/services/notification-service/src/mail/mailer.ts): `backend/services/notification-service/src/mail/mailer.ts`

### Shared platform

- [Shared service utilities](https://github.com/sajiv8/p_g20/tree/main/backend/services/shared/src): `backend/services/shared/src`
- **Firebase Authentication**
- **Supabase database**
- **Redis Streams**

### Other components

- **Campus user**

## Connections

- Campus user → App routing: uses (evidence: `frontend/src/App.tsx`)
- App routing → Auth experience: provides auth (evidence: `frontend/src/App.tsx`)
- App routing → Booking workflow: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Resource catalog UI: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Peer lending UI: routes to (evidence: `frontend/src/App.tsx`)
- Auth experience → Firebase Authentication: authenticates (evidence: `frontend/src/contexts/AuthContext.tsx`)
- Auth experience → API client: loads profile (evidence: `frontend/src/contexts/AuthContext.tsx`)
- Booking workflow → API client: submits requests (evidence: `frontend/src/pages/bookings/NewBookingPage.tsx`)
- Resource catalog UI → API client: loads resources (evidence: `frontend/src/pages/resources/ResourceDetailPage.tsx`)
- Peer lending UI → API client: requests data
- Profile management → API client: updates profile (evidence: `frontend/src/pages/profile/ProfilePage.tsx`)
- Profile management → User administration: not connected
- User administration → API client: manages users (evidence: `frontend/src/pages/admin/AdminUsersPage.tsx`)
- Notification center → API client: loads notifications (evidence: `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 (evidence: `backend/services/user-service/src/routes.ts`)
- Bookings and optimization → Booking rules: uses rules (evidence: `backend/services/booking-service/src/routes.ts`)
- Bookings and optimization → Shared service utilities: publishes events (evidence: `backend/services/booking-service/src/routes.ts`)
- Notifications → Shared service utilities: consumes events (evidence: `backend/services/notification-service/src/routes.ts`)
- Notifications → Email dispatch: sends email (evidence: `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 (evidence: `backend/services/booking-service/src/routes.ts`)
- Notifications → Supabase database: reads and writes (evidence: `backend/services/notification-service/src/routes.ts`)
- Email dispatch → Campus user: emails
