# siraj-dujana/event-management-system architecture

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

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

## Overview

##### Project type and purpose
- This is a monolithic full-stack web application built with Node.js + Express, using MongoDB for persistence and EJS for server-side HTML rendering.
- Purpose: Provide an admin interface for creating/editing/deleting events, automatically update event statuses (past/upcoming), and expose public views for end users to browse events.

##### File structure
Top level:
├── server.js             # single Express entry point, all routes, cron job, middleware
├── package.json          # dependencies: express, mongoose, ejs, express-session
├── public/               # static assets (CSS for each page)
└── views/                # EJS templates, partials, client-side script.js
No sub-services or microservices—everything lives in one runtime process.

##### Extract key architectural insights from README
- Backend framework: Express
- Database ORM: Mongoose → MongoDB
- Session management via express-session
- A recurring task (setInterval) for auto-updating event statuses
- Route patterns: /admin (login), /events, /past-events, /new-event, /edit-event, /delete

a. Main components
- Web Client (Browser)
- Express Server (server.js)
– Router layer (defines endpoints: admin, CRUD on events, public listing)
– Controller logic (handlers for each route)
– View Engine (EJS templates + partials)
– Static file server (public/css)
– Session middleware (express-session)
– Scheduler module (setInterval cron job)
- MongoDB (with Mongoose models for events & admin users)
b. Relationships & interactions
- Browser ⇄ Express Server: HTTP requests/responses
- Express Server uses EJS to render HTML + CSS for views
- Express Server ⇄ MongoDB: Mongoose queries for CRUD and status updates
- Scheduler (inside Server) → MongoDB: periodic updates
- Session middleware persists session data (in-memory or store)
c. Architectural patterns/principles
- MVC style:
Model = Mongoose schemas
View = EJS templates
Controller = Express route handlers
- Monolithic layering: presentation, business logic, data access all housed in one process
- Cron-style background task for maintenance
d. Key technologies/frameworks
- Node.js/Express.js, EJS, MongoDB, Mongoose, express-session

## Diagram (Mermaid)

```mermaid
flowchart TB
    Browser["Web Client (Browser)"]:::frontend
    subgraph "Express Server"
        direction TB
        Router["Router Layer"]:::compute
        Session["Session Middleware"]:::compute
        Controllers["Controllers (Route Handlers)"]:::compute
        ViewEngine["View Engine (EJS Templates)"]:::frontend
        StaticServer["Static File Server (CSS)"]:::frontend
        Scheduler["Scheduler (Cron Job)"]:::background
    end
    DB["MongoDB (Mongoose Models)"]:::data

    Browser -->|"HTTP Request"| Router
    Router -->|"authenticate()"| Session
    Session -->|"route handling"| Controllers
    Controllers -->|"render() / find() / save()"| ViewEngine
    Controllers -->|"CRUD Operations"| DB
    Controllers -->|"serve CSS"| StaticServer
    ViewEngine -->|"HTML Response"| Browser
    DB -->|"query results"| Controllers
    Scheduler -->|"updateMany()"| DB

    click Router "https://github.com/siraj-dujana/event-management-system/blob/main/server.js"
    click Session "https://github.com/siraj-dujana/event-management-system/blob/main/server.js"
    click Controllers "https://github.com/siraj-dujana/event-management-system/blob/main/server.js"
    click Scheduler "https://github.com/siraj-dujana/event-management-system/blob/main/server.js"
    click ViewEngine "https://github.com/siraj-dujana/event-management-system/tree/main/views/"
    click StaticServer "https://github.com/siraj-dujana/event-management-system/tree/main/public/css/"
    click DB "https://github.com/siraj-dujana/event-management-system/blob/main/server.js"

    classDef frontend fill:#ADD8E6,stroke:#000,color:#000
    classDef data fill:#90EE90,stroke:#000,color:#000
    classDef background fill:#FFA500,stroke:#000,color:#000
    classDef compute fill:#D3D3D3,stroke:#000,color:#000
```
