FuelFlow is a fuel expense tracking application designed to help vehicle owners understand fuel costs, vehicle efficiency, and fuel consumption trends over time.
The project was created as a personal learning initiative focused on software analysis, backend-oriented design, database modeling, and full-stack development. It is also intended to serve as a portfolio project that demonstrates the software development lifecycle, from requirements gathering and system analysis to implementation and deployment.
The primary goal of FuelFlow is to provide a practical solution for recording fuel refills, tracking fuel expenses, estimating vehicle autonomy, and generating meaningful reports based on historical data.
FuelFlow aims to solve several common problems faced by vehicle owners:
- Difficulty tracking monthly fuel expenses.
- Limited visibility into vehicle fuel efficiency.
- Inaccurate fuel tank estimations provided by many vehicles.
- Poor understanding of long-term fuel consumption trends.
- Lack of centralized fuel history records.
The application introduces a virtual tank system, fuel performance calculations, and historical reporting to provide more useful information than traditional vehicle dashboards.
Important
FuelFlow is currently in the Analysis and Design phase.
Completed work includes:
- Requirements engineering.
- User stories.
- Functional requirements.
- Non-functional requirements.
- Business requirements.
- Use cases.
- UML use case diagrams.
- UML activity diagrams.
Currently in progress:
- Entity Relationship Diagram (ERD).
- Relational model.
- Data dictionary.
- Database architecture.
- Database design.
Implementation will begin after the database design phase is completed.
- User registration.
- User authentication.
- Password recovery.
- Profile management.
- Password management.
- Vehicle registration.
- Multiple vehicle support.
- Vehicle profile management.
- Partial refill registration.
- Full refill registration.
- Historical refill records.
- Fuel expense tracking.
- Global vehicle reports.
- Fuel consumption analysis.
- Fuel cost analysis.
- Vehicle performance metrics.
- Virtual fuel tank estimation.
- React
- TypeScript
- Tailwind CSS
- Node.js
- TypeScript
- PostgreSQL
This project is being used to strengthen practical skills in:
- Software analysis and design.
- Requirements engineering.
- UML modeling.
- Database design.
- Backend development.
- Full-stack application architecture.
- Software documentation.
- Git and GitHub workflows.
Project documentation is available in the /docs directory.
Current documentation includes:
- Requirements Documentation
- Use Cases Documentation
- Activity Diagrams Documentation
Additional technical documentation will be added during future development phases.
The first release focuses on:
- Vehicle registration.
- Fuel refill registration.
- Fuel expense tracking.
- Historical reporting.
- Virtual tank estimation.
Future releases may include additional automation, advanced reporting, route analysis, and fuel prediction features.
Warning
This project is shared for educational, learning, portfolio, and academic purposes only.
The source code, documentation, diagrams, analysis artifacts, and project materials may be studied, referenced, and used for personal learning or academic activities.
Commercial use is strictly prohibited.
You are allowed to:
- View the source code.
- Study the project structure.
- Learn from the implementation.
- Use the project for academic and educational purposes.
- Reference the project for personal learning.
You may not:
- Sell this project or any derivative work.
- Use this project in a commercial product or service.
- Redistribute this project as your own work.
- Remove copyright or attribution notices.
This repository is intended to demonstrate software analysis, system design, database modeling, and application development practices. See the LICENSE file for complete terms and conditions.
© 2026 Alberto Zúñiga All Rights Reserved.