docs releases v3.0.0 - AlexandreZanata/Abastevo GitHub Wiki

GitHub Release v3.0.0 โ€” Draft Notes

Status: Ready for GitHub Release
Tag: v3.0.0
Distribution: Sideload via signed APK on GitHub Releases
Product contract: user-business-logic.md ยท Privacy: privacy-policy.md ยท Build: release-build.md

Copy the block below into the GitHub Release description when publishing v3.0.0.


Release title

ANP Fuel Prices v3.0.0 โ€” Vehicles, tank cost & price alerts

Release body (paste into GitHub)

ANP Fuel Prices v3.0.0

Major update: register vehicles, see tank fill cost on Home, optional GPS city detection, station navigation, and local price drop alerts.

Highlights

  • Vehicle profiles (UC-010) โ€” up to 3 vehicles; tank capacity, fuel type, cheapest or specific station price reference
  • Tank fill cost (UC-011) โ€” Home cards show estimated full-tank cost for the active survey week
  • Optional location (UC-012) โ€” one-shot GPS + Nominatim reverse geocode after onboarding sync; OSM attribution shown
  • Station navigation (UC-013) โ€” Navigate button opens Maps/Waze with normalized station address
  • Price drop alerts (UC-014) โ€” local notifications after weekly import when tracked price falls vs previous week
  • Database migration โ€” v2.0.0 user data preserved when upgrading to v3 schema (vehicle table)

Install (sideload)

  1. Download app-release.apk from the assets below.
  2. Upgrading from v2.0.0: install over existing app โ€” local price data migrates automatically.
  3. Minimum Android 8.0 (API 26). Android 13+ may prompt for notification permission when enabling price alerts.

Build instructions: docs/release-build.md

Data & disclaimers

Fuel price data ยฉ ANP โ€” public government data.
This app is not affiliated with ANP.
Geocoding ยฉ OpenStreetMap contributors (Nominatim).
Prices are weekly surveys, not live pump prices.

Full changelog: CHANGELOG.md


Assets checklist

Asset File
Release APK app/build/outputs/apk/release/app-release.apk
Release AAB app/build/outputs/bundle/release/app-release.aab

Publish steps

  1. ./gradlew validateRepoBaseline test validateReleaseBuild
  2. Tag: git tag -a v3.0.0 -m "ANP Fuel Prices v3.0.0 โ€” Vehicles, tank cost & price alerts"
  3. Push when ready: git push origin main && git push origin v3.0.0