# yllnore/mybbm---project architecture

> Architecture diagram of the GitHub repository yllnore/mybbm---project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yllnore/mybbm---project
- Repository: https://github.com/yllnore/mybbm---project

## Overview

MYBBM is an Android fuel-planning app: users choose or search an origin and destination, select a vehicle and fuel, and receive an estimated route and travel cost; they can also find nearby fuel stations and manage vehicles, fuel, history, and settings. MainActivity opens the Compose app, while BbmViewModel coordinates screen state and the planning workflow. The graph preserves the documented local cache and Supabase sync branches. Some storage and screen implementations were not excerpted, so uncertain connections are omitted.

Main entry points: [`app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt) (App state), [`app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt) (App navigation), [`app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt) (Trip search), [`app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt`](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt) (Trip result)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and screens"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_appscreen["App navigation<br/>[MainAppScreen.kt]"]
  node_home["Trip search<br/>[HomeScreen.kt]"]
  node_result["Trip result<br/>[ResultScreen.kt]"]
  node_vehicles["Vehicle settings<br/>[Kendaraan.kt]"]
  node_history["Trip history<br/>[Histori.kt]"]
  node_settings["Preferences<br/>[Pengaturan.kt]"]
end

subgraph group_planning["Trip planning"]
  node_vm["App state<br/>[BbmViewModel.kt]"]
  node_cost["Cost estimate"]
  node_calculator["Fuel calculations<br/>[FuelCalculator.kt]"]
end

subgraph group_data["Data and sync"]
  node_stations["Nearby fuel stations<br/>[SpbuRepository.kt]"]
  node_seed["Offline seed data"]
  node_db[("Room database<br/>[AppDatabase.kt]")]
  node_prefs["Walkthrough preferences"]
  node_sync["Default data sync"]
  node_supabase["Supabase client<br/>[SupabaseClient.kt]"]
end

subgraph group_support["Location and map"]
  node_route["Driving route"]
  node_distance["Distance fallback<br/>[HaversineUtil.kt]"]
  node_location["Location search"]
  node_device["Device location"]
  node_map["OSM map view<br/>[OsmMapView.kt]"]
  node_mapoverlay["Route map overlay"]
end

node_user(("Driver"))
node_osrm{{"OSRM routing service"}}
node_nominatim{{"Nominatim geocoding"}}
node_overpass{{"Overpass station data"}}
node_supabase_service{{"Supabase service"}}

node_user -->|"opens app"| node_activity
node_activity -->|"shows"| node_appscreen
node_activity -->|"creates"| node_vm
node_appscreen -->|"observes state"| node_vm
node_appscreen -->|"routes to"| node_home
node_appscreen -->|"routes to"| node_result
node_appscreen -->|"routes to"| node_vehicles
node_home -->|"updates trip state"| node_vm
node_home -->|"requests location"| node_device
node_home -->|"renders map"| node_map
node_home -->|"renders overlay"| node_mapoverlay
node_result -->|"reads trip state"| node_vm
node_result -->|"renders map"| node_map
node_result -->|"renders overlay"| node_mapoverlay
node_vehicles -->|"updates vehicles"| node_vm
node_history -->|"reads history"| node_vm
node_settings -->|"opens vehicle settings"| node_vehicles
node_vm -->|"searches locations"| node_location
node_vm -->|"requests route"| node_route
node_vm -->|"requests estimate"| node_cost
node_vm -->|"loads stations"| node_stations
node_vm -->|"uses database"| node_db
node_vm -->|"loads offline data"| node_seed
node_vm -->|"reads preferences"| node_prefs
node_vm -->|"loads defaults"| node_sync
node_cost -->|"gets route"| node_route
node_cost -->|"calculates fuel cost"| node_calculator
node_route -->|"estimates fallback"| node_distance
node_location -->|"queries"| node_nominatim
node_route -->|"requests directions"| node_osrm
node_stations -->|"queries stations"| node_overpass
node_stations -->|"ranks by distance"| node_distance
node_sync -->|"uses client"| node_supabase
node_sync -->|"fetches defaults"| node_supabase_service

click node_activity "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/MainActivity.kt"
click node_appscreen "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt"
click node_home "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt"
click node_result "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt"
click node_vehicles "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Kendaraan.kt"
click node_history "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Histori.kt"
click node_settings "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Pengaturan.kt"
click node_vm "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt"
click node_cost "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/domain/usecase/HitungBiayaUseCase.kt"
click node_calculator "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/util/FuelCalculator.kt"
click node_route "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/routing/OsrmRouteRepository.kt"
click node_distance "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/domain/engine/HaversineUtil.kt"
click node_location "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/location/LocationRepository.kt"
click node_device "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/util/DeviceLocationHelper.kt"
click node_map "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/components/OsmMapView.kt"
click node_mapoverlay "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/components/MapVisualOverlay.kt"
click node_stations "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/spbu/SpbuRepository.kt"
click node_seed "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/seed/OfflineSeedHelper.kt"
click node_db "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/database/AppDatabase.kt"
click node_prefs "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/WalkthroughPreferences.kt"
click node_sync "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseDefaultRepository.kt"
click node_supabase "https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseClient.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_appscreen,node_home,node_result,node_vehicles,node_history,node_settings toneBlue
class node_vm,node_cost,node_calculator toneAmber
class node_stations,node_seed,node_db,node_prefs,node_sync,node_supabase toneMint
class node_route,node_distance,node_location,node_device,node_map,node_mapoverlay toneRose
class node_user,node_osrm,node_nominatim,node_overpass,node_supabase_service toneIndigo
```

## Components

### App and screens

- [Android entry](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/MainActivity.kt): `app/src/main/java/com/mybbm/app/MainActivity.kt`
- [App navigation](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt): `app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`
- [Trip search](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt): `app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`
- [Trip result](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt): `app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt`
- [Vehicle settings](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Kendaraan.kt): `app/src/main/java/com/mybbm/app/ui/screens/Kendaraan.kt`
- [Trip history](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Histori.kt): `app/src/main/java/com/mybbm/app/ui/screens/Histori.kt`
- [Preferences](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/screens/Pengaturan.kt): `app/src/main/java/com/mybbm/app/ui/screens/Pengaturan.kt`

### Trip planning

- [App state](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt): `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`
- [Cost estimate](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/domain/usecase/HitungBiayaUseCase.kt): `app/src/main/java/com/mybbm/app/domain/usecase/HitungBiayaUseCase.kt`
- [Fuel calculations](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/util/FuelCalculator.kt): `app/src/main/java/com/mybbm/app/util/FuelCalculator.kt`

### Data and sync

- [Nearby fuel stations](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/spbu/SpbuRepository.kt): `app/src/main/java/com/mybbm/app/data/remote/spbu/SpbuRepository.kt`
- [Offline seed data](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/seed/OfflineSeedHelper.kt): `app/src/main/java/com/mybbm/app/data/local/seed/OfflineSeedHelper.kt`
- [Room database](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/database/AppDatabase.kt): `app/src/main/java/com/mybbm/app/data/local/database/AppDatabase.kt`
- [Walkthrough preferences](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/local/WalkthroughPreferences.kt): `app/src/main/java/com/mybbm/app/data/local/WalkthroughPreferences.kt`
- [Default data sync](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseDefaultRepository.kt): `app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseDefaultRepository.kt`
- [Supabase client](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseClient.kt): `app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseClient.kt`

### Location and map

- [Driving route](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/routing/OsrmRouteRepository.kt): `app/src/main/java/com/mybbm/app/data/remote/routing/OsrmRouteRepository.kt`
- [Distance fallback](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/domain/engine/HaversineUtil.kt): `app/src/main/java/com/mybbm/app/domain/engine/HaversineUtil.kt`
- [Location search](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/data/remote/location/LocationRepository.kt): `app/src/main/java/com/mybbm/app/data/remote/location/LocationRepository.kt`
- [Device location](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/util/DeviceLocationHelper.kt): `app/src/main/java/com/mybbm/app/util/DeviceLocationHelper.kt`
- [OSM map view](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/components/OsmMapView.kt): `app/src/main/java/com/mybbm/app/ui/components/OsmMapView.kt`
- [Route map overlay](https://github.com/yllnore/mybbm---project/blob/main/app/src/main/java/com/mybbm/app/ui/components/MapVisualOverlay.kt): `app/src/main/java/com/mybbm/app/ui/components/MapVisualOverlay.kt`

### Other components

- **Driver**
- **OSRM routing service**
- **Nominatim geocoding**
- **Overpass station data**
- **Supabase service**

## Connections

- Driver → Android entry: opens app (evidence: `app/src/main/java/com/mybbm/app/MainActivity.kt`)
- Android entry → App navigation: shows (evidence: `app/src/main/java/com/mybbm/app/MainActivity.kt`)
- Android entry → App state: creates (evidence: `app/src/main/java/com/mybbm/app/MainActivity.kt`)
- App navigation → App state: observes state (evidence: `app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`)
- App navigation → Trip search: routes to (evidence: `app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`)
- App navigation → Trip result: routes to (evidence: `app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`)
- App navigation → Vehicle settings: routes to (evidence: `app/src/main/java/com/mybbm/app/ui/MainAppScreen.kt`)
- Trip search → App state: updates trip state (evidence: `app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`)
- Trip search → Device location: requests location (evidence: `app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`)
- Trip search → OSM map view: renders map (evidence: `app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`)
- Trip search → Route map overlay: renders overlay (evidence: `app/src/main/java/com/mybbm/app/ui/screens/HomeScreen.kt`)
- Trip result → App state: reads trip state (evidence: `app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt`)
- Trip result → OSM map view: renders map (evidence: `app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt`)
- Trip result → Route map overlay: renders overlay (evidence: `app/src/main/java/com/mybbm/app/ui/screens/ResultScreen.kt`)
- Vehicle settings → App state: updates vehicles (evidence: `app/src/main/java/com/mybbm/app/ui/screens/Kendaraan.kt`)
- Trip history → App state: reads history (evidence: `app/src/main/java/com/mybbm/app/ui/screens/Histori.kt`)
- Preferences → Vehicle settings: opens vehicle settings (evidence: `app/src/main/java/com/mybbm/app/ui/screens/Pengaturan.kt`)
- App state → Location search: searches locations (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Driving route: requests route (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Cost estimate: requests estimate (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Nearby fuel stations: loads stations (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Room database: uses database (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Offline seed data: loads offline data (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Walkthrough preferences: reads preferences (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- App state → Default data sync: loads defaults (evidence: `app/src/main/java/com/mybbm/app/viewmodel/BbmViewModel.kt`)
- Cost estimate → Driving route: gets route (evidence: `app/src/main/java/com/mybbm/app/domain/usecase/HitungBiayaUseCase.kt`)
- Cost estimate → Fuel calculations: calculates fuel cost (evidence: `app/src/main/java/com/mybbm/app/domain/usecase/HitungBiayaUseCase.kt`)
- Driving route → Distance fallback: estimates fallback (evidence: `app/src/main/java/com/mybbm/app/data/remote/routing/OsrmRouteRepository.kt`)
- Location search → Nominatim geocoding: queries (evidence: `app/src/main/java/com/mybbm/app/data/remote/location/LocationRepository.kt`)
- Driving route → OSRM routing service: requests directions (evidence: `app/src/main/java/com/mybbm/app/data/remote/routing/OsrmRouteRepository.kt`)
- Nearby fuel stations → Overpass station data: queries stations (evidence: `app/src/main/java/com/mybbm/app/data/remote/spbu/SpbuRepository.kt`)
- Nearby fuel stations → Distance fallback: ranks by distance (evidence: `app/src/main/java/com/mybbm/app/data/remote/spbu/SpbuRepository.kt`)
- Default data sync → Supabase client: uses client (evidence: `app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseDefaultRepository.kt`)
- Default data sync → Supabase service: fetches defaults (evidence: `app/src/main/java/com/mybbm/app/data/remote/supabase/SupabaseDefaultRepository.kt`)
