core/baas-control-plane/docs/architecture.md

Arquitetura

O baas-control-plane implementa um control plane modular para gerenciar múltiplos provedores BaaS de forma multi-tenant. Ele centraliza provisioning, schema, secrets, métricas e auditoria sem executar workloads de clientes.

Camadas

• core: tipos e interface dos providers.
• providers: implementações técnicas de Appwrite e Supabase.
• modules: serviços de negócio (tenants, projects, provisioning, schema, secrets, finops, audit).
• lib: utilitários de ambiente, logger e HTTP.

Fluxo básico

1. Tenant é criado e armazenado.
2. Projeto é criado e vinculado a um provider.
3. Provisioning aciona o provider e salva o externalId.
4. Schema é versionado e aplicado via provider.
5. FinOps coleta métricas normalizadas.
6. Auditoria registra eventos relevantes.