PAWsitive

Visit and Support us at - www.bepawsitive.xyz

Project Inspiration

The inspiration for PAWsitive came from the need to create a centralized platform that connects pet owners with essential services such as blood donors, veterinary clinics, and rescue centers. Our goal is to ensure the well-being of pets by making it easier for their owners to find and access the necessary resources.

Project Description

PAWsitive is a comprehensive web application designed to help pet owners find blood donors, veterinary clinics, and rescue centers with ease. The platform features:

Blood Donors Directory: Search and filter blood donors based on specific criteria.
Veterinary Clinics Locator: Find nearby veterinary clinics and get detailed information about their services.
Rescue Centers Directory: Access a directory of rescue centers with information on ambulance services.
Registration Portals: Register as a blood donor, veterinary clinic, rescue center, or event host.
Spotlight Section: Highlight ongoing projects and campaigns to encourage community participation.
Voice Assistant Section: Provide customer support and educational resources for pet owners through voice assistant calls powered by Callchimp.AI.
Fully Customized AI Chatbot: Gemini powered AI chatbot to tackle all animal-related queries of users and provide customized answers through puns for other doubts.

Tech Stacks Used

React: For building the user interface.
Next.js: For server-side rendering and building static websites.
TypeScript: For static type checking to improve code quality.
MongoDB: For the database to store and retrieve data.
Tailwind CSS: For styling the application with a dark theme.
Node.js: For backend development and handling server-side operations.

Third-Party Technologies Used

Kinde Authentication Service

For user authentication using OTP, login, and signup.

UploadThing

To upload images of certificates for dog vaccination certificate status.

Callchimp.ai

To integrate a calling service that tackles user doubts related to pet-related queries. The architecture of the API Calls is explained below.

Integration Steps:

Authentication:
```
const apiKey = 'your-api-key';
```

Create Supervisor:

callchimp.createSupervisor({
  name: 'Supervisor Name'
}).then(response => {
  // Handle create supervisor response
});

Send OTP to Supervisor by ID:

callchimp.sendOtpToSupervisor({
  supervisorId: 'supervisor-id'
}).then(response => {
  // Handle OTP sent response
});

Verify Supervisor OTP by ID:

callchimp.verifySupervisorOtp({
  supervisorId: 'supervisor-id',
  otp: '123456'
}).then(response => {
  // Handle verified response
});

List Subscribers:

callchimp.listSubscribers().then(response => {
  // Handle list subscribers response
});

Create Call:

callchimp.createCall({
  leadId: 'lead-id'
}).then(response => {
  // Handle create call response
});

Gemini API

To create a custom chatbot for solving animal-related user queries.

.xyz Domain

To host the Website on a custom domain name.

How to Start and Run the Project

Follow these steps to start and run the PAWsitive project locally:

Clone the repository:

git clone https://github.com/Parthiba-Mukhopadhyay/BongO.n

Navigate into the project directory:
```
cd BongO.n
```
Create a .env.local file: Add your API keys for Kinde Auth, Next.js, MongoDB, Gemini, and UploadThing in the .env.local file.
Install dependencies:
```
npm install
```
Run the development server:
```
npm run dev
```
Open your browser: Navigate to http://localhost:3000 to see the application running.

Walkthrough of the Project

Here are the steps to navigate through the PAWsitive application:

Landing Page: The homepage of the PAWsitive application.

Login/Sign Up: Authenticate users via Kinde for secure access.
Dashboard: The main interface with access to all features.

Spotlight Section: Highlight ongoing projects and campaigns.
Call Support: Access voice assistant support powered by Callchimp.AI.

Services:
- View Donors: Search and filter through blood donors.
- View Veterinary Clinics: Locate nearby veterinary clinics.
- View Rescue Centers: Find rescue centers and ambulance services.

Collaborations:
- Register as Donor: Sign up as a blood donor.
- Register as Vet Clinic: Register a veterinary clinic.
- Register as Rescue Center: Enroll a rescue center.
- Register Events and Campaigns: Organize events and campaigns.

AI Chatbot: Use the Gemini-powered chatbot for animal-related queries.

Detailed Working of the Project

For a comprehensive understanding of how the PAWsitive project works, you can watch our video walkthrough on youtube:

Watch the Detailed Video Walkthrough

Team

Parthiba Mukhopadhyay: Full Stack Developer
Mainak Chattopadhyay: Full Stack Developer
Aritro Saha: Full Stack Developer

halcyon-past/PAW-sitive