Guia do Super Admin
O SUPER_ADMIN e o cargo de nivel mais alto da plataforma. Diferente dos demais cargos, ele nao pertence a nenhum nucleo especifico e possui acesso irrestrito a todos os nucleos. Alem disso, o Super Admin tem acesso ao modo Nacional com funcionalidades exclusivas.
Login e Navegacao
O Super Admin faz login normalmente, porem sem estar vinculado a um nucleo. Apos o login, o sistema exibe um dropdown no header para selecionar o nucleo desejado. A selecao envia o header X-Tenant-ID em todas as requisicoes, permitindo que o backend aplique o contexto multi-tenant correto.
A troca de nucleo pelo dropdown e imediata — nao requer novo login. O Super Admin pode alternar entre nucleos a qualquer momento.
Se o Super Admin acessar o dashboard sem nucleo selecionado, e redirecionado automaticamente para a pagina de selecao de nucleo.
Acesso Total
Com um nucleo selecionado, o Super Admin tem acesso a todas as paginas e funcionalidades daquele nucleo, incluindo:
- Aprovacao de membros e alteracao de cargos
- Configuracoes do nucleo (cores, moeda, toggles de transparencia)
- Gestao financeira, projetos, eventos, loja, planos
- Dashboard, relatorios e exportacoes CSV
- Enquetes, comunicados, conquistas e economia
- Assistente IA com permissoes de escrita
- Gerenciamento de porta-vozes
Modo Nacional
O modo Nacional e um conjunto de funcionalidades exclusivas do Super Admin que operam em nivel global, afetando todos os nucleos da plataforma simultaneamente.
Relatorios Globais (7 Abas)
Acessiveis via Relatorios Globais na sidebar. Consolidam dados de todos os nucleos:
- Membros: Total de membros por nucleo, por status, por cargo. Grafico de evolucao de cadastros.
- Economia: Moedas em circulacao por nucleo, transacoes totais, indicadores de saude economica.
- Eventos: Eventos realizados por nucleo, taxa de presenca media, evolucao mensal.
- Projetos: Projetos ativos por nucleo, tarefas concluidas, taxa de conclusao.
- Engajamento: Score de engajamento por nucleo, membros ativos vs inativos, tendencias.
- Planos: Distribuicao de planos por nucleo, receita de assinaturas, conversoes.
- Comparativo: Ranking de nucleos por metricas-chave (membros, engajamento, economia). Graficos side-by-side.
IA Assessor Nacional
O Super Admin tem acesso a um Assistente IA com contexto de todos os nucleos:
- Pode consultar dados consolidados: "Qual o nucleo com mais membros?", "Compare engajamento entre Vitoria e Vila Velha"
- Pode executar acoes em qualquer nucleo: "Credite 100 moedas para Maria no nucleo Vitoria"
- Gera resumos globais da plataforma
- Acesso via pagina fullscreen
/dashboard/iaou widget flutuante
Produtos Nacional
O Super Admin pode criar produtos de nivel nacional que ficam disponiveis em todos os nucleos:
- Produtos nacionais aparecem na loja de todos os nucleos em uma secao separada "Loja Nacional"
- Membros de qualquer nucleo podem comprar com moeda do nucleo ou R$
- Gestao centralizada: estoque, precos e visibilidade controlados pelo Super Admin
Comunicados Nacional
Comunicados de nivel nacional sao enviados para o feed de todos os nucleos:
- Aparecem no feed de todos os nucleos com destaque visual "Nacional"
- Podem incluir foto e video
- Notificacao push enviada para todos os membros de todos os nucleos
Enquetes Nacional
Enquetes de nivel nacional coletam respostas de todos os nucleos:
- Aparecem para todos os membros de todos os nucleos
- Resultados consolidados por nucleo e total
- Suportam modal obrigatorio (afeta todos os nucleos)
Emails Nacional
O Super Admin pode enviar emails para membros de todos os nucleos ou nucleos especificos:
- Selecao de destinatarios: todos, por nucleo, por cargo, por plano
- Geracao de conteudo via IA com preview visual
- Envio via Resend
Criar Nucleo
O Super Admin e o unico cargo que pode criar novos nucleos na plataforma.
Dados do nucleo
| Campo | Descricao |
|---|---|
nome | Nome do nucleo (ex: MBL Vitoria) |
estado | UF do nucleo (ex: ES) |
slug | Identificador unico na URL (ex: vitoria) |
dominio | Dominio personalizado (ex: vitoria.mbles.org) |
logo | Upload da logo do nucleo |
corPrimaria | Cor primaria em hex |
corSecundaria | Cor secundaria em hex |
nomeMoeda | Nome da moeda virtual (ex: Capixacoins) |
siglaMoeda | Sigla da moeda (ex: CC) |
Checklist pos-criacao
Apos criar o nucleo, o Super Admin deve completar as seguintes configuracoes de infraestrutura:
- DNS CNAME — Configurar o registro CNAME do dominio personalizado apontando para o frontend no Google Cloud Run.
- Cloud Run domain mapping — Mapear o dominio no Google Cloud Run para que o backend responda no dominio correto.
- Supabase redirect URLs — Adicionar as URLs do novo nucleo na lista de redirect URLs permitidas no Supabase Auth (login, callback, reset password).
- Asaas config — Configurar a chave de API e o ambiente (sandbox/production) do Asaas nas configuracoes do nucleo para habilitar pagamentos.
Criar Outros Super Admins
O Super Admin pode criar novos usuarios com o mesmo cargo. Os campos obrigatorios sao:
| Campo | Tipo | Descricao |
|---|---|---|
nome | string | Nome completo |
email | string | Email para login |
senha | string | Senha inicial (usuario deve alterar no primeiro acesso) |
cpf | string | CPF do usuario |
telefone | string | Telefone de contato |
Navegacao entre Nucleos
O dropdown de nucleos no header exibe todos os nucleos cadastrados. Ao selecionar um nucleo diferente, o contexto troca imediatamente: sidebar, dashboard, dados e configuracoes passam a refletir o nucleo selecionado. Nenhuma acao adicional e necessaria.