How sudo-workspace/cybrstudy works
CybrStudy combines an authenticated study-material platform with an automated hackathon discovery subsystem. The primary user flow is login, browse sections, and preview study files; administrators manage content, users, notifications, and hackathons. Discovery aggregates external event sources and processes events through extraction, normalization, classification, validation, deduplication, and Firestore synchronization. The graph follows sampled imports and calls plus README-documented capabilities; source adapter and some runtime details were not sampled, so uncertain connections are omitted.
Main entry points: runDiscovery.js Discovery Scheduler · AdminPage.jsx Admin Dashboard · firebase.js Firestore Helpers · BrowsePage.jsx Browse Materials
Components 32
Study Platform
- App Router
src/App.jsx - Browse Materials
src/pages/BrowsePage.jsx - Media Preview
src/components/files/MediaPreview.jsx - Login Page
src/pages/LoginPage.jsx - Hackathon Listings
src/pages/HackathonsPage.jsx
Administration
- Admin Dashboard
src/pages/AdminPage.jsx - File Uploader
src/components/admin/FileUploader.jsx - Section Manager
src/components/admin/SectionManager.jsx - User Manager
src/components/admin/UserManager.jsx - Notification Manager
src/components/admin/NotificationManager.jsx - Hackathon Manager
src/components/admin/HackathonManager.jsx
Identity And Data
- Section Subscription
src/hooks/useSections.js - File Subscription
src/hooks/useFiles.js - Drive Proxy
src/services/driveService.js - Firestore Helpers
src/services/firebase.js - Auth Context
src/context/AuthContext.jsx - Authentication Service
src/services/authService.js - Notification Service
src/services/notificationService.js - Hackathon Service
src/services/hackathonService.js - Hackathon Subscription
src/hooks/useHackathons.js
Hackathon Discovery
- Discovery Scheduler
backend/discovery/scheduler/runDiscovery.js - Source Connectors
backend/discovery/sources - HTTP Fetcher
backend/discovery/fetcher/httpFetcher.js - Firestore Sync
backend/discovery/firestore/firestoreSync.js
Event Processing
- Event Extraction
backend/discovery/extractors/eventExtractor.js - Event Normalizer
backend/discovery/normalizer/eventNormalizer.js - Event Classifier
backend/discovery/classifier/eventClassifier.js - Event Validator
backend/discovery/validator/eventValidator.js - Event Deduplicator
backend/discovery/deduplicator/eventDeduplicator.js
Other components
- User
- Event Sources
- Firebase Firestore
Connections 36
- User → App Router: opens
src/App.jsx - App Router → Browse Materials: routes to
src/App.jsx - App Router → Login Page: routes to
src/App.jsx - App Router → Admin Dashboard: routes to
src/App.jsx - Browse Materials → Section Subscription: loads
src/pages/BrowsePage.jsx - Browse Materials → File Subscription: loads
src/pages/BrowsePage.jsx - Browse Materials → Media Preview: renders
src/pages/BrowsePage.jsx - Browse Materials → Firestore Helpers: renames sections
src/pages/BrowsePage.jsx - Section Subscription → Firestore Helpers: subscribes
src/hooks/useSections.js - File Subscription → Firestore Helpers: reads files
src/hooks/useFiles.js - Media Preview → Drive Proxy: loads media
src/components/files/MediaPreview.jsx - Login Page → Auth Context: uses auth state
src/pages/LoginPage.jsx - Auth Context → Authentication Service: checks sessions
src/context/AuthContext.jsx - Authentication Service → Firestore Helpers: reads profiles
src/services/authService.js - Admin Dashboard → File Uploader: renders
src/pages/AdminPage.jsx - Admin Dashboard → Section Manager: renders
src/pages/AdminPage.jsx - Admin Dashboard → User Manager: renders
src/pages/AdminPage.jsx - Admin Dashboard → Notification Manager: renders
src/pages/AdminPage.jsx - Admin Dashboard → Hackathon Manager: renders
src/pages/AdminPage.jsx - User Manager → Authentication Service: manages accounts
src/components/admin/UserManager.jsx - Notification Manager → Notification Service: manages notices
src/components/admin/NotificationManager.jsx - Notification Service → Firestore Helpers: stores notices
src/services/notificationService.js - Hackathon Manager → Hackathon Service: manages events
src/components/admin/HackathonManager.jsx - Hackathon Service → Firestore Helpers: stores events
src/services/hackathonService.js - Hackathon Subscription → Hackathon Service: subscribes
src/hooks/useHackathons.js - Hackathon Listings → Hackathon Subscription: loads listings
src/pages/HackathonsPage.jsx - Event Sources → Source Connectors: provides events
README.md - Source Connectors → Discovery Scheduler: registered with
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Event Extraction: extracts events
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Event Normalizer: normalizes events
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Event Classifier: classifies events
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Event Validator: validates events
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Event Deduplicator: deduplicates events
backend/discovery/scheduler/runDiscovery.js - Discovery Scheduler → Firestore Sync: syncs events
backend/discovery/scheduler/runDiscovery.js - Event Extraction → HTTP Fetcher: fetches sources
- Firestore Sync → Firebase Firestore: writes events