Data: 2026-04-03 Status: Implementado e testado
O que e
Funcionalidade que permite a um usuário pertencer a multiplas organizações (empresas/tenants) e alternar entre elas instantaneamente, sem logout/login. Baseado no Clerk Organizations com identidade única e multiplas memberships.
Como funciona para o usuário
- Usuário faz login normalmente (1 vez)
- No topo do menu lateral, ve o nome da empresa ativa
- Se pertencer a 2+ empresas, ve um badge numerico
- Ao clicar, dropdown mostra todas as empresas com seu cargo em cada uma
- Clica em outra empresa → troca instantanea (menos de 1 segundo)
- Todos os dados (chat, contatos, configurações) são da nova empresa
- Na primeira vez com 2+ orgs, popup educativo explica como funciona
Popup educativo
Aparece automaticamente quando o usuário tem 2+ organizações e nunca viu o popup antes.
Conteúdo:
- Título: "Você faz parte de N organizações!"
- Lista visual das empresas (com indicador "Atual")
- Instrução: "Clique no nome da empresa no topo do menu lateral para alternar"
- Botao "Entendi!" — fecha e não aparece mais
Como adicionar alguém a outra empresa
- Admin da empresa vai em Configurações > Usuários > Novo Membro
- Digita o e-mail da pessoa
- Se a pessoa já tem conta, ela entra direto e ve a nova empresa no switcher
- Se não tem conta, recebe e-mail de convite para se cadastrar
- Popup educativo aparece ensinando a usar o switcher
Informações mostradas no switcher
Para cada organização:
- Nome da empresa
- Logo (se configurada)
- Cargo do usuário nessa empresa (Administrador, Membro, Convidado)
- Indicador verde na empresa ativa
Segurança
- Dados de cada empresa são completamente isolados
- Impossível acessar dados de outra empresa sem ser membro
- Ao trocar de empresa, todos os caches são limpos
- Token de autenticação e atualizado automaticamente
Limites
- Um usuário pode pertencer a quantas empresas quiser
- Sem limite de trocas entre empresas
- Não precisa de login adicional ao trocar
Documentação criada em 2026-04-03