API Reference: Dashboard

Base URL: /api/dashboard. Todos os endpoints requerem autenticacao.

GET /api/dashboard/resumo

Retorna dados personalizados do dashboard de acordo com o papel do usuario logado. Cada papel recebe campos diferentes.

Permissao: Qualquer usuario autenticado

Response 200 (Todos os papeis)

Campo	Tipo	Descricao
`saldo`	number	Saldo atual de Capixacoins do usuario
`siglaMoeda`	string	Sigla da moeda do nucleo (ex: "CC")
`eventosProximos`	array	Lista dos proximos eventos do nucleo
`tarefasPendentes`	array	Tarefas atribuidas ao usuario ainda nao concluidas
`posicaoRanking`	number	Posicao do usuario no ranking do nucleo
`totalMembrosRanking`	number	Total de membros no ranking

Estrutura de tarefasPendentes

{
  "tarefasPendentes": [
    {
      "titulo": "Divulgar evento nas redes",
      "projetoTitulo": "Campanha Novembro",
      "prioridade": "ALTA"
    }
  ]
}

Campos extras para COORDENADOR / ADMINISTRADOR

Campo	Tipo	Descricao
`pendentes`	number	Quantidade de tarefas pendentes de aprovacao
`projetosAtivos`	number	Quantidade de projetos com status ativo
`eventosAgendados`	number	Quantidade de eventos futuros agendados

Exemplo de response completa (COORD/ADMIN)

{
  "saldo": 3500,
  "siglaMoeda": "CC",
  "eventosProximos": [
    { "id": "uuid", "titulo": "Reuniao Semanal", "data": "2026-04-02T19:00:00Z" }
  ],
  "tarefasPendentes": [
    { "titulo": "Revisar arte do flyer", "projetoTitulo": "Acao Social", "prioridade": "MEDIA" }
  ],
  "posicaoRanking": 3,
  "totalMembrosRanking": 42,
  "pendentes": 7,
  "projetosAtivos": 4,
  "eventosAgendados": 3
}

Frontend: Tela do Dashboard

O dashboard exibe cards com dados reais retornados pela API:

Card de Saldo: mostra saldo e siglaMoeda
Card de Ranking: mostra posicaoRanking de totalMembrosRanking
Lista de Tarefas Pendentes: exibe titulo, projeto e prioridade de cada tarefa
Lista de Proximos Eventos: exibe titulo e data dos eventos futuros
Cards extras (COORD/ADMIN): pendentes de aprovacao, projetos ativos, eventos agendados

Cards Clicaveis

Todos os cards do topo do dashboard sao clicaveis e redirecionam para a pagina correspondente:

Saldo → /dashboard/extrato
Ranking → /dashboard/ranking
Eventos → /dashboard/eventos
Tarefas → /dashboard/tarefas
Pendentes (Coord/Admin) → /dashboard/aprovacoes
Projetos Ativos (Coord/Admin) → /dashboard/projetos
Eventos Agendados (Coord/Admin) → /dashboard/eventos

Super Admin: Redirect

Quando um SUPER_ADMIN acessa o dashboard sem ter um nucleo selecionado, o sistema redireciona automaticamente para a pagina de selecao de nucleo (/dashboard/nucleos). Apos selecionar um nucleo via dropdown no header, o dashboard carrega normalmente com os dados daquele nucleo.

Resumo Semanal por IA (COORD/ADMIN)

Coordenadores e administradores veem um card adicional com um resumo semanal gerado por inteligencia artificial.

Endpoint utilizado

POST /api/ia/resumo-semanal — veja a documentacao completa em API > IA.

Estrategia de cache

O resumo e armazenado no localStorage com TTL de 1 hora
Enquanto o cache estiver valido, nao e feita nova requisicao ao backend
Apos expirar, o frontend chama novamente o endpoint e atualiza o cache

Exibicao

O card de resumo semanal mostra o texto gerado pela IA com os principais indicadores de engajamento do nucleo nos ultimos 7 dias.