C4 - Nível 1 (Contexto)

Objetivo

Representar o Billings Ease no ecossistema externo com atores, sistemas integrados e limites de responsabilidade.

Atores primários

• Cliente
• Profissional
• Administrador
• Operações internas (suporte/financeiro)

Sistemas internos

• Backend API (billings-ease-backend)
• Frontend Web (billings-ease-web)
• Mobile App (billings-ease-mobile)

Sistemas externos

• PostgreSQL
• Cloudflare R2 (storage)
• Mercado Pago (pagamentos/webhook)
• Provedores OAuth (Google)
• Provedores de e-mail (SMTP/SendGrid/SendPulse)

Fronteiras de responsabilidade

• Backend: fonte única de verdade de domínio, autorização e consistência.
• Web/Mobile: experiência de usuário e orquestração de interface.
• Integrações externas: sempre mediadas pelo backend.

Riscos arquiteturais neste nível

• Dependência de provedores externos sem fallback operacional.
• Divergência de comportamento entre web e mobile quando contratos mudam sem migração coordenada.