š¦ 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