Multi-empresa
Um único usuário pode operar várias empresas no FreteFlow, com papéis distintos em cada uma.
Resumo
Cada vínculo entre um usuário e uma empresa é um membership com um papel (admin, operador, etc.). O usuário escolhe a qualquer momento em qual empresa está operando — o escopo ativo.
Memberships e papéis
Um membership conecta um usuário a uma empresa e define o que ele pode fazer ali dentro. Os papéis hoje são:
admin— administra a empresa: usuários, integrações, planos e configurações. Pode também criar novas empresas (veja o guia).operador— opera o dia a dia (fretes, motoristas, documentos, mensagens), sem acesso a configurações sensíveis.- Outros papéis específicos podem aparecer conforme o módulo (ex.: financeiro, pátio).
Empresa primária x escopo ativo
- Empresa primária — a primeira empresa do usuário, criada no onboarding. É a empresa "casa" do perfil.
- Escopo ativo — qual empresa o usuário está operando no momento. Pode ser uma empresa específica ou "Todas", que agrega os dados de todas as empresas em que ele tem papel ativo.
Visão "Todas"
Quando o escopo ativo é Todas, listagens (fretes, motoristas, mensagens, etc.) trazem registros de todas as empresas em que o usuário tem papel ativo, com a coluna de empresa visível. É útil para grupos com várias filiais ou para administradores que precisam de uma visão consolidada.
Criação sempre em uma empresa
Ações de escrita (criar um frete, emitir um CIOT, enviar uma mensagem) sempre exigem um escopo de empresa específico. No modo "Todas" o app pede que você selecione uma empresa antes de criar.
Isolamento e segurança
Os dados são isolados por empresa via Row-Level Security no banco. Um usuário só enxerga registros das empresas em que possui membership ativo, mesmo no modo "Todas". Revogar um membership corta o acesso imediatamente.