# vipparla-prasanth/kits-eos architecture

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

- Interactive diagram: https://gitdiagram.com/vipparla-prasanth/kits-eos
- Repository: https://github.com/vipparla-prasanth/kits-eos

## Overview

This repository provides student-facing event and registration services, an administration and coordinator portal, and a lightweight fallback portal, backed by shared browser utilities and Supabase Edge Functions. The primary student journey is to discover events and register; administrators and coordinators manage events, registrations, attendance, payments, and results. The graph captures documented routing and sampled calls; many domain pages and Edge Functions were not excerpted, so uncertain connections are omitted.

Main entry points: [`apps/admin-coordinator/src/App.tsx`](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/App.tsx) (Admin app routing), [`apps/public-student/src/App.tsx`](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/App.tsx) (Student app routing), [`apps/public-student/src/context/AuthContext.tsx`](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/context/AuthContext.tsx) (Student authentication), [`apps/admin-coordinator/src/context/AuthContext.tsx`](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/context/AuthContext.tsx) (Admin authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student portal"]
  node_student_app["Student app routing<br/>[App.tsx]"]
  node_student_auth["Student authentication<br/>[AuthContext.tsx]"]
  node_event_browse["Event discovery<br/>[EventDetails.tsx]"]
  node_registration["Event registration"]
  node_student_records["Student records"]
  node_student_certificates["Certificates and results"]
end

subgraph group_admin["Admin and coordination"]
  node_admin_app["Admin app routing<br/>[App.tsx]"]
  node_admin_auth["Admin authentication<br/>[AuthContext.tsx]"]
  node_event_admin["Event administration<br/>[Details.tsx]"]
  node_registration_admin["Registration management<br/>[index.tsx]"]
  node_coordinator_ops["Coordinator operations<br/>[index.tsx]"]
  node_result_admin["Result management<br/>[index.tsx]"]
  node_payment_access["Payment access control"]
  node_coord_session["Coordinator sessions"]
end

subgraph group_fallback["Fallback portal"]
  node_fallback_app["Fallback app<br/>[App.tsx]"]
  node_fallback_public["Fallback public portal<br/>[PublicPortal.tsx]"]
  node_fallback_coord["Fallback coordinator portal"]
end

subgraph group_shared["Shared browser services"]
  node_shared_auth["Session lifecycle"]
  node_api_client["Supabase API client<br/>[client.ts]"]
  node_storage_utils["Storage lifecycle helper<br/>[storageUtils.ts]"]
end

subgraph group_backend["Backend functions"]
  node_edge_functions["Supabase Edge Functions"]
  node_edge_auth["Edge function authentication<br/>[auth.ts]"]
  node_edge_event_update["Sub-event updates<br/>[index.ts]"]
  node_edge_doc_download["Document access<br/>[index.ts]"]
  node_edge_coordinator["Coordinator check-in<br/>[index.ts]"]
  node_edge_payment["Payment confirmation<br/>[index.ts]"]
  node_edge_student_register["Student registration endpoint<br/>[index.ts]"]
  node_edge_storage_cleanup["Storage cleanup worker<br/>[index.ts]"]
end

node_student_user(("Student"))
node_admin_user(("Administrator or coordinator"))
node_supabase[("Supabase services")]

node_student_user -->|"uses"| node_student_app
node_student_app -->|"provides auth"| node_student_auth
node_student_app -->|"routes to"| node_event_browse
node_student_app -->|"routes to"| node_registration
node_student_auth -->|"uses lifecycle"| node_shared_auth
node_student_auth -->|"checks account"| node_supabase
node_registration -->|"uses identity"| node_student_auth
node_student_user -.->|"views"| node_student_records
node_student_user -.->|"views"| node_student_certificates
node_admin_user -->|"uses"| node_admin_app
node_admin_app -->|"provides auth"| node_admin_auth
node_admin_app -->|"routes to"| node_event_admin
node_admin_app -->|"routes to"| node_registration_admin
node_admin_app -->|"routes to"| node_coordinator_ops
node_admin_app -->|"routes to"| node_result_admin
node_admin_auth -->|"uses lifecycle"| node_shared_auth
node_admin_auth -->|"invokes functions"| node_api_client
node_payment_access -->|"checks identity"| node_admin_auth
node_payment_access -->|"checks session"| node_coord_session
node_coord_session -->|"uses lifecycle"| node_shared_auth
node_registration_admin -->|"requests document URL"| node_edge_doc_download
node_api_client -->|"creates client"| node_supabase
node_api_client -->|"invokes functions"| node_edge_functions
node_storage_utils -->|"uses client"| node_api_client
node_storage_utils -->|"triggers worker"| node_edge_storage_cleanup
node_edge_event_update -->|"uses auth"| node_edge_auth
node_fallback_app -->|"selects portal"| node_fallback_public
node_fallback_app -->|"selects portal"| node_fallback_coord
node_fallback_public -.->|"uses backend"| node_supabase
node_fallback_coord -.->|"uses backend"| node_supabase
node_registration -.->|"submits registration"| node_edge_student_register
node_coordinator_ops -.->|"performs check-in"| node_edge_coordinator
node_coordinator_ops -.->|"confirms payment"| node_edge_payment

click node_student_app "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/App.tsx"
click node_student_auth "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/context/AuthContext.tsx"
click node_event_browse "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/EventDetails.tsx"
click node_registration "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/SubEventRegister.tsx"
click node_student_records "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/MyRegistrations.tsx"
click node_student_certificates "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/StudentCertificates.tsx"
click node_admin_app "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/App.tsx"
click node_admin_auth "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/context/AuthContext.tsx"
click node_event_admin "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Events/Details.tsx"
click node_registration_admin "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Registrations/index.tsx"
click node_coordinator_ops "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Coordinator/index.tsx"
click node_result_admin "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Results/index.tsx"
click node_payment_access "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx"
click node_coord_session "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/utils/coordinatorSession.ts"
click node_fallback_app "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/App.tsx"
click node_fallback_public "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/components/PublicPortal.tsx"
click node_fallback_coord "https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/components/CoordinatorPortal.tsx"
click node_shared_auth "https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/utils/sessionLifecycle.ts"
click node_api_client "https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/api/client.ts"
click node_storage_utils "https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/utils/storageUtils.ts"
click node_edge_functions "https://github.com/vipparla-prasanth/kits-eos/tree/main/supabase/functions"
click node_edge_auth "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/_shared/auth.ts"
click node_edge_event_update "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-update-sub-event/index.ts"
click node_edge_doc_download "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-download-document/index.ts"
click node_edge_coordinator "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/coordinator-checkin/index.ts"
click node_edge_payment "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/coordinator-confirm-payment/index.ts"
click node_edge_student_register "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/student-register/index.ts"
click node_edge_storage_cleanup "https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-process-storage-cleanup/index.ts"

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_student_app,node_student_auth,node_event_browse,node_registration,node_student_records,node_student_certificates toneBlue
class node_admin_app,node_admin_auth,node_event_admin,node_registration_admin,node_coordinator_ops,node_result_admin,node_payment_access,node_coord_session,node_supabase toneAmber
class node_fallback_app,node_fallback_public,node_fallback_coord toneMint
class node_shared_auth,node_api_client,node_storage_utils toneRose
class node_edge_functions,node_edge_auth,node_edge_event_update,node_edge_doc_download,node_edge_coordinator,node_edge_payment,node_edge_student_register,node_edge_storage_cleanup,node_student_user,node_admin_user toneIndigo
```

## Components

### Student portal

- [Student app routing](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/App.tsx): `apps/public-student/src/App.tsx`
- [Student authentication](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/context/AuthContext.tsx): `apps/public-student/src/context/AuthContext.tsx`
- [Event discovery](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/EventDetails.tsx): `apps/public-student/src/pages/EventDetails.tsx`
- [Event registration](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/SubEventRegister.tsx): `apps/public-student/src/pages/SubEventRegister.tsx`
- [Student records](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/MyRegistrations.tsx): `apps/public-student/src/pages/MyRegistrations.tsx`
- [Certificates and results](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/public-student/src/pages/StudentCertificates.tsx): `apps/public-student/src/pages/StudentCertificates.tsx`

### Admin and coordination

- [Admin app routing](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/App.tsx): `apps/admin-coordinator/src/App.tsx`
- [Admin authentication](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/context/AuthContext.tsx): `apps/admin-coordinator/src/context/AuthContext.tsx`
- [Event administration](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Events/Details.tsx): `apps/admin-coordinator/src/pages/Events/Details.tsx`
- [Registration management](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Registrations/index.tsx): `apps/admin-coordinator/src/pages/Registrations/index.tsx`
- [Coordinator operations](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Coordinator/index.tsx): `apps/admin-coordinator/src/pages/Coordinator/index.tsx`
- [Result management](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/pages/Results/index.tsx): `apps/admin-coordinator/src/pages/Results/index.tsx`
- [Payment access control](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx): `apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx`
- [Coordinator sessions](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/admin-coordinator/src/utils/coordinatorSession.ts): `apps/admin-coordinator/src/utils/coordinatorSession.ts`

### Fallback portal

- [Fallback app](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/App.tsx): `apps/fallback/src/App.tsx`
- [Fallback public portal](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/components/PublicPortal.tsx): `apps/fallback/src/components/PublicPortal.tsx`
- [Fallback coordinator portal](https://github.com/vipparla-prasanth/kits-eos/blob/main/apps/fallback/src/components/CoordinatorPortal.tsx): `apps/fallback/src/components/CoordinatorPortal.tsx`

### Shared browser services

- [Session lifecycle](https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/utils/sessionLifecycle.ts): `packages/shared/src/utils/sessionLifecycle.ts`
- [Supabase API client](https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/api/client.ts): `packages/shared/src/api/client.ts`
- [Storage lifecycle helper](https://github.com/vipparla-prasanth/kits-eos/blob/main/packages/shared/src/utils/storageUtils.ts): `packages/shared/src/utils/storageUtils.ts`

### Backend functions

- [Supabase Edge Functions](https://github.com/vipparla-prasanth/kits-eos/tree/main/supabase/functions): `supabase/functions`
- [Edge function authentication](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/_shared/auth.ts): `supabase/functions/_shared/auth.ts`
- [Sub-event updates](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-update-sub-event/index.ts): `supabase/functions/admin-update-sub-event/index.ts`
- [Document access](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-download-document/index.ts): `supabase/functions/admin-download-document/index.ts`
- [Coordinator check-in](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/coordinator-checkin/index.ts): `supabase/functions/coordinator-checkin/index.ts`
- [Payment confirmation](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/coordinator-confirm-payment/index.ts): `supabase/functions/coordinator-confirm-payment/index.ts`
- [Student registration endpoint](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/student-register/index.ts): `supabase/functions/student-register/index.ts`
- [Storage cleanup worker](https://github.com/vipparla-prasanth/kits-eos/blob/main/supabase/functions/admin-process-storage-cleanup/index.ts): `supabase/functions/admin-process-storage-cleanup/index.ts`

### Other components

- **Student**
- **Administrator or coordinator**
- **Supabase services**

## Connections

- Student → Student app routing: uses (evidence: `apps/public-student/src/App.tsx`)
- Student app routing → Student authentication: provides auth (evidence: `apps/public-student/src/App.tsx`)
- Student app routing → Event discovery: routes to (evidence: `apps/public-student/src/App.tsx`)
- Student app routing → Event registration: routes to (evidence: `apps/public-student/src/App.tsx`)
- Student authentication → Session lifecycle: uses lifecycle (evidence: `apps/public-student/src/context/AuthContext.tsx`)
- Student authentication → Supabase services: checks account (evidence: `apps/public-student/src/context/AuthContext.tsx`)
- Event registration → Student authentication: uses identity (evidence: `apps/public-student/src/pages/SubEventRegister.tsx`)
- Student → Student records: views
- Student → Certificates and results: views
- Administrator or coordinator → Admin app routing: uses (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin app routing → Admin authentication: provides auth (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin app routing → Event administration: routes to (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin app routing → Registration management: routes to (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin app routing → Coordinator operations: routes to (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin app routing → Result management: routes to (evidence: `apps/admin-coordinator/src/App.tsx`)
- Admin authentication → Session lifecycle: uses lifecycle (evidence: `apps/admin-coordinator/src/context/AuthContext.tsx`)
- Admin authentication → Supabase API client: invokes functions (evidence: `apps/admin-coordinator/src/context/AuthContext.tsx`)
- Payment access control → Admin authentication: checks identity (evidence: `apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx`)
- Payment access control → Coordinator sessions: checks session (evidence: `apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx`)
- Coordinator sessions → Session lifecycle: uses lifecycle (evidence: `apps/admin-coordinator/src/utils/coordinatorSession.ts`)
- Registration management → Document access: requests document URL (evidence: `apps/admin-coordinator/src/pages/Registrations/index.tsx`)
- Supabase API client → Supabase services: creates client (evidence: `packages/shared/src/api/client.ts`)
- Supabase API client → Supabase Edge Functions: invokes functions (evidence: `packages/shared/src/api/client.ts`)
- Storage lifecycle helper → Supabase API client: uses client (evidence: `packages/shared/src/utils/storageUtils.ts`)
- Storage lifecycle helper → Storage cleanup worker: triggers worker (evidence: `packages/shared/src/utils/storageUtils.ts`)
- Sub-event updates → Edge function authentication: uses auth (evidence: `supabase/functions/admin-update-sub-event/index.ts`)
- Fallback app → Fallback public portal: selects portal (evidence: `apps/fallback/src/App.tsx`)
- Fallback app → Fallback coordinator portal: selects portal (evidence: `apps/fallback/src/App.tsx`)
- Fallback public portal → Supabase services: uses backend
- Fallback coordinator portal → Supabase services: uses backend
- Event registration → Student registration endpoint: submits registration
- Coordinator operations → Coordinator check-in: performs check-in
- Coordinator operations → Payment confirmation: confirms payment
