Pular para o conteúdo principal

Painel de Controle

O Painel de Controle (/admin, item "Painel de Controle" no menu do usuário) é a visão consolidada da saúde e do uso da Apoia em uma única tela, com janela fixa de 60 dias: logins, uso e custo de IA, processos acelerados (inclusive via MCP), erros de servidor e chamados. Ele agrega e interliga os painéis existentes — nada do que já existia foi alterado.

Quem acessa

  • Moderadores veem todos os tribunais e podem filtrar por um tribunal específico.
  • Representantes de tribunal acessam com o tribunal fixado no próprio — o filtro de tribunal não é exibido e todos os quadros refletem o seu tribunal. O quadro "Processos acelerados por tribunal por dia" é exclusivo de moderadores.
  • Demais usuários são redirecionados para a página inicial.

O que o Dashboard mostra

Gráficos por dia:

  • Logins por dia — barras de logons e linha de usuários distintos;
  • Processos acelerados por dia — barras comparando o aplicativo (processos distintos com geração de IA, contagem retroativa) e o MCP (processos consultados pela integração, contagem a partir do deploy do dashboard);
  • Uso total de IA por dia — barras empilhadas do gasto por dia destacando os 5 modelos de IA mais usados e um bloco "Outros", com uma linha de usos — cobre todas as gerações, inclusive com chave própria;
  • Uso de chave de API corporativa por dia — barras de gerações e linha de custo, apenas do uso pago com as chaves da Apoia;
  • Erros do servidor por dia — barras empilhadas com os 5 erros mais frequentes e um bloco "Outros" (mesmo formato do painel Erros do Servidor);
  • Chamados por dia — barras empilhadas com os 5 órgãos com mais chamados e um bloco "Outros";
  • Processos acelerados por tribunal por dia — barras empilhadas com os 9 tribunais com mais processos (aplicativo e MCP somados num único total) e um bloco "Outros". Disponível apenas para moderadores.
  • Uso por hora do dia — mapa de calor (heatmap) com as 24 horas do dia (linhas) × dias da janela (colunas), em dois grids lado a lado: gerações de IA (azul) e chamadas de ferramentas (roxo). A intensidade da cor escala com a contagem de cada dia + hora; passe o mouse sobre uma célula para ver a data, a hora e a contagem exata. As chamadas de ferramentas contam a partir do deploy do dashboard (sem retroativo); as gerações têm histórico completo.

Tabelas: prompts mais usados e ferramentas mais usadas (chamadas totais e via MCP), ambas com rolagem interna.

Filtros: tribunal (o gráfico e os KPIs da chave corporativa refletem a seleção).

Logins e tools: contagem a partir do deploy

Os eventos de login, de chamada de tool e de processo acelerado via MCP passaram a ser registrados quando o Dashboard foi implantado — não há histórico retroativo para eles (processos acelerados via aplicativo têm retroativo, pois vêm das gerações). Todos têm retenção de 60 dias.

Detalhes de comportamento:

  • Um login é cada entrada (sign-in) na Apoia — pelo Keycloak em produção ou pelo formulário de desenvolvimento. Renovações silenciosas de sessão não contam como novo login.
  • Toda chamada de tool é registrada, com a marcação de ter vindo do aplicativo (chat, execução de prompts) ou via MCP. Chamadas bloqueadas por configuração ausente (por exemplo, busca de jurisprudência sem JURISPRUDENCIA_URL) também contam como chamadas.
  • A atribuição por tribunal segue o órgão atual do usuário: se ele mudar de tribunal, o histórico agregado acompanha — o mesmo critério dos relatórios existentes.

Painéis relacionados

O título de cada quadro que tem um painel de detalhe correspondente é um link para ele: uso total de IA (Relatório de Uso de IA), uso da chave corporativa por dia (Uso de Chave de API — do tribunal selecionado no filtro ou, com "Todos os tribunais", do mais ativo na janela), erros do servidor, chamados e relatório de uso de prompts.