Event Management System

<<<<<<< HEAD

Event Management System

A comprehensive event management platform built with the MERN stack (MongoDB, Express.js, React, Node.js). This application allows users to create, manage, and book events with a professional and modern interface.

🚀 Features

For Users

Browse Events: Search and filter events by category, location, date, and more
Event Details: View comprehensive event information including venue, pricing, and organizer details
Booking System: Book tickets with secure payment processing
User Dashboard: Manage bookings, view event history, and update profile
Responsive Design: Works seamlessly on desktop, tablet, and mobile devices

For Organizers

Event Creation: Create and manage events with detailed information
Dashboard: View event analytics, manage bookings, and track revenue
Event Management: Edit, update, and manage event details
Booking Management: Handle attendee check-ins and booking management

For Administrators

User Management: Manage user accounts, roles, and permissions
Event Oversight: Monitor all events and manage content
Analytics: View system-wide statistics and performance metrics
Category Management: Create and manage event categories

🛠️ Technology Stack

Backend

Node.js - Runtime environment
Express.js - Web framework
MongoDB - Database
Mongoose - ODM for MongoDB
JWT - Authentication
bcryptjs - Password hashing
Express Validator - Input validation

Frontend

React 18 - UI library
TypeScript - Type safety
Material-UI (MUI) - Component library
React Router - Client-side routing
React Hook Form - Form management
TanStack Query - Data fetching and caching
Axios - HTTP client

📋 Prerequisites

Before running this application, make sure you have the following installed:

Node.js (v16 or higher)
MongoDB (v4.4 or higher)
npm or yarn

🚀 Installation & Setup

1. Clone the Repository

git clone <repository-url>
cd event-management-system

2. Install Backend Dependencies

npm install

3. Install Frontend Dependencies

cd client
npm install --legacy-peer-deps
cd ..

4. Environment Configuration

Create a .env file in the root directory with the following variables:

MONGODB_URI=mongodb://localhost:27017/eventmanagement
JWT_SECRET=your_jwt_secret_key_here
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_email_password
NODE_ENV=development

5. Database Setup

Make sure MongoDB is running on your system, then seed the database with initial data:

node seedData.js

6. Start the Application

Development Mode

# Start backend server
npm run dev

# In a new terminal, start frontend
npm run client

Production Mode

# Build frontend
npm run build

# Start production server
npm start

The application will be available at:

Frontend: http://localhost:3000
Backend API: http://localhost:5000

🔑 Demo Accounts

The seed data includes demo accounts for testing:

Role	Email	Password
Admin	admin@example.com	admin123
Organizer	organizer@example.com	organizer123
User	user@example.com	user123

📁 Project Structure

event-management-system/
├── client/                 # React frontend
│   ├── public/
│   ├── src/
│   │   ├── components/     # Reusable components
│   │   ├── contexts/       # React contexts
│   │   ├── pages/          # Page components
│   │   ├── services/       # API services
│   │   ├── types/          # TypeScript types
│   │   └── App.tsx
│   └── package.json
├── models/                 # MongoDB models
├── routes/                 # Express routes
├── middleware/             # Custom middleware
├── server.js              # Main server file
├── seedData.js            # Database seeding script
└── package.json

🎯 API Endpoints

Authentication

POST /api/auth/register - User registration
POST /api/auth/login - User login
GET /api/auth/me - Get current user
PUT /api/auth/profile - Update profile
PUT /api/auth/change-password - Change password

Events

GET /api/events - Get all events (with filtering)
GET /api/events/featured - Get featured events
GET /api/events/:id - Get single event
POST /api/events - Create event (Organizer/Admin)
PUT /api/events/:id - Update event (Organizer/Admin)
DELETE /api/events/:id - Delete event (Organizer/Admin)

Bookings

GET /api/bookings - Get user's bookings
GET /api/bookings/:id - Get single booking
POST /api/bookings - Create booking
PUT /api/bookings/:id/confirm - Confirm booking
PUT /api/bookings/:id/cancel - Cancel booking

Users

GET /api/users - Get all users (Admin)
GET /api/users/:id - Get user by ID
PUT /api/users/:id/role - Update user role (Admin)
DELETE /api/users/:id - Delete user (Admin)

🎨 Key Features