An app for tracking your fuel consumption.
https://fuelstats.filiprojek.cz
Filip Rojek
7517bcb78f
All checks were successful
Build and Deploy Zola Website / build_and_deploy (push) Successful in 14s
Updated: - DashboardController now fetches latest refuel record only for the default vehicle - VehicleController - first created vehicle is now set as default automatically - Refuel model - latest_one() now accepts vehicle_id instead of user_id - Dashboard view - improved handling when no vehicles or refuel records exist - CSS styles - adjusted dashboard layout and global action padding |
||
|---|---|---|
| .docker | ||
| .gitea/workflows | ||
| .screenshots | ||
| app | ||
| config | ||
| core | ||
| public | ||
| storage/logs | ||
| .dockerignore | ||
| .gitignore | ||
| docker-compose.yaml | ||
| Dockerfile | ||
| LICENSE | ||
| README.md | ||
| TODO.md | ||
Fuel Stats
An app for tracking your fuel consumption and optimizing your driving efficiency.
Used Technologies
- Frontend: HTML, CSS, JavaScript
- Backend: PHP (OOP)
- Database: MariaDB
How to Build
Build Using Docker
Run the container using docker-compose:
docker-compose --profile <dev|prod> up -d
The app should be available at http://localhost:8000.
PhpMyAdmin should be available at http://localhost:8080.
Build Manually
- Clone the repository:
git clone https://git.filiprojek.cz/fr/fuel-stats.git
- Create
config/environment.php:
- It should have the following structure:
<?php
define('DB_HOST', 'your db host');
define('DB_USER', 'your db username');
define('DB_PASS', 'your db password');
define('DB_NAME', 'your db name');
- For the database, you can use the included
docker-compose.yamlwhich includes both MariaDB and PhpMyAdmin.
- Start a local web server:
- You can use PHP's integrated server by running this:
php -S localhost:8000 -t ./public
- You can use any host and any port you prefer.
Usage
- Register and log in to the app.
- Add your vehicles with their details (fuel type, registration, etc.).
- Record each refueling:
- Select your vehicle.
- Input the number of liters, price per liter, and total cost.
- Track your fuel consumption and spending through the dashboard.
- View detailed stats and graphs to analyze your driving habits.
Use case diagram
Data logical model
Class diagram
License
This project is licensed under GPL3.0 and later. More information is available in the LICENSE file.