Guia do Administrador

Este guia explica como realizar as principais tarefas administrativas do Portal Meu Núcleo - MBL.

Aprovar Cadastros

1. Acesse o menu Aprovacoes na sidebar (visivel apenas para Coordenadores e Administradores)
2. Voce vera a lista de cadastros pendentes, com nome, email, CPF e telefone
3. Para cada cadastro, clique em Aprovar ou Rejeitar
4. Ao aprovar:
   • O usuario recebe uma notificacao e pode fazer login
   • Uma entrada e gerada no feed: "Bem-vindo ao nucleo!"
   • Se o usuario foi indicado, 100 moedas do nucleo sao creditadas ao indicador
5. Ao rejeitar:
   • O registro e marcado como "Rejeitado" (soft delete)
   • O usuario nao consegue logar

Cadastros pendentes tambem aparecem como card no Dashboard, com o numero de pendentes.

Alterar Cargos

Apenas Administradores podem alterar cargos.

1. Acesse o menu Membros na sidebar
2. Encontre o membro na lista (use filtros e busca)
3. Clique no membro para ver o perfil completo
4. Na secao de cargo, selecione o novo cargo:
   • MEMBRO — Acesso base
   • LIDER_PROJETO — Pode gerenciar tarefas no seu projeto
   • PORTA_VOZ — Comunicacao: comunicados, enquetes, emails, tarefas, IA
   • COORDENADOR — Gerencia nucleo (projetos, eventos, loja, financeiro)
   • ADMINISTRADOR — Acesso total (cargos, moeda do nucleo, configuracoes)

Cuidado ao promover alguem a Administrador — esse cargo tem acesso irrestrito ao sistema.

Suspender/Reativar Membros

Coordenadores e Administradores podem alterar o status de membros ativos.

• ATIVO → pode logar e usar o sistema normalmente
• INATIVO → nao pode logar, mas os dados sao preservados
• SUSPENSO → nao pode logar, indicando suspensao temporaria

Dashboard Administrativo

O dashboard do Coordenador/Admin mostra:

• Numero de cadastros pendentes (clicavel — leva para aprovacoes)
• Eventos agendados
• Projetos ativos
• Saldo de moeda do nucleo (futuro: painel anti-inflacao)

Sidebar — Menus Visiveis por Cargo

Transparencia Granular

O Administrador pode configurar quais informacoes ficam visiveis para membros comuns.

1. Acesse Configuracoes na sidebar
2. Navegue ate a secao Transparencia para Membros
3. Voce vera 3 grupos de toggles:
   • Financeira: Exibir receitas, despesas e saldo do nucleo para membros
   • Ranking: Exibir ranking completo, posicao individual e pontuacao
   • Relatorios: Exibir dashboards e graficos para membros
4. Cada grupo possui um toggle master (liga/desliga o grupo inteiro) e sub-toggles para controle granular de cada item
5. Alteracoes sao salvas automaticamente e aplicadas em tempo real

Por padrao, membros nao veem dados financeiros nem relatorios. Ative apenas o que fizer sentido para o seu nucleo.

Dashboard (Admin)

O Dashboard do Administrador exibe informacoes consolidadas do nucleo:

• Cadastros pendentes: Card com contador, clicavel para ir direto a aprovacoes
• Projetos ativos: Numero de projetos em andamento
• Eventos agendados: Proximos eventos com data e local
• Resumo IA: Texto gerado por IA (OpenAI) com resumo semanal de atividades do nucleo — novos membros, tarefas concluidas, eventos realizados, tendencias

Relatorios — Aba Dashboards

Na pagina de Relatorios, uma nova aba Dashboards exibe graficos visuais:

• Membros por status: Grafico de pizza (Ativo, Inativo, Suspenso, Pendente)
• Membros por cargo: Grafico de barras (Membro, Lider, Coordenador, Admin)
• Cadastros ao longo do tempo: Grafico de linha mostrando evolucao mensal
• Receitas vs Despesas: Grafico de barras comparativo por mes
• Top produtos da loja: Ranking dos mais vendidos
• Top engajados: Membros com mais pontos no periodo

Enquetes

Administradores e Coordenadores podem criar enquetes para coletar opiniao dos membros.

1. Acesse Enquetes na sidebar
2. Clique em Nova Enquete
3. Preencha: Pergunta, Opcoes de resposta, Data de encerramento
4. Opcoes avancadas:
   • Modal obrigatorio: Se ativado, a enquete aparece como modal na tela inicial ate o membro votar. O membro nao consegue navegar sem responder.
   • Notificar membros: Se ativado, todos os membros do nucleo recebem notificacao sobre a nova enquete
5. Acompanhe os resultados em tempo real na pagina da enquete

Porta-Vozes

Administradores podem configurar membros como porta-vozes, cujas postagens em redes sociais aparecem no feed do nucleo.

1. Acesse Configuracoes na sidebar
2. Navegue ate a secao Porta-Vozes
3. Clique em Adicionar Porta-Voz e selecione o membro desejado
4. Apos adicionar, clique no porta-voz para gerenciar suas redes sociais:
   • Clique em Adicionar Rede
   • Selecione a plataforma (Instagram, YouTube ou Twitter/X)
   • Informe o username e, opcionalmente, a URL do perfil e URL do RSS feed
