Skip to content

akshatsrivastavagit/Urban_Ninja

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ› οΈ UrbanClap Clone – Home Service Booking Web App

This is a full-stack clone of UrbanClap, offering a multi-role platform where users can book home services, technicians manage assignments, and admins control operations. It includes detailed workflows, real-time booking, payment gateway integration, dashboards, and user feedback systems.


πŸš€ Features

πŸ‘€ Client Portal

  • Check service availability by city.
  • Sign in via Google OAuth.
  • Browse categories β†’ subcategories β†’ service packages.
  • Add services to cart, adjust quantities, and proceed to checkout.
  • Pay using Razorpay.
  • Track past bookings, download bills, leave reviews, and cancel services.
  • Auto-credit handling for cancellations and applied discounts.

πŸ› οΈ Technician Portal

  • Login via email.
  • View assigned jobs.
  • Confirm job completion with OTP from customer.

πŸ§‘β€πŸ’Ό Admin Portal

  • Secure login via company key.
  • Dashboard: sales, revenue, top services, booking trends.
  • Payment reconciliation with UPI reference.
  • View full database.
  • Monitor technician performance and earnings.

πŸ–ΌοΈ Screenshots & Workflow Images

Replace the your-username in URLs with your actual GitHub username if needed.

1. πŸ” Home Page – Check City Availability

Screenshot 2025-06-03 032812

2. πŸ” Google OAuth Login Flow

Screenshot 2025-06-03 032836
Screenshot 2025-06-03 032847

3. πŸ“š Browse Services by Category and Subcategory

Screenshot 2025-06-03 032914
Screenshot 2025-06-03 032924

4. πŸ›’ Add to Cart and View Cart

Screenshot 2025-06-03 032943
Screenshot 2025-06-03 033001

5. πŸ“… Slot Selection & Address Form

Screenshot 2025-06-03 031253
Screenshot 2025-06-03 031313
Screenshot 2025-06-03 031401

6. πŸ’³ Razorpay Payment Gateway

Screenshot 2025-06-03 031412
Screenshot 2025-06-03 031432
Screenshot 2025-06-03 031455

7. πŸ“œ Booking Summary & Bill Generation

Screenshot 2025-06-03 031521
Screenshot 2025-06-03 031619
Screenshot 2025-06-03 031627

8. ✍️ Review and Feedback Submission

Screenshot 2025-06-03 033019

9. πŸ‘¨β€πŸ”§ Technician Portal – View Assigned Jobs

Screenshot 2025-06-03 033338
Screenshot 2025-06-03 033359

10. πŸ“Š Admin Dashboard – Charts & Analytics

Screenshot 2025-06-03 033058
Screenshot 2025-06-03 033153
Screenshot 2025-06-03 033211
Screenshot 2025-06-03 033226

11. πŸ’° Admin – Payment Management

Screenshot 2025-06-03 033110

12. 🧾 Show Full Database

Screenshot 2025-06-03 042752


πŸ“ Project Structure

urbanclap-clone/
β”‚
β”œβ”€β”€ app.py
β”œβ”€β”€ config.py
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ templates/
β”œβ”€β”€ static/
β”‚   └── images/
└── SQL/

βš™οΈ Setup Instructions

  1. Clone the repo

    git clone https://github.com/your-username/urbanclap-clone.git
    cd urbanclap-clone
  2. Create virtual environment

    python -m venv venv
    source venv/bin/activate  # or venv\Scripts\activate on Windows
  3. Install dependencies

    pip install -r requirements.txt
  4. Setup MySQL

    • Create a DB named group-project-1
    • Import SQL files from the /SQL folder
  5. Run the app

    python app.py

πŸ” Tech Stack

  • Backend: Python (Flask), MySQL
  • Frontend: HTML, Bootstrap, Jinja2
  • Auth: Google OAuth via Authlib
  • Payments: Razorpay API
  • Charts: Chart.js

πŸ‘¨β€πŸ’» Author

  • Akshat Srivastava – Full Stack Developer

πŸ“ƒ License

This project is open-source and available under the MIT License.


πŸ’¬ Feedback

Feel free to open issues or submit pull requests. Contributions are welcome!