docs releases v1.0.0 - AlexandreZanata/Abastevo GitHub Wiki

GitHub Release v1.0.0 — Draft Notes

Status: Ready for GitHub Release (Phase 10.7 — tag v1.0.0 created locally)
Tag: v1.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 v1.0.0.

Release title

ANP Fuel Prices v1.0.0 — MVP

Release body (paste into GitHub)

ANP Fuel Prices v1.0.0

First public release of the open-source Android app for browsing official Brazilian ANP weekly fuel price surveys — fully on-device, no account required.

Highlights

Onboarding & sync — First-run explanation and automatic download of latest ANP spreadsheets (UC-001, UC-002)
City search — Autocomplete municipality search with state disambiguation (UC-003, UC-004)
Fuel averages — Weekly gasoline, ethanol, and diesel prices for any city (UC-005)
Price history — Local trend chart for selected location (UC-006)
Station detail — Optional per-station download sorted by price (UC-007)
Settings — Language (en / pt-BR), sync preferences, storage management, cache controls (UC-008)
Offline-first — Browse cached data without network after first sync (BR-004)
Background sync — WorkManager updates on Wi‑Fi when configured (BR-014)

Install (sideload)

Download app-release.apk from the assets below.
On your Android device, allow installation from your browser or file manager (“Install unknown apps”).
Open the app and complete the first sync when online.
Minimum Android 8.0 (API 26).

Signed AAB (app-release.aab) is included for maintainers preparing a Play Store upload.

Build instructions: docs/release-build.md

Data & disclaimers

Fuel price data © ANP (Agência Nacional do Petróleo, Gás Natural e Biocombustíveis) — public government data.
This app is not affiliated with ANP.
Prices reflect weekly surveys, not live pump prices. Data freshness depends on ANP publication schedule.
The app works offline after the first sync; an internet connection is required only to download new weekly tables.

Privacy & license

No personal data collected — see privacy policy
Open source — MIT License
Source code: https://github.com/AlexandreZanata/TABELA-ANP-COMBUSTIVEIS

Known limitations (v1.0.0)

Weekly ANP data only — not real-time station prices
Station detail is downloaded on demand and subject to local retention settings (BR-013)
Play Store listing pending; GitHub Releases is the primary distribution path for v1.0.0

Full documentation

Document	Link
Architecture	docs/architecture.md
Use cases	docs/use-cases/
Contributing	CONTRIBUTING.md

Required disclaimers checklist

ANP data attribution (BR-009)
Not affiliated with ANP
Weekly data — not real-time prices
Offline-capable after first sync
No personal data collected (privacy policy link)
MIT license and repository URL

Release assets (attach when publishing)

Asset	Source path	Notes
`app-release.apk`	`app/build/outputs/apk/release/`	Primary sideload artifact
`app-release.aab`	`app/build/outputs/bundle/release/`	Optional — Play Console upload

Generate signed artifacts: ./gradlew validateReleaseBuild

Publishing steps (Phase 10.7)

Ensure ./gradlew validateReleaseTag passes (version, license, disclaimers, clean tree).
Run ./gradlew createReleaseTag — builds signed APK/AAB and creates annotated tag v1.0.0 locally.
Push tag and branch when ready: git push origin main && git push origin v1.0.0.
Create GitHub Release from tag v1.0.0 with title and body from this draft.
Attach app-release.apk (and optionally app-release.aab) as release assets.