FleetTrack - Laravel Logistics Tracking and Management System

FleetTrack is a complete logistics and shipment tracking platform built with Laravel 12 and PHP 8.x. It helps businesses manage shipments, monitor delivery workflows, and run logistics operations from a centralized dashboard.

Demo Access / Login Details

• Admin Panel URL: https://zedoski.name.ng/logistic/admin
• Admin Login: username: admin | password: Vincentdepaul1234
• Customer Login URL: https://zedoski.name.ng/logistic/login (register from frontend or create from admin panel)
• Agent Panel URL: https://zedoski.name.ng/logistic/login
• Agent Login: agent code: AGT-2025-EGF31N | password: Vincentdepaul@1234
• Staff Panel URL: https://zedoski.name.ng/logistic/login
• Finance Staff Login: email: [email protected] | password: Vincentdepaul@1234
• Dispatcher Staff Login: email: [email protected] | password: Vincentdepaul@1234
• Warehouse Staff Login: email: [email protected] | password: Vincentdepaul@1234
• Manager Staff Login: email: [email protected] | password: Vincentdepaul@1234
• Developer Portal URL: https://zedoski.name.ng/logistic/developers/login (developer access is managed by admin workflow)
• Public Shipment Tracking: https://zedoski.name.ng/logistic/track

Note: In production, change all demo credentials immediately after purchase and first login.

Main Features

• Shipment and logistics tracking workflows
• Admin dashboard, analytics, and reporting
• Role-based access for admin, staff, and agents
• Queue-ready architecture for background jobs
• Email configuration support (SMTP and third-party providers)
• Optional social login integrations (Google, GitHub, Facebook)
• Optional translation integrations (LibreTranslate / DeepL)
• Optional storage integrations (local, S3-compatible, FTP/SFTP, DigitalOcean Spaces)
• Modular Laravel architecture for easy extension

Technical Details

• Framework: Laravel 12
• PHP Version: 8.2+
• Database: MySQL 8+
• Frontend Tooling: Vite, Bootstrap 5, Tailwind CSS

Installation

1. Upload files to your server
2. Run composer install
3. Run npm install and npm run build
4. Create and configure .env
5. Run php artisan key:generate
6. Run php artisan migrate

Detailed setup instructions are included in the documentation file.

• Real-time shipment tracking with live status updates
• Fleet management including driver assignment & route optimization
• Warehouse & inventory management for organized operations
• Finance & revenue analytics with detailed reporting
• Role-based dashboards for Admin, Dispatcher, Agent, Finance & Warehouse
• Responsive design accessible on all devices
• Secure and scalable Laravel-based architecture

Requirements

• PHP Version: >= 8.2
• Laravel Framework: 8.x or higher recommended
• Database: MySQL 5.x or higher
• Web Server: Apache or Nginx
• Composer installed

Required PHP Extensions:

• PDO
• OpenSSL
• Mbstring
• Fileinfo
• Tokenizer
• XML
• GMP
• CURL
• GD
• Zip
• JSON

Folder Permissions:

• config/ must be writable
• storage/ must be writable

Note: FleetTrack performs automatic checks during installation to ensure all requirements are met before running.

1. Upload the .zip project files to your server.
2. Open your browser and navigate to https://your-project-url/install. The Installation Wizard will guide you through the setup.
3. Enter your database credentials and other required settings in the wizard.
4. Create your Admin account: During installation, you will be prompted to set up a new Admin login and password. This ensures your system is secure and personalized. ###li/li###
5. Access dashboards for each role (Dispatcher, Agent, Finance, Warehouse) using the default demo credentials.
6. Optionally, customize settings, reports, and routes after installation.
7. Preview your installation: FleetTrack Demo to see the dashboards in action.

Note: The installation wizard ensures all server requirements are met and configures the system automatically, making setup simple, secure, and ready for production.