How radhiha2007/eventhub-a-devops-driven-event-management-platform works
EventHub is a campus event-management platform. Students discover events, register, check in, and access notifications and certificates; clubs manage events, attendance, and certificate issuance. The React app calls a FastAPI API whose domain services enforce workflow rules and use PostgreSQL for application state. Microsoft Entra ID supplies sign-in, while Celery and Redis support background notifications. The README also documents Prometheus/Grafana monitoring; deployment and monitoring configuration are not present in this file tree, so those are shown only as documented external capabilities.
Main entry points: main.py FastAPI entry · App.tsx Web app routing · notification.py Notifications · services Domain services
Components 22
Web experience
- Student experience
frontend/src/pages/student - Club management
frontend/src/pages/club - Event discovery
frontend/src/pages - Sign-in screens
frontend/src/components/eventhub/AuthScreens.tsx - API client
frontend/src/api/client.ts - Web app routing
frontend/src/App.tsx
API and workflows
- FastAPI entry
backend/app/main.py - Event management
backend/app/routers/events.py - Registration and check-in
backend/app/routers/registrations.py - Clubs and users
backend/app/routers - Event feedback
backend/app/routers/feedback.py - Notifications
backend/app/services/notification.py - Certificate lifecycle
backend/app/services/certificate.py - Authentication and access
backend/app/core/auth.py - Domain services
backend/app/services
Data and tasks
- Application records
backend/app/models - PostgreSQL
backend/app/database/session.py - Notification tasks
backend/app/tasks/notifications.py
External services
- Microsoft Entra ID
- Redis and Celery
- Prometheus and Grafana
Other components
- Student or club user
Connections 29
- Student or club user → Web app routing: uses
- Web app routing → Student experience: routes to
frontend/src/App.tsx - Web app routing → Club management: routes to
frontend/src/App.tsx - Web app routing → Event discovery: routes to
frontend/src/App.tsx - Web app routing → Sign-in screens: routes to
- Student experience → API client: requests data
- Club management → API client: requests data
- Event discovery → API client: requests data
- API client → FastAPI entry: calls REST API
- Sign-in screens → Microsoft Entra ID: signs in
- FastAPI entry → Event management: registers routes
backend/app/main.py - FastAPI entry → Registration and check-in: registers routes
backend/app/main.py - FastAPI entry → Event feedback: registers routes
backend/app/main.py - FastAPI entry → Clubs and users: registers routes
backend/app/main.py - Event management → Domain services: delegates to
backend/app/routers/events.py - Registration and check-in → Domain services: delegates to
backend/app/routers/registrations.py - Certificate lifecycle → Notifications: creates notices
backend/app/services/certificate.py - Registration and check-in → Notifications: creates notices
- FastAPI entry → Authentication and access: authenticates
backend/app/main.py - Domain services → Application records: reads and writes
backend/app/services/registration.py - Event management → Application records: reads and writes
backend/app/routers/events.py - Certificate lifecycle → Application records: reads and writes
backend/app/services/certificate.py - Notifications → Application records: writes notices
backend/app/services/notification.py - FastAPI entry → PostgreSQL: initializes database
backend/app/main.py - Domain services → PostgreSQL: uses sessions
backend/app/database/session.py - Notifications → Notification tasks: dispatches tasks
backend/app/services/notification.py - Notification tasks → Redis and Celery: background processing
- FastAPI entry → Prometheus and Grafana: exposes metrics
backend/app/main.py - Prometheus and Grafana → PostgreSQL: collects metrics