C4 - Nível 2 (Containers)

Objetivo

Detalhar containers executáveis e seus protocolos de comunicação no estado atual.

Containers

1. Backend API (Go + Echo)

• Entrada: HTTP/JSON (/api, /api/v1, /api/v2)
• Saída: PostgreSQL, R2, provedores externos
• Responsabilidade: autenticação, autorização, regras de negócio, contratos

2. Frontend Web (React + Vite)

• Entrada: navegador
• Saída: chamadas HTTP para backend
• Responsabilidade: UI por perfil, guardas de rota, fluxo de módulo efetivo

3. Mobile (Expo + React Native)

• Entrada: app Android/iOS
• Saída: chamadas HTTP para backend
• Responsabilidade: jornadas móveis, auth/token seguro, navegação por perfil

4. PostgreSQL

• Persistência transacional de domínio, marketplace e auditoria

5. Cloudflare R2

• Armazenamento de ativos e mídias

Protocolos e contratos

• Cliente -> Backend: REST/JSON com JWT Bearer
• Backend -> DB: GORM/PostgreSQL
• Backend -> externos: HTTP/Webhook/SDK

Observações de desenho atual

• Backend mantém compatibilidade simultânea de versões (/api, /api/v1, /api/v2).
• v2 adiciona middleware de resolução de public_id para parâmetros de rota.