Repository navigation
docs enterprise modules station commerce
Let a currently authorized station representative publish bounded commercial information and transact with a fleet under an explicit contract.
F7 follows the separate Stage D override, representation decision and staffing evidence; the maintainer recorded the commerce override for the delivered slice (EDR-386), while station claims, the station portal, replies, metrics and statement reconciliation stay gated. It adds commercial profile, announced prices, labelled promotions, replies and agreements. It cannot overwrite official records, moderate its own criticism or change trust.
Delivery state (M7 local checkpoint, EDR-391): announced prices (000260), labelled promotions, bilateral agreements with private negotiated terms (000261), bounded single-use authorizations, the once-only station redemption and the cross-organization sharing guards are implemented and locally verified; the station-side surfaces stay behind the production composition boundary (503) until the recorded activation, exactly like the profile surface.
The organization owns profile revisions, announced price and promotion under one station authority. An agreement names two explicit parties. A voucher belongs to its transaction scope. Each side owns its internal accounting record and sees only the agreed field allowlist.
- BR-STN-001 — Separate commercial source. An announced price has product, unit, author, conditions and validity and never enters official or community consensus (BR-SRC-001).
- BR-STN-002 — Neutrality. Payment and promotions do not affect organic ranking, moderation, trust or confidence (BR-SRC-002).
- BR-AGREE-001 — Narrow bilateral sharing. An agreement grants only named transaction fields to named parties. It grants no fleet, employee, document or location browsing (EDR-023).
- BR-AGREE-002 — Once-only redemption. An eligible voucher is consumed online once under current authority and its validity and limits.
UC-STN-01 — Announce a price. A current representative selects an authorized station, product and conditions and submits a revision. The server validates authority and validity. A superseded or withdrawn announcement retains history.
UC-AGREE-01 — Establish terms. Eligible representatives propose and explicitly accept an agreement. Suspension or ending stops new eligible transactions under its recorded policy. Neither party expands the allowlist unilaterally.
UC-AGREE-02 — Redeem. A permitted station actor submits the valid transaction and voucher. Current server checks and one transaction record the result. A confirmation for the same voucher, product, unit and quantity returns the recorded result. A change to any settlement field is a conflict. The station receipt contains the settlement, agreement, voucher and station identifiers, the product, unit, quantity, negotiated unit price, total and confirmation time. An operation identifier already used to redeem another voucher is also a conflict. Typed ports create only the permitted internal fueling and receivable effects.
Announced prices are active, expired, withdrawn or superseded. Promotions have scheduled, active, ended or withdrawn state. Agreements are proposed, active, suspended, ended, declined or expired. Vouchers are issued, redeemed, expired, cancelled or locked. The state catalog defines names. Each transition checks current station authority and party scope and retains audit history. Commercial expiry never rewrites representation history.
Station-scoped permissions require live station authority. Fleet and station views use separate party scopes. General agreement visibility does not permit employee, track or original document reads. Catalog corrections use Directory governance. Official replies use existing feedback moderation rules.
Profile management, agreements, pre-authorization and voucher redemption are online-only. Server time decides validity. Redemption locks its source authority and limits and persists one acknowledgement with the accepted effects. Corrections use reviewed revisions and preserve each party's history.
Publication uses profile revision ports. Redemption invokes typed fueling and payable interfaces with minimal fields. Interaction metrics require admitted collection and thresholds. Notification payloads remain bounded. Fiscal invoicing and provider settlement require their separate reviewed integrations.
Negotiated prices retain product, quantity unit, payment and offer conditions, effective interval and source version. Integer centavos and milli-units follow BR-MONEY. A statement reconciles existing transaction records and never creates another expense. Comparison cannot silently substitute announced or negotiated values for official or community data.
| ID | Surface | Objective | Actor | Data and actions | Validation |
|---|---|---|---|---|---|
| SCR-STN-01 | PORTAL | Manage authorized station commerce | Current representative | Profile, separate price source and promotions | Authority, validity, labels and five shared states |
| SCR-AGREE-01 | PANEL, PORTAL | Review own contract side | Permitted party | Allowed terms and transaction facts | No general cross-party access, explicit acceptance |
| SCR-AGREE-02 | PORTAL | Redeem an eligible voucher | Authorized station actor | Safe voucher metadata and server result | Online requirement, bounded failures and accessible outcomes |
EP15 supplies tasks and dependencies. VAL-33 and VAL-34 prove neutrality and transaction-only sharing. Test revoked authority, expiry, competing redemption, field allowlists on API/jobs/exports and duplicate cost recognition before any activation.
- 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