# mirshadvx/event-management architecture

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

- Interactive diagram: https://gitdiagram.com/mirshadvx/event-management
- Repository: https://github.com/mirshadvx/event-management

## Overview

This is a Django REST Framework and React event-management application for attendees, organizers, and administrators. The main attendee journey is to discover an event, purchase a ticket, and participate; organizers create and manage events, while admins oversee approvals and platform operations. The graph also preserves documented chat/social features, subscriptions and payments, ticket validation, and the supporting domain models. Edges from the README represent documented capabilities; source-specific edges are limited to relationships visible in excerpts or the source index.

Main entry points: [`client/src/App.jsx`](https://github.com/mirshadvx/event-management/blob/main/client/src/App.jsx) (React application), [`client/src/pages/User/Checkout/CheckoutPage.jsx`](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Checkout/CheckoutPage.jsx) (Ticket checkout), [`client/src/routes/admin/AdminRoutes.jsx`](https://github.com/mirshadvx/event-management/blob/main/client/src/routes/admin/AdminRoutes.jsx) (Admin operations), [`client/src/components/layout/user/chat/MainLayout.jsx`](https://github.com/mirshadvx/event-management/blob/main/client/src/components/layout/user/chat/MainLayout.jsx) (Group and private chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["React application<br/>[App.jsx]"]
  node_auth["Authentication"]
  node_user_dashboard["User dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_events["Events and tickets"]
  node_event_discovery["Event discovery<br/>[Explore.jsx]"]
  node_event_management["Event management"]
  node_ticket_checkout["Ticket checkout<br/>[CheckoutPage.jsx]"]
  node_ticket_validation["Ticket validation<br/>[ValidatorPage.jsx]"]
end

subgraph group_community["Community features"]
  node_social_profiles["Profiles and follows<br/>[GlobalProfile.jsx]"]
  node_chat["Group and private chat<br/>[MainLayout.jsx]"]
  node_notifications["Notifications"]
end

subgraph group_commerce["Administration and commerce"]
  node_admin_portal["Admin operations<br/>[AdminRoutes.jsx]"]
  node_subscriptions["Subscriptions"]
  node_payments["Stripe payments<br/>[stripe_webhooks.py]"]
end

subgraph group_backend["Backend domains"]
  node_event_domain[("Event domain<br/>[models.py]")]
  node_user_domain[("User and booking data<br/>[models.py]")]
  node_chat_service["Chat service"]
  node_admin_domain[("Admin data<br/>[models.py]")]
  node_background_tasks["Background tasks<br/>[tasks.py]"]
end

node_attendee(("Attendee"))
node_organizer(("Organizer"))
node_administrator(("Administrator"))

node_attendee -->|"uses"| node_webapp
node_organizer -->|"uses"| node_webapp
node_administrator -->|"manages"| node_admin_portal
node_webapp -->|"routes to"| node_auth
node_webapp -->|"routes to"| node_event_discovery
node_webapp -->|"routes to"| node_ticket_checkout
node_webapp -->|"routes to"| node_chat
node_webapp -->|"routes to"| node_admin_portal
node_webapp -->|"routes to"| node_user_dashboard
node_attendee -->|"explores"| node_event_discovery
node_organizer -->|"creates events"| node_event_management
node_attendee -->|"buys tickets"| node_ticket_checkout
node_ticket_checkout -->|"records ticketing"| node_event_domain
node_ticket_checkout -->|"records booking"| node_user_domain
node_attendee -->|"joins event chat"| node_chat
node_chat -->|"communicates"| node_chat_service
node_chat_service -.->|"notifies"| node_notifications
node_attendee -->|"connects with users"| node_social_profiles
node_organizer -->|"scans tickets"| node_ticket_validation
node_administrator -->|"reviews requests"| node_admin_portal
node_admin_portal -->|"manages platform data"| node_admin_domain
node_attendee -->|"buys premium"| node_subscriptions
node_subscriptions -->|"uses Stripe"| node_payments
node_payments -->|"updates subscription"| node_admin_domain
node_background_tasks -->|"loads user"| node_user_domain
node_background_tasks -->|"resets counters"| node_admin_domain

click node_webapp "https://github.com/mirshadvx/event-management/blob/main/client/src/App.jsx"
click node_auth "https://github.com/mirshadvx/event-management/tree/main/client/src/pages/User/Auth"
click node_user_dashboard "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Dashboard/Dashboard.jsx"
click node_event_discovery "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Explore/Explore.jsx"
click node_event_management "https://github.com/mirshadvx/event-management/blob/main/client/src/components/layout/user/Dashboard/Organized_Outlet.jsx"
click node_ticket_checkout "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Checkout/CheckoutPage.jsx"
click node_ticket_validation "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/TicketValidator/ValidatorPage.jsx"
click node_event_domain "https://github.com/mirshadvx/event-management/blob/main/server/event/models.py"
click node_user_domain "https://github.com/mirshadvx/event-management/blob/main/server/users/models.py"
click node_social_profiles "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/home/GlobalProfile.jsx"
click node_chat "https://github.com/mirshadvx/event-management/blob/main/client/src/components/layout/user/chat/MainLayout.jsx"
click node_chat_service "https://github.com/mirshadvx/event-management/tree/main/server/chat"
click node_notifications "https://github.com/mirshadvx/event-management/blob/main/client/src/services/user/notification/webSocketManager.js"
click node_admin_portal "https://github.com/mirshadvx/event-management/blob/main/client/src/routes/admin/AdminRoutes.jsx"
click node_admin_domain "https://github.com/mirshadvx/event-management/blob/main/server/Admin/models.py"
click node_subscriptions "https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Checkout/SubscriptionCheckout.jsx"
click node_payments "https://github.com/mirshadvx/event-management/blob/main/server/users/services/stripe_webhooks.py"
click node_background_tasks "https://github.com/mirshadvx/event-management/blob/main/server/users/tasks.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_webapp,node_auth,node_user_dashboard toneBlue
class node_event_discovery,node_event_management,node_ticket_checkout,node_ticket_validation toneAmber
class node_social_profiles,node_chat,node_notifications toneMint
class node_admin_portal,node_subscriptions,node_payments toneRose
class node_event_domain,node_user_domain,node_chat_service,node_admin_domain,node_background_tasks,node_attendee,node_organizer,node_administrator toneIndigo
```

## Components

### Web application

- [React application](https://github.com/mirshadvx/event-management/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Authentication](https://github.com/mirshadvx/event-management/tree/main/client/src/pages/User/Auth): `client/src/pages/User/Auth`
- [User dashboard](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Dashboard/Dashboard.jsx): `client/src/pages/User/Dashboard/Dashboard.jsx`

### Events and tickets

- [Event discovery](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Explore/Explore.jsx): `client/src/pages/User/Explore/Explore.jsx`
- [Event management](https://github.com/mirshadvx/event-management/blob/main/client/src/components/layout/user/Dashboard/Organized_Outlet.jsx): `client/src/components/layout/user/Dashboard/Organized_Outlet.jsx`
- [Ticket checkout](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Checkout/CheckoutPage.jsx): `client/src/pages/User/Checkout/CheckoutPage.jsx`
- [Ticket validation](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/TicketValidator/ValidatorPage.jsx): `client/src/pages/TicketValidator/ValidatorPage.jsx`

### Community features

- [Profiles and follows](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/home/GlobalProfile.jsx): `client/src/pages/User/home/GlobalProfile.jsx`
- [Group and private chat](https://github.com/mirshadvx/event-management/blob/main/client/src/components/layout/user/chat/MainLayout.jsx): `client/src/components/layout/user/chat/MainLayout.jsx`
- [Notifications](https://github.com/mirshadvx/event-management/blob/main/client/src/services/user/notification/webSocketManager.js): `client/src/services/user/notification/webSocketManager.js`

### Administration and commerce

- [Admin operations](https://github.com/mirshadvx/event-management/blob/main/client/src/routes/admin/AdminRoutes.jsx): `client/src/routes/admin/AdminRoutes.jsx`
- [Subscriptions](https://github.com/mirshadvx/event-management/blob/main/client/src/pages/User/Checkout/SubscriptionCheckout.jsx): `client/src/pages/User/Checkout/SubscriptionCheckout.jsx`
- [Stripe payments](https://github.com/mirshadvx/event-management/blob/main/server/users/services/stripe_webhooks.py): `server/users/services/stripe_webhooks.py`

### Backend domains

- [Event domain](https://github.com/mirshadvx/event-management/blob/main/server/event/models.py): `server/event/models.py`
- [User and booking data](https://github.com/mirshadvx/event-management/blob/main/server/users/models.py): `server/users/models.py`
- [Chat service](https://github.com/mirshadvx/event-management/tree/main/server/chat): `server/chat`
- [Admin data](https://github.com/mirshadvx/event-management/blob/main/server/Admin/models.py): `server/Admin/models.py`
- [Background tasks](https://github.com/mirshadvx/event-management/blob/main/server/users/tasks.py): `server/users/tasks.py`

### Other components

- **Attendee**
- **Organizer**
- **Administrator**

## Connections

- Attendee → React application: uses (evidence: `README.md`)
- Organizer → React application: uses (evidence: `README.md`)
- Administrator → Admin operations: manages (evidence: `README.md`)
- React application → Authentication: routes to (evidence: `client/src/App.jsx`)
- React application → Event discovery: routes to (evidence: `client/src/App.jsx`)
- React application → Ticket checkout: routes to (evidence: `client/src/App.jsx`)
- React application → Group and private chat: routes to (evidence: `client/src/App.jsx`)
- React application → Admin operations: routes to (evidence: `client/src/App.jsx`)
- React application → User dashboard: routes to
- Attendee → Event discovery: explores (evidence: `README.md`)
- Organizer → Event management: creates events (evidence: `README.md`)
- Attendee → Ticket checkout: buys tickets (evidence: `README.md`)
- Ticket checkout → Event domain: records ticketing (evidence: `README.md`)
- Ticket checkout → User and booking data: records booking (evidence: `README.md`)
- Attendee → Group and private chat: joins event chat (evidence: `README.md`)
- Group and private chat → Chat service: communicates (evidence: `README.md`)
- Chat service → Notifications: notifies
- Attendee → Profiles and follows: connects with users (evidence: `README.md`)
- Organizer → Ticket validation: scans tickets (evidence: `README.md`)
- Administrator → Admin operations: reviews requests (evidence: `README.md`)
- Admin operations → Admin data: manages platform data (evidence: `README.md`)
- Attendee → Subscriptions: buys premium (evidence: `README.md`)
- Subscriptions → Stripe payments: uses Stripe (evidence: `README.md`)
- Stripe payments → Admin data: updates subscription (evidence: `server/users/services/stripe_webhooks.py`)
- Background tasks → User and booking data: loads user (evidence: `server/users/tasks.py`)
- Background tasks → Admin data: resets counters (evidence: `server/users/tasks.py`)
