Production

Booking Platform

SitBlitz

SitBlitz turns venue discovery and booking into a controlled product flow with authentication, inventory rules, booking states, and an admin review path.

GitHub Repository

Status

Production

Stack

Next.js, MongoDB, Node.js

Throughput / Users

500+

Performance

95/100

System Architecture & Problem Statement

Core Problem Solved: Manual booking requests create delays, double-booking risk, and poor visibility for both users and administrators.

Architecture Layers:

1Next.js interface for customer, admin, and public routes.

2Node.js service layer for booking rules, validation, and notifications.

3MongoDB collections for users, venues, slots, bookings, and audit events.

4REST endpoints separated by public discovery, authenticated user actions, and admin operations.

Key Product Features

Availability-aware booking requests

Admin approval and cancellation states

Role-based access for users and managers

Searchable venue catalogue

Booking history and status tracking

Database Entity Schema & Relationships

Users

Collection/Table

nameattr

emailattr

roleattr

createdAtattr

→ Creates many bookings

Venues

Collection/Table

titleattr

locationattr

capacityattr

amenitiesattr

→ Owns many slots

Bookings

Collection/Table

userIdattr

venueIdattr

slotIdattr

statusattr

→ Joins users, venues, and slots

API Specifications & Endpoints

GET/api/venues

Search venues by location, capacity, and availability.

POST/api/bookings

Create a validated booking request.

PUT/api/admin/bookings/:id

Approve, reject, or cancel a booking.

Interactive Visual Screenshots & Previews

Command Dashboard

LIVE SIMULATION

Operational Metrics OverviewLive Telemetry

Total Throughput

1,240 / day

Avg Latency

18ms

Health Index

99.8%

Admin queue with booking volume, conversion, and status filters.

Venue Detail Matrix

LIVE SIMULATION

Operational Metrics OverviewLive Telemetry

Total Throughput

1,240 / day

Avg Latency

18ms

Health Index

99.8%

Availability matrix, amenities, and booking call to action.

🚀 Quick Start & Process to Run

STEP-BY-STEP REPRODUCIBLE SETUP

Prerequisites

Node.js 18+
MongoDB instance

Required Environment Variables (.env)

MONGODB_URI=mongodb://localhost:27017/sitblitz

NEXTAUTH_SECRET=supersecret

Execution Steps:

1. Clone Project Repository

Clone codebase.

$ git clone https://github.com/Dev-Nurul08/sitblitz.git && cd sitblitz

2. Install Node Dependencies

Install Next.js, Mongoose, and React dependencies.

$ npm install

3. Run Development Server

Launch Next.js development server on http://localhost:3000.

$ npm run dev

Engineering Challenges & Solutions

Challenge #1: Preventing duplicate bookings while keeping the user flow simple.

Challenge #2: Designing status transitions that are easy for admins to audit.

Key Lessons & Principles

Takeaway #1: State machines make booking workflows easier to reason about.

Takeaway #2: Readable admin tools reduce support load as much as public UI polish.