Skip to content

OmAmar106/Household-Services-Application-23f2002152

Repository files navigation

Household Services Application

📋 Overview

The Household Services Application is a scalable platform designed to connect users with service providers for various household needs. It provides a seamless experience for users to browse, book, and manage household services such as plumbing, electrical repairs, cleaning, and more.


Note : The vercel version might not work as expected since vercel does not support Celery and Redis.


✨ Features

  • User-Friendly Interface: Simple navigation for users to find and book services easily.
  • Service Interface: You may login as a Service Provider and provide services to other users.
  • Customer Interface: You may login as a Customer and request for services from Service Providers.
  • Notifications: Email notifications for confirmation and reminders.
  • Admin Dashboard: Manage users, services, and bookings efficiently and view site stats.
  • Backend Jobs: Integrated Features such as export in csv, email notifications, etc. as a part of the backend jobs through Celery, Redis and MailHog.

🛠️ Technologies Used

Frontend:

  • Vue.js
  • HTML5 & CSS3
  • JavaScript

Backend:

  • Flask
  • Flask Security
  • Flask Caching
  • Celery Module
  • SQLAlchemy

Database:

  • SQLite

Other Tools:

  • Redis
  • Celery
  • MailHog

🚀 How to Run the Project

Prerequisites

  • Python 3.11 or above
  • Linux

Steps

  1. Clone the repository:

    >> git clone https://github.com/OmAmar106/Household-Services-Application-23f2002152.git
    >> cd Household-Services-Application-23f2002152
  2. Create a Virtual Environment:

    >> python3 -m venv venv
    >> source venv/bin/activate
  3. Installing the Modules:

    >> pip3 install requirements.txt
  4. Installing Other Dependencies:

    >> sudo apt install redis-server
    >> sudo apt-get -y install golang-go
    >> go install github.com/mailhog/MailHog@latest
  5. Running Other Dependencies:

    >> ~/go/bin/MailHog
    >> redis-server --port 6380
    >> celery -A app.cel worker -l INFO
    >> celery -A app.cel beat -l INFO
  6. Running the Python App:

    >> python app.py

Screenshots

Screenshot 2024-11-26 183405

Screenshot 2024-11-26 183439

Screenshot 2024-11-26 183455

Screenshot 2024-11-26 183514

About

This repository consists of MAD-II Project by 23f2002152.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published