An app for tracking your fuel consumption.
https://fuelstats.filiprojek.cz
Filip Rojek
3d86f1ae2e
All checks were successful
Build and Deploy Zola Website / build_and_deploy (push) Successful in 12s
|
||
|---|---|---|
| .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.