Univent College Event Management System

Abstract

1. Introduction

Univent is a comprehensive, real-time event management platform designed specifically for the dynamic environment of colleges and universities. Built on the MERN stack (MongoDB, Express.js, React.js, Node.js) with a microservice architecture, it provides a centralized system for organizing and participating in college fests, workshops, and technical events. The platform features live announcements and interactive leaderboards to boost engagement and streamline communication between organizers and participants.

This open-source project is a perfect example of a full-stack web application using modern technologies like Socket.IO for real-time communication and JWT for secure authentication.

2. Objective

A real-time college event management system built with the MERN stack, featuring role-based dashboards, live announcements, and leaderboard tracking using Socket.IO.

This project demonstrates how JavaScript, Express, MongoDB can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• Full Event Lifecycle Management: Create, update, delete, and manage events.
• Easy Participant Registration: Simple, one-click event registration for students.
• Real-time Announcements: Push live updates and announcements to all users instantly.
• Live Gamified Leaderboards: Dynamic leaderboards that update scores in real-time to foster competition.
• Role-based Access Control (RBAC): Distinct roles for Admins, Organizers, and Participants with specific permissions.
• Instant Notifications: Real-time notifications for event registrations, updates, and more.
• Event Analytics Dashboard: Organizers can view registration statistics and engagement metrics.

4. Technology Stack

• Frontend: React.js with TailwindCSS for a responsive and beautiful UI.
• Backend: Node.js with Express.js for building robust APIs.
• Database: MongoDB with Mongoose for flexible, schema-based data storage.
• Real-time Communication: Socket.IO for WebSocket-based live updates.
• Authentication: JWT (JSON Web Tokens) for secure, stateless authentication.
• Containerization: Docker and Docker Compose for easy setup and deployment.

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm
• A modern web browser
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/AbhishekBalija/Univent-College_Event_Management_System.git
cd Univent-College_Event_Management_System

1. Clone the repository:
2. Install server and client dependencies:
3. Environment Variables Setup:
4. Run the Application:

git clone [https://github.com/AbhishekBalija/Univent.git](https://github.com/AbhishekBalija/Univent.git)
    cd univent

# Install frontend dependencies
    cd frontend
    npm install

    # Install backend dependencies for each microservice
    cd ../backend
    cd auth-service && npm install
    cd ../event-service && npm install
    cd ../notification-service && npm install
    cd ../leaderboard-service && npm install

# Example for auth-service/.env:
    MONGODB_URI=mongodb://localhost:27017/univent
    JWT_SECRET=your_super_secret_jwt_key
    PORT=8001

# Option 1: Start all services using Docker (Recommended)
    docker-compose up

    # Option 2: Start each service and the frontend individually
    # Terminal 1: Auth Service
    cd backend/auth-service && npm run dev
    # Terminal 2: Event Service
    cd backend/event-service && npm run dev
    # ...and so on for other services

    # Terminal 5: Frontend
    cd frontend && npm start

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by AbhishekBalija and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.