Repository navigation
docs product stations fuel quality
2026-10-14 D deferral — adopted maintainer restriction: Future D holds private purchase/document verification and attachment features until extreme app consolidation plus thousands of real clients, unless the maintainer explicitly requests earlier named scope. Official ANP history and non-document reports remain independent. Rules below are future target semantics, not permission to collect documents or implement D now.
Owner: FQ-00–FQ-17 implementation plan. Existing price, account, feedback, media, trust and profile rules retain their meanings. FQ-12 separately freezes numeric score methodology. This file changes no API or runtime policy.
For each canonical station, expose dated official evidence by fuel, distinct enforcement/sanction records, clearly identified consumer experiences and a versioned explanation of available reliability measures. Every station can have a quality profile; lack of observations means insufficient evidence.
A user can inspect all safely matched published official cases, open their source, request correction of a station association and attach a related experience. User votes/claims do not validate chemical quality or legal guilt.
- B-BR-FQ-01 — Source separation. GIVEN PMQC, enforcement, sanctions, community reports, ratings and price confidence, WHEN presenting a station, THEN expose their provenance/meaning separately. No user command edits an official finding; PMQC is not an infraction notice.
- B-BR-FQ-02 — Exact historical identity. GIVEN a source event, WHEN binding it, THEN use a valid full establishment CNPJ and explicit chronology/review. A name/address/nearby point, CNPJ root or different branch cannot establish the binding. Unmatched/ambiguous cases remain in quarantine/review, not lost.
- B-BR-FQ-03 — Lossless samples and assays. GIVEN several assay rows for a sample, WHEN importing, THEN retain each distinct assay/result/unit/conformity and count the sample independently. Unknown fields/fuels/status stay explicit. Missing or conflicting native identity never silently merges samples.
- B-BR-FQ-04 — Versioned official facts. GIVEN a revised resource, WHEN publishing, THEN retain hash/source/schema/native-key provenance and append correction/supersession/withdrawal. Identical content is idempotent; changed content cannot overwrite historical evidence or double count a sample.
- B-BR-FQ-05 — Complete-run visibility. GIVEN a failed/partial import or concurrent replay, WHEN serving, THEN retain the previous complete published revision. Counts reconcile all inputs and all matching dispositions; a URL label alone never proves a period's coverage.
- B-BR-FQ-06 — Honest procedural status. GIVEN an action/fine/proceeding snapshot, WHEN displaying, THEN preserve actual scope/status/as-of date. Autuation, payment, absence of later records or unverified linkage never means definitive guilt, acquittal or current legal status.
- B-BR-FQ-07 — Public and private authorization. GIVEN a guest, WHEN reading official public history, THEN allow bounded reads. GIVEN a write/private owner read, THEN require current authenticated account and verified caller binding; reject forged owner/station/event/fuel and revoked or foreign proof.
- B-BR-FQ-08 — Claims versus checked purchases. GIVEN a consumer report, WHEN assigning evidence level, THEN distinguish user claim, supplied document and independently checked purchase. An image/OCR/valid-looking key/CNPJ alone never verifies a purchase, adulteration or ANP protocol. Failed/unavailable verification stays explicitly unresolved.
- B-BR-FQ-09 — Temporal correlation. GIVEN a related official case and consumer experience, WHEN linking, THEN verify station/fuel/revision and show dates. Proximity in time does not prove the same batch/tank, cause or diagnosis.
- B-BR-FQ-10 — Independent community signals. GIVEN related accounts/keys or reused receipts, WHEN aggregating, THEN avoid multiple support for one attribution/purchase. Distinct accounts are not guaranteed distinct humans. Thresholds need frozen evidence; unresolved abuse stays under review.
- B-BR-FQ-11 — Score sufficiency and isolation. GIVEN too little/stale/ unmapped evidence, WHEN reading a score, THEN return null with reason/counts. Eligible per-fuel scores have frozen sample semantics/window/rounding and version. Payment, rating, brand, profile badge, raw report count and pending non-quality proceedings cannot affect the proposed v1 numeric score.
- B-BR-FQ-12 — Reproducible dated explanations. GIVEN identical eligible official facts, policy and injected clock, WHEN rebuilding, THEN produce the same score/flags/counts independent of input order. Return as-of, expiry, coverage and input/policy revision. Expired views are stale even if jobs stop. A current favorable score cannot hide a dated nonconformity.
- B-BR-FQ-13 — Fuel scope. GIVEN evidence for only one fuel, WHEN presenting the station, THEN identify its coverage. Gasoline findings cannot establish diesel quality; a station-wide numeric index needs its own accepted aggregation policy. Every station can expose an unavailable score-state object.
- B-BR-FQ-14 — Privacy and retention. GIVEN receipts/workshop/lab documents, WHEN storing or rendering, THEN keep them private, minimize identifying fields and apply the established operational media ceiling of 24 hours. Private protocol/CPF/keys/GPS/object references never appear publicly or in logs. Training consent is unrelated. Erasure/restore replay and checked-status degradation are documented before persistence.
- B-BR-FQ-15 — Review and recovery. GIVEN disputed linkage, report abuse, source correction or erasure, WHEN deciding, THEN append actor/reason/policy, adjust eligibility and enqueue affected rebuilds atomically. Corrected wrong links are removed from the active wrong-station view; appeals cannot rewrite source records or grant station representatives moderation power.
- B-BR-FQ-16 — Measurable complete access. GIVEN one frozen complete source edition, WHEN traversing the public case API/app, THEN every matched eligible event is reachable exactly once and each has source/date/detail. Record the denominator plus unmatched/quarantined/missing periods. Offline cached content is dated; queued writes are not server-acknowledged validations.
- BUC-FQ-01: Discover/prepare/stage/publish official evidence. Test malformed archive/schema/period/encoding, limits, loss accounting, deduplication, partial failure, retry/concurrency and prior-publication preservation.
- BUC-FQ-02: Resolve/review station linkage. Test full-CNPJ branch distinctions, leading zeros/alphanumeric values, missing/historical identity, conflicting mappings, succession and corrective replay.
- BUC-FQ-03: Revise/retract/recompute. Test corrected assays/identity/status, source resource replacement, duplicate annual/monthly data, atomic visibility, stale jobs and rebuild convergence.
- BUC-FQ-04: Inspect official station/fuel history and case detail. Test guest access, source separation, no sample, partial fuel coverage, stale data, procedural labels, bounded complete pagination and source links.
- BUC-FQ-05: Submit/edit/withdraw own structured experience and request linkage review. Test signed owner proof, idempotency/replay, invalid targets/text/dates, foreign-owner denial, parallel writes, moderation and source immutability. Android refinement (2026-11-10): the Profile entry "Meus relatos privados" is the owner's history. A report always targets one station and one fuel, so the history never creates a station-less report: when the signed owner list is empty it explains where reports are created and offers one action that opens the station list; an existing report can still be selected there to edit, appeal or withdraw. Guests see only the free sign-in action. Report text, dates and status stay in memory and behind the secure window.
- BUC-FQ-06: Attach/check/minimize/expire private supporting documents. Test fabricated/reused/foreign evidence, unavailable verifier, false protocol claim, expiry races, every-copy deletion, erasure and restoration.
- BUC-FQ-07: Detect/review/appeal a community pattern. Test related attribution, account farms, duplicate purchases, conflicting official history, insufficient independence, audit and no numeric official-score contamination.
- BUC-FQ-08: Export/erase/recover private quality data and command state. Test logout/account/origin isolation, expiry, restored deletions, redacted audit, lost-response convergence and no resurrection of checked/private evidence.
- BUC-FQ-09: Explain/rebuild available reliability measures. Test hand-calculated sample denominators, no/sparse/stale inputs, exact arithmetic, input reordering, fuel coverage, policy changes and chronological recovery without history loss.
Critical SQL/auth/privacy/jobs scenarios use immediate real PostGIS and actual affected storage/transport boundaries; pure rules use deterministic RED → GREEN → REFACTOR. Runtime completion requires those tests, not this target document.
UI is localized; the following Portuguese phrases convey the intended meaning:
- "Amostra ANP/PMQC: conforme em [data]" or "Ensaio não conforme registrado".
- "Ação de fiscalização registrada"; show source-proven procedural status.
- "Relato do usuário", "Documento apresentado" and "Compra verificada" only where a recorded independent verification supports the latter.
- "Dados insuficientes para calcular a nota"; show fuel/date/coverage reasons.
- "Nota baseada nas amostras históricas disponíveis"; link methodology and source denominator. Avoid "combustível garantido", "fraude comprovada" without appropriate official proof, or claims of ANP certification/affiliation.
- "Informar divergência neste registro", "Relacionar minha experiência" and "Consultar canal oficial da ANP". No automatic complaint transmission.
Concrete wire enums, endpoints, legal/privacy copy, verification providers and score thresholds are frozen by their owning tasks; none exists merely because its target label appears 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