Billings Ease - Visão Técnica Executiva

Última atualização arquitetural: 2026-03-10.

Snapshot 2026-03-10

• Backend: domínio de marketplace consolidado com deleção lógica de cursos e remoção assíncrona de vídeos, mantendo contrato estável para clientes.
• Frontend Web: navegação evoluiu para layout persistente, sidebar em árvore colapsável, hubs por perfil e command palette (⌘K/Ctrl+K).
• Mobile: sem mudanças de código detectadas neste ciclo.

Propósito do Sistema

O Billings Ease é uma plataforma para operação digital do Método Billings, com foco em:

• registro e análise de ciclos
• suporte orientado por profissional
• operação de assinatura e pagamentos
• governança de módulos por perfil/usuário

Arquitetura de Alto Nível

A solução é composta por:

• Backend (Go/Echo): fonte de verdade de regras de negócio e autorização.
• Frontend Web (React/Vite): operação administrativa e experiência web por perfil.
• Mobile (React Native/Expo): experiência móvel para jornadas de cliente/profissional.
• Infraestrutura: PostgreSQL, Cloudflare R2, pipelines CI/CD.

Leitura arquitetural recomendada

1. Overview Técnico
2. Arquitetura Geral
3. Domínio
4. Backend - Estado Atual
5. Frontend - Estado Atual

Diagramas C4

• Nível 1 - Contexto
• Nível 2 - Containers
• Nível 3 - Componentes Backend
• Nível 3 - Componentes Frontend
• Nível 4 - Código

Governança Arquitetural

• ADRs
• Invariantes
• Anti-Patterns
• Security Review SaaS
• Security Roadmap
• Security Headers e CSP (Cloudflare)
• Dívidas Técnicas

Início Rápido para Engenheiros

1. Execute setup local em Guides > Desenvolvimento Local.
2. Rode checks arquiteturais e de build/test.
3. Antes de mudanças estruturais, revise ADRs, invariantes e C4.
4. Atualize documentação impactada na mesma PR.