Repository navigation
docs product ev financial method
Date: 2026-10-20. EE-11 is LOCAL_DONE / INTEGRATION_PENDING; other runtime methods remain unimplemented until their owning acceptance. Owner: EV rules, EE-02/11/15/16/23. Extends, never reinterprets, financial-v1. Freeze machine vectors before code; numeric input ceilings/rounding precision follow a recorded need and existing bounds, not arbitrary guesses or provider float examples.
Independent review, 2026-10-21: audited EE-11 checkpoint repairs false Rust overflow, fractional/calendar decoding and typed-input validation.53 shared vectors now execute in Go/Kotlin/Rust without new dependencies. Large rational intermediates remain exact; only the rounded money result is subject to the existing centavo ceiling. No provider/source, session persistence, public API or production acceptance follows from this.
EE-02 checkpoint, 2026-10-21: exact policy/data contract and24 shared CSV arithmetic vectors are frozen and validated in Go/Kotlin/Rust. This is contract arithmetic, not acceptance of the EE-11 runtime tariff engine, measurement/window method, provider billing or SQL/report implementation.
EE-11 checkpoint, 2026-10-21: the pure tariff scenario engine is implemented in Go/Kotlin with a Rust parity oracle over 42 shared synthetic rows (evidence). Only INCLUDED tax with complete mandatory components, no undeclared minimum/maximum stage and the supported final half-up rounding produce KNOWN centavos; absent energy, incomplete/unknown fees, eligibility mismatch, partial validity windows and money overflow are explicit refusals/UNKNOWN. This remains a local pure engine: provider billing terms, SQL/report persistence, monthly timezone allocation and public ranking are not accepted by this checkpoint.
Persist actual paid BRL in centavos; energy in an exact declared Wh-compatible scale, power W, time seconds and odometer metres. Raw rate decimal, unit, billing step, eligibility, minimum/maximum, tax basis, validity and timezone are preserved and converted using checked integer/rational operations. Freeze final display rounding and provider billing rounding separately; no rounding each intermediate unless the actual tariff specifies it. Cross-language Rust/Go/Kotlin vectors must agree. Unknown fees, amount, energy or basis are nullable, never zero defaults.
Keep four methods distinguishable: reference/modelled vehicle efficiency; meter/charger-basis purchased-energy interval; actually measured vehicle energy; and monetary observed-window cost. Compare only the same method/basis/unit and matching eligibility. No phone GPS distance or nominal battery inferred energy silently completes an odometer/energy window.
An electric matched interval requires a declared source/measurement basis, positive complete distance and included energy with accepted start/end charge state/anchor/gap policy. Different battery state at endpoints affects bought energy versus consumption; disclose that limitation or return UNKNOWN under the frozen method. Never call arbitrary sum of purchases divided by driving distance exact battery efficiency. For a PHEV do not infer distance split between motors.
Monthly money totals use event occurrence in the selected IANA timezone. A session can preserve start, end and payment timestamps; the frozen event-time rule selects the monthly expense basis. Crossing midnight/month does not permit inventing per-minute energy/cost without interval evidence. A monthly total does not establish a complete monthly distance denominator. Retain separately labelled valid observed-window metrics. A backdated correction invalidates dependent output.
- Unit conversion: 150 Wh/km = 0.15 kWh/km = 15 kWh/100 km = 0.54 MJ/km. A PBE field labelled equivalent km/L is retained under its actual method; no implicit conversion to physical litres or guessed kWh based on that label.
- Actual energy charge: 30 kWh at BRL 1.80/kWh = BRL 54.00; plus explicit BRL 2.00 session fee = BRL 56.00. At 160 km over a valid same-basis matched interval, bought energy is 18.75 kWh/100 km and cost is BRL 0.35/km, labelled purchased-energy/session-cost basis, not battery laboratory efficiency.
- Separate parking: add BRL 8.00 parking to the previous same-window case: fuel/energy-session cost stays BRL 56.00, all included cost becomes BRL 64.00 and BRL 0.40/km. Do not include parking twice or label BRL 0.40 energy-only.
- Multi-component tariff: 12 kWh at BRL 2.00/kWh plus 600 charging seconds at BRL 0.50/minute plus BRL 2.00 fixed = BRL 31.00 before idle charge. Six idle minutes with five-minute grace, one-minute billing steps and BRL 1.00 per charged minute add BRL 1.00: total BRL 32.00. Freeze inclusive boundary and step semantics with additional zero/exact-boundary/partial-step cases.
- Free is explicit: known zero energy/session price plus BRL 10.00 parking is not a free whole visit. Missing energy price cannot be treated as zero; unknown mandatory fees prevent ranking by complete estimated total.
- PHEV monetary aggregation: 25 L at BRL 6.00 = BRL 150.00 plus 20 kWh at BRL 2.00 = BRL 40.00; total BRL 190.00 over a valid same 500 km window is BRL 0.38/km. Do not derive liquid efficiency as 500/25 or electric efficiency as 500/20 without proven propulsion-specific distance/energy method.
- Measurement distinction: 18 kWh measured at supply and 16 kWh measured at battery over verified corresponding boundaries differ by 2 kWh. Preserve both measurement bases and provenance; do not assert a universal loss rate, degradation or every future session's efficiency from this observation.
- SOC estimate: nominal 60 kWh and 50 percentage-point SOC change does not establish 30 metered kWh. Usable/gross capacity, display estimation and losses are unknown unless supplied. Retain a labelled model estimate separately; do not overwrite the reported meter energy or actual paid total.
- Home tariff: separate TE/TUSD references are incomplete as a final home rate without the applicable other components and basis. A user-supplied known effective BRL/kWh can drive a labelled estimate; actual paid session allocation remains a separate asserted amount. Solar/free/employer-paid is explicit data, not inferred from a location label or a vehicle model.
- Wallet is not a second session: adding BRL 100.00 prepaid credit and later paying BRL 40.00 for one session does not create BRL 140.00 of consumed-energy expense. Wallet/payment processing is outside this scope; do not fabricate ledger energy or double count imported session totals and tariff components.
- Unknown or incompatible windows: missing distance, mismatched SOC/gaps, meter-basis change, partial-month coverage and reset segments produce the relevant UNKNOWN reason; raw monetary/energy totals remain readable. A cost correction/deletion recomputes affected revisions, not an unrelated vehicle.
- Comparability and bounds: unequal-distance fleet/vehicle summaries use eligible summed energy/cost/distance, never average individual ratios. Keep L, m3 and kWh totals separate. Refuse negative/overflow/noncanonical decimal, unknown currency conversion, unsupported precision and zero denominators.
These are test targets, not observed customer results, active billing terms or implemented measurements. Add timezone/daylight-change, member/nonmember, effective-tariff switch, provider rounding, capped/minimum charge and incomplete components to the frozen test matrix before ranking a real offer.
- 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