docs mobile p32 home commercial - AlexandreZanata/Abastevo GitHub Wiki

P32-UI-HOME-COMMERCIAL — reference-inspired Home

Status: LOCAL_DONE Validation: PASS

2026-10-06 user scope: create a polished Home opening inspired by the supplied mockup, with original branded hero artwork and colored SVG icons matching the existing filled fuel pictograms. Continue isolated codex/phase-32-home-minimal from 745f747; preserve other checkouts and all previous navigation adjustments.

B-BR-C01 / BUC-C01: preserve actual municipal ANP averages, observation period, staleness/offline/error states and source attribution. The mockup's station names, distances, avatars, consensus and live prices are visual references, not data. B-BR-C02 / BUC-C02: the contextual hero action selects a station through the existing station route before capture; no new permission or submission contract.

Presentation: existing abastevo logo, city selector, generated blue/green hero, economy/community/source-context benefits, clearer ANP reference cards, station and history shortcuts, preserved vehicles and expert tools. Native text remains accessible/localized; no text baked into the artwork. SVG masters and equivalent Android VectorDrawables use filled silhouettes and colored accents; preserve the existing fuel icons. No dependency, backend/domain or iOS change.

Validation: affected Home/navigation/contrast tests, APK and instrumented-test builds, lint, selected Home instrumentation on identified Poco, light/dark and large-font/scroll checks, SVG safety/geometry parity, diff/secret review. Artwork uses built-in ImageGen; exact prompt/provenance retained with assets. No remote issue/push/PR/merge/wiki or release certification in this request.

Assets

  • Built-in ImageGen artwork/provenance and exact prompt. WebP: 1672 × 941, 58,758 bytes, encoded without crop/rescale; loaded locally for offline Home rendering.
  • Six native SVG masters: piggy bank, community, shield, map/stations, history and location. Android path/color parity and SVG no-script/no-raster/no-external-reference checks PASS.
  • Existing Android logo export copied byte-for-byte; original logo, launcher and fuel icons unchanged. No library/font dependency added.
  • Eighteen new strings translated in all eight existing locales. ANP is a non-translated source label. All copy stays native, including artwork overlays.

Actual validation

ANDROID_HOME=/data/dev/android/sdk/Sdk ./gradlew :app:testDebugUnitTest --tests '*HomeViewModelTest' --tests '*NavigationTabTest' --tests '*ColorContrastTest' --tests '*FuelProductTintContrastTest' :app:assembleDebug :app:assembleDebugAndroidTest :app:lintDebug --console=plain PASS (2m16s). Home 4, navigation 6, contrast 3, fuel contrast 2: 15 unit tests, no failures/errors/skips. Hero text/action AA contrast and explicit app dark-theme fuel colors are covered.

Initial Poco instrumentation: 8/9 PASS, vehicle-card assertion failed because performScrollTo selected the nested horizontal LazyRow rather than its outer vertical page. Added a carousel test tag and scrolled the actual container before asserting both vehicle name and total; no assertion removed. Affected rebuild/APKs/lint PASS (35s). Final targeted class: adb -s <identified-phone> shell am instrument -w -r -e class com.anpfuel.app.ui.home.HomeScreenTest com.anpfuel.app.debug.test/androidx.test.runner.AndroidJUnitRunner PASS, 9/9 (15.665s), including 2x Compose font scale, dark source label, contextual contribution -> station selection, city picker, actual fuel route, empty state, vehicle placeholder and existing registered-vehicle card.

Lint: zero errors, 174 warnings; none suppressed or baselined. Native SVG contact sheet rendered with existing Inkscape and inspected; six icons have clear silhouettes and filled accent colors. No renderer dependency installed. git diff --check, localization coverage and scoped secret-surface review PASS.

Final APK installed with install -r, data preserved. Cold launch Status ok, 964ms (one sample, not a performance certification). Actual Home opening and scroll inspected on Poco in light/dark themes: intact logo, readable hero, colored benefits, source/date/staleness retained and prior navigation styling preserved. Final screenshots remain only in /tmp; observed source data is not committed. Dark theme restored and Home left open. APK SHA-256: dda8b410abad62149bd83190d20028db3b624de07a069b72607c6bd39df6ad10.

INTEGRATION_PENDING. Existing batch/live-provider/release blockers are untouched. Rollback: revert this task commit; retain previous Home/navigation commits.

P32-UI-HOME-COMPACT — presentation follow-up

2026-10-06 user scope, from b3eb265 on the same isolated branch: compact, horizontal hero with smaller type; remove duplicated brand inside the hero and the decorative city pin. Redraw the savings pictogram as a recognizable rounded piggy bank in the existing native SVG/VectorDrawable palette. Benefits show only icons and main titles, centered in three equal columns with subtle separators.

B-BR-C03 / BUC-C03: preserve C01/C02 data/source/navigation behavior and header branding. At normal font the hero becomes shorter without a fixed height; larger text can grow and scroll. All three benefits retain equal widths at large font, with wrapping titles rather than truncation or a stacked replacement.

Planned validation: affected Home/contrast unit checks, both APKs and lint, existing Home instrumentation including 2x font, vector parity/safety, identified Poco update preserving data, light/dark visual review, diff and secret review. Status: LOCAL_DONE / INTEGRATION_PENDING; no publication or broader release acceptance.

Actual checks: the same scoped Gradle command above PASS (1m06s): 15/15 unit checks, debug APK, instrumentation APK and lint. First process was interrupted (exit 143); final source was rebuilt successfully. Lint has zero errors and 175 warnings, including the retained unused location drawable; no suppression or baseline added. Removed the three obsolete benefit-description strings from all eight locales. All locale XML and six SVG/vector path/color pairs PASS; no script, font, bitmap or external reference in the SVGs. Pig master rendered with existing Inkscape and inspected before device validation.

Poco Home instrumentation PASS, 9/9 (15.45s). The existing 2x-font check now asserts all three main benefit titles remain visible with equal widths and equally spaced horizontal centers (1 pixel tolerance), while contribution, fuel/vehicle navigation and scrolling regressions remain covered.

Installed both APKs with install -r only on the identified Poco, preserving app data. Light/dark screenshots inspected: wide compact banner, smaller native copy, no duplicated hero brand or city pin, improved pig and centered separated benefits. Header logo retained. Original dark theme restored; Home left open. Screenshots remain in /tmp, outside Git. One cold launch: Status ok, 936ms, not a performance certification. git diff --check and secret-surface review PASS. No dependency, backend/domain, fuel artwork or raster hero change. APK SHA-256: 935ce5c224b9a976b92231bc92610fad6ca8cdc8d59665441867dab70d573900. Rollback: revert only this follow-up commit, preserving previous UI work.