EventStack

Production-Ready Event Management Platform

Full-stack event management • AI-powered budgeting • Real-time analytics

Status Tests Coverage

What is this?

EventStack is a comprehensive full-stack event management platform designed to connect event organizers with attendees. It provides a complete suite of tools for managing events, tracking expenses, discovering activities, and engaging with attendees through intelligent features.

Built with modern web technologies and best practices, EventStack offers a seamless experience for both event organizers and attendees, from event discovery to budget management.

Key Features

User Authentication

• Secure registration and login for attendees and organizers
• Role-based access control (Admin, Organizer, Attendee)
• JWT-based authentication with secure token management

Event Management

• Admins can create, update, and manage event listings
• Rich event details with image uploads
• Event categorization and filtering
• Venue management

Event Discovery

• Advanced search functionality
• Browse and filter events by category, date, and location
• Detailed event information pages
• Bookmark favorite events

Expense Tracking

• Organizers can manage event budgets
• Track expenses with detailed records
• Budget analysis and reporting
• Financial dashboard for organizers

AI-Powered Budget Bot

• Intelligent assistant for budget planning
• Real-time budget recommendations
• Integration with Google Gemini API
• Smart expense categorization

Admin & Organizer Dashboards

• Dedicated interfaces for managing events
• Financial overview and analytics
• User management capabilities
• Complete system control

How It Works

System Architecture

1. Frontend (React + Vite)
   • Modern, responsive user interface
   • Real-time updates and interactions
   • Client-side routing and state management
2. Backend (Fastify + Node.js)
   • RESTful API endpoints
   • Database operations and business logic
   • Authentication and authorization
   • File upload handling
3. Database (PostgreSQL)
   • Relational data storage
   • User, event, and expense management
   • Optimized queries and relationships
4. AI Integration (Google Gemini)
   • Budget planning assistance
   • Intelligent recommendations
   • Natural language processing

Technology Stack

Quick Start

One Command Deployment

# Run with default settings
.\deploy-eventstack.ps1

# Or customize with parameters
.\deploy-eventstack.ps1 -DbPassword "YourPassword" -JwtSecret "YourSecret" -BackendPort 4000

# Load sample data
.\deploy-eventstack.ps1 -LoadSampleData

# When done, press ENTER to automatically cleanup everything

Access Your System

• Frontend: http://localhost:5173
• Backend API: http://localhost:4000
• Database: localhost:5432

Automatic Cleanup: Press ENTER when finished to stop all services, close windows, and optionally drop the database (unless CTRL+C is pressed to keep the database).

Deployment Script Parameters

Database Configuration:

• -DbName (default: eventstack) - PostgreSQL database name
• -DbHost (default: localhost) - PostgreSQL server host
• -DbPort (default: 5432) - PostgreSQL server port
• -DbUser (default: postgres) - PostgreSQL username
• -DbPassword (default: Changeme) - ⚠️ Change this default password!

Server Configuration:

• -BackendHost (default: localhost) - Backend server host
• -BackendPort (default: 4000) - Backend server port
• -FrontendHost (default: localhost) - Frontend server host
• -FrontendPort (default: 5173) - Frontend server port

Security Configuration:

