How vipparla-prasanth/kits-eos works
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: src/App.tsx Admin app routing · src/App.tsx Student app routing · context/AuthContext.tsx Student authentication · context/AuthContext.tsx Admin authentication
Components 31
Student portal
- Student app routing
apps/public-student/src/App.tsx - Student authentication
apps/public-student/src/context/AuthContext.tsx - Event discovery
apps/public-student/src/pages/EventDetails.tsx - Event registration
apps/public-student/src/pages/SubEventRegister.tsx - Student records
apps/public-student/src/pages/MyRegistrations.tsx - Certificates and results
apps/public-student/src/pages/StudentCertificates.tsx
Admin and coordination
- Admin app routing
apps/admin-coordinator/src/App.tsx - Admin authentication
apps/admin-coordinator/src/context/AuthContext.tsx - Event administration
apps/admin-coordinator/src/pages/Events/Details.tsx - Registration management
apps/admin-coordinator/src/pages/Registrations/index.tsx - Coordinator operations
apps/admin-coordinator/src/pages/Coordinator/index.tsx - Result management
apps/admin-coordinator/src/pages/Results/index.tsx - Payment access control
apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx - Coordinator sessions
apps/admin-coordinator/src/utils/coordinatorSession.ts
Fallback portal
- Fallback app
apps/fallback/src/App.tsx - Fallback public portal
apps/fallback/src/components/PublicPortal.tsx - Fallback coordinator portal
apps/fallback/src/components/CoordinatorPortal.tsx
Shared browser services
- Session lifecycle
packages/shared/src/utils/sessionLifecycle.ts - Supabase API client
packages/shared/src/api/client.ts - Storage lifecycle helper
packages/shared/src/utils/storageUtils.ts
Backend functions
- Supabase Edge Functions
supabase/functions - Edge function authentication
supabase/functions/_shared/auth.ts - Sub-event updates
supabase/functions/admin-update-sub-event/index.ts - Document access
supabase/functions/admin-download-document/index.ts - Coordinator check-in
supabase/functions/coordinator-checkin/index.ts - Payment confirmation
supabase/functions/coordinator-confirm-payment/index.ts - Student registration endpoint
supabase/functions/student-register/index.ts - Storage cleanup worker
supabase/functions/admin-process-storage-cleanup/index.ts
Other components
- Student
- Administrator or coordinator
- Supabase services
Connections 33
- Student → Student app routing: uses
apps/public-student/src/App.tsx - Student app routing → Student authentication: provides auth
apps/public-student/src/App.tsx - Student app routing → Event discovery: routes to
apps/public-student/src/App.tsx - Student app routing → Event registration: routes to
apps/public-student/src/App.tsx - Student authentication → Session lifecycle: uses lifecycle
apps/public-student/src/context/AuthContext.tsx - Student authentication → Supabase services: checks account
apps/public-student/src/context/AuthContext.tsx - Event registration → Student authentication: uses identity
apps/public-student/src/pages/SubEventRegister.tsx - Student → Student records: views
- Student → Certificates and results: views
- Administrator or coordinator → Admin app routing: uses
apps/admin-coordinator/src/App.tsx - Admin app routing → Admin authentication: provides auth
apps/admin-coordinator/src/App.tsx - Admin app routing → Event administration: routes to
apps/admin-coordinator/src/App.tsx - Admin app routing → Registration management: routes to
apps/admin-coordinator/src/App.tsx - Admin app routing → Coordinator operations: routes to
apps/admin-coordinator/src/App.tsx - Admin app routing → Result management: routes to
apps/admin-coordinator/src/App.tsx - Admin authentication → Session lifecycle: uses lifecycle
apps/admin-coordinator/src/context/AuthContext.tsx - Admin authentication → Supabase API client: invokes functions
apps/admin-coordinator/src/context/AuthContext.tsx - Payment access control → Admin authentication: checks identity
apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx - Payment access control → Coordinator sessions: checks session
apps/admin-coordinator/src/components/PaymentManagerProtectedRoute.tsx - Coordinator sessions → Session lifecycle: uses lifecycle
apps/admin-coordinator/src/utils/coordinatorSession.ts - Registration management → Document access: requests document URL
apps/admin-coordinator/src/pages/Registrations/index.tsx - Supabase API client → Supabase services: creates client
packages/shared/src/api/client.ts - Supabase API client → Supabase Edge Functions: invokes functions
packages/shared/src/api/client.ts - Storage lifecycle helper → Supabase API client: uses client
packages/shared/src/utils/storageUtils.ts - Storage lifecycle helper → Storage cleanup worker: triggers worker
packages/shared/src/utils/storageUtils.ts - Sub-event updates → Edge function authentication: uses auth
supabase/functions/admin-update-sub-event/index.ts - Fallback app → Fallback public portal: selects portal
apps/fallback/src/App.tsx - Fallback app → Fallback coordinator portal: selects portal
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