📦 Project Overview

A full-stack Parcel Delivery Management System designed to handle parcel booking, tracking, and delivery with role-based access control (RBAC). This system provides separate dashboards for Admins, Senders, and Receivers, along with analytics and reporting for effective parcel management.

🚀 Features

🔹 Authentication & Roles

• Super Admin
• Full access to the system
• Manage all Admins and users
• Access to all analytics
• Admin
• Manage parcels (create, update, confirm, reject, cancel)
• Manage users (approve/block/verify)
• View analytics dashboard (parcels, users, senders)
• Sender
• Create new parcels
• Track own parcels
• View parcel history (delivered, pending, in transit, cancelled)
• Receiver
• Track incoming parcels
• Get real-time updates on parcel status
• User
• Can register/login
• Upgrade role to Sender/Receiver by Admin approval

📊 Analytics & Dashboards

• Parcel Analytics
• Total Parcels
• Delivered Parcels
• In-Transit Parcels
• Pending / Cancelled
• Monthly Shipment Trends (Bar Chart)
• Delivery Status Distribution (Pie Chart)
• User Analytics
• Total Users
• Verified Users
• Unverified Users
• Blocked Users
• Sender Analytics
• Total Parcels by Sender
• Monthly parcel creation stats
• Sender activity tracking

🛠️ Tech Stack

Backend

• Node.js + Express.js → REST API
• TypeScript → Type safety
• MongoDB + Mongoose → Database
• JWT Authentication → Secure login
• Role-based Access Middleware
• Multer + Cloudinary → File uploads (images/documents)
• Zod → Request validation

Frontend

• React + TypeScript
• Redux Toolkit + RTK Query → State management & API integration
• TailwindCSS + ShadCN UI → Styling & UI components
• Lucide React Icons → Dashboard icons
• React Hook Form + Zod → Form handling & validation
• Recharts → Data visualization (Bar/Pie charts)

Deployment

• Backend → Vercel (Express server with MongoDB Atlas)
• Frontend → Vercel (React app)
• Cloudinary → File & image hosting

🔐 Access Control

Role Permissions

Super Admin: Manage all admins & users, full analytics

Admin: Manage parcels, approve users, analytics

Sender: Create parcels, view & track own parcels

Receiver:Track incoming parcels

📡 API Highlights

• Authentication → Register, Login, Logout with cookies & JWT
• User Management → Create, Update, Block, Verify users
• Parcel Management → Create, Update status, Cancel, Track parcels
• Analytics APIs → User analytics, Parcel analytics, Sender analytics
• File Upload → Cloudinary integration with dynamic folder support

📝 Key Highlights

• Secure role-based access system
• Real-time parcel tracking
• Dynamic analytics dashboards for Admins & Super Admins
• Cloudinary integration with dynamic folder uploads
• Fully deployed and integrated frontend + backend

🔑 Demo Credentials

You can test the platform using these sample accounts:

• Admin → private:
• Sender → Email: sender@gmail.com | Password: S@12345678
• Receiver → Email: receiver@gmail.com | Password: R@12345678