🚚 Walmart DFS Delivery Daily Operations App

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

---

📖 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:

---

---

🔐 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.*