https://github.com/techysphinx/bharatkonnect

BharatKonnect is an innovative driver application designed specifically for the transportation and logistics industry. This app empowers drivers with real-time updates and a user-friendly interface, ensuring they stay informed throughout the entire delivery process.
https://github.com/techysphinx/bharatkonnect

google-maps-api postgressql react-native-app stripe tailwindcss twilio-api typescript

Last synced: 26 days ago
JSON representation

BharatKonnect is an innovative driver application designed specifically for the transportation and logistics industry. This app empowers drivers with real-time updates and a user-friendly interface, ensuring they stay informed throughout the entire delivery process.

• Host: GitHub
• URL: https://github.com/techysphinx/bharatkonnect
• Owner: techySPHINX
• License: other
• Created: 2024-11-14T13:17:32.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-12-24T08:01:00.000Z (4 months ago)
• Last Synced: 2025-02-10T15:23:33.408Z (3 months ago)
• Topics: google-maps-api, postgressql, react-native-app, stripe, tailwindcss, twilio-api, typescript
• Language: TypeScript
• Homepage:
• Size: 5.04 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.Md

Awesome Lists containing this project

README

        
# 🚀 **End-to-End Logistics Solution**

***"Driving Innovation, Delivering Excellence"***

An advanced **transportation and logistics platform** developed to optimize fleet management, dynamic routing, geofencing, labor allocation, and more for the **Department of Posts**. Built with cutting-edge technologies like **React Native**, **FastAPI**, **PostgreSQL**, and **Google Maps**, this solution revolutionizes the logistics landscape.

---

## 🌟 **Features**

### 1⃣ **Fleet Management**

- Real-time vehicle tracking and utilization.

- Live status updates of fleet movement and driver activity.

### 2⃣ **Dynamic Routing**

- AI-powered route optimization for efficient delivery.

- Adaptive scheduling based on traffic and delays.

### 3⃣ **Space & Labor Optimization**

- Intelligent packing and resource allocation for cost reduction.

- Real-time monitoring of available capacity.

### 4⃣ **Geofencing Integration**

- Location-based alerts for better shipment control.

- Ensures compliance with safety protocols.

### 5⃣ **Portal Management**

- A central dashboard for logistics operations.

- Visualizes data with charts, metrics, and real-time alerts.

### 6⃣ **Multi-Role Authentication**

- Secure authentication for drivers, admins, and stakeholders using **JWT** and **Clerk**.

- OTP-based login via **Twilio**.

### 7⃣ **Payment Integration**

- Seamless payment processing using **Stripe API** for logistics services.

---

## 🛠️ **Tech Stack**

### **Frontend**:

- **React Native (Expo)**: For building a robust and responsive driver app.

- **Typescript**: Strongly typed language for maintainable code.

- **Google Maps API**: For location visualization and geofencing.

### **Backend**:

- **FastAPI**: High-performance backend API development.

- **PostgreSQL**: Reliable and scalable database for logistics data.

### **Additional Integrations**:

- **Twilio**: OTP-based secure login and communication.

- **Stripe**: Payment gateway for secure transactions.

---

## 🗂️ **Project Structure**

### **Backend** (`FastAPI`):

```

app/

├── routes/        # API routes

├── db.py          # Database configuration

├── models.py      # ORM models

├── schemas.py     # Data validation schemas

├── utils.py       # Helper utilities

└── main.py        # Application entry point

```

### **Frontend** (`React Native with Expo`):

```

client/

├── src/

│   ├── app/

│   │   ├── tabs/        

│   │   ├── +not-found.tsx

│   │   └── _layout.tsx

│   ├── components/       # Reusable UI components

│   ├── constants/        # Configurations and constants

│   ├── context/          # Context API definitions

│   ├── hooks/            # Custom React hooks

│   ├── lib/              # Library-specific logic

│   ├── navigation/       # Navigation setup

│   ├── services/         # API services

│   └── utils/            # Helper utilities

├── app.tsx               # App entry point

├── app.json              # Expo configuration

├── index.tsx             # Main index file

├── tsconfig.json         # Typescript configuration

└── package.json          # Dependency management

```

---

## 🚀 **How to Run**

### 1⃣ **Clone the Repository**

```bash

git clone https://github.com/your-repo-link.git

cd your-repo-link

```

### 2⃣ **Setup Backend**

- Navigate to the `FastAPI` backend folder.

- Create a `.env` file with your environment variables (e.g., database URL, Twilio keys).

- Install dependencies:

  ```bash

  pip install -r requirements.txt

  ```

- Run the server:

  ```bash

  uvicorn main:app --reload

  ```

### 3⃣ **Setup Frontend**

- Navigate to the `React Native` frontend folder.

- Install dependencies:

  ```bash

  npm install

  ```

- Start the development server:

  ```bash

  npm start

  ```

---

## 🔙 **Key Screens in BharatKonnect**

---

### 🛃️ **GeoFence Management Page**  

📍 **GeoFence Screen**  

- Manage and update geofence areas for warehouses.  

- Ensure drivers pass through required geofences for better routing from source to destination.  

---

### 📊 **Admin Dashboard Page**  

📋 **Dashboard Screen**  

- Get real-time notifications for fleet management.  

- Generate **MIS Reports** and monitor **Driver Performance** efficiently.  

---

### 🏠 **Home/Explore Page**  

🗺️ **Live Geofencing Map**  

- Visualize fleet movement and coverage areas.  

- Optimize routes based on space utilization and time constraints.  

📦 **Shipping Dashboard**  

- Monitor **Total Tonnage**, **Remaining Capacity**, and **Expected Loads** for ongoing shipments.  

---

### 🚛 **Trips Page**  

📜 **Current and Past Trips**  

- View details of current trips, next halts, and previous trips.  

🛑 **Status Screen**  

- Update trip statuses such as:  

  - **✅ Delivered**, **⏳ Delayed**, **📍 In-Route**, or **🚫 Unavailable**.

---

### 🔔 **Monitoring & Alerts**  

⚠️ **Real-Time Notifications**  

- Get alerts for unexpected stops or delays.  

- Understand the reasons for delays via **Flash Notifications** and detailed insights.  

## 🏆 **Achievements**

- **Smart India Hackathon 2024** – **Runners-Up** under **PS 1753** by the Ministry of Communications.

- **Highly praised by industry experts** for innovation and execution.

---

***"This project isn’t just code—it’s a testament to our passion for innovation and problem-solving."***

**#ReactNative #FastAPI #PostgreSQL #LogisticsSolutions #Innovation #Stripe #Twilio #GoogleMaps #Typescript #HackathonProject**



### 𝚂𝚑𝚘𝚠 𝚜𝚘𝚖𝚎 ❤️ 𝚋𝚢 𝚜𝚝𝚊𝚛𝚛𝚒𝚗𝚐 this 𝚛𝚎𝚙𝚘𝚜𝚒𝚝𝚘𝚛y!