Skip to content

Nisarg-Vekariya/College-Event-Management-System

Repository files navigation

πŸŽ“ College Event Management System

A comprehensive web-based Event Management System designed for colleges to streamline event registration, coordination, analytics, and Student of the Year (SOTY) applications.


🎯 About

College Event Management System is a powerful event management platform that enables colleges to efficiently manage their events, track student participation, and analyze engagement through interactive dashboards and analytics. The system features multi-role access control, CSV data imports, automated email notifications, and comprehensive reporting capabilities.

Key Highlights

  • πŸ” Multi-role authentication (Admin, Coordinator, Student, Guest)
  • πŸ“Š Real-time analytics with interactive graphs
  • πŸ“§ Automated email notifications with password delivery
  • πŸ“ CSV bulk import for students and events
  • πŸŽ“ Student of the Year (SOTY) application module
  • πŸ“± Responsive design for all devices
  • πŸ“ˆ Event-wise registration tracking and analysis

✨ Features

For Administrators

  • Complete System Control: Manage users, coordinators, students, and events
  • CSV Import: Bulk import students and events data
  • Analytics Dashboard: View registration trends, event participation, and SOTY applications
  • Interactive Graphs: Analyze student registrations with bar charts, line graphs, and pie charts
  • Registration Management: Control registration opening/closing dates and participation limits
  • User Management: Create and manage coordinators and admins

For Coordinators

  • Event Management: Manage assigned events and view participant lists
  • Email Communication: Send announcements to all registered students
  • Registration Tracking: Monitor real-time registration counts
  • Participant Details: Access enrollment numbers, names, and contact information

For Students

  • Easy Registration: Register with enrollment number only
  • Auto-filled Details: System automatically fetches student information (Name, Class, Branch, Email, Year)
  • Event Browsing: View all available events categorized as Indoor, Outdoor, and Cultural
  • SOTY Application: Apply for Student of the Year with auto-populated CGPA and records
  • Email Password Delivery: Receive password via email upon account creation automatically

Event Categories

  • 🎯 Indoor Events: Quizzes, debates, workshops
  • 🏏 Outdoor Events: Sports, marathons, outdoor activities
  • 🎭 Cultural Events: Dance, music, drama performances

πŸ‘₯ User Roles

Admin

Full system access, user management, analytics, CSV imports, event control

Coordinator

Manage assigned events, view participants, send emails

Student

Register for events, apply for SOTY, view personal dashboard

Guest

Limited access, view public pages and event listings


πŸ›  Tech Stack

  • Backend: Laravel (PHP Framework)
  • Frontend: Blade Templates, Tailwind CSS, JavaScript
  • Database: MySQL
  • Charts: Chart.js for interactive graphs
  • Animations: GSAP (GreenSock Animation Platform) with ScrollTrigger
  • Email: PHPMailer / SMTP
  • Version Control: Git

πŸ“₯ Installation

Prerequisites

Ensure you have the following installed on your system:

  • PHP >= 8.1
  • Composer
  • MySQL >= 5.7
  • Node.js & NPM
  • Git

Step-by-Step Installation

  1. Clone the Repository

    git clone https://github.com/Nisarg-Vekariya/College-Event-Management-System.git
    cd College-Event-Management-System
    
  2. Install PHP Dependencies

    composer install
    
  3. Install NPM Dependencies

    npm install
    
  4. Create Environment File

    cp .env.example .env
    
  5. Generate Application Key

    php artisan key:generate
    
  6. Configure Database

    Open .env file and update the following:

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=your_database_name
    DB_USERNAME=your_database_user
    DB_PASSWORD=your_database_password
    
  7. Import Database

    Import the provided SQL file to set up the complete database with tables, sample data, and configurations:

    mysql -u your_username -p your_database_name < cemsys.sql
    

    Or use phpMyAdmin:

    • Open phpMyAdmin
    • Select your database
    • Click on "Import" tab
    • Choose cemsys.sql file
    • Click "Go"
    npm run build
    

    For development:

    npm run dev
    
  8. Create Storage Link

    php artisan storage:link
    
  9. Start the Development Server

    php artisan serve
    
  10. Access the Application

Open your browser and navigate to: `http://localhost:8000`

βš™οΈ Configuration

Email Setup (Important!)

To enable email functionality for automatic password delivery to students and coordinator notifications, configure SMTP settings in your .env file:

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your-email@gmail.com
MAIL_PASSWORD=your-app-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your-email@gmail.com
MAIL_FROM_NAME="${APP_NAME}"

Gmail App Password Setup

  1. Go to your Google Account settings
  2. Enable 2-Factor Authentication
  3. Navigate to Security > 2-Step Verification > App passwords
  4. Generate a new app password for "Mail"
  5. Use this 16-character password in MAIL_PASSWORD

⚠️ Important: When a student creates an account, their password will be automatically emailed to them. Ensure email configuration is complete before allowing student registrations.

File Upload Configuration

Ensure the storage directory is writable:

chmod -R 775 storage
chmod -R 775 bootstrap/cache

πŸ”‘ Demo Credentials

Use these credentials to test different user roles:

πŸ‘¨β€πŸŽ“ Student Account

  • Email: team.818x+student@gmail.com
  • Password: ZEBhCaXi

πŸ‘¨β€πŸ« Coordinator Account

  • Email: team.818x+co@gmail.com
  • Password: team.818

πŸ‘¨β€πŸ’Ό Admin Account

  • Email: team.818x+admin@gmail.com
  • Password: team.818

πŸ“Έ Screenshots

View application screenshots in the sample images folder. Screenshots showcase:

  • Admin Dashboard with Analytics
  • Event Management Interface
  • Student Registration Flow
  • Coordinator Panel

πŸ“š Documentation

Analytics & Graphs

The system provides comprehensive analytics through interactive graphs to analyze student registrations:

  • Event-wise Registration Comparison: Bar charts showing registrations per event
  • Daily/Hourly Patterns: Line charts tracking registration trends
  • Category Analysis: Compare participation across Indoor, Outdoor, and Cultural events
  • SOTY Applications: Track Student of the Year application trends

These visualizations help administrators make data-driven decisions and understand student engagement patterns.

Database Schema

The application includes a pre-configured SQL file (cemsys.sql) that contains:

  • All necessary tables with proper relationships
  • Sample data for testing
  • User roles and permissions
  • Initial system configuration
  • Demo user accounts

⚠️ Disclaimer

This project uses images without specific copyright licensing. Please replace all images with properly licensed alternatives before commercial use.


πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ‘¨β€πŸ’» Team 818

Developed with ❀️ by Team 818

Contact


πŸ“ž Support

For any queries or support, please contact: team.818x@gmail.com

If you encounter any issues:

  • Check existing documentation
  • Review the sample images for visual guidance

⭐ Star this repository if you find it helpful!

About

It is a full-featured College Event Management Web Application designed to simplify event creation, registration, coordination, and result management for students, coordinators, and administrators. The system supports multi-role access, automated student data fetching, SOTY (Student of the Year) applications, and powerful admin controls.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages