🎪 EventPulse — Premium Event Registration System

EventPulse is a robust, production-ready Event Registration and Management System. Designed with a secure Node.js & Express REST API backend and a lightweight, dynamic vanilla JavaScript frontend, EventPulse provides organizers and attendees with a seamless workflow for discovering, hosting, reviewing, and registering for premium events.

---

🔗 Live Demo

Experience the live application deployed on Render:
👉 EventPulse Live Demo

---

✨ Features

👤 User & Organizer Management

• Role-Based Access Control (RBAC): Distinct permissions for user, organizer, and admin roles.
• Secure Authentication: JWT-based stateless authentication with password hashing powered by bcrypt.
• Profile Customization: Support for user avatars, phone numbers, and profile details.

📅 Event Management & Discovery

• Full CRUD Operations: Organizers can create, edit, publish, and delete events.
• Lifecycle States: Events transition smoothly through draft, published, cancelled, and completed states.
• Categorization: Events are grouped dynamically under specific categories (e.g., Tech, Music, Business).
• Capacity Tracking: Real-time seat availability tracking to prevent overbooking.

🎟️ Registration & Ticketing

• One-Click Registrations: Attendees can register for events and receive unique ticket codes.
• Status Tracking: Ticket lifecycle states including pending, confirmed, cancelled, and attended.
• Flexible Payments: Support for tracking free, paid, and refunded transactions.

💬 Social & Interaction

• Event Reviews & Ratings: Registered attendees can rate events (1-5 stars) and write comments.
• Notification System: Instant alerts for registrations, reminders, event cancellations, and reviews.

---

🛠️ Tech Stack

Backend

• Runtime Environment: Node.js (v18+)
• Framework: Express.js (v5)
• ORM: Sequelize (v6)
• Database: PostgreSQL (Production/Config), SQLite (Local/Development testing)
• Security: Helmet, Express Rate Limit (DDoS mitigation), CORS middleware

Frontend

• Markup & Structure: Semantic HTML5
• Styling: Vanilla CSS (Glassmorphism design, responsive layouts)
• Client-side Logic: Vanilla JavaScript (ES6 Fetch API)

---

📁 Project Structure

CodeAlpha_EventRegistrationSystem/
├── public/                 # Static assets served by Express
│   ├── css/
│   │   └── style.css       # Core design system & modern UI styling
│   └── js/
│       ├── auth.js         # Authentication helpers
│       ├── dashboard.js    # Attendee & Organizer dashboard actions
│       ├── event-details.js# Single event interactions & reviews
│       ├── events.js       # Event listing and category filtering
│       └── main.js         # Core fetch wrappers & navigation controller
├── src/                    # Backend application source code
│   ├── config/
│   │   ├── database.js     # Sequelize database connection setup
│   │   └── seed.js         # Database seeding script (default categories & test data)
│   ├── controllers/        # Business logic for all modules
│   │   ├── authController.js
│   │   ├── eventController.js
│   │   ├── notificationController.js
│   │   ├── registrationController.js
│   │   └── reviewController.js
│   ├── middleware/         # Custom Express middlewares
│   │   ├── auth.js         # JWT verification & user session payload injector
│   │   └── validation/     # Request body and parameter schema validator
│   │       ├── helpers.js  # Validation utility helpers
│   │       ├── index.js    # Validation middleware initialization
│   │       └── schemas.js  # Joi/custom schemas for API requests
│   ├── models/             # Sequelize database schemas & associations
│   │   ├── index.js
│   │   ├── Category.js
│   │   ├── Event.js
│   │   ├── Notification.js
│   │   ├── Registration.js
│   │   ├── Review.js
│   │   └── User.js
│   ├── routes/             # RESTful API route endpoints
│   │   ├── auth.js
│   │   ├── events.js
│   │   ├── notifications.js
│   │   ├── registrations.js
│   │   └── reviews.js
│   ├── app.js              # Express app setup & middleware stacking
│   └── server.js           # Server listener & database synchronization
├── views/                  # Static frontend page templates
│   ├── admin.html          # Organizer/Admin management view
│   ├── dashboard.html      # Attendee personalized space
│   ├── event-details.html  # Event details, reviews, and sign-ups
│   ├── events.html         # Browse & filter published events
│   ├── index.html          # Landing page
│   ├── login.html          # User login
│   └── register.html       # User registration
├── .env.example            # Sample configuration file
├── database.sqlite         # Local development SQLite database
├── package.json            # Scripts & project dependencies
└── test_api.js             # API test automation script

---

🚀 Getting Started

📋 Prerequisites

Ensure you have the following installed on your local machine:

• Node.js (v18 or higher)
• npm (bundled with Node.js)
• PostgreSQL (or use the SQLite file for quick local testing)

🔧 Installation

1. Clone the Repository

   git clone https://github.com/mohammedabusamra04/CodeAlpha_EventRegistrationSystem.git
   cd CodeAlpha_EventRegistrationSystem

2. Install Dependencies

   npm install

3. Configure Environment Variables
   Duplicate .env.example to create a .env file:

   cp .env.example .env

   Open .env and fill in your credentials:

   PORT=5000
   DB_HOST=localhost
   DB_PORT=5432
   DB_USER=your_db_user
   DB_PASSWORD=your_db_password
   DB_NAME=event_registration_db
   JWT_SECRET=your_jwt_secret_key
   JWT_EXPIRES_IN=1d

💻 Running Locally

• Start in Development Mode (with automatic reload):

  npm run dev

• Start in Production Mode:

  npm start

Once running, access the landing page at: http://localhost:5000

---

🧪 API Documentation

The REST API exposes the following endpoints (all requests/responses use JSON format):

🔑 Authentication Endpoints (/api/auth)

Method	Endpoint	Description	Auth Required
POST	/register	Register a new user account	❌
POST	/login	Authenticate user and return a JWT	❌

📅 Event Endpoints (/api/events)

Method	Endpoint	Description	Auth Required
POST	/	Create a new event	🔐 (Admin/Organizer)
GET	/	Retrieve list of all events	❌
GET	/:id	Retrieve details of a single event	❌
PUT	/:id	Update an existing event	🔐 (Admin/Organizer)
DELETE	/:id	Delete/cancel an event	🔐 (Admin/Organizer)

🎟️ Registration Endpoints (/api/registrations)

Method	Endpoint	Description	Auth Required
POST	/:eventId	Register current user for an event	🔐
GET	/	Get current user's registrations	🔐
DELETE	/:id	Cancel a registration	🔐

💬 Review Endpoints (/api/reviews)

Method	Endpoint	Description	Auth Required
POST	/:eventId	Submit rating & review for an event	🔐
GET	/:eventId	Get all reviews for an event	❌
DELETE	/:id	Delete a review	🔐

🔔 Notification Endpoints (/api/notifications)

Method	Endpoint	Description	Auth Required
GET	/user	Get all notifications for current user	🔐
PATCH	/mark-as-read/:id	Mark notification as read	🔐
GET	/event/:eventId	Get notifications for a specific event	🔐

---

🔒 Security Notes

• Helmet.js is integrated to set secure HTTP headers and protect the application from common web vulnerabilities.
• Express Rate Limit protects the API from brute-force attempts and DDoS attacks by limiting requests to 100 per 15-minute window per IP.
• ORM Protection: Database interactions are mediated through Sequelize, preventing SQL injection vulnerabilities.

---

🔮 Future Improvements

• Payment Integration: Implement Stripe or PayPal SDKs for paid event ticket purchases.
• Interactive Seating Charts: Allow organizers to define maps and users to select seats.
• PDF Ticket Generator: Auto-email a styled PDF ticket with a QR code upon registration.
• WebSockets Integration: Live notifications for event changes or seat availability counts.

```