Gestão de Tenants e Whitelabel

Resumo

Tenants são os revendedores/whitelabels da plataforma P8W. Cada tenant opera o SaaS com sua própria marca, domínio, tema, idioma padrão e regras comerciais, mantendo isolamento total de dados (SaaS dentro de SaaS). Este módulo concentra a criação, configuração, branding, plugins habilitados e estúdio whitelabel.

Para quem é (papel/role)

• super-admin - acesso exclusivo. Somente o admin global pode criar ou excluir tenants.
• tenant-admin - configura branding, domínio e preferências apenas do próprio tenant.

O que você pode fazer

Tenants (super-admin)

• Criar tenant: definir slug, nome comercial, dono, plano base e status.
• Editar tenant: dados cadastrais, limites comerciais, responsável técnico.
• Excluir tenant: remoção controlada com impacto em todos os dados do tenant.
• Listar tenants: filtros por status, plano, data, volume.
• Estatísticas de tenants: totais, ativos, inativos, MRR por tenant.

Whitelabel (branding e identidade)

• Branding: logo claro/escuro, favicon, nome comercial, cores primárias.
• Tema: tokens visuais, dark mode, layout padrão.
• Domínios: domínio próprio, subdomínios, SSL (ver dominios-ssl.md).
• Marketplace de plugins: quais plugins o tenant exibe aos seus clientes.
• Planos: pacotes de assinatura próprios do tenant.
• Permissões: roles customizadas dentro do tenant.
• Precificação: tabela comercial do tenant.
• Requests: solicitações/tickets de expansão abertas pelo tenant.
• VPS: alocação de recursos dedicados (quando aplicável).
• Módulos ativos: quais módulos do CORE são expostos aos usuários do tenant.

Estúdio Whitelabel

• Clonagem de configuração: copiar setup de um tenant existente para um novo.
• Exportar configuração: gerar snapshot da configuração atual para auditoria.

Como acessar

1. Acesse /admin.
2. Entre em Whitelabel ou diretamente /admin/settings/whitelabel.
3. Para CRUD de tenants: /admin/settings/tenants.

Tutoriais

Criar um novo whitelabel completo

1. Acesse /admin/settings/tenants/create.
2. Informe slug, nome, e-mail do responsável e plano base.
3. Após criar, entre em Whitelabel → Branding e configure logo, favicon e cores.
4. Em Whitelabel → Domínios, vincule o domínio próprio (veja dominios-ssl.md).
5. Em Whitelabel → Plugins, selecione os plugins liberados para o tenant.
6. Em Whitelabel → Planos, configure os pacotes que o tenant revenderá.

Clonar configuração de um tenant para outro

1. Crie o tenant destino em branco.
2. No estúdio whitelabel, use Clonar configuração indicando o tenant origem.
3. Revise branding e domínios (esses são específicos de cada tenant).

Configurar tenant como "cliente direto" (sem revenda)

Tenant direto usa tenant_id = NULL internamente. Para isso, o cliente é criado como usuário/empresa sem vínculo a um tenant revendedor - não há passo no módulo de tenants.

Integrações

• Domínios e SSL - um tenant pode ter múltiplos domínios (dominios-ssl.md).
• Planos - planos podem ser globais ou específicos do tenant (planos-e-pacotes.md).
• Marketplace de plugins - controla catálogo por tenant (store-marketplace-plugins.md).
• Observabilidade - comparação de tenants, health score, risco de churn.
• Eventos: tenant.created, tenant.updated, tenant.suspended.

Perguntas frequentes

Um tenant pode criar outro tenant (revenda em cascata)? Somente se o super-admin liberar. Por padrão, tenant-admin não cria novos tenants.

O que acontece quando excluo um tenant? Usuários, empresas, assinaturas e dados do tenant são marcados para remoção conforme política LGPD. A operação é irreversível.

Posso ter o mesmo domínio em dois tenants? Não. Cada domínio é único e vinculado a um único tenant.

Existe limite de tenants por plataforma? Não em código. O sistema é preparado para milhares de tenants.

O tenant vê usuários de outros tenants? Nunca. O isolamento multi-tenant é aplicado em toda query via middleware TenantResolver.

Como suspendo um tenant sem excluir? Edite o tenant e altere o status para suspenso. Dispara evento tenant.suspended.

Posso mudar o dono de um tenant? Sim, pela aba de edição, desde que o novo dono já seja usuário da plataforma.

Métricas por tenant estão disponíveis? Sim, em /admin/settings/stats/tenants e no módulo de observabilidade.

Limitações, políticas e avisos

• Apenas super-admin cria, edita status crítico ou exclui tenant.
• Branding de tenant sobrepõe o branding global da plataforma para usuários daquele tenant.
• Exclusão de tenant emite tenant.suspended seguido de fluxo de retenção.
• O painel /admin/settings/whitelabel/tenants é o CRUD canônico.

Relacionados

• companies-management.md
• customization-theme.md
• domains-ssl.md
• plans-and-packages.md
• store-marketplace-plugins.md