# noruiz-04/event-mangment-system architecture

> Architecture diagram of the GitHub repository noruiz-04/event-mangment-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/noruiz-04/event-mangment-system
- Repository: https://github.com/noruiz-04/event-mangment-system

## Overview

Smart Centralized Event Management is a full-stack event operations platform. Organizers create and manage events, schedules and food plans; participants discover events, register and pay; staff scan QR credentials for entry and food access. Administrators monitor live metrics, scan history, feedback and rankings, while participants can use event assistance. The README documents these capabilities and the FastAPI/React architecture; sampled files confirm app routing, token handling, database setup, and several UI/API interactions. Many router implementations were not sampled, so undocumented internal calls are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/main.py) (FastAPI app), [`frontend/src/App.jsx`](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/App.jsx) (Browser UI), [`frontend/src/services/api.js`](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/services/api.js) (HTTP client), [`frontend/src/pages/ManageEvents.jsx`](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ManageEvents.jsx) (Event administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_browser["Browser UI<br/>[App.jsx]"]
  node_event_admin_ui["Event administration<br/>[ManageEvents.jsx]"]
  node_food_ui["Food-plan manager"]
  node_participant_ui["Event discovery"]
  node_payment_ui["Payment page<br/>[Payment.jsx]"]
  node_dashboard_ui["Admin dashboard<br/>[Dashboard.jsx]"]
  node_scan_ui["Scan history<br/>[ScanHistory.jsx]"]
  node_http_client["HTTP client<br/>[api.js]"]
  node_auth_ui["Auth state<br/>[auth.js]"]
end

subgraph group_api["Backend API"]
  node_api_app["FastAPI app<br/>[main.py]"]
end

subgraph group_domain["Event capabilities"]
  node_event_ops["Event management<br/>[event.py]"]
  node_registration["Registration<br/>[registration.py]"]
  node_payments["Payment workflow<br/>[payment.py]"]
  node_qr_ticket["QR and tickets<br/>[verification.py]"]
  node_dashboards["Metrics and scans<br/>[dashboard.py]"]
  node_feedback_analytics["Feedback and ranking<br/>[analytics.py]"]
  node_chat_assistant["Event chatbot<br/>[chatbot.py]"]
  node_websocket["Live updates<br/>[manager.py]"]
end

subgraph group_platform["Data and security"]
  node_models["Event data models"]
  node_database[("SQL database<br/>[database.py]")]
  node_security["JWT and roles<br/>[security.py]"]
end

node_organizer(("Organizer / staff"))
node_participant(("Participant"))
node_payment_gateway["Razorpay / mock"]
node_chat_engine["Ollama chatbot"]

node_organizer -->|"uses"| node_browser
node_participant -->|"uses"| node_browser
node_browser -->|"routes to"| node_event_admin_ui
node_browser -->|"routes to"| node_participant_ui
node_browser -->|"routes to"| node_payment_ui
node_browser -->|"routes to"| node_dashboard_ui
node_browser -->|"routes to"| node_scan_ui
node_event_admin_ui -->|"uses"| node_food_ui
node_event_admin_ui -->|"calls"| node_http_client
node_food_ui -->|"calls"| node_http_client
node_participant_ui -->|"calls"| node_http_client
node_payment_ui -->|"calls"| node_http_client
node_dashboard_ui -->|"calls"| node_http_client
node_scan_ui -->|"calls"| node_http_client
node_http_client -->|"HTTP requests"| node_api_app
node_api_app -->|"registers"| node_event_ops
node_api_app -->|"registers"| node_registration
node_api_app -->|"registers"| node_payments
node_api_app -->|"registers"| node_qr_ticket
node_api_app -->|"registers"| node_dashboards
node_api_app -->|"registers"| node_feedback_analytics
node_api_app -->|"registers"| node_chat_assistant
node_api_app -->|"registers"| node_websocket
node_api_app -->|"creates tables"| node_database
node_database -->|"persists"| node_models
node_security -->|"loads user"| node_database
node_payments -.->|"orchestrates"| node_payment_gateway
node_chat_assistant -.->|"queries"| node_chat_engine
node_qr_ticket -.->|"broadcasts updates"| node_websocket
node_auth_ui -->|"stores role"| node_browser

click node_browser "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/App.jsx"
click node_event_admin_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ManageEvents.jsx"
click node_food_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/components/FoodPlanManager.jsx"
click node_participant_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ParticipantEvents.jsx"
click node_payment_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/Payment.jsx"
click node_dashboard_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/Dashboard.jsx"
click node_scan_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ScanHistory.jsx"
click node_http_client "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/services/api.js"
click node_auth_ui "https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/services/auth.js"
click node_api_app "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/main.py"
click node_event_ops "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/event.py"
click node_registration "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/registration.py"
click node_payments "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/payment.py"
click node_qr_ticket "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/verification.py"
click node_dashboards "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/dashboard.py"
click node_feedback_analytics "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/analytics.py"
click node_chat_assistant "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/chatbot.py"
click node_websocket "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/websocket/manager.py"
click node_models "https://github.com/noruiz-04/event-mangment-system/tree/main/backend/app/models"
click node_database "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/database.py"
click node_security "https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/auth/security.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_browser,node_event_admin_ui,node_food_ui,node_participant_ui,node_payment_ui,node_dashboard_ui,node_scan_ui,node_http_client,node_auth_ui toneBlue
class node_api_app toneAmber
class node_event_ops,node_registration,node_payments,node_qr_ticket,node_dashboards,node_feedback_analytics,node_chat_assistant,node_websocket toneMint
class node_models,node_database,node_security toneRose
class node_organizer,node_participant,node_payment_gateway,node_chat_engine toneIndigo
```

## Components

### React application

- [Browser UI](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Event administration](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ManageEvents.jsx): `frontend/src/pages/ManageEvents.jsx`
- [Food-plan manager](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/components/FoodPlanManager.jsx): `frontend/src/components/FoodPlanManager.jsx`
- [Event discovery](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ParticipantEvents.jsx): `frontend/src/pages/ParticipantEvents.jsx`
- [Payment page](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/Payment.jsx): `frontend/src/pages/Payment.jsx`
- [Admin dashboard](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Scan history](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/pages/ScanHistory.jsx): `frontend/src/pages/ScanHistory.jsx`
- [HTTP client](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth state](https://github.com/noruiz-04/event-mangment-system/blob/main/frontend/src/services/auth.js): `frontend/src/services/auth.js`

### Backend API

- [FastAPI app](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/main.py): `backend/app/main.py`

### Event capabilities

- [Event management](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/event.py): `backend/app/routers/event.py`
- [Registration](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/registration.py): `backend/app/routers/registration.py`
- [Payment workflow](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/payment.py): `backend/app/routers/payment.py`
- [QR and tickets](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/verification.py): `backend/app/routers/verification.py`
- [Metrics and scans](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/dashboard.py): `backend/app/routers/dashboard.py`
- [Feedback and ranking](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/analytics.py): `backend/app/routers/analytics.py`
- [Event chatbot](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/routers/chatbot.py): `backend/app/routers/chatbot.py`
- [Live updates](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/websocket/manager.py): `backend/app/websocket/manager.py`

### Data and security

- [Event data models](https://github.com/noruiz-04/event-mangment-system/tree/main/backend/app/models): `backend/app/models`
- [SQL database](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/database.py): `backend/app/database.py`
- [JWT and roles](https://github.com/noruiz-04/event-mangment-system/blob/main/backend/app/auth/security.py): `backend/app/auth/security.py`

### Other components

- **Organizer / staff**
- **Participant**
- **Razorpay / mock**
- **Ollama chatbot**

## Connections

- Organizer / staff → Browser UI: uses (evidence: `README.md`)
- Participant → Browser UI: uses (evidence: `README.md`)
- Browser UI → Event administration: routes to (evidence: `frontend/src/App.jsx`)
- Browser UI → Event discovery: routes to (evidence: `frontend/src/App.jsx`)
- Browser UI → Payment page: routes to (evidence: `frontend/src/App.jsx`)
- Browser UI → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Browser UI → Scan history: routes to (evidence: `frontend/src/App.jsx`)
- Event administration → Food-plan manager: uses (evidence: `frontend/src/pages/ManageEvents.jsx`)
- Event administration → HTTP client: calls (evidence: `frontend/src/pages/ManageEvents.jsx`)
- Food-plan manager → HTTP client: calls (evidence: `frontend/src/components/FoodPlanManager.jsx`)
- Event discovery → HTTP client: calls (evidence: `frontend/src/pages/ParticipantEvents.jsx`)
- Payment page → HTTP client: calls (evidence: `frontend/src/pages/Payment.jsx`)
- Admin dashboard → HTTP client: calls (evidence: `frontend/src/pages/Dashboard.jsx`)
- Scan history → HTTP client: calls (evidence: `frontend/src/pages/ScanHistory.jsx`)
- HTTP client → FastAPI app: HTTP requests (evidence: `README.md`)
- FastAPI app → Event management: registers (evidence: `backend/app/main.py`)
- FastAPI app → Registration: registers (evidence: `backend/app/main.py`)
- FastAPI app → Payment workflow: registers (evidence: `backend/app/main.py`)
- FastAPI app → QR and tickets: registers (evidence: `backend/app/main.py`)
- FastAPI app → Metrics and scans: registers (evidence: `backend/app/main.py`)
- FastAPI app → Feedback and ranking: registers (evidence: `backend/app/main.py`)
- FastAPI app → Event chatbot: registers (evidence: `backend/app/main.py`)
- FastAPI app → Live updates: registers (evidence: `backend/app/main.py`)
- FastAPI app → SQL database: creates tables (evidence: `backend/app/main.py`)
- SQL database → Event data models: persists (evidence: `backend/app/database.py`)
- JWT and roles → SQL database: loads user (evidence: `backend/app/auth/security.py`)
- Payment workflow → Razorpay / mock: orchestrates (evidence: `README.md`)
- Event chatbot → Ollama chatbot: queries (evidence: `README.md`)
- QR and tickets → Live updates: broadcasts updates (evidence: `README.md`)
- Auth state → Browser UI: stores role (evidence: `frontend/src/services/auth.js`)
