Skip to content

QuickQuest is a cutting-edge platform that connects customers with laborers based on location and service needs. Utilizing MongoDB for precise geospatial queries and incorporating a real-time chat feature via Server-Sent Events (SSE), it enables seamless communications and negotiations.Using RecommendationEngine for personalized recommendations

License

Notifications You must be signed in to change notification settings

DFanso/QuickQuest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QuickQuest: Streamlining Gig Economy Connections

Banner

QuickQuest is a cutting-edge platform that connects customers with laborers based on location and service needs. It enables seamless communications and negotiations by utilizing MongoDB for precise geospatial queries and incorporating a real-time chat feature via Server-Sent Events (SSE). Laborers can send tailored bids with service details and pricing, while a recommendation engine, powered by Python and machine learning, enhances match accuracy. Transactions are secure, and facilitated by PayPal, with Brevo managing notification emails. QuickQuest ensures laborers receive 90% of earnings, with a minimal platform commission of 8%. The platform spans three responsive frontends for different user roles, built with Next.js and Tailwind CSS, and integrates AWS Cognito for robust authentication. Deployments are handled via Vercel and Ubuntu VPS, ensuring reliability and scalability.

User Guide

System Requirements: To run QuickQuest, ensure that your system meets the following minimum requirements:

  • Operating System: Windows 10, macOS 10.15+, or Linux (Ubuntu 18.04+, Debian 10+, or equivalent)
  • Node.js version 20 +
  • Python 3.11 +
  • Processor: Intel Core i3 or equivalent
  • RAM: 4 GB
  • Storage: 10 GB of free disk space
  • Web Browser: Google Chrome (latest version), Mozilla Firefox (latest version), or Microsoft Edge (latest version)

🛠️ Installation:

  1. Clone the QuickQuest repository from GitHub:

    git clone <https://github.com/DFanso/QuickQuest.git>
    
    
  2. Navigate to the project directory:

    cd QuickQuest
    
    
  3. Install dependencies for the Next.js applications (Admin, Customer, Worker):

    cd admin
    npm install
    
    cd customer
    npm install
    
    cd worker
    npm install
    
    
  4. Install dependencies for the Nest.js API:

    cd API
    npm install
    
    
  5. Install dependencies for the FastAPI Recommender Engine:

    cd RecommenderEngine
    pip install -r requirements.txt
    
    
  6. Set up environment variables:

    • For Next.js applications (Admin, Customer, Worker), create a .env.local file in each respective directory.
    NEXT_PUBLIC_LOCATIONIQ_API_KEY=
    NEXT_PUBLIC_BASE_API_URL=
    NEXT_PUBLIC_MAP_API_KEY=
    • For the Nest.js API, create a .env file in the api directory.
    MONGO_URI=
    AWS_REGION=
    AWS_BUCKET_NAME=
    AWS_ACCESS_KEY_ID=
    AWS_SECRET_ACCESS_KEY=
    COGNITO_USER_POOL_ID=
    COGNITO_CLIENT_ID=
    COGNITO_CLIENT_SECRET=
    PAYPAL_CLIENT_ID=
    PAYPAL_CLIENT_SECRET=
    PAYPAL_REDIRECT_URI=
    FRONTEND_URL=http://localhost:3000
    BREVO_SMTP=smtp-relay.brevo.com
    BREVO_SMTP_PORT=
    BREVO_USER=
    BREVO_PASS=
    EMAIL_FROM_ADDRESS=
    COGNITO_CALLBACK_URL=
    COGNITO_DOMAIN=
    RECOMMENDATION_ENGINE_API=
    • For the Python RecommenderEngine, create a .env file in the RecommenderEngine directory.
    MONGODB_CONNECTION_STRING=
  7. Build the Next.js applications:

    cd admin
    npm run build
    
    cd customer
    npm run build
    
    cd worker
    npm run build
    
    
  8. Start the applications:

    • Next.js applications (Admin, Customer, Worker):

      cd admin
      npm start
      
      cd customer
      npm start
      
      cd worker
      npm start
      
      
    • Nest.js API:

      cd API
      npm run dev
      
      
    • FastAPI Recommender Engine:

      cd RecommenderEngine
      uvicorn main:app --reload
      
      
  9. Access the applications:

    • Admin: http://localhost:3002
    • Customer: http://localhost:3000
    • Worker: http://localhost:3001
    • API: http://localhost:9000/v1
    • Recommender Engine: http://localhost:5000
    • API Documentation (Swagger): http://localhost:9000/api (username: admin, password: admin)

Usage:

  1. Admin Application:
    • Open the Admin application in your web browser.
    • Log in using the admin credentials.
    • Manage services, and categories.
    • Monitor Orders revenues and charts.
  2. Customer Application:
    • Open the Customer application in your web browser.
    • Sign up or log in to your customer account.
    • Search for services using keywords, filters, and categories.
    • View service details, provider profiles, and ratings.
    • Create own Bids to your budget and preference
    • Chat with Workers
    • Book services and make payments through the integrated PayPal gateway.
    • Rate and review Jobs after completion.
  3. Worker Application:
    • Open the Worker application in your web browser.
    • Sign up or log in to your worker account.
    • View Bids from Customers
    • Create and manage your service listings.
    • Set your availability and pricing.
    • Send Offer to Customers.
    • Communicate with customers using the in-app messaging system.
  4. API:
    • The API serves as the backend for the QuickQuest platform.
    • It handles data storage, retrieval, and manipulation.
    • The API endpoints are consumed by the frontend applications (Admin, Customer, Worker) to fetch and update data.
  5. Recommender Engine:
    • The Recommender Engine uses machine learning algorithms to provide personalized service recommendations to customers.
    • It analyzes user preferences, booking history, and service ratings to generate relevant suggestions.
    • The Recommender Engine is integrated with the API to fetch data and update recommendations in real-time.
  6. API Documentation (Swagger):
    • Access the API documentation by opening http://localhost:9000/api in your web browser.
    • Log in using the provided credentials (username: admin, password: admin).
    • Explore the available API endpoints, request/response formats, and authentication requirements.
    • Test and interact with the API endpoints directly through the Swagger interface.

About

QuickQuest is a cutting-edge platform that connects customers with laborers based on location and service needs. Utilizing MongoDB for precise geospatial queries and incorporating a real-time chat feature via Server-Sent Events (SSE), it enables seamless communications and negotiations.Using RecommendationEngine for personalized recommendations

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published