KickIt - Turf Booking Management System

A comprehensive turf booking and management ecosystem built with Flutter and Node.js, designed to streamline the process of booking sports turfs while providing powerful administrative tools for owners and super admins.

🎯 Overview

KickIt is a full-stack turf booking platform that solves the challenge of managing sports facility bookings efficiently. The system consists of three main components:

1. Player App - For customers to browse, book, and manage their turf reservations
2. Admin App - For turf owners and super admins to manage facilities, bookings, and view analytics
3. Backend Server - RESTful API built with Express.js and Prisma ORM

✨ Features

Player App

• 🔐 User Authentication - Secure login and registration
• 🏟️ Turf Browsing - View available turfs with detailed information
• 📅 Booking Management - Create, view, and manage bookings
• 🎮 Game Joining - Find and join games at various turfs
• 👤 Profile Management - Update user profile and preferences
• 📊 Booking History - Track past and upcoming bookings

Admin App

• 🏢 Multi-Role Support - Separate dashboards for Turf Owners and Super Admins
• 📈 Analytics Dashboard - View comprehensive stats and insights
• 🏟️ Turf Management - Add, edit, and manage turf details
• 📋 Booking Overview - Monitor all bookings across turfs
• 👥 Game Management - Oversee game sessions and participants
• 🔒 Secure Access Control - Role-based permissions

Backend Server

• 🚀 RESTful API - Clean and documented endpoints
• 🔐 JWT Authentication - Secure token-based auth
• 💾 PostgreSQL Database - Reliable data storage with Prisma ORM
• 🛡️ Security - Helmet.js for security headers, bcrypt for password hashing
• 📝 Request Logging - Morgan for HTTP request logging
• ✅ Input Validation - Zod schema validation

🏗️ Architecture

This is a monorepo project structured with the following architecture:

┌─────────────────┐         ┌─────────────────┐
│   Player App    │         │   Admin App     │
│   (Flutter)     │         │   (Flutter)     │
└────────┬────────┘         └────────┬────────┘
         │                           │
         └──────────┬────────────────┘
                    │
                    ↓
         ┌──────────────────┐
         │   Shared Core    │
         │    Package       │
         └─────────┬────────┘
                   │
                   ↓
         ┌──────────────────┐
         │  Backend Server  │
         │  (Express + TS)  │
         └─────────┬────────┘
                   │
                   ↓
         ┌──────────────────┐
         │   PostgreSQL     │
         │    Database      │
         └──────────────────┘

🛠️ Tech Stack

Frontend (Flutter Apps)

• Framework: Flutter 3.8.1+
• State Management: Riverpod 2.6.1
• Routing: GoRouter 17.0.0
• UI/UX:
  • Google Fonts 6.3.2
  • Flutter Animate 4.5.2
  • Material Design 3
• Architecture: Clean Architecture with Repository Pattern

Backend

• Runtime: Node.js with TypeScript
• Framework: Express.js 4.18.2
• ORM: Prisma 5.10.0
• Database: PostgreSQL
• Authentication: JWT (jsonwebtoken 9.0.2)
• Security:
  • Helmet.js 7.1.0
  • bcryptjs 2.4.3
  • CORS 2.8.5
• Validation: Zod 3.22.4
• Logging: Morgan 1.10.0

Development Tools

• Hot Reload: Nodemon (Backend)
• Type Safety: TypeScript 5.3.3
• Linting: Flutter Lints 5.0.0

📁 Project Structure

kickit/
├── Turf/
│   ├── apps/
│   │   ├── admin/              # Admin Flutter application
│   │   │   ├── lib/
│   │   │   │   ├── screens/   # UI screens
│   │   │   │   ├── widgets/   # Reusable widgets
│   │   │   │   └── main.dart
│   │   │   └── pubspec.yaml
│   │   │
│   │   └── player/            # Player Flutter application
│   │       ├── lib/
│   │       │   ├── screens/
│   │       │   ├── widgets/
│   │       │   └── main.dart
│   │       └── pubspec.yaml
│   │
│   ├── packages/
│   │   └── core/              # Shared core package
│   │       ├── lib/
│   │       │   └── src/
│   │       │       ├── network/      # API client
│   │       │       └── features/
│   │       │           ├── auth/     # Authentication
│   │       │           ├── turf/     # Turf management
│   │       │           ├── booking/  # Booking system
│   │       │           ├── game/     # Game sessions
│   │       │           └── stats/    # Analytics
│   │       └── pubspec.yaml
│   │
│   └── server/                # Backend server
│       ├── src/
│       │   ├── controllers/   # Business logic
│       │   ├── routes/        # API endpoints
│       │   ├── middleware/    # Auth & validation
│       │   ├── utils/         # Helper functions
│       │   └── index.ts       # Entry point
│       ├── prisma/
│       │   └── schema.prisma  # Database schema
│       ├── package.json
│       └── tsconfig.json
│
└── README.md