EventHive - Event Management System

A minimal MERN stack application for event management and ticket booking.

Features

• User authentication (Customer/Organizer/Admin roles)
• Event creation and management
• Ticket booking with QR codes
• Real-time updates with Socket.IO
• Clean, minimalistic UI

Quick Start

Prerequisites

• Node.js (v16+)
• MongoDB

Installation

1. Clone the repository

git clone <repo-url>
cd Event-Hive

2. Install dependencies

# Server
cd server
npm install

# Client
cd ../client
npm install

3. Setup environment

# Copy and edit server/.env
cp server/.env.example server/.env

4. Start the application

# Terminal 1 - Server
cd server
npm run dev

# Terminal 2 - Client
cd client
npm start

Access

• Client: http://localhost:3000
• Server: http://localhost:5000

API Endpoints

Auth

• POST /api/auth/register - Register user
• POST /api/auth/login - Login user
• GET /api/auth/profile - Get user profile

Events

• GET /api/events - List all events
• GET /api/events/:id - Get event details
• POST /api/events - Create event (organizer/admin)
• PUT /api/events/:id - Update event
• DELETE /api/events/:id - Delete event

Tickets

• POST /api/tickets/book - Book ticket
• GET /api/tickets/my-tickets - Get user tickets
• POST /api/tickets/validate - Validate QR ticket

Tech Stack

• Frontend: React, React Router
• Backend: Node.js, Express
• Database: MongoDB
• Real-time: Socket.IO
• Authentication: JWT

Project Structure

Event-Hive/
├── server/
│   ├── models/          # Database models
│   ├── routes/          # API routes
│   ├── middleware/      # Auth middleware
│   └── server.js        # Main server file
└── client/
    ├── src/
    │   ├── components/  # React components
    │   ├── pages/       # Page components
    │   ├── context/     # Auth context
    │   └── App.js       # Main app component
    └── public/