Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Courier Management System

Courier Management System is a ready-to-run student project generated from the management template. It includes frontend, backend, database, Docker setup, Swagger API docs, demo login, seed data, screenshots, viva questions, project report content, and presentation material.

Project Category: Web Application.

This project can be used as a minor project or upgraded into a final-year major/enterprise project with custom modules, new UI, advanced reports, role permissions, payment/export modules, and complete college submission documentation.

Features

  • HTML + Tailwind frontend with protected dashboard
  • Laravel backend REST API
  • PostgreSQL database
  • Docker Compose run system
  • Swagger API documentation
  • Demo admin login
  • CRUD modules
  • Dashboard statistics
  • Reports and CSV export
  • Audit log
  • Seed data
  • Student documentation pack
  • Browser-tested demo screenshots
  • Upgrade-ready custom UI design

Project Modules

Courier Vehicles, Courier Drivers, Courier Routes, Courier Shipments, Courier Trips

Tech Stack

  • Frontend: HTML + Tailwind
  • Backend: Laravel
  • Database: PostgreSQL
  • API Docs: Swagger
  • Runtime: Docker Compose

Demo Login

Email: admin@example.com
Password: Admin@123

Run Locally

Prerequisites

Install these tools first:

  • Git
  • Docker Desktop
  • Node.js 20 or newer

Steps

git clone <your-repo-url>
cd courier-management-system
cd backend
cp .env.example .env
docker compose up --build

Open:

Frontend: http://localhost:13000
Backend API: http://localhost:18080/api
Swagger Docs: http://localhost:18080/api/docs
Health Check: http://localhost:18080/api/health

Stop the project:

cd backend
docker compose down

Reset database and seed again:

cd backend
docker compose down -v
docker compose up --build

Change Master Login Email And Password

Before the first run, edit:

backend/config/seed.json

Change this section:

{
  "admin": {
    "email": "admin@example.com",
    "password": "Admin@123",
    "displayName": "System Admin",
    "role": "admin"
  }
}

Then run:

cd backend
docker compose up --build

If you already ran the project once, reset the database so the new admin user is seeded:

cd backend
docker compose down -v
docker compose up --build

Student Submission Docs

Generated documentation is available in:

docs/

Important files:

  • SYNOPSIS.md
  • ABSTRACT.md
  • PROJECT-REPORT.md
  • MAJOR-PROJECT.md
  • PRESENTATION-CONTENT.md
  • PRESENTATION.pptx
  • VIVA-QUESTIONS.md
  • TEST-CASES.md
  • ER-DIAGRAM.md
  • UML-DIAGRAMS.md
  • SCREENSHOTS-CHECKLIST.md
  • screenshots/
  • diagrams/

Screenshots

Demo screenshots are stored in:

docs/screenshots/

Typical screenshots include login page, dashboard, list pages, forms, reports, audit log, and Swagger docs.

Promotional Upgrade Options

Want this project upgraded so it does not look like a common downloaded project?

Available upgrades:

  • Convert minor project to major project
  • Convert major project to enterprise-level project
  • Change complete UI theme and layout
  • Add unique vector images based on your project topic
  • Make the project look fresh and different from common downloaded projects
  • Add project-specific modules
  • Add advanced dashboard analytics
  • Add role-based permissions
  • Add PDF/Excel export
  • Add payment, email, SMS, or notification modules
  • Add custom report, synopsis, PPT, viva, and screenshots
  • Prepare a complete college submission package

Contact And Community

For upgrades and customization, contact CSEProjects360:

WhatsApp: +91 78914 45668
Website: CSEProjects360

Send WhatsApp Message

Visit CSEProjects360

Scan to message on WhatsApp:

WhatsApp QR Code

Community links:

  • WhatsApp Group: request the latest group invite on WhatsApp.
  • WhatsApp Channel: request the latest channel link on WhatsApp.
  • Telegram Group: request the latest group invite on WhatsApp.
  • Telegram Channel: request the latest channel link on WhatsApp.

Why Customize?

Many student projects look the same because they use the same template, same colors, same dashboard, and same module names. This project factory supports domain-specific modules, configurable design templates, vector illustrations, documentation, and screenshots so your project can look original and presentation-ready.

Notes

  • Change demo credentials before submission.
  • Do not commit real API keys or production passwords.
  • Use Docker Compose for the easiest local setup.
  • If ports are busy, update backend/.env and run again.

Domain-Specific Project Details

A student-ready courier management generated from the management template with domain modules, seed data, reports, Swagger docs, Docker support, screenshots, viva questions, PPT content, and submission documentation.

Target Users

  • Fleet Admin
  • Dispatcher
  • Driver Manager
  • Operations Manager

Domain Modules

  • Courier Vehicles: Courier Vehicle Code, Courier Vehicle Name, Courier Category, Transport & Logistics Management Owner, Courier Vehicle Status, Courier Vehicle Number, Courier Vehicle Type, Courier Fuel Level
  • Courier Drivers: Courier Driver Code, Courier Driver Name, Courier Category, Transport & Logistics Management Owner, Courier Driver Status, Courier Driver Code, Courier License Number, Courier Phone Number
  • Courier Routes: Courier Route Code, Courier Route Name, Courier Category, Transport & Logistics Management Owner, Courier Route Status, Courier Route Code, Courier Origin, Courier Destination
  • Courier Shipments: Courier Shipment Code, Courier Shipment Name, Courier Category, Transport & Logistics Management Owner, Courier Shipment Status, Courier Shipment Number, Courier Weight, Courier Delivery Status
  • Courier Trips: Courier Trip Code, Courier Trip Name, Courier Category, Transport & Logistics Management Owner, Courier Trip Status, Courier Trip Number, Courier Trip Date, Courier Distance

Workflows

  • Dispatch Vehicle: Select Shipment -> Assign Vehicle -> Assign Driver -> Start Trip
  • Track Shipment: Open Shipment -> Update Location -> Check Delay -> Notify Customer
  • Close Trip: Verify Delivery -> Record Fuel -> Capture Toll -> Close Trip

Demo Use Cases

  • Manage courier vehicles for Courier Management
  • Track courier drivers and operational ownership
  • Run dispatch vehicle workflow
  • Generate courier reports and audit history

Problem Statement

Courier Management needs a focused system for courier vehicles, courier drivers, courier routes, courier shipments, workflows, reports, and audit visibility instead of manual spreadsheets.

Learning Outcomes

  • Courier Management domain modelling
  • Transport & Logistics Management CRUD and dashboard design
  • Courier workflow automation
  • Student-ready documentation, screenshots, and Docker deployment

About

Courier Management System generated with HTML + Tailwind + Laravel, PostgreSQL, realistic seed data, verified Docker setup, Swagger API, docs, and screenshots.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages