Skip to content

docs enterprise README

AlexandreZanata edited this page Nov 21, 2026 · 1 revision

Abastevo Empresas

Private fleet, fueling, expense, document and trip management for companies, built on the same backend and Android app as the public product. Organization data is isolated by the boundary in decision 025: row-level security, explicit permissions and an active organization context. The suite is disabled in staging until the activation runbook is applied (operations). Open work is listed in the backlog and summarized in ROADMAP.md.

Reading order

Business rules first, then design and interfaces.

Document What it answers
Conventions Identifier formats, the module and task templates, validation profiles
Product vision The four fronts, audiences, problems, scope by module and phase, what the suite is not, commercial hypotheses
Glossary One meaning per term; status words with a fixed meaning
Shared business rules Tenancy, source separation, honest status, exact values, time, audit, review lifecycle, amendments; generated rule index
Journeys Thirteen end-to-end journeys with rules and exceptions
Domain model Contexts, aggregates and owners, relations, constraints
Permissions Roles, scopes, permission registry, the action × role × scope matrix, active context
State model Operational, sync and review states kept apart; catalog of every state machine
Architecture Modules, request pipeline, API conventions, persistence, events, panel refresh, storage, capacity hypotheses, activation and rollback
Offline and sync Operation queue, acknowledgements, intake decisions, review queue, the offline matrix
Privacy and security Isolation, minimisation, retention schedule, devices, points that need legal validation
App experience Enterprise mode: information architecture, shared states, flows, screen index
Web experience Company panel, station portal, internal administration
Validation Risks and how each is proven, fixtures, scenarios with exact numbers, exit criteria
Decisions Decisions proposed, conflicts with existing rules, assumptions, open questions, what is actually blocking

Module specifications

Each follows the same twelve sections (00-conventions §4).

Front Module Codes Backlog
Empresas Organizations ORG EP02
Empresas Identity and employee accounts IDN EP03
Empresas Permissions AUTH EP03
Empresas Offline and sync OFFL EP04
Empresas Fleet and meters FLEET, METER EP05
Empresas Trips and logbook TRIP EP06
Empresas Tracking, routes and navigation GPS, ROUTE EP07
Empresas Fuelings and consumption FUEL EP08
Empresas Documents DOC EP09
Empresas Expenses, approvals, budgets, finance EXP, APPR, BUDG, FIN EP10
Empresas Maintenance and checklists MAINT, CHECK EP11
Empresas Internal fuel stock STOCK EP12
Empresas Intelligence, findings, reports KPI, FIND, RPT EP13
Empresas Imports, notifications, integrations IMPORT, NOTIF, INTEG EP18
Postos Station claims and representation CLAIM EP14
Postos Station commerce and agreements STN, AGREE EP15
Data, Motoristas Subscriptions and public products SUBS, PUB EP16
Data Abastevo Data DATA EP17
Platform Back office BACK EP19
Platform Architecture, privacy and security PLAT, PRIV EP01
Programme Governance and discovery; release gates GOV, REL EP00, EP20

The full task list with phase, cut, type, size and dependencies is backlog/INDEX (generated).

Fuel prices wiki

Source: AlexandreZanata/Abastevo @ e4a67580fc368a59bc1c0f1e0466fc011313f330

Clone this wiki locally