# rachanaramkumar/event-management-system architecture

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

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

## Overview

This event-management system lets administrators manage client records, create events linked to clients and venues, record payments, and review reports. The React pages call typed service modules, which use a shared HTTP client to reach the Express REST API; the API accesses the database layer. The README describes MySQL and optional SQL bootstrap scripts, but sampled backend excerpts do not show route-to-query details, so those internal edges are omitted. Reports and venue/payment capabilities are retained as documented or indexed subsystems.

Main entry points: [`src/services/http.ts`](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/http.ts) (HTTP client), [`src/App.tsx`](https://github.com/rachanaramkumar/event-management-system/blob/main/src/App.tsx) (Page routing), [`src/pages/AddEventPage.tsx`](https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/AddEventPage.tsx) (Event creation), [`backend/src/server.js`](https://github.com/rachanaramkumar/event-management-system/blob/main/backend/src/server.js) (Express REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Admin interface"]
  node_routes["Page routing<br/>[App.tsx]"]
  node_clientpage["Client management<br/>[ClientsPage.tsx]"]
  node_eventpage["Event creation<br/>[AddEventPage.tsx]"]
  node_paymentpage["Payment tracking<br/>[PaymentsPage.tsx]"]
  node_reportpage["Reports<br/>[ReportsPage.tsx]"]
end

subgraph group_services["Frontend services"]
  node_clientsvc["Client service<br/>[clients.ts]"]
  node_eventsvc["Event service<br/>[events.ts]"]
  node_venuesvc["Venue service<br/>[venues.ts]"]
  node_paymentsvc["Payment service<br/>[payments.ts]"]
  node_reportsvc["Report service<br/>[reports.ts]"]
  node_http["HTTP client<br/>[http.ts]"]
  node_models["Domain models<br/>[models.ts]"]
end

subgraph group_backend["API and persistence"]
  node_api["Express REST API<br/>[server.js]"]
  node_dbaccess["Database access<br/>[db.js]"]
  node_database[("MySQL database")]
  node_sqlscripts["Schema and seed scripts"]
end

node_admin(("Administrator"))

node_admin -->|"uses UI"| node_routes
node_routes -->|"routes to"| node_clientpage
node_routes -->|"routes to"| node_eventpage
node_routes -->|"routes to"| node_paymentpage
node_routes -->|"routes to"| node_reportpage
node_clientpage -->|"calls"| node_clientsvc
node_eventpage -->|"loads clients"| node_clientsvc
node_eventpage -->|"creates event"| node_eventsvc
node_eventpage -->|"loads venues"| node_venuesvc
node_paymentpage -->|"records and loads"| node_paymentsvc
node_reportpage -->|"loads reports"| node_reportsvc
node_clientsvc -->|"sends requests"| node_http
node_eventsvc -->|"sends requests"| node_http
node_venuesvc -->|"sends requests"| node_http
node_paymentsvc -->|"sends requests"| node_http
node_reportsvc -->|"sends requests"| node_http
node_http -->|"HTTP requests"| node_api
node_api -->|"uses database layer"| node_dbaccess
node_api -.->|"reads and writes"| node_database
node_sqlscripts -->|"initializes optionally"| node_database

click node_routes "https://github.com/rachanaramkumar/event-management-system/blob/main/src/App.tsx"
click node_clientpage "https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/ClientsPage.tsx"
click node_eventpage "https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/AddEventPage.tsx"
click node_paymentpage "https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/PaymentsPage.tsx"
click node_reportpage "https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/ReportsPage.tsx"
click node_clientsvc "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/clients.ts"
click node_eventsvc "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/events.ts"
click node_venuesvc "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/venues.ts"
click node_paymentsvc "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/payments.ts"
click node_reportsvc "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/reports.ts"
click node_http "https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/http.ts"
click node_models "https://github.com/rachanaramkumar/event-management-system/blob/main/src/types/models.ts"
click node_api "https://github.com/rachanaramkumar/event-management-system/blob/main/backend/src/server.js"
click node_dbaccess "https://github.com/rachanaramkumar/event-management-system/blob/main/backend/src/db.js"
click node_sqlscripts "https://github.com/rachanaramkumar/event-management-system/tree/main/DBMSPROJECT"

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_routes,node_clientpage,node_eventpage,node_paymentpage,node_reportpage toneBlue
class node_clientsvc,node_eventsvc,node_venuesvc,node_paymentsvc,node_reportsvc,node_http,node_models toneAmber
class node_api,node_dbaccess,node_database,node_sqlscripts toneMint
class node_admin toneIndigo
```

## Components

### Admin interface

- [Page routing](https://github.com/rachanaramkumar/event-management-system/blob/main/src/App.tsx): `src/App.tsx`
- [Client management](https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/ClientsPage.tsx): `src/pages/ClientsPage.tsx`
- [Event creation](https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/AddEventPage.tsx): `src/pages/AddEventPage.tsx`
- [Payment tracking](https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/PaymentsPage.tsx): `src/pages/PaymentsPage.tsx`
- [Reports](https://github.com/rachanaramkumar/event-management-system/blob/main/src/pages/ReportsPage.tsx): `src/pages/ReportsPage.tsx`

### Frontend services

- [Client service](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/clients.ts): `src/services/clients.ts`
- [Event service](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/events.ts): `src/services/events.ts`
- [Venue service](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/venues.ts): `src/services/venues.ts`
- [Payment service](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/payments.ts): `src/services/payments.ts`
- [Report service](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/reports.ts): `src/services/reports.ts`
- [HTTP client](https://github.com/rachanaramkumar/event-management-system/blob/main/src/services/http.ts): `src/services/http.ts`
- [Domain models](https://github.com/rachanaramkumar/event-management-system/blob/main/src/types/models.ts): `src/types/models.ts`

### API and persistence

- [Express REST API](https://github.com/rachanaramkumar/event-management-system/blob/main/backend/src/server.js): `backend/src/server.js`
- [Database access](https://github.com/rachanaramkumar/event-management-system/blob/main/backend/src/db.js): `backend/src/db.js`
- **MySQL database**
- [Schema and seed scripts](https://github.com/rachanaramkumar/event-management-system/tree/main/DBMSPROJECT): `DBMSPROJECT`

### Other components

- **Administrator**

## Connections

- Administrator → Page routing: uses UI (evidence: `README.md`)
- Page routing → Client management: routes to (evidence: `src/App.tsx`)
- Page routing → Event creation: routes to (evidence: `src/App.tsx`)
- Page routing → Payment tracking: routes to (evidence: `src/App.tsx`)
- Page routing → Reports: routes to (evidence: `src/App.tsx`)
- Client management → Client service: calls (evidence: `src/pages/ClientsPage.tsx`)
- Event creation → Client service: loads clients (evidence: `src/pages/AddEventPage.tsx`)
- Event creation → Event service: creates event (evidence: `src/pages/AddEventPage.tsx`)
- Event creation → Venue service: loads venues (evidence: `src/pages/AddEventPage.tsx`)
- Payment tracking → Payment service: records and loads (evidence: `src/pages/PaymentsPage.tsx`)
- Reports → Report service: loads reports (evidence: `src/pages/ReportsPage.tsx`)
- Client service → HTTP client: sends requests (evidence: `src/services/clients.ts`)
- Event service → HTTP client: sends requests (evidence: `src/services/events.ts`)
- Venue service → HTTP client: sends requests (evidence: `src/services/venues.ts`)
- Payment service → HTTP client: sends requests (evidence: `src/services/payments.ts`)
- Report service → HTTP client: sends requests (evidence: `src/services/reports.ts`)
- HTTP client → Express REST API: HTTP requests (evidence: `README.md`)
- Express REST API → Database access: uses database layer (evidence: `backend/src/server.js`)
- Express REST API → MySQL database: reads and writes
- Schema and seed scripts → MySQL database: initializes optionally (evidence: `README.md`)
