Skip to content

README.md

Latest commit

 

History

History
176 lines (129 loc) · 5.41 KB

README.md

File metadata and controls

176 lines (129 loc) · 5.41 KB

🚚 Walmart DFS Delivery Daily Operations App

📦 Logistics Automation System for Walmart's Daily Delivery Fulfillment Operations

Python FastAPI PostgreSQL Docker React Native Expo AWS Postman GitHub

📖 Overview

The Walmart DFS Delivery Daily Operations App is an end-to-end logistics workflow system that automates daily Walmart DFS (Delivery Fulfillment Services) operations.

It replaces manual sorting, scanning, driver assignment, and dispatch processes with a fast, accurate, real-time digital system.

This project includes:

  • 📤 Manifest ingestion from Walmart PDFs
  • 🔍 Parcel barcode scanning
  • 📦 Batch creation & completion tracking
  • 🧑‍✈️ Driver management & route assignment
  • 📊 Real-time operational insights
  • 🔐 Secure login with OTP & JWT authentication
  • 🚚 Daily dispatch workflow automation

Designed for simplicity, zero human error, and high-speed operations.

🧭 System Architecture

         ┌────────────────────────┐
         │   React Native App     │
         │  (Expo, SecureStore)   │
         │ Barcode Scan, UI, Auth │
         └───────────┬────────────┘
                     │
                 REST API
                     │
         ┌───────────▼────────────┐
         │       FastAPI          │
         │  Auth • Orders • Scan  │
         └───────────┬────────────┘
                     │
                SQLAlchemy ORM
                     │
         ┌───────────▼────────────┐
         │       PostgreSQL       │
         │ dfs.orders, drivers…   │
         └────────────────────────┘

✨ Key Features

📤 Manifest Processing

  • PDF upload → auto extract → insert into dfs.orders
  • Deduplication
  • Full ingestion logs

🔍 Intelligent Scanning

  • Detect duplicates
  • Validate staging zone
  • Track last scanned item
  • Auto move to batch_status when completed

🧑‍✈️ Driver Management

  • Add, update, delete
  • Assign batches
  • Track status in real time

🔐 Authentication

  • OTP signup
  • JWT login
  • Role-based access

📊 Reporting

  • Staging accuracy
  • Driver performance
  • Missing parcels
  • Daily KPI metrics

📂 Project Structure

Here is the organizational structure of the Walmart DFS Delivery Daily Operations App:

Project Structure

🔐 Authentication Flow

  1. User sends signup request → OTP email sent
  2. User verifies OTP → account activated
  3. User logs in → JWT token returned
  4. All protected routes require Authorization: Bearer <token>

📄 API Endpoints

🔐 Auth

Method Route Description
POST /api/auth/signup-request Send OTP
POST /api/auth/verify-otp Verify OTP
POST /api/auth/login Login

📤 Manifest / Orders

Method Route Description
POST /api/upload-pdf Upload Walmart PDF
GET /api/orders List all orders
GET /api/orders/{tracking_id} Get order
DELETE /api/orders/{tracking_id} Delete

🔍 Batch Scanning

Method Route Description
POST /api/scan Scan parcel
GET /api/batch-status Check batch completion

🧑‍✈️ Drivers

Method Route Description
POST /api/drivers Add new driver
GET /api/drivers List drivers
DELETE /api/drivers/{id} Remove driver

🛢 Database Schema

Core Tables

  • dfs.orders
  • dfs.batch_scans
  • dfs.batch_status
  • dfs.drivers
  • dfs.ingest_log
  • dfs.users
  • dfs.user_activity_log
## 👥 Developers – Walmart DFS Delivery Daily Operations App

### **Rushiraj (Krish) Pathak**
- 📱 +1 (437) 439-2998  
- 🧑‍💻 GitHub: https://github.com/RushirajPathak  
- 🔗 LinkedIn: https://www.linkedin.com/in/krish-naynil-pathak/  

---

### **Karambir Sharma**
- 📱 +1 (437) 660-1139  
- 🧑‍💻 GitHub: https://github.com/karambirsharma08  
- 🔗 LinkedIn: https://www.linkedin.com/in/karambir-sharma-318550305/  
 

---

> 🚀 *This system was collaboratively engineered by a two-person development team using industry-level architecture, CI/CD practices, strong database design, and high-performance mobile workflows.*