Repository navigation
docs backend TOOLCHAIN
Status: P01-T01 evidence. Resolves D01 (runtime versions) for local/CI use; digests and remaining tool pins land in their owning P01 tasks. No Android version was changed.
Source commit b8a52049e0294cd2d07612cedcc52b3017c5271e, branch main.
gradle/libs.versions.toml: Kotlin 2.0.21, AGP 8.7.3, Compose BOM 2024.12.01,
Room 2.6.1, Hilt 2.53.1, WorkManager 2.10.0, OkHttp 4.12.0, Jsoup 1.18.3.
Gradle wrapper 8.10.2; minSdk 26, compileSdk/targetSdk 35; JVM target 17
(domain/application via jvmToolchain(17)); app versionName 3.1.0 /
versionCode 4 (app/build.gradle.kts:42-43).
Execution environment on 2026-09-28:
- Active JVM: Eclipse Temurin 21 (
java -version→21+35-LTS). Gradle auto-provisioned Eclipse Temurin JDK 17.0.19+10 (/data/dev/caches/gradle-home/jdks/eclipse_adoptium-17-amd64-linux.2,./gradlew -q javaToolchains→ auto-detection/download enabled), which satisfiesjvmToolchain(17). No JDK install or Gradle change was needed. - Android SDK:
ANDROID_HOME/ANDROID_SDK_ROOT=/data/dev/android/sdk/Sdkholdsplatforms/android-34, android-35, android-36, android-36.1andbuild-tools/35.0.0among others. The earlier "no platforms directory" observation inspected the parent symlink path/data/dev/android/sdk/platformsinstead of$ANDROID_HOME. - Full baseline
./gradlew :domain:test :application:test :data:testDebugUnitTest :app:testDebugUnitTest :app:assembleDebug --no-daemon→ BUILD SUCCESSFUL in ~1m55s (88 tasks: 81 executed, 2 from cache, 5 up-to-date).bash scripts/validate-repo-baseline.sh→ exit 0.
- Go: minimum supported 1.26, preferred 1.27.x (checked 2026-09-28:
latest 1.27.1 per go.dev; Go supports the two most recent majors).
Installed
go1.22.2is out of support and must not be used beyond this planning task. P01-T02 pins the exact version inbackend/go.mod(GOTOOLCHAIN=automay fetch it; a local 1.26+ install is preferred). - PostgreSQL 18 + PostGIS 3.6.x (stable 3.6.2, Feb 2026; supports
PG 12–18; PG 14–18 are supported majors per postgresql.org).
PostGIS 3.7 is still RC — do not use for the pilot. P01-T07 pins the exact
image digest (no
latesttags) ininfra/compose.dev.yml. - Docker 29.1.3 + Compose v2.27.0 (verified
docker versionserver reachable,docker compose version). Daemon access confirmed. - Go stack per ADR-005:
net/http, chi routing, pgx, sqlc, slog, explicit SQL migrations. Exact library versions are pinned inbackend/go.modby P01-T02 with a recorded license/security review; Caddy image digest by P01-T10. - Static/contract tooling (
staticcheck,govulncheck,sqlc, OpenAPI linter) is pinned in P01-T11/P01-T12, not here.
Go BSD-3-Clause; PostgreSQL under the permissive PostgreSQL Licence; PostGIS GPL-2.0 (copyleft — server-side use, no client redistribution); Docker Engine/Compose Apache-2.0; Gradle/AGP Apache-2.0; Room/Compose/WorkManager Apache-2.0. Support windows rechecked 2026-09-28 via go.dev, postgresql.org and postgis.net; recheck at image/dependency procurement (P01-T02/T07).
Baseline truth; docs/architecture.md R-ARCH-03 and the README scope/version
lines below are corrected in this task. Remaining historical references
(tech-stack/data-sources/ADR-001 FTS5 prose, old TABELA-ANP-COMBUSTIVEIS
URLs, docs/releases/v1.0.0|v2.0.0.md) stay as history and are recorded here,
not rewritten.
-
A01 — FTS baseline is FTS4.
MunicipalityFtsEntity.kt:5,14uses Room@Fts4;AnpFuelDatabaseMigrations.kt:12,102createmunicipality_fts USING FTS4. Prose claiming FTS5 (docs/architecture.md:285,331-338,docs/tech-stack.md:17,34,105,188,191,docs/data-sources.md:121,docs/adr/001-kotlin-compose-stack.md:27,37) is stale. Do not replace search during backend work. -
A02 — Schema v4;
:dataalso depends on:application.AnpFuelDatabase.kt:30→version = 4with schemas 1–4 underdata/schemas/;data/build.gradle.kts:57-58implements bothproject(":domain")andproject(":application")(worker orchestration).docs/architecture.mdR-ARCH-03 and its version-1 schema example are corrected/annotated accordingly in this task. -
A11 — Legacy publishing references.
README.mdindexed UC-001…UC-014 while UC-015 exists (FindNearestBestPriceStationUseCase, architecture mapping table row UC-015); linked git-ignored.local/PROJECT_PLAN.md; release quick-start commented(v2.0.0)while the release is 3.1.0 (app/build.gradle.kts:42-43). Scope/version lines are corrected in this task; historical release notes keep their original text. Never run release/tag scripts to establish a baseline.
java -version # Temurin 21+35-LTS (launcher); JDK 17.0.19 auto-provisioned by Gradle
go version # go1.22.2 linux/amd64 — out of support, plan-only
docker version # Server 29.1.3 reachable
docker compose version # v2.27.0
bash scripts/validate-repo-baseline.sh # exit 0
./gradlew :domain:test :application:test :data:testDebugUnitTest \
:app:testDebugUnitTest :app:assembleDebug --no-daemon # BUILD SUCCESSFUL ~1m55s
./gradlew -q javaToolchains --no-daemon # Temurin 17.0.19 provisioned; 21 current
git diff --check # clean (run after edits)Limitation: instrumentation (connectedDebugAndroidTest), coverage/lint gates
and live ANP import were not executed in this task.
P01-T02 (Go module and process roots) consumes the Go ≥1.26 pin from §2. P01-T07 pins the Postgres/PostGIS digest. Backend code starts in P01-T02; no Android source was touched here.
- Home
- Roadmap
- docs-README
- docs-android-build
- docs-android-design-system
- docs-android-forum
- docs-android-games
- docs-android-map-engine
- docs-android-navigation
- docs-android-ocr-image
- docs-android-ocr-live-framing
- docs-android-premium-area
- docs-android-premium-integration
- docs-android-release
- docs-android-ui-containers
- docs-architecture-android-stack
- docs-architecture-android
- docs-architecture-backend
- docs-architecture-data-sources
- docs-architecture-overview
- docs-architecture-sources-ev-research
- docs-architecture-sources-national-limits
- docs-architecture-sources-national-stations
- docs-architecture-sources-register
- docs-assets-app-tutorial-CAPTURE_CONTRACT
- docs-assets-app-tutorial-FABLE_LANDING_POLISH_PROMPT
- docs-assets-app-tutorial-README
- docs-assets-attribution
- docs-assets-brand-README
- docs-assets-flags-ATTRIBUTION
- docs-assets-fuel-icons-README
- docs-assets-games-fuel-v1-README
- docs-assets-home-icons-README
- docs-assets-landing-fleet-android-20261012-BRIEF
- docs-assets-landing-hero-20261011-BRIEF
- docs-assets-landing-illustrated-20261012-BRIEF
- docs-assets-landing-illustrated-20261012-README
- docs-assets-landing-minimal-20261012-BRIEF
- docs-assets-landing-open-data-20261026-BRIEF
- docs-assets-landing-redesign-20261011-PREPARATION_EVIDENCE
- docs-assets-landing-redesign-20261011-README
- docs-assets-landing-redesign-20261011-REFERENCE_BRIEF
- docs-assets-landing-sync-20261012-BRIEF
- docs-assets-map-icons-README
- docs-backend-anp-ingestion
- docs-backend-api
- docs-backend-community-pricing
- docs-backend-data-model
- docs-backend-domain-model
- docs-backend-driver-private-data
- docs-backend-forum-architecture
- docs-backend-forum-bulletins
- docs-backend-forum-sources
- docs-backend-payments-provider-admission
- docs-backend-payments-provider-register
- docs-backend-photos-capture
- docs-backend-photos-subset-submission
- docs-backend-premium-api
- docs-backend-premium-cloud-protocol
- docs-backend-testing
- docs-backend-toolchain
- docs-brand-app-icons
- docs-brand-identity
- docs-decisions-001-kotlin-compose-stack
- docs-decisions-002-price-import-immutability
- docs-decisions-003-nominatim-reverse-geocode
- docs-decisions-005-modular-monolith-and-postgresql
- docs-decisions-006-official-catalog-and-exact-contracts
- docs-decisions-007-anonymous-proof-of-possession
- docs-decisions-008-privacy-and-retention
- docs-decisions-009-community-consensus-and-projections
- docs-decisions-010-private-object-evidence
- docs-decisions-012-licensing-and-hosted-business
- docs-decisions-015-kotlin-multiplatform-shared-domain
- docs-decisions-016-android-commercial-community-ios-deferred
- docs-decisions-017-station-profile-and-verified-representation
- docs-decisions-021-community-first-contribution
- docs-decisions-022-comaps-derived-native-map-engine
- docs-decisions-023-admin-suite-granted-tiers-contributors
- docs-decisions-025-private-abastevo-empresas-organization-boundary
- docs-decisions-026-multilingual-public-site
- docs-decisions-README
- docs-enterprise-README
- docs-enterprise-architecture
- docs-enterprise-backlog-INDEX
- docs-enterprise-backlog-ep00-governance
- docs-enterprise-backlog-ep01-platform
- docs-enterprise-backlog-ep02-organizations
- docs-enterprise-backlog-ep03-identity-access
- docs-enterprise-backlog-ep04-sync
- docs-enterprise-backlog-ep05-fleet-meters
- docs-enterprise-backlog-ep06-trips
- docs-enterprise-backlog-ep07-gps-navigation
- docs-enterprise-backlog-ep08-fuelings
- docs-enterprise-backlog-ep09-documents
- docs-enterprise-backlog-ep10-expenses-finance
- docs-enterprise-backlog-ep11-maintenance
- docs-enterprise-backlog-ep12-fuel-stock
- docs-enterprise-backlog-ep13-intelligence
- docs-enterprise-backlog-ep14-station-claims
- docs-enterprise-backlog-ep15-station-commerce
- docs-enterprise-backlog-ep16-subscriptions
- docs-enterprise-backlog-ep17-data
- docs-enterprise-backlog-ep18-imports-notifications-integrations
- docs-enterprise-backlog-ep19-back-office
- docs-enterprise-backlog-ep20-release
- docs-enterprise-business-rules
- docs-enterprise-contract
- docs-enterprise-conventions
- docs-enterprise-data-offering
- docs-enterprise-decisions
- docs-enterprise-domain-model
- docs-enterprise-glossary
- docs-enterprise-journeys
- docs-enterprise-modules-back-office
- docs-enterprise-modules-data
- docs-enterprise-modules-documents
- docs-enterprise-modules-expenses-finance
- docs-enterprise-modules-fleet
- docs-enterprise-modules-fuel-stock
- docs-enterprise-modules-fuelings
- docs-enterprise-modules-gps-navigation
- docs-enterprise-modules-identity
- docs-enterprise-modules-imports-notifications-integrations
- docs-enterprise-modules-intelligence
- docs-enterprise-modules-maintenance
- docs-enterprise-modules-organizations
- docs-enterprise-modules-station-claims
- docs-enterprise-modules-station-commerce
- docs-enterprise-modules-subscriptions
- docs-enterprise-modules-trips
- docs-enterprise-offline-sync
- docs-enterprise-permissions
- docs-enterprise-portal-routes
- docs-enterprise-privacy-security
- docs-enterprise-product-vision
- docs-enterprise-source-admission
- docs-enterprise-state-model
- docs-enterprise-testing
- docs-enterprise-ux-app
- docs-enterprise-ux-web
- docs-operations-README
- docs-operations-backup
- docs-operations-deploy-agent
- docs-operations-dou-editions
- docs-operations-edge-cache
- docs-operations-enterprise-activation
- docs-operations-map-static-overlay
- docs-operations-moderation-feedback
- docs-operations-moderation-profiles
- docs-operations-monitoring
- docs-operations-operator-access
- docs-operations-payments
- docs-operations-premium-billing
- docs-operations-recovery
- docs-operations-registry-daily-sync
- docs-operations-registry-runs
- docs-product-README
- docs-product-admin-tiers
- docs-product-community-community-first
- docs-product-community-experience
- docs-product-community-metrics
- docs-product-community-moderation
- docs-product-community-safety
- docs-product-community-terms-pt-br
- docs-product-driver-suite-README
- docs-product-driver-suite-android-state
- docs-product-driver-suite-cloud-sync
- docs-product-driver-suite-cost-profiles-and-maintenance
- docs-product-driver-suite-driver-model-and-earnings
- docs-product-driver-suite-foundation-decisions
- docs-product-driver-suite-gps-lifecycle
- docs-product-driver-suite-mobile-hub
- docs-product-driver-suite-odometer-review
- docs-product-driver-suite-outbox-wire
- docs-product-driver-suite-quick-refuel
- docs-product-driver-suite-reports
- docs-product-driver-suite-shifts-and-distance
- docs-product-driver-suite-signed-commands
- docs-product-ev-README
- docs-product-ev-charging-stop-planner
- docs-product-ev-energy-model
- docs-product-ev-financial-method
- docs-product-ev-journey-ui
- docs-product-ev-preparation
- docs-product-ev-typed-data
- docs-product-exploration
- docs-product-forum-contract
- docs-product-forum-policies
- docs-product-glossary
- docs-product-landing-content
- docs-product-landing-guides
- docs-product-landing-organic-growth-i18n-plan
- docs-product-licensing
- docs-product-map-discovery
- docs-product-map-favorites-and-trips
- docs-product-map-reports-routing-guidance
- docs-product-notification-content
- docs-product-official-prices
- docs-product-open-source-business
- docs-product-overview
- docs-product-payments-README
- docs-product-payments-offer-policy
- docs-product-premium-README
- docs-product-premium-financial-method
- docs-product-premium-source-policy
- docs-product-stations-catalog
- docs-product-stations-fuel-feedback
- docs-product-stations-fuel-quality
- docs-product-stations-identity-and-ev-catalog
- docs-product-stations-profile-contract
- docs-product-stations-profile-representation
- docs-product-stations-registry-sources
- docs-product-vehicle-registration
- docs-product-vehicles-and-occurrences
- docs-security-android-terms-acceptance
- docs-security-free-account-access
- docs-security-identity-profile
- docs-security-media-location-policy
- docs-security-privacy-notice
- docs-security-privacy-policy
- docs-security-retention
- docs-security-risks
- docs-security-security-privacy
- docs-store-README
- docs-store-play-readiness
- docs-store-play-store-listing
- docs-store-ugc-safety
Source: AlexandreZanata/Abastevo @ e4a67580fc368a59bc1c0f1e0466fc011313f330