• -JwtSecret (default: change-me-now) - ⚠️ Change this default JWT secret!
• -CorsOrigins (default: http://localhost:5173) - Comma-separated CORS origins

Deployment Options (switches):

• -SkipDb - Skip database setup
• -SkipBackend - Skip backend installation and startup
• -SkipFrontend - Skip frontend installation and startup
• -LoadSampleData - Load sample data into the database
• -ProdFrontend - Build and serve production frontend (instead of dev server)

Example Customizations

# Override default password and JWT secret (RECOMMENDED)
.\deploy-eventstack.ps1 -DbPassword "YourSecurePassword123" -JwtSecret "your-super-secret-jwt-key-min-6-chars"

# Custom database settings
.\deploy-eventstack.ps1 -DbName "myeventstack" -DbUser "myuser" -DbPassword "mypassword"

# Custom ports
.\deploy-eventstack.ps1 -BackendPort 5000 -FrontendPort 3000

# Multiple customizations
.\deploy-eventstack.ps1 -DbPassword "SecurePass" -JwtSecret "MySecretKey" -BackendPort 8080 -LoadSampleData

Need more details? Check the deployment guide for all available parameters and options.

System Highlights

Production Ready - Fully tested and deployment-ready

Comprehensive Testing - 60+ test files covering unit and integration tests

High Code Coverage - 89%+ coverage across frontend and backend

Secure - JWT authentication, password hashing, input validation

Modern UI - Responsive design for mobile and desktop

Fast & Efficient - Fastify backend, Vite frontend build

Easy Setup - Single-script automated deployment

Type Safe - Full TypeScript implementation

Running Tests

Both packages are equipped with comprehensive test suites using Vitest.

Test Scripts

Navigate to the package directory (apps/backend or apps/frontend) and use:

• npm test - Run all tests once
• npm run test:watch - Run tests in watch mode
• npm run testu - Run unit tests with coverage
• npm run testi - Run integration tests with coverage
• npm run test:coverage - Run all tests with combined coverage
• npm run test:report - Generate PDF coverage reports

Examples

Backend Tests:

cd apps/backend
npm test                    # Run all tests
npm run testu              # Unit tests with coverage
npm run testi              # Integration tests with coverage
npm run test:report        # Generate PDF coverage reports

Frontend Tests:

cd apps/frontend
npm test                    # Run all tests
npm run testu              # Unit tests with coverage
npm run testi              # Integration tests with coverage

Coverage reports are generated in the coverage/ directory, and PDF reports are available in tests/reports/ for each package.

Project Structure

eventstack/
├── apps/
│   ├── backend/          # Fastify server, database logic, and API endpoints
│   │   ├── src/          # Source code
│   │   ├── database/     # SQL schema and sample data
│   │   └── tests/        # Unit and integration tests
│   └── frontend/         # React client application
│       ├── src/          # Source code
│       └── tests/        # Unit and integration tests
├── deploy-eventstack.ps1 # Automated deployment script
├── tsconfig.base.json    # Shared TypeScript configuration
└── README.md

Manual Setup

If you prefer to set up the project manually or are on a non-Windows system:

Prerequisites

• Node.js (v20.x or later)
• npm
• PostgreSQL

Steps

1. Clone the Repository:

   git clone <YOUR_REPOSITORY_URL>
   cd eventstack
   

2. Database Setup:

   createdb eventstack
   psql -d eventstack -f apps/backend/database/schema.sql
   # Optional: Load sample data
   psql -d eventstack -f apps/backend/database/sample_data.sql
   

3. Environment Configuration:

   Create apps/backend/.env:

   NODE_ENV=development
   PORT=4000
   DATABASE_URL="postgresql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME"
   JWT_SECRET="your-super-secret-jwt-key-minimum-6-characters"
   CORS_ORIGINS="http://localhost:5173"
   GEMINI_API_KEY=""  # Optional: Required for AI Budget Bot features
   

4. Install Dependencies:

   cd apps/backend && npm install
   cd ../frontend && npm install
   

5. Run the Application:

   # Backend (in one terminal)
   cd apps/backend
   npm run dev
      
   # Frontend (in another terminal)
   cd apps/frontend
   npm run dev
   

⚠️ Security Notes

• The default database password (Changeme) and JWT secret (change-me-now) are not secure and should be changed for any non-local development environment.
• Always use strong, unique passwords and JWT secrets in production.
• The JWT secret must be at least 6 characters long.
• Never commit .env files or sensitive credentials to version control.

Academic Context

Course: Computer Engineering Project
Institution: University of Peradeniya
Year: 2024-2025

This project demonstrates the integration of modern web technologies, database management, AI integration, and best practices in software development to create a production-ready event management platform.

Transforming event experiences through intelligent technology