Repository navigation
docs product ev README
Date: 2026-10-20. State: PLANNED / NOT_IMPLEMENTED_BY_THIS_AMENDMENT. Owner: EE execution, integrated with MEX. Sources/access limits: research register. Math: EV financial method.
EE-02 frozen data/numeric contract (2026-10-21): Typed data/ports, planned schemas and shared exact vectors now freeze this contract layer. Runtime implementations, source rights/ admission and real device/operator acceptance remain pending.
The requested target is complete product support for declared BEV, PHEV and non-plug-in hybrid journeys across Rust preparation, backend, Android local data, community prices and private costs/sync. It is not guaranteed coverage of every Brazilian charger/model, every live connector or every private operator's tariff. Unknown input/support/data is explicit, not a fabricated answer or silent fallback. Source/API rights, real operator access and runtime/device proofs have separate gates. Do not call core journeys complete while a required local path is missing.
This adds energy/propulsion support without replacing existing MEX/PRM/FQ/OPT, ANP fuel models or source history. Public catalog/compatible search/community stay free. One vehicle free and Premium for additional vehicles applies per physical vehicle, including PHEV, not per fuel/energy carrier. Retain existing source ceiling, legacy data and PRM professional/financial/cloud capability matrix.
- B-BR-EV-01 — Propulsion and capabilities: represent ICE, BEV, PHEV, HEV/MHEV explicitly; range-extender/other variants retain source wording and actual charging/fuel capabilities rather than guessed equivalence. A BEV need not have a liquid tank or liquid FuelProduct. A PHEV can hold fuel plus battery; HEV/MHEV must not be offered external charging unless explicitly supported. Unknown capabilities remain editable/unknown, not forced to a fake default.
- B-BR-EV-02 — Retained identity: keep vehicle IDs, fuel enums and historical persisted meanings through append-only migration. Add propulsion/carriers and optional capacities; never reinterpret a historical premium-gasoline value, assign an EV to all old rows or invent battery size on migration.
- B-BR-EV-03 — Specifications: model market/year/trim and source edition; gross versus usable battery capacity, connector support and AC/DC limits are distinct optional facts. PBE laboratory reference, manufacturer assertion, manual estimate and user-measured history remain separate. Corrections retain lineage and do not silently change old calculations or every vehicle model.
- B-BR-EV-04 — Exact units: energy Wh, power W, elapsed seconds, SOC with declared precision/basis, distance metres and money in centavos (actual total) have separate types. Rates use frozen exact decimal/rational semantics shared by Rust/Go/Kotlin. No float money, kW treated as kWh, L added to kWh, zero for missing values, unsupported conversion or overflow. Equivalent km/L on an EV label is not physical liquid consumption. MJ/km conversion preserves basis.
- B-BR-EV-05 — Place/equipment/connector identity: public charging location, EVSE/equipment and connector are separate entities with stable internal IDs and source-scoped external IDs/versions. Location count, EVSE count, sockets and simultaneous vehicle capacity are not interchangeable. One CNPJ/brand can operate many places; do not use CNPJ as the unique charger key. Unknown child equipment stays unknown, not a synthetic connector falsely counted as real.
- B-BR-EV-06 — Safe reconciliation: external source IDs and reviewed evidence govern merge/split; names/coordinates alone create candidates, not automatic identity. Keep source assertions, conflicting facts, duplicate lineage and operator changes. OCM API/export or OSM/Geofabrik are not independent witnesses. A partial import/missing row never silently closes or deletes a location.
- B-BR-EV-07 — Sources and rights: freeze source/profile/license, raw hash, fields, attribution, clocks, boundaries and limits before ingestion. Open protocol/public webpage does not grant commercial, offline or redistribution rights. Preserve each provider's license across backend, exports and Room; code MIT notices do not license third-party data. Restricted provider content cannot enter an unrestricted downloadable national pack.
- B-BR-EV-08 — Deterministic Rust batches: extend station-prep's local-file, no-network/no-database preparation pattern. Validate actual source bytes/profile and stream bounds; minimize fields; emit typed versioned manifests/records, complete independent census, duplicates/quarantine and field provenance. Unknown schemas, required artifact tampering or fatal framing produce no admitted partial batch. Go owns fetch/lease/atomic publication and recovery, not Rust.
- B-BR-EV-09 — Source clocks and access: fetched time does not refresh source status/tariff evidence. Distinguish operator update, observation, source edition, validity interval, successful check and private session time. Public/restricted/ customer-only/home access and hours are independent of catalog existence. No default open-24h/free/public assertion from absent provider tags. Residential/home candidates are not automatically eligible for public maps or reports. Require documented public-access/publication eligibility; minimize contributor/contact fields and never publish a private user's home coordinates.
- B-BR-EV-10 — Compatibility: reason from supported connector/format, AC/DC, known vehicle limits and access restrictions. Show compatible/incompatible/ unknown with explanation. A matching plug or advertised station power does not prove actual charging power, safe adapter use or guaranteed session duration. Unknown/unsupported types survive wire evolution without crashing clients.
- B-BR-EV-11 — Tariff context: tariff version, location/EVSE/connector scope, currency, tax inclusion, eligibility/membership/payment channel, timezone and effective interval belong to every offer. Components can include energy, charging time, idle/parking time, fixed session and explicitly separate parking fees, with steps/grace/min/max/restrictions only when sourced. Unknown is not free. A member/brand benefit is never shown as a universal standard price. A provider's free-text cost description remains a bounded attributed note; it is not a complete structured tariff inferred by regex or missing-fee defaults.
- B-BR-EV-12 — Price comparison: rank like-for-like energy rates only when those fields/conditions are complete, explicitly label excluded fees; otherwise compare estimated total for the same declared energy/time/parking scenario. Unknown mandatory components produce incomplete/unrankable, not cheapest. Save tariff revision and assumptions; a simulation is not an actual bill or guarantee.
- B-BR-EV-13 — Community reports: signed free-account writes target an eligible stable public charging entity and exact tariff/condition/component scope. Store reported/observed times, provenance and bounded content; support correction, withdrawal, replay, owner reads, quotas and existing moderation/privacy. No compulsory GPS, payment, document upload or public home-location admission. Ordinary optional media follows existing accepted retention/proof policy only.
- B-BR-EV-14 — Independent signals: price report, successful/failed charging experience, access report and provider availability are different evidence. Helpfulness/votes and repeated snapshots do not certify price or independence. Freeze EV-specific eligibility/freshness/conflict policy with evidence before current-price promotion; do not blindly reuse liquid-price thresholds. Until accepted, reports remain dated source-separated claims, with no invented score.
- B-BR-EV-15 — Operational availability: occupied/available/fault/out-of-service states require an authorized fresh per-equipment source and clear last update. Expiry/outage/unknown becomes stale or unknown, not available. A check-in, static listing, protocol support or old status cannot imply a reservable/live connector. No live-status promise for Brazil from global API marketing.
- B-BR-EV-16 — Private charging ledger: owner/origin-bound session records include source/measurement basis, actual energy/amount when known, times, odometer, optional SOC and tariff snapshot/fees. Home/work/public context is private unless the user separately submits an eligible public observation. A private charge must never automatically publish price, address or SOC history.
- B-BR-EV-17 — Honest energy metrics: bought/metered energy per km, measured vehicle efficiency, PBE reference and modeled battery estimate are different methods. Compute only on matched complete distance/energy windows with declared SOC/anchor/gap policy; otherwise explain UNKNOWN. SOC percentage times nominal battery size is an estimate, not metered energy. Never assume a fixed loss rate, measure battery health from bills or present nominal range as guaranteed travel.
- B-BR-EV-18 — Hybrids and reports: retain liquid entries/quantities plus electric sessions in one vehicle. Sum actual compatible monetary costs over the same distance window for R$/km, without double-counting wallet top-ups, fuel, session fees or parking. Do not assign all PHEV kilometres to liquid or electric propulsion without evidence. Monthly timezone/correction/coverage and supported versus unknown methodology follow PRM and EV financial vectors.
- B-BR-EV-19 — Home energy cost: user-entered known effective rate/actual total has declared basis and dates. Distributor TE/TUSD reference is not the final household bill, public charger price or automatically zero-cost solar energy. Fixed charges, taxes, flags and allocation assumptions remain explicit when applicable; no utility-account/document scraping or solar savings guarantee.
- B-BR-EV-20 — Local-first processing: Android imports validated bounded typed public snapshots/pages into Room with manifest/schema/source/licensing metadata, atomic generations and safe deltas/full-resnapshot. Preserve old accepted data on interrupted/inconsistent download; no whole-user DB wipe. Lists/search/filter/detail/estimates/allowed private entry work offline with honest age. No full national PBF/PDF scan or network work on UI thread, no requirement to embed Rust into the APK without a separately proven need.
- B-BR-EV-21 — Sync/privacy: extend PRM's explicit allowlist for vehicle energy fields and eligible private sessions/reports; keys, tokens, raw bills/photos, precise home/route location and public packs remain excluded. Durable receipts, conflicts, owner switch/lapse, erasure and restore fences apply. No pretending local writes are synced or restored; held-data exit survives subscription loss.
- B-BR-EV-22 — Shared discovery and official context: reuse MEX city/discovery, scoped filters/cursors and rankings; public EV community/catalog do not gain a paid gate. Keep electric tariffs distinct from ANP liquid prices and official fuel occurrences. Co-located fuel/charging entities can link only with safe evidence; an ANP fuel infraction is not an EVSE violation. Community complaint is not an official sanction or electrical safety inspection.
- B-BR-EV-23 — Bounded runtime: existing Go monolith/jobs/PostGIS, Rust batch tool and Kotlin layers remain. Typed ports separate modules. Licensed partner reads are bounded/cancellable/cached only as permitted. No ingestion/fan-out to providers per search/keystroke, leaked API key or uncontrolled polling. Query filters apply before pagination, source vectors bind cursors/ETags, and mutable status/tariff expiry invalidates results even without a write.
- B-BR-EV-24 — Scope and acceptance: every declared local user journey requires meaningful tests and atomic evidence/commit. Full support means these journeys are complete, not all models/chargers/network coverage. Track rights/provider/ source/device/deployment proof separately. D receipts/business portal remains held; no vehicle tracking/control, OCPP server, payment/start/stop/reservation, iOS, commercial activation, connector safety certification or automatic routing feasibility engine is introduced by this data-support amendment.
- BUC-EV-01: add/restore/update ICE, BEV, PHEV and HEV/MHEV, optional unknown specs, existing IDs and one-free/additional-Premium lifecycle.
- BUC-EV-02: select exact model/version reference, correct a capability, compare lab/manual/measured values without changing history silently.
- BUC-EV-03: browse/search compatible public charging places, equipment and connectors by city/region/access/power/type; offline/no-price/unknown included.
- BUC-EV-04: inspect complete tariff conditions/fees or unknown components, compare a declared scenario and return to source/history.
- BUC-EV-05: signed community tariff/access/experience report, replay, correction/withdrawal, helpfulness/report and moderated public/private states.
- BUC-EV-06: private home/work/public session entry, incomplete measurements, offline draft/save/reopen, correction and no automatic public disclosure.
- BUC-EV-07: BEV/PHEV month/cost/efficiency reports, matched windows/gaps/SOC, supported units, comparisons and explicit unknown results.
- BUC-EV-08: authorized operator status/tariff read, expiry/outage/unknown, inaccessible provider and no fake live/reservation status.
- BUC-EV-09: signed public pack/page import, schema/rights/clock metadata, cancellation/corruption/old cursor, atomic replacement, local filters/reconnect.
- BUC-EV-10: Premium sync/import conflicts, late account switch, held-data exit, deletion/restore and exclusion of keys/home location/public cache.
- BUC-EV-11: master questions for compatible chargers and contextual cost, source-separated geography/period, incomplete tariffs and no fake national best.
- BUC-EV-12: source correction/alias/removal, full census/lineage, retained fuel/ANP functionality, accessibility/locales, bounds and scoped rollback.
- 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