How cognisphere-aiml-club/club_cognisphere works
This is a club-games event management web app. Participants sign in, complete a profile, browse activities, register or request passes, and use a participant pass for attendance; coordinators administer events, attendance, scores, timers, and announcements. The app also provides leaderboards, certificates, a big-screen display, and Google Sheets synchronization. Firebase/Firestore is the shared backend. Connections reflect the supplied source index and excerpts; several listed capabilities are unsampled, so their internal wiring is not inferred.
Main entry points: App.jsx App shell · passApprovalService.js Pass approvals · BigScreenView.jsx Big-screen display · RegistrationsHub.jsx Registration oversight
Components 27
Access and profiles
- Sign-in and roles
src/contexts/AuthContext.jsx - Participant profile
src/hooks/useParticipantProfile.js - Profile management
src/components/ProfileEditPage.jsx
Activities and participation
- Activity catalog
src/data/activities.js - Game guides
src/data/gameGuides.js - Activity updates
src/hooks/useActivities.js - Event landing
src/components/EventLandingPage.jsx - Game details
src/components/GameDetailPage.jsx - Registration
src/components/RegistrationModal.jsx - Participant pass
src/components/ParticipantPass.jsx
Event operations
- Attendance scanner
src/components/CoordinatorScanner.jsx - Attendance records
src/services/attendanceService.js - Pass approvals
src/services/passApprovalService.js - Registration oversight
src/components/RegistrationsHub.jsx - Scoring service
src/services/scoreService.js - Leaderboard
src/components/LeaderboardPage.jsx - Shared timers
src/hooks/useSharedTimer.js - Big-screen display
src/components/BigScreenView.jsx - Announcement feed
src/hooks/useAnnouncements.js - Certificates
src/components/CertificatesView.jsx - Sheet batch sync
src/services/sheetsBatchSyncService.js - Google Sheets sync
src/services/googleSheetsService.js
Shared platform
- App shell
src/App.jsx - Firebase setup
src/firebase.js - Firestore
Other components
- Participant
- Coordinator
Connections 41
- Participant → App shell: uses
src/App.jsx - Coordinator → App shell: uses
src/App.jsx - App shell → Sign-in and roles: reads auth state
src/App.jsx - App shell → Participant profile: loads profile
src/App.jsx - App shell → Activity updates: loads activities
src/App.jsx - App shell → Registration: opens
src/App.jsx - App shell → Participant pass: shows
src/App.jsx - App shell → Attendance scanner: routes to
src/App.jsx - App shell → Event landing: routes to
src/App.jsx - App shell → Game details: routes to
src/App.jsx - App shell → Registration oversight: routes to
src/App.jsx - App shell → Shared timers: routes to
src/App.jsx - App shell → Big-screen display: routes to
src/App.jsx - App shell → Certificates: routes to
src/App.jsx - App shell → Profile management: routes to
src/App.jsx - Profile management → Participant profile: uses
src/components/ProfileEditPage.jsx - Activity updates → Activity catalog: falls back to
src/hooks/useActivities.js - Activity catalog → Game guides: uses guide data
src/data/activities.js - Event landing → Pass approvals: uses
src/components/EventLandingPage.jsx - Game details → Pass approvals: uses
src/components/GameDetailPage.jsx - Participant pass → Pass approvals: uses
src/components/ParticipantPass.jsx - Participant pass → Attendance records: checks attendance
src/components/ParticipantPass.jsx - Attendance scanner → Attendance records: records attendance
src/components/CoordinatorScanner.jsx - Registration oversight → Pass approvals: uses
src/components/RegistrationsHub.jsx - Registration oversight → Attendance records: uses
src/components/RegistrationsHub.jsx - Registration oversight → Sheet batch sync: syncs batches
src/components/RegistrationsHub.jsx - Leaderboard → Scoring service: loads scores
src/components/LeaderboardPage.jsx - Big-screen display → Scoring service: uses
src/components/BigScreenView.jsx - Big-screen display → Pass approvals: uses
src/components/BigScreenView.jsx - Big-screen display → Shared timers: uses
src/components/BigScreenView.jsx - Big-screen display → Announcement feed: uses
src/components/BigScreenView.jsx - Certificates → Activity catalog: uses
src/components/CertificatesView.jsx - Sheet batch sync → Google Sheets sync: delegates to
src/services/sheetsBatchSyncService.js - Sign-in and roles → Firebase setup: uses
src/contexts/AuthContext.jsx - Participant profile → Firebase setup: uses
src/hooks/useParticipantProfile.js - Firebase setup → Firestore: initializes
src/firebase.js - Attendance records → Firestore: reads and writes
src/services/attendanceService.js - Pass approvals → Firestore: reads and writes
src/services/passApprovalService.js - Scoring service → Firestore: uses
src/services/scoreService.js - Shared timers → Firestore: reads and writes
src/hooks/useSharedTimer.js - Google Sheets sync → Firestore: reads and writes
src/services/googleSheetsService.js