How fahadrafan/mileagetracker works
Fuel Garage is an offline-first Android app for managing vehicles and recording fuel fills. The main workflow is to choose a vehicle, enter a fill-up, persist it, and review mileage and expense metrics on the dashboard or in history. The README documents vehicle management, dashboard statistics, history, and planned statistics capabilities; the tree also contains settings and backup/restore modules. Source excerpts were not provided, so implementation links are dashed where runtime calls cannot be verified.
Main entry points: AppNavigation.kt App Navigation · DashboardViewModel.kt Dashboard Metrics · FuelRepository.kt Fuel Repository · HomeScreen.kt Vehicle Home
Components 21
App Flow
- App Activity
app/src/main/java/com/example/mileagetracker/MainActivity.kt - App Navigation
app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt - Settings
app/src/main/java/com/example/mileagetracker/ui/settings/SettingsScreen.kt
Vehicle and Fuel
- Vehicle Home
app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt - Vehicle Management
app/src/main/java/com/example/mileagetracker/ui/vehicle/VehicleDialog.kt - Fuel Entry
app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryScreen.kt - Entry State
app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryViewModel.kt - Fuel History
app/src/main/java/com/example/mileagetracker/ui/history/HistoryScreen.kt
Analytics
- Vehicle Dashboard
app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardScreen.kt - Dashboard Metrics
app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt - Mileage Calculations
app/src/main/java/com/example/mileagetracker/utils/MileageCalculator.kt - Vehicle Statistics
app/src/main/java/com/example/mileagetracker/utils/VehicleStatistics.kt
Persistence and Preferences
- Fuel Repository
app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt - Vehicle Repository
app/src/main/java/com/example/mileagetracker/data/repository/VehicleRepository.kt - Fuel Data Access
app/src/main/java/com/example/mileagetracker/data/dao/FuelEntryDao.kt - Vehicle Data Access
app/src/main/java/com/example/mileagetracker/data/dao/VehicleDao.kt - Room Database
app/src/main/java/com/example/mileagetracker/data/database/FuelGarageDatabase.kt - User Preferences
app/src/main/java/com/example/mileagetracker/data/preferences/UserPreferencesRepository.kt
Data Management
- Backup and Restore
app/src/main/java/com/example/mileagetracker/backup/BackupAndRestoreManager.kt - Backup Data Model
app/src/main/java/com/example/mileagetracker/backup/BackupData.kt
Other components
- Vehicle Owner
Connections 22
- Vehicle Owner → App Activity: opens app
- App Activity → App Navigation: hosts navigation
- App Navigation → Vehicle Home: routes to
- App Navigation → Fuel Entry: routes to
- App Navigation → Fuel History: routes to
- App Navigation → Settings: routes to
- Vehicle Home → Vehicle Management: manages vehicles
- Vehicle Home → Vehicle Dashboard: shows metrics
- Fuel Entry → Entry State: submits entry
- Entry State → Fuel Repository: saves fill-up
- Fuel History → Fuel Repository: loads entries
- Vehicle Dashboard → Dashboard Metrics: requests metrics
- Dashboard Metrics → Fuel Repository: reads fuel data
- Dashboard Metrics → Mileage Calculations: calculates mileage
- Dashboard Metrics → Vehicle Statistics: summarizes usage
- Fuel Repository → Fuel Data Access: uses data access
- Vehicle Repository → Vehicle Data Access: uses data access
- Fuel Data Access → Room Database: queries database
- Vehicle Data Access → Room Database: queries database
- Vehicle Management → Vehicle Repository: manages records
- Settings → User Preferences: updates preferences
- Backup and Restore → Backup Data Model: encodes data