Smart Parcel Tracking System

A full-stack web application for parcel tracking in a logistics system using QR codes.
It supports three user roles: *Sender, **Handler, and *Admin to create, update, and monitor parcels securely and efficiently.

---

Table of Contents

• Project Overview
• Features
• Tech Stack
• Database
• Frontend Dependencies
• Backend Dependencies
• Setup Instructions
• Screenshots

---

Project Overview

• Parcel tracking system with QR code integration.
• Three user roles:
  • Sender: Creates parcels and generates QR codes.
  • Handler: Scans QR codes and updates parcel status.
  • Admin: Manages users, parcels, tamper alerts, and analytics.
• Automated tamper detection to flag suspicious parcel status updates.
• Map-based route visualization and interactive dashboards.

---

Features

• Parcel Lifecycle Tracking

  • Parcel statuses:
    • Received
    • Packed
    • Shipping
    • Out for Delivery
    • Delivered
  • QR code generation and scanning for parcels.

• Tamper Detection

  • Flags skipped steps or very rapid status changes (less than 1 hour).
  • Alerts displayed prominently on Admin Dashboard.

• Admin Dashboard

  • Manage users and parcels.
  • View tamper alerts and analytics charts.
  • Route tracking on maps (using Leaflet).

• User Profiles

  • Role-based dashboards.
  • Editable avatar, banner, and personal info.
  • Password reset and change functionalities.

• Security

  • JWT-based authentication.
  • Protected API routes.

---

Tech Stack

• Frontend:

  • React.js
  • Tailwind CSS
  • Leaflet (maps)
  • Chart.js (data visualization)
  • HTML5 QR code scanner

• Backend:

  • .NET Core (C#)
  • Entity Framework Core
  • MySQL
  • JWT Authentication

• Testing Tools:

  • Postman
  • JMeter
  • Jira
  • Zephyr

---

Database

• Database Used: MySQL
• Schema Includes:
  • Tables for users, parcels, parcel status history, tamper alerts, and roles.
  • Relationships:
    • Users linked to parcels (Sender and Handler).
    • Parcel status changes logged with timestamps.
    • Tamper alerts linked to parcels with detailed info.
• Setup Notes:
  • Import provided SQL schema or run migrations (if applicable).
  • Update connection string in backend appsettings.json.

---

Frontend Dependencies

Use npm install to add these packages inside the frontend folder.

• Core Libraries

  • react, react-dom: React framework core
  • react-router-dom: Routing and navigation

• Styling

  • tailwindcss, postcss, autoprefixer: Styling and CSS processing
  • flowbite: UI components library
  • @heroicons/react, lucide-react, react-icons: Icons

• HTTP & State

  • axios: HTTP client for API requests

• QR & Maps

  • html5-qrcode: QR code scanning in browser
  • leaflet, react-leaflet: Map rendering and interactivity

• Data Visualization

  • chart.js, react-chartjs-2: Charts and graphs

• Animations & Effects

  • framer-motion, gsap: Animations and transitions

• Notifications

  • react-hot-toast, react-toastify: Toast notifications

---

Backend Dependencies

Use .NET CLI commands to install these packages in the backend project.

• Microsoft.AspNetCore.Authentication.JwtBearer
  Adds JWT authentication for API security.

• Microsoft.EntityFrameworkCore
  Entity Framework Core ORM for database operations.

• Microsoft.EntityFrameworkCore.Design
  Tools for database migrations.

• Microsoft.EntityFrameworkCore.SqlServer
  SQL Server database provider (used alongside MySQL if needed).

• QRCoder
  Generates QR codes server-side.

• BCrypt.Net-Next
  Password hashing for secure user credentials.

• Swashbuckle.AspNetCore
  Adds Swagger UI for API documentation.

---

Setup Instructions

Frontend

1. Go to frontend folder:

   cd frontend
   

2. Install dependencies:

npm install

3. Run development server:

npm start

---

Backend

1. Go to backend folder:

cd backend

2. Restore packages:

dotnet restore

3. Build the project:

dotnet build

4. Run the project:

dotnet run

---

Database

Install and run MySQL server.

Import the SQL schema file provided (if available):

mysql -u username -p database_name < schema.sql

Update your database connection string in appsettings.json (backend).

---

Screenshots

Sender Dashboard — Parcel creation with QR code

Handler Dashboard — QR code scanner and status update

Admin Dashboard — Parcel list, tamper alerts, and analytics charts

Map view showing parcel routes

Profile page with editable avatar and personal details

---