Skip to content
Blueprintt × Omie

Blueprintt × Omie

EventStorming-driven domain model + C4 architecture, focado no MVP da Versão Atual.
Domain (EventStorming) Architecture (C4)

TL;DR

Section titled “TL;DR”

Backend FastAPI orquestra Bubble ↔ Omie ERP. Bubble dispara 1 trigger automático ao criar pedido; o backend executa todas as regras de billing, emissão de NFS-e, webhook Pagar.me e lookup CNPJ. Integração exclusiva via aplicativo AABC (LNG fora do escopo). Esta é a Versão Atual, decidida em 07/05/2026 e canonicalizada no Confluence.

Por onde começar

Section titled “Por onde começar”
Domain (EventStorming) 24 events, 21 commands, 10 aggregates, 36 termos UL — o mapa do mental model do domínio.
Architecture (C4) System Context → Containers → Components via Structurizr DSL — como as peças se conectam.
Decisions Versão Atual canonical (8 ADRs) + pendências em aberto + gaps do audit OrderToBillingFlow.

Como ler estes docs

Section titled “Como ler estes docs”

Comece por Domain pra mapa do mental model: eventos, comandos, agregados, e linguagem ubíqua. Siga pra Architecture pra entender como as peças se conectam — do contexto sistêmico até os componentes internos do backend. Vá pra Decisions quando precisar entender o porquê de cada escolha, o que ficou fora do escopo, e o que ainda está em aberto.

Stack reference

Section titled “Stack reference”
  • Backend — Python 3.11+, FastAPI async, SQLAlchemy 2.0, Alembic, uv (Astral). Postgres prod / sqlite test. Redis + ARQ pra jobs.
  • Bubble Data API — https://eventos.blueprintt.co/version-test/api/1.1/obj (staging). Bearer token. Backend lê/escreve via Data API; mantém localmente apenas billing_schedule, omie_id_map, idempotency_cache, action_log, invoices, order_sync_record.
  • Omie API v1 — cliente, OS, faturamento via aplicativo AABC. Toggle Homologação cobre só envelope NFS-e.
  • Pagar.me webhook — HMAC obrigatório, idempotência por charge_id.
  • Brasil API CNPJ — chamado pelo backend (rate limit + cache), resultado escrito de volta no Bubble.

Source of truth

Section titled “Source of truth”

A página canonical de business rules é Confluence 3813310465 — Integração Financeiro Blueprintt — Omie (Versão Atual). Estes docs refletem o domínio e a arquitetura derivados dela. Quando houver conflito, a página Confluence prevalece em regra de negócio; o código prevalece em comportamento implementado. Memory ledger transitório fica em memory/state.md no repo.