Repository navigation
docs product driver suite foundation decisions
Date: 2026-10-26. Scope: DRV-00/01/02 only, selected by the owner. Future DRV-03–35 stay planned. The owner confirmed professional Premium. This freeze changes neither subscription enforcement nor production/provider state.
Isolated maintained-dev clone: /tmp/abastevo-driver-suite-planning-20261026, planning parent 42250934, runtime parent f1e1d0db. Remote main fetched as eee1b33f; remote dev fetched as f1e1d0db; main is an ancestor of this source. Other primary/MAP checkout edits were inspected read-only and are excluded. No other branch is moved or modified.
MEX-09/PRM06/09 own exact consumption and financial-v1; MEX-10 owns backend ledger/report reacceptance; MEX-11/12/13 own durable Android entries and monthly views; EE owns charge/energy methods; MAP owns navigation/location consumers. Reuse those boundaries. New driver work is not a duplicate ledger or payments module. Actual runtime has Room schema 27 and production SQL migrations through the current head; applied versions are never rewritten. Inspect any later main/schema changes again before integration.
-
D-DRV-01, capability: professional tools remain Premium. Existing
professional.write/professional.reportand live server authority are reused. No checkout/provider activation or invented grant in this batch. Held-data exit stays free. - D-DRV-02, financial meanings: earned value, received money, wallet transfer and payout are distinct. Net-only summaries preserve unknown gross/fee components. Cash and economic estimates remain separate. Future typed adjustment links, never negative refuels, own reversals.
- D-DRV-03, distance: metre integers remain canonical. Decimal km input accepts one decimal separator (comma or dot), with no grouping/exponent/sign ambiguity; maximum precision is one metre. Entry/edit/reopen convert symmetrically. BRL cost displays two decimals, HALF_UP at final display only; ratios retain exact intermediates. Measured efficiency displays localized decimals, not an unexplained rational string.
- D-DRV-04, old history: no value/size/date heuristic proves a legacy unit. Missing explicit provenance is UNVERIFIED, not automatically 1000 times too small. Preserve original values/revisions; review requires owner intent, preview, body/revision fencing and deterministic retry. Ambiguous raw records remain readable/exportable and cannot supply a certified metric.
- D-DRV-05, work time: UTC plus explicit IANA report timezone, defaulted from device only at initial selection; monotonic active-time accounting and reboot gaps. Future app online intervals use union rather than addition. No shift/time runtime is built in this batch.
- D-DRV-06, privacy: manual operation needs no GPS. Optional work recording later requires its own explicit session start/stop and review under Android/Play policy. Navigation is not recording consent. Raw traces are off by default and excluded from cloud/logs/training; no collection is added here.
- D-DRV-07, ownership: existing account/origin/guest partitions remain; no guest adoption, restore or erasure bypass. All synthetic scenarios contain no passenger, account-secret, real receipt or precise contributor location.
- D-DRV-08, allocation proposal for later task: largest fractional remainder, stable ID tie-break, exact source-centavo sum; reserves and actual service costs are separate views. Owner values/effective dates define recurring cost; no invented tax/commission/depreciation rate. Freeze detailed time-proration coverage at DRV-06 before implementing it.
- D-DRV-09, offline: reuse existing bounded capability mechanism; the known vehicle admission lease is 24 hours, not automatic authority to create a different professional lease. Professional local entry/report acceptance must use its owning capability policy before future new paid behavior. No new quota or entitlement is invented.
- D-DRV-10, recovery: corrections produce a new acknowledged revision/operation under existing contracts; no destructive down migration. Unknown or invalid values do not become zero. Keep financial-v1 unchanged and test Go/Kotlin parity for methods implemented in this batch.
Use actual PremiumBounds: quantity 1..1,000,000,000 milli-units; actual paid total 0..1,000,000,000,000 centavos; general odometer 0..1,000,000,000,000 metres; note 280 runes; command batch 50. Charge has its separately frozen 1,000,000,000-metre ceiling: do not accidentally enlarge it when fixing UI conversion. Currency is BRL. These are input bounds, not performance or commercial promises.
Synthetic workloads: two full anchors for the unit defect; full/partial/full discounted chain; 50 queued commands for the existing batch boundary; 1,000 normalized rows for the existing bounded comparison projection (200 entries/year over five years is only a workload assumption); 1,001 rows must not return a truncated full report. No national ingest, external platform call or shared-VPS load is needed here. Performance acceptance budgets remain owned by DRV-31 and must be declared before its measurements.
- Owned ICE: 10000→10500 km, 40 L, BRL 260 → 500 km, 12.5 km/L, BRL 0.52/km.
- Partial fills: initial 50 L/BRL 300 excluded; partial 20 L/BRL 120 plus full 20 L/BRL 124 across 400 km → 10 km/L and BRL 0.61/km.
- Rental/multi-app: owner-entered lease and expenses, no added depreciation; six and five online hours overlapping four produce seven unique hours when future shift rules are implemented.
- EV/PHEV: preserve exact energy/fees and shared-distance method; no guessed per-motor kilometres. Charge odometer respects its existing stricter bound.
- GNV: raw m3 purchases valid; unsupported measured-consumption method stays UNKNOWN, never fake km/L.
- Legacy/missing data: no invented origin; review/correction must retain original data, fence stale edits and survive retry. Incomplete coverage shows a reason, never zero-cost profitability.
DRV-01 tests execute the current actual form/domain/formatting chain. DRV-02 freezes/classifies legacy repair and extends only the foundation needed for its safe acceptance; new earnings, shifts, GPS and driver hub are outside this batch.
- 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