Fluxo: Plataforma Nacional

O sistema opera em dois niveis: Nacional (gestao global de todos os nucleos) e Nucleo (gestao local de um nucleo especifico). O Super Admin alterna entre os dois modos.

Super Admin sem Nucleo = Modo Nacional

Quando um usuario SUPER_ADMIN tem nucleo_id = null, ele opera no modo Nacional. Nesse modo, a plataforma exibe funcionalidades globais em vez de funcionalidades de nucleo.

  • O Super Admin nao pertence a nenhum nucleo especifico
  • Ele enxerga dados agregados de todos os nucleos
  • Tem acesso a tabelas nacionais (config_nacional, produtos_nacional, etc)
  • Pode entrar em qualquer nucleo para administrar localmente

Menu Condicional

O menu lateral (sidebar) muda dinamicamente conforme o modo atual:

Modo Nacional (sem nucleo selecionado)

SecaoItens
Visao GeralDashboard global com KPIs de todos os nucleos
NucleosLista de nucleos, criar/editar nucleo
Loja NacionalProdutos nacionais, pedidos nacionais
ComunicadosComunicados nacionais (para todos)
EnquetesEnquetes nacionais (votacao global)
RelatoriosRelatorios globais (7 tabs)
IA InsightsAssessor IA com ferramentas globais
ConfiguracoesConfig nacional (Asaas, etc)

Modo Nucleo (nucleo selecionado)

SecaoItens
DashboardDashboard do nucleo selecionado
MembrosMembros do nucleo, aprovacoes
ProjetosProjetos e tarefas do nucleo
EventosEventos do nucleo
EconomiaCapixacoins, loja local, financeiro
ComunicacaoComunicados, enquetes, feed do nucleo

Homepage: Relatorios Globais

Quando o Super Admin acessa o portal sem nucleo selecionado, a homepage exibe relatorios globais em vez do dashboard de nucleo. Isso inclui:

  • Total de membros em todos os nucleos
  • Total de eventos realizados
  • Movimentacao financeira consolidada
  • Economia de Capixacoins agregada
  • Top e bottom nucleos por engajamento
  • Variacao percentual vs periodo anterior

Dropdown "Modo Nacional" no Header

O header exibe um dropdown que permite ao Super Admin alternar entre:

  • Modo Nacional — Visao global, sem nucleo selecionado
  • Nucleo X — Entrar em um nucleo especifico para administrar

Ao selecionar um nucleo, o contexto muda: o nucleo_id e enviado em todas as requisicoes e o menu lateral troca para o menu de nucleo. Ao voltar para "Modo Nacional", o contexto volta ao global.

Arquitetura Multi-Nivel

Nacional (Super Admin)
├── Relatorios globais
├── Loja nacional (Asaas proprio)
├── Comunicados para todos
├── Enquetes globais
└── Gestao de nucleos
    ├── Nucleo A
    │   ├── Membros, projetos, tarefas
    │   ├── Eventos, economia
    │   └── Loja local (Asaas do nucleo)
    ├── Nucleo B
    │   └── ...
    └── Nucleo C
        └── ...

Separacao de Dados

NivelTabelasnucleo_id
Nacionalconfig_nacional, produtos_nacional, comunicados_nacional, enquetes_nacionalNao possui
NucleoTodas as demais tabelasObrigatorio (RLS)
Global (leitura)metricas_globais, audit_logFiltrado por permissao

Permissoes

  • Endpoints /api/nacional/* requerem cargo SUPER_ADMIN
  • Endpoints /api/super-admin/* requerem cargo SUPER_ADMIN
  • Super Admin pode acessar /api/* de qualquer nucleo passando nucleo_id no header
  • Membros comuns so acessam dados do seu proprio nucleo (filtrado por RLS)