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)
| Secao | Itens |
|---|---|
| Visao Geral | Dashboard global com KPIs de todos os nucleos |
| Nucleos | Lista de nucleos, criar/editar nucleo |
| Loja Nacional | Produtos nacionais, pedidos nacionais |
| Comunicados | Comunicados nacionais (para todos) |
| Enquetes | Enquetes nacionais (votacao global) |
| Relatorios | Relatorios globais (7 tabs) |
| IA Insights | Assessor IA com ferramentas globais |
| Configuracoes | Config nacional (Asaas, etc) |
Modo Nucleo (nucleo selecionado)
| Secao | Itens |
|---|---|
| Dashboard | Dashboard do nucleo selecionado |
| Membros | Membros do nucleo, aprovacoes |
| Projetos | Projetos e tarefas do nucleo |
| Eventos | Eventos do nucleo |
| Economia | Capixacoins, loja local, financeiro |
| Comunicacao | Comunicados, 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
| Nivel | Tabelas | nucleo_id |
|---|---|---|
| Nacional | config_nacional, produtos_nacional, comunicados_nacional, enquetes_nacional | Nao possui |
| Nucleo | Todas as demais tabelas | Obrigatorio (RLS) |
| Global (leitura) | metricas_globais, audit_log | Filtrado 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 passandonucleo_idno header - Membros comuns so acessam dados do seu proprio nucleo (filtrado por RLS)