docs README

abastevo documentation

Notification content/OneSignal plan defines proposed bodies and PRM11–PRM14; implementation and live sends remain deferred.

Premium execution plan, product contract and first-ten evidence track the isolated backend batch and deferred real payments.

Current commercial direction: community delivery plan, experience contract, Android/iOS scope ADR, parked iOS backlog and native icon guide.

This repository contains the preserved Android app, integrated backend phase history and the next functional multiplatform plan. Current status is in PROGRESS; prior command outcomes are preserved as evidence, not rerun claims. Next implementation: P12-T01 after G09-LOCAL correction integration; real-production G09 waits until G18.

Canonical planning documents

Next construction: Android/VPS P34–P38 and continuation prompt; subsequent national catalog and station representation. Plans are not runtime proof.

• CURRENT_STATE_AUDIT — source provenance, real implementation, reuse and inconsistencies.
• PRODUCT_CONTRACT — free/community scope and revised local-backend → functional-app → real-production ordering.
• TARGET_ARCHITECTURE — C4 views, modules, ownership, flows, jobs and scale.
• DOMAIN_MODEL — vocabulary, B-BR invariants, aggregates/events/states.
• COMMUNITY_PRICING_SPEC — admissibility, conditions, consensus, trust and freshness.
• API_PLAN — contracts, proof, errors, idempotency and caching; OpenAPI introduced in P01.
• DATA_MODEL — proposed ownership, tables, constraints, indexes, transactions and volumes.
• ANP_INGESTION — source discovery, parser validation, revisions, geo and shared fixtures.
• SECURITY_PRIVACY — STRIDE, identity/media security, inventory and rights.
• TEST_STRATEGY — unit/integration/contracts/golden/migration/E2E/load and risk-based gates.
• INFRASTRUCTURE_PLAN — environments, deployment, recovery, observability and cost assumptions.
• DELIVERY_WORKFLOW, FAST_EXECUTION and CI_PLAN — isolated phase branches/checkpoints, task issues/commits, immediate targeted tests, final project batch CI/PR merge/wiki and separate full release.
• Phase record, task issue and phase PR — templates for G01-FLOW helpers; no remote records are implied.
• AI_ENGINEERING_CONTRACT and AGENTS — bounded task workflow and DOD-1.
• MIGRATION_PLAN — each existing feature, offline/conflict behavior and P10 integration.
• Backend BUC-001…008 — actor/preconditions/flows/rules/events/acceptance.
• ADR_INDEX — existing decisions plus backend and delivery policy decisions.
• OPEN_SOURCE_BUSINESS and TRADEMARKS — MIT preservation, brand and hosted value.
• DECISIONS, RISKS, REQUIREMENTS_TRACEABILITY — unresolved choices, failure risks and brief coverage.
• BASELINE_VALIDATION, original plan validation, P01 evidence archive and workflow revision validation — dated evidence and limitations.

Read only what the task needs

Every task: AGENTS → PROGRESS → selected roadmap task → relevant product/rule/BUC → ADR → specific API/schema → relevant tests/code. Import work adds ANP_INGESTION; security/media adds SECURITY_PRIVACY; deployment adds INFRASTRUCTURE_PLAN. No need to reload every plan per task.

Legacy Android references: user-business-logic, architecture, tech-stack, glossary/BR-001…028, data-sources, local build, privacy policy, use cases. These remain historical/current-app context; audit conflicts are explicitly tracked.

References checked for this plan

Technical/legal/provider facts were checked on 2026-09-28; recheck at implementation/procurement where relevant.

• Android Keystore — key protection/support considerations.
• RFC 9421 — message-signature profile basis.
• PostgreSQL SELECT, PostGIS ST_DWithin — queue lock and spatial-query semantics.
• R2 presigned URLs and pricing — direct-upload capability and cost categories.
• Nominatim usage policy — provider restrictions; no national bulk assumption.
• Receita Federal CNPJ program — alphanumeric identifier compatibility.
• LGPD and MIT license text — review references, not a claim that the project is legally certified.

Functional multiplatform extension

• MOBILE_DELIVERY_PLAN — explicit phase sequence and functionality-first acceptance.

• KOTLIN_MULTIPLATFORM_AUDIT — actual versions, portability gaps and official compatibility sources.

• STATION_FUEL_FEEDBACK — stars, 280-character text, votes and moderation.

• FREE_ACCOUNT_ACCESS — free email-code/Google/Apple signup and secure recovery.

• LOCAL_MEDIA_LOCATION_POLICY — low-memory encoding, all-copy 24-hour expiry and simulated-location controls.

• ADR-014, ADR-015 — release order and Kotlin/Swift boundaries.

• Brand identity — selected name/logo and local README artwork awaiting approval.