# radhiha2007/eventhub-a-devops-driven-event-management-platform architecture

> Architecture diagram of the GitHub repository radhiha2007/eventhub-a-devops-driven-event-management-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/radhiha2007/eventhub-a-devops-driven-event-management-platform
- Repository: https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform

## Overview

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: [`backend/app/main.py`](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/main.py) (FastAPI entry), [`frontend/src/App.tsx`](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/App.tsx) (Web app routing), [`backend/app/services/notification.py`](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/services/notification.py) (Notifications), [`backend/app/services`](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/services) (Domain services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_student["Student experience"]
  node_club["Club management"]
  node_public["Event discovery"]
  node_auth_ui["Sign-in screens<br/>[AuthScreens.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
  node_app["Web app routing<br/>[App.tsx]"]
end

subgraph group_api["API and workflows"]
  node_api_entry["FastAPI entry<br/>[main.py]"]
  node_event_workflow["Event management<br/>[events.py]"]
  node_registration["Registration and check-in<br/>[registrations.py]"]
  node_clubs_users["Clubs and users"]
  node_feedback["Event feedback<br/>[feedback.py]"]
  node_notifications["Notifications<br/>[notification.py]"]
  node_certificates["Certificate lifecycle<br/>[certificate.py]"]
  node_access["Authentication and access<br/>[auth.py]"]
  node_domain_services["Domain services"]
end

subgraph group_state["Data and tasks"]
  node_records["Application records"]
  node_postgres[("PostgreSQL<br/>[session.py]")]
  node_celery_tasks["Notification tasks<br/>[notifications.py]"]
end

subgraph group_integrations["External services"]
  node_entra["Microsoft Entra ID"]
  node_redis_celery["Redis and Celery"]
  node_monitoring["Prometheus and Grafana"]
end

node_web_user(("Student or club user"))

node_web_user -->|"uses"| node_app
node_app -->|"routes to"| node_student
node_app -->|"routes to"| node_club
node_app -->|"routes to"| node_public
node_app -->|"routes to"| node_auth_ui
node_student -->|"requests data"| node_api_client
node_club -->|"requests data"| node_api_client
node_public -->|"requests data"| node_api_client
node_api_client -->|"calls REST API"| node_api_entry
node_auth_ui -->|"signs in"| node_entra
node_api_entry -->|"registers routes"| node_event_workflow
node_api_entry -->|"registers routes"| node_registration
node_api_entry -->|"registers routes"| node_feedback
node_api_entry -->|"registers routes"| node_clubs_users
node_event_workflow -->|"delegates to"| node_domain_services
node_registration -->|"delegates to"| node_domain_services
node_certificates -->|"creates notices"| node_notifications
node_registration -->|"creates notices"| node_notifications
node_api_entry -->|"authenticates"| node_access
node_domain_services -->|"reads and writes"| node_records
node_event_workflow -->|"reads and writes"| node_records
node_certificates -->|"reads and writes"| node_records
node_notifications -->|"writes notices"| node_records
node_api_entry -->|"initializes database"| node_postgres
node_domain_services -->|"uses sessions"| node_postgres
node_notifications -->|"dispatches tasks"| node_celery_tasks
node_celery_tasks -.->|"background processing"| node_redis_celery
node_api_entry -->|"exposes metrics"| node_monitoring
node_monitoring -.->|"collects metrics"| node_postgres

click node_student "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages/student"
click node_club "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages/club"
click node_public "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages"
click node_auth_ui "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/components/eventhub/AuthScreens.tsx"
click node_api_client "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/api/client.ts"
click node_app "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/App.tsx"
click node_api_entry "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/main.py"
click node_event_workflow "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/events.py"
click node_registration "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/registrations.py"
click node_clubs_users "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/routers"
click node_feedback "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/feedback.py"
click node_notifications "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/services/notification.py"
click node_certificates "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/services/certificate.py"
click node_access "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/core/auth.py"
click node_domain_services "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/services"
click node_records "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/models"
click node_postgres "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/database/session.py"
click node_celery_tasks "https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/tasks/notifications.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_student,node_club,node_public,node_auth_ui,node_api_client,node_app,node_web_user toneBlue
class node_api_entry,node_event_workflow,node_registration,node_clubs_users,node_feedback,node_notifications,node_certificates,node_access,node_domain_services toneAmber
class node_records,node_postgres,node_celery_tasks toneMint
class node_entra,node_redis_celery,node_monitoring toneRose
```

## Components

### Web experience

- [Student experience](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages/student): `frontend/src/pages/student`
- [Club management](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages/club): `frontend/src/pages/club`
- [Event discovery](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/frontend/src/pages): `frontend/src/pages`
- [Sign-in screens](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/components/eventhub/AuthScreens.tsx): `frontend/src/components/eventhub/AuthScreens.tsx`
- [API client](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Web app routing](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/frontend/src/App.tsx): `frontend/src/App.tsx`

### API and workflows

- [FastAPI entry](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/main.py): `backend/app/main.py`
- [Event management](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/events.py): `backend/app/routers/events.py`
- [Registration and check-in](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/registrations.py): `backend/app/routers/registrations.py`
- [Clubs and users](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/routers): `backend/app/routers`
- [Event feedback](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/routers/feedback.py): `backend/app/routers/feedback.py`
- [Notifications](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/services/notification.py): `backend/app/services/notification.py`
- [Certificate lifecycle](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/services/certificate.py): `backend/app/services/certificate.py`
- [Authentication and access](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/core/auth.py): `backend/app/core/auth.py`
- [Domain services](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/services): `backend/app/services`

### Data and tasks

- [Application records](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/tree/develop/backend/app/models): `backend/app/models`
- [PostgreSQL](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/database/session.py): `backend/app/database/session.py`
- [Notification tasks](https://github.com/radhiha2007/eventhub-a-devops-driven-event-management-platform/blob/develop/backend/app/tasks/notifications.py): `backend/app/tasks/notifications.py`

### External services

- **Microsoft Entra ID**
- **Redis and Celery**
- **Prometheus and Grafana**

### Other components

- **Student or club user**

## Connections

- Student or club user → Web app routing: uses
- Web app routing → Student experience: routes to (evidence: `frontend/src/App.tsx`)
- Web app routing → Club management: routes to (evidence: `frontend/src/App.tsx`)
- Web app routing → Event discovery: routes to (evidence: `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 (evidence: `backend/app/main.py`)
- FastAPI entry → Registration and check-in: registers routes (evidence: `backend/app/main.py`)
- FastAPI entry → Event feedback: registers routes (evidence: `backend/app/main.py`)
- FastAPI entry → Clubs and users: registers routes (evidence: `backend/app/main.py`)
- Event management → Domain services: delegates to (evidence: `backend/app/routers/events.py`)
- Registration and check-in → Domain services: delegates to (evidence: `backend/app/routers/registrations.py`)
- Certificate lifecycle → Notifications: creates notices (evidence: `backend/app/services/certificate.py`)
- Registration and check-in → Notifications: creates notices
- FastAPI entry → Authentication and access: authenticates (evidence: `backend/app/main.py`)
- Domain services → Application records: reads and writes (evidence: `backend/app/services/registration.py`)
- Event management → Application records: reads and writes (evidence: `backend/app/routers/events.py`)
- Certificate lifecycle → Application records: reads and writes (evidence: `backend/app/services/certificate.py`)
- Notifications → Application records: writes notices (evidence: `backend/app/services/notification.py`)
- FastAPI entry → PostgreSQL: initializes database (evidence: `backend/app/main.py`)
- Domain services → PostgreSQL: uses sessions (evidence: `backend/app/database/session.py`)
- Notifications → Notification tasks: dispatches tasks (evidence: `backend/app/services/notification.py`)
- Notification tasks → Redis and Celery: background processing
- FastAPI entry → Prometheus and Grafana: exposes metrics (evidence: `backend/app/main.py`)
- Prometheus and Grafana → PostgreSQL: collects metrics
