Parkini - Smart Parking Management System

📋 Overview

Parkini is an all-in-one smart parking management web application designed to streamline and innovate the way parking is reserved, managed, and secured — from both the user and admin perspectives.

🎥 Watch the full demo

🔗 Try it Live: front-end-front-office.vercel.app

💡 About Parkini

Parkini is a modern full-stack solution that includes:

• ✔️ User Front-Office (React.js)
• ✔️ Admin Back-Office (React.js)
• ✔️ Node.js & MongoDB Backend
• ✔️ CI/CD with Jenkins, Docker, and DevOps tools

✨ Key Features

👤 User Side

• Face Recognition Login: Secure biometric authentication
• Smart Parking Search: Search by location, availability, and vehicle type
• Live Availability Map: Includes meteorological data per parking location
• 2D Customization: Parking owners can design their spot layouts
• Reservation System: Book parking with QR-code-based access
• Subscription Plans: Free, Standard, and Premium
• Favorite Parkings: Save preferred locations

🚨 Reclamation System with Deep Learning

If someone parks in your reserved spot:

1. Plate Detection Model checks the license plate against the database
2. If recognized: Sends an email to the driver to move their vehicle
3. If unrecognized: Sends an alert to the on-duty parking employee

🧠 AI & ML Integrations

• Gemini API: For analytical insights
• Smart Stats in Admin Dashboard
• ML Predictions:
  • Price optimization
  • Hotspot detection for new parking areas
  • User preference analysis

📊 Admin Dashboard Highlights

• Live occupancy tracking
• Revenue and region-based analytics
• Employee and facility management
• Weather overlays
• Multi-step parking approval workflows
• Statics

⚙️ DevOps & Monitoring Tools

• CI/CD Pipelines with Jenkins
• SonarQube: Code quality metrics
• Grafana & Prometheus: Real-time system monitoring
• Jest: Unit testing
• Docker: Seamless containerization

🧱 Tech Stack

Category	Technologies
Frontend	React.js, Tailwind CSS, Axios, Map APIs
Backend	Node.js, Express.js, MongoDB, Mongoose
Authentication	JWT + Face Recognition
Media & File Handling	Multer, Cloudinary, QRCode
AI & ML	Gemini API, Deep Learning for plate detection
DevOps	Docker, Jenkins, SonarQube, Grafana, Prometheus

Setup Instructions

Getting Started

1. Clone the Repository

git clone https://github.com/PiDev-2025/Parkini.git
cd Parkini

2. Install Dependencies

The project has multiple components (frontend, backend). Navigate to each relevant directory and install dependencies:

cd <relevant-directory>
npm install

3. Set Up Environment Variables

Create a .env file in the root directory of the backend with the following variables:

DATABASE_URI=<your-mongodb-uri>
JWT_SECRET=<your-secret-key>
CLOUDINARY_API_KEY=<your-cloudinary-key>
# Add other variables as needed

Running the Application

4. Start the Backend

cd backend
npm start

5. Start the Frontend

cd frontend
npm start

6. Docker Setup (Optional)

If using Docker for containerization:

docker-compose up --build

7. Access the Application

Open your browser and navigate to http://localhost:3000 (or the port specified in the frontend).

Prerequisites

• Node.js: Install the latest LTS version
• MongoDB: Ensure MongoDB is running locally or use a cloud-based MongoDB service
• Docker & Docker Compose (Optional): For containerized deployment