5. Para adicionar uma postagem manualmente:
   • Clique em Adicionar Postagem no porta-voz desejado
   • Cole a URL do post (ex: https://instagram.com/p/ABC123/)
   • O sistema detecta automaticamente a plataforma e gera o embed
6. Sincronizacao automatica: o sistema busca novas postagens via RSS a cada 30 minutos
7. Sincronizacao manual: clique em Sincronizar Agora para forcar a busca imediata de novas postagens em todas as redes configuradas

Apenas Administradores podem gerenciar porta-vozes. As postagens aparecem automaticamente no feed do nucleo.

Economia Admin

O painel de Economia oferece 7 abas para gestao completa da moeda virtual:

1. Painel de Metricas: Visao geral com total de moedas em circulacao, transacoes recentes e indicadores de saude da economia
2. Ajuste Manual: Creditar ou debitar moedas manualmente para membros especificos com justificativa obrigatoria
3. Historico de Membros: Extrato detalhado de transacoes de cada membro do nucleo
4. Rankings: Rankings por periodo (mensal, trimestral, anual) com filtros por tipo de transacao
5. Configuracao (Multiplicador/Teto/Faixas): Definir multiplicador global de recompensas, teto maximo de saldo e faixas de recompensa por dificuldade de tarefa
6. Bonus em Massa: Distribuir moedas para grupos de membros (todos ativos, por cargo, por plano) de uma vez
7. Alertas: Configurar alertas automaticos para saldos altos, transacoes suspeitas ou limites atingidos

Bug Reports

Gerencie reports de bugs, sugestoes e melhorias enviados pelos membros.

1. Ative o modo beta (modoBeta) nas Configuracoes do nucleo
2. Com o modo beta ativo, todos os membros veem um widget flutuante para reportar bugs
3. Acesse o Kanban de Bug Reports nas Configuracoes para gerenciar os reports
4. O Kanban possui 3 colunas: Planejando, Fazendo e Feito
5. Clique em um card para ver detalhes: descricao, screenshot, metadata do usuario (navegador, resolucao, cargo)
6. Arraste cards entre colunas para atualizar o status

Conquistas Dinamicas

Crie e gerencie conquistas (badges) com regras personalizadas e desbloqueio automatico.

1. Acesse Conquistas nas Configuracoes
2. Clique em Nova Conquista para abrir o construtor visual de regras
3. Defina o nome, descricao e icone da conquista
4. Configure as regras de desbloqueio usando o construtor visual:
   • Eventos X: Participar de X eventos
   • Tarefas X: Completar X tarefas
   • Indicacoes X: Indicar X membros aprovados
   • Saldo X: Atingir X moedas de saldo
   • Plano: Ter determinado plano ativo
   • Projetos X: Participar de X projetos
5. Salve a conquista — o sistema verificara automaticamente e desbloqueara para membros que ja atendem os criterios

As conquistas sao verificadas dinamicamente a cada acao relevante do membro (participar de evento, concluir tarefa, etc.). O desbloqueio e imediato e gera notificacao push + entrada no feed.

Membros — DataTable

A listagem de membros utiliza o componente DataTable com layout responsivo:

• Desktop: Tabela com colunas sortaveis e filtros no header
• Mobile: Cards empilhados com informacoes essenciais e acoes via dropdown
• Busca por nome com debounce, filtros por cargo e status
• Paginacao integrada com contagem total

Tarefas Avulsas

Administradores podem criar tarefas fora do contexto de projetos:

• Acessiveis via menu Tarefas na sidebar ou na secao "Tarefas Avulsas" do Kanban
• Mesmos campos de uma tarefa normal (titulo, descricao, dificuldade, recompensa em moeda do nucleo, prazo)
• Podem ser atribuidas diretamente ou criadas como "abertas" para candidaturas

Usando o Assistente IA

O Assistente IA e um widget interativo que permite consultar dados do nucleo e executar acoes administrativas usando linguagem natural.

Como abrir

Clique no botao flutuante com icone de estrela (Sparkles) no canto inferior direito da tela. O botao e visivel apenas para Porta-Vozes, Coordenadores e Administradores.

Exemplos de perguntas

• "Quantos membros ativos temos no nucleo?"
• "Qual o ranking de moeda do nucleo?"
• "Quais eventos estao agendados?"
• "Membros com competencia em Marketing"
• "Crie um email convidando para o evento de sabado"
• "Quais tarefas estao pendentes de validacao?"

Acoes de escrita (apenas Administrador)

Alem de consultar dados, o Administrador pode executar acoes diretamente pelo chat:

• Creditar/debitar moedas: "Credite 50 moedas para Maria Silva por participacao no evento"
• Alterar cargo: "Promova Joao Santos para Coordenador"
• Alterar status: "Suspenda o membro Carlos Oliveira"
• Criar notificacao: "Envie notificacao para todos sobre a reuniao de amanha"
• Criar tarefa: "Crie uma tarefa de design no projeto Campanha Verao"

Todas as acoes de escrita exigem confirmacao explicita antes de serem executadas. O chat exibe um card de confirmacao com os detalhes da acao.

Criar emails via chat (IA + Preview)

1. Descreva o email desejado (ex: "Crie um email sobre o mutirao de sabado")
2. A IA gera o assunto e conteudo HTML com preview visual renderizado no chat
3. Revise o preview — voce pode ver exatamente como o email ficara
4. Peca ajustes se necessario ("mude o titulo", "adicione informacao sobre local")
5. Confirme para enviar via Resend

Push Seletivo via IA

O Administrador pode enviar push notifications seletivas pelo chat:

• "Envie push para todos os membros com plano Onca"
• "Notifique os coordenadores sobre a reuniao"
• "Envie push para membros que participaram do ultimo evento"

A IA interpreta o criterio de segmentacao e apresenta um card de confirmacao com o numero de destinatarios antes de enviar.

Dicas de uso

• Seja especifico nas perguntas — "Membros de Vitoria com competencia em design" funciona melhor que "me fala dos membros"
• Use nomes reais dos membros ao pedir acoes — "Credite 100 moedas para Maria Silva"
• O chat mantem o historico da sessao, entao voce pode fazer perguntas de follow-up
• A IA so acessa dados do seu nucleo (multi-tenant)