FuelMaster - Petrol Pump Management System

FuelMaster – Petrol Pump Management System

FuelMaster is a modern web-based petrol pump management system designed for fuel stations to manage daily operations efficiently. The system allows station owners to track fuel sales, manage tank stock, record fuel deliveries, monitor expenses, and generate detailed reports from a clean and user-friendly dashboard.

FuelMaster helps petrol stations automate their workflow by providing real-time fuel tracking, automated cash flow calculations, and organized reporting tools. The system is lightweight, secure, and easy to install on any PHP hosting environment.

Live Demo: View Demo

Demo Login Username: admin Password: admin123

System Overview

The dashboard provides a quick overview of station performance including fuel levels, today’s sales, expenses, and recent activities. Animated fuel tank indicators help visualize stock levels while charts display sales trends for better decision making.

Sales can be recorded using either liters or cash amount, and the system automatically calculates the remaining value. Fuel stock updates automatically whenever a sale or delivery is recorded.

FuelMaster also provides expense management, supplier management, pump tracking, and daily cash flow calculations, making it a complete management solution for petrol stations.

Main Modules

• Dashboard – Real-time overview of fuel levels, sales and expenses.
• Fuel Sales – Record and manage daily fuel sales.
• Fuel Deliveries – Add tank refills and supplier deliveries.
• Expense Management – Track station operating expenses.
• Suppliers – Maintain supplier information and delivery records.
• Pump Management – Manage fuel pumps and assign fuel types.
• Reports – Generate daily and monthly financial reports.
• System Settings – Configure station information, logo and currency.

Technology Stack

• Backend: PHP 8 (OOP based structure)
• Frontend: Bootstrap 5
• Database: MySQL / MariaDB
• Charts: Chart.js
• Icons: Font Awesome

FuelMaster is a simple yet powerful management system built specifically for petrol stations looking to digitize their daily operations.

Features

Key Features

• Animated Fuel Tank Gauges – Visual fuel level indicators with Green (50%+), Yellow (20–50%), and Red (below 20%) alerts.
• Cash-Based Sales System – Record fuel sales by entering either Liters or Cash Amount. The system automatically calculates the other value.
• Automatic Fuel Stock Management – Fuel stock decreases automatically when a sale is recorded and increases when a delivery is added.
• Fuel Delivery Management – Record fuel tank refills and link them with suppliers for accurate inventory tracking.
• Expense Management – Track daily expenses with categories like Salaries, Electricity, Maintenance, Rent, and Miscellaneous.
• Daily Cash Flow Calculation – Automatically calculates Opening Cash + Sales – Expenses = Closing Balance.
• Daily & Monthly Reports – Generate printable reports with a clean A4 layout and export through the browser.
• Fuel Price History Log – Every fuel price change is saved automatically for future reference.
• Supplier Management – Maintain a complete list of suppliers with contact information.
• Pump / Nozzle Management – Register pumps and link them with fuel types for better tracking of sales.
• Sales History with Filters – Filter records by date range, fuel type, or pump with running totals.
• Dashboard Analytics – Interactive charts and activity feed to monitor station performance.
• Unlimited Records with Pagination – Store unlimited data with organized pagination for easy navigation.
• Dark Mode Support – Toggle full system dark theme for comfortable night usage.
• Premium Login Screen – Displays station logo, name, address, phone, and email information.
• Database Backup & Restore – Download database backups and restore them easily.
• Web-Based Installer – Simple installation wizard that creates database tables automatically.
• Multi-Currency Support – Includes 12 currencies such as USD, AED, SAR, PKR, INR, BDT, IRR, KWD, QAR, EGP, GBP, and EUR.
• Secure Authentication – Includes password hashing, CSRF protection, and secure session handling.
• Responsive Design – Fully responsive interface that works on desktop, tablet, and mobile devices.

Requirements

Server Requirements

• PHP Version: PHP 8.0 or higher
• Database: MySQL 5.7+ or MariaDB 10.4+
• Web Server: Apache with mod_rewrite enabled
• PHP Extensions: PDO and PDO_MySQL
• Hosting Environment: Compatible with XAMPP, WAMP, LAMP and cPanel hosting
• Modern Web Browser: Google Chrome, Firefox, Edge or Safari
• Internet Connection: Required for installation and updates

Instructions

Installation Instructions

1. Upload Files Extract the downloaded package and upload the fuelmaster folder to your web server root directory (for example: public_html or htdocs).
2. Create Database Create a new MySQL database from your hosting control panel (cPanel / phpMyAdmin).
3. Run Installer Open your browser and visit: http://yourdomain.com/fuelmaster/installer/
4. Enter Database Details Provide your database hostname, database name, username, and password.
5. Create Admin Account Set your admin username and password for the system.
6. Complete Installation Click the Install button. The installer will automatically create all required tables and configuration files.
7. Login to System After installation, open: http://yourdomain.com/fuelmaster/ Login using your admin credentials.

Note: For security reasons, it is recommended to delete the installer folder after completing the installation.