Fundação técnica
Arquitetura
Premissas estruturais que orientam todos os incrementos do GOEVO HUB.
Conceitos que nunca se confundem
- Tenant
- Fronteira de isolamento e conta contratante no Hub.
- Organização
- Grupo econômico; pode reunir várias empresas.
- Empresa
- Entidade legal identificada por CNPJ.
- Unidade Operacional
- Planta, filial, centro de distribuição ou site.
Decisões desta fase
- Monólito modular: cada módulo tem domínio, services, repositórios, eventos e UI próprios.
- Multi-tenant híbrido: rede global compartilhada + dados privados por tenant, com tenant_id e RLS; preparado para banco dedicado.
- Regras de negócio apenas em services; web, API, WhatsApp e agentes reutilizam os mesmos serviços.
- Eventos de domínio gravados em outbox transacional; consumidores idempotentes.
- Autorização com negação por padrão nos services e RLS como segunda linha independente.
- IA nunca acessa o banco diretamente; ações críticas exigem confirmação humana e auditoria.
Fora do escopo por enquanto
- Banco de dados, tabelas e migrations de domínio
- Autenticação real e OTP
- Fornecedores, documentos e homologação
- Cotações, oportunidades e pedidos
- Agendamento por capacidade
- WhatsApp, agentes de IA e monetização