Vipreshana 🚚

   

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Pull Requests

---

🚀 Project Overview

Vipreshana is a real-time delivery and complaint tracking platform that enables users and administrators to monitor service status, manage issues, and ensure transparency across the delivery lifecycle. With live location tracking, complaint resolution workflow, and SMS notifications, the platform is aimed at transforming operational efficiency and enhancing user trust.

---

📑 Table of Contents

• 💡 Problem Statement

• ✅ Proposed Solution

• 🔧 Tech Stack

• ✨ Features

• 📦 Local Setup

  • 🍴 1. Fork & Clone the Repository

• 📄 License

💡 Problem Statement

Organizations and users often face challenges in tracking service requests, deliveries, and complaint resolutions. Lack of transparency, delayed updates, and manual tracking lead to dissatisfaction and inefficiency.

---

✅ Proposed Solution

Vipreshana solves this by enabling:

• Live delivery/complaint status tracking via location APIs.
• Real-time SMS alerts using Twilio.
• Role-based dashboards for Users,Drivers, and Admins.
• A complete end-to-end resolution lifecycle with automated updates.

---

🔧 Tech Stack

---

✨ Features

• 📍 Live Location Tracking of deliveries and issue status
• 🧑‍💻 Role-based Portals: Separate dashboards for users and officers
• 📲 SMS Notifications for status updates
• 📊 Admin Dashboard to view, assign, and resolve issues

---

📦 Local Setup

Want to run Vipreshana locally and contribute? Follow these simple steps! 🚀✨

🍴 1. Fork & Clone the Repository

First, fork the repository to your GitHub account. Then, open your terminal and run:

# Clone your forked repo
git clone https://github.com/<your-username>/Vipreshana.git

# Move into the project directory
cd Vipreshana

# Install Frontend Dependencies
npm install

# Move to server directory and install backend dependencies
cd server
npm install

# Add .env file
cp .example.env .env

# Then open .env and add the following credentials
MONGO_CONNECTION_STRING=your_mongo_connection_string
TWILIO_ACCOUNT_SID=your_twilio_account_sid
TWILIO_AUTH_TOKEN=your_twilio_auth_token
TWILIO_PHONE_NUMBER=your_twilio_phone_number
PORT=5000

# From the root directory [For frontend]
npm start

# From the root directory [For backend]
cd server
npm run dev


# Visit the app at:
http://localhost:3000/ 

# Backend server runs on
http://localhost:5000/

---

📄 License

This project is licensed under the MIT License

---