How ragavu1430/club-management-portal works
AI Frontier Club is a club portal for browsing activities and events, registering for events, and managing club operations. The client routes users to public pages and an admin console; its API adapter supports Supabase-backed operations and a conventional HTTP backend. On the backend, Express routes requests to domain controllers backed by SQLite, with email and Google Sheets integrations. Several client pages and backend controllers are represented at subsystem level where source was not sampled; those relationships are included only when supported by the README or source index.
Main entry points: App.tsx Route application · api.ts API adapter · server.js Express API · db.js SQLite database
Components 27
Portal client
- Route application
client/src/App.tsx - Shared layout
client/src/components/Layout.tsx - Theme state
client/src/context/ThemeContext.tsx - Hero visuals
client/src/components/GlobalVideoBackground.tsx - API adapter
client/src/utils/api.ts - Supabase operations
client/src/services/supabaseService.ts - Supabase config
client/src/config/supabase.ts
Club features
- Events portal
client/src/pages/Events.tsx - Event registration
client/src/components/RegistrationModal.tsx - Admin console
client/src/pages/Admin.tsx - Coordinator directory
client/src/pages/Team.tsx - Club pages
client/src/pages/About.tsx - Games hub
client/src/pages/Games.tsx
API backend
- Express API
server/src/server.js - Authentication
server/src/controllers/auth.js - Event operations
server/src/controllers/events.js - Team operations
server/src/controllers/team.js - Club operations
server/src/controllers/club.js - Game operations
server/src/controllers/games.js - Settings operations
server/src/controllers/settings.js - SQLite database
server/src/config/db.js
External services
- Email delivery
server/src/services/emailService.js - Sheets sync
server/src/services/googleSheets.js - Confirmation endpoint
api/send-confirmation.js
Other components
- Portal user
- Gmail SMTP
- Google Sheets
Connections 38
- Portal user → Route application: opens
client/src/App.tsx - Route application → Shared layout: renders
client/src/App.tsx - Route application → Theme state: provides theme
client/src/App.tsx - Shared layout → Hero visuals: renders
client/src/components/Layout.tsx - Route application → Events portal: routes to
client/src/App.tsx - Route application → Coordinator directory: routes to
client/src/App.tsx - Route application → Club pages: routes to
client/src/App.tsx - Route application → Admin console: routes to
client/src/App.tsx - Route application → Games hub: routes to
client/src/App.tsx - Events portal → Event registration: opens
client/src/pages/Events.tsx - Events portal → API adapter: requests data
client/src/pages/Events.tsx - Event registration → API adapter: submits registration
client/src/components/RegistrationModal.tsx - Admin console → API adapter: manages portal
client/src/pages/Admin.tsx - Coordinator directory → API adapter: requests data
client/src/pages/Team.tsx - Club pages → API adapter: requests data
client/src/pages/About.tsx - Games hub → API adapter: requests data
client/src/pages/Games.tsx - API adapter → Supabase operations: delegates operations
client/src/utils/api.ts - Supabase operations → Supabase config: uses client
client/src/services/supabaseService.ts - API adapter → Express API: HTTP fallback
client/src/utils/api.ts - Express API → Authentication: routes requests
server/src/server.js - Express API → Event operations: routes requests
server/src/server.js - Express API → Team operations: routes requests
server/src/server.js - Express API → Club operations: routes requests
server/src/server.js - Express API → Game operations: routes requests
server/src/server.js - Express API → Settings operations: routes requests
server/src/server.js - Authentication → SQLite database: reads and writes
server/src/controllers/auth.js - Event operations → SQLite database: reads and writes
server/src/controllers/events.js - Team operations → SQLite database: reads and writes
server/src/controllers/team.js - Club operations → SQLite database: reads and writes
server/src/controllers/club.js - Game operations → SQLite database: reads and writes
server/src/controllers/games.js - Settings operations → SQLite database: reads and writes
server/src/controllers/settings.js - Event operations → Email delivery: sends notices
server/src/controllers/events.js - Settings operations → Email delivery: configures email
server/src/controllers/settings.js - Settings operations → Sheets sync: syncs sheets
server/src/controllers/settings.js - Event operations → Sheets sync: syncs event
server/src/controllers/events.js - Email delivery → SQLite database: reads club details
server/src/services/emailService.js - Email delivery → Gmail SMTP: sends mail
- Sheets sync → Google Sheets: syncs data