A complete logistics management system for tracking packages across countries with partial payments, receipts, and admin dashboards.
# ShipSync-Africa
A complete logistics management system for tracking packages across countries with partial payments, receipts, and admin dashboards.
# 📦 Multi-Country Logistics & Package Tracking System
A full-featured **logistics and parcel delivery management system** built with **PHP (MySQLi), HTML, CSS, and JavaScript**.
This system is designed to manage package delivery across multiple countries with support for payments, receipts, tracking, and reporting.
---
## 🌍 Features
* 📦 Package registration and tracking
* 🌎 Multi-country support (Kenya, Tanzania, Congo, Uganda)
* 💰 Automatic pricing based on weight
* 💳 Full & partial payment handling
* 🧾 Thermal-style receipt generation and printing
* 📸 Image upload for package verification
* 🔄 Real-time package status tracking
* 👥 Role-based dashboards:
* Super Admin
* Country Admin
* 📊 Reports and analytics per country and global
---
## 🔐 User Roles
### 🧑✈️ Super Admin
* Manage countries and pricing
* View all packages
* Access global reports and revenue
### 🌍 Country Admin
* Register and manage packages
* Confirm arrival and pickup
* Upload proof images
* View country-specific reports
---
## 🔄 Package Workflow
1. Package registration
2. Payment (full or partial)
3. In transit
4. Arrival confirmation
5. Ready for pickup
6. Pickup confirmation
---
## 🧾 Receipt System
* Automatically generated after package registration
* Includes payment details and balance
* Printable in small thermal format
---
## 📸 Image Proof System
* Upload package images
* Delivery confirmation photos
* Pickup verification
---
## 🛠️ Technologies Used
* PHP (MySQLi)
* MySQL
* HTML5
* CSS3
* JavaScript
---
## 🚀 Project Goal
To provide a **real-world logistics management solution** for handling cross-country package delivery with tracking, payments, and reporting.
---
## 📌 Status
🚧 completed