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