Visão geral do Painel
O Painel é o centro de operações do AuditorIA. A partir daqui você vê os KPIs do tenant, a analytics em tempo real, os alertas do sistema e acessa com um clique qualquer fluxo operacional.
Anatomia do Painel
A tela é organizada em uma sidebar de navegação permanente, um header contextual e uma área central que combina KPIs, analytics, alertas e ações rápidas.
1 · Sidebar
É a navegação primária e fica sempre visível. A estrutura se adapta aos papéis do usuário: se você não tem permissão para um módulo, ele não aparece.
| Seção | Descrição | Acesso típico |
|---|---|---|
| Painel | Home com KPIs, analytics, alertas e ações rápidas | Todos |
| Todas as tarefas | Lista global com duas sub-visões: Chamadas e Redes Sociais | Supervisor, Admin |
| Enviar arquivo | Formulário manual de upload (arquivo único, ZIP ou CSV) | Todos |
| Suas tarefas | Tarefas atribuídas ao usuário com abas Suas chamadas / Validadas / Fixadas / Chats | Todos |
| Auditoria manual | Wizard guiado para criar uma auditoria do zero (Operador → Configuração → Confirmar) | Supervisor, Admin |
| Buscar áudios | Busca unificada com filtros (data, campanha, operador, direção, palavras-chave) | Todos |
| Relatórios | Analytics agregadas: Amostra Diária, Operador, Campanha, Cross & Habilidades | Supervisor, Admin |
| Campanhas | CRUD + wizard de 7 passos: Geral, Origens de Áudio, Etiquetas, Planilha, Alertas, Processos, IA | Admin |
| Gestão de equipe | Usuários Keycloak + Operadores locais + Papéis e Permissões | Somente Admin |
| Analytics | Dashboards avançados com drill-down e conexões de campanha | Supervisor, Admin |
| Configurações | Chaves de API, Logs, Uso e Limites, Faturamento, Plataforma | Admin |
Permissões dinâmicas
O menu é reconstruído a cada sessão lendo os paths autorizados pelo backend. Se um administrador alterar suas permissões, a próxima navegação atualiza o menu automaticamente. Veja Papéis e Permissões.
2 · Header
Controles transversais na parte superior:
| Elemento | Localização | Função |
|---|---|---|
| Breadcrumb | Esquerda | Mostra a rota atual (ex. Painel) |
Busca global (Ctrl + K) | Centro | Pesquisa tarefas, operadores, campanhas |
| Notificacoes | Direita | Central de notificações em tempo real via SSE |
| Avatar | Direita | Menu do usuário (Perfil, Sair) |
| Tema claro/escuro | Extremo direito | Alterna tema, persistido em localStorage |
| Saudação personalizada | Topo da área central | "Boa tarde, [Nome]!" + data localizada |
| Filtro por campanha | Topo da área central (direita) | Filtra todos os widgets do Painel pela campanha selecionada |
3 · KPIs do tenant
Quatro cartões resumem os indicadores-chave dos últimos 30 dias:
| KPI | O que mede | Observações |
|---|---|---|
| Registros encontrados | Total de tarefas criadas | Contagem absoluta no período |
| Tarefas Completadas | Tarefas com pipeline finalizado | Inclui contador de pendentes abaixo |
| Qualidade Média | Score médio ponderado | Mostra linha de meta (ex. Meta: 90%) |
| Áudio Processado | Duração total transcrita | Expresso em horas |
Cartões clicáveis
Cada cartão navega para a visão de detalhe correspondente (Todas as tarefas, Amostra Diária, etc.).
4 · Analytics – Tempo Real
Painel central com gráfico de linhas e três abas:
- Qualidade Média — série temporal do score médio, com linha pontilhada de Meta (90%).
- Análise de sentimento — polaridade agregada (positivo/negativo/neutro).
- Volume — quantidade de tarefas por dia.
O gráfico atualiza-se automaticamente (indicador "Atualizado há X min"). Eixo X em datas ISO.
5 · Alertas do Sistema
Painel lateral direito com alertas ativos das últimas 24 h. Mostra contador de alertas novos (N Novos) e categorias típicas:
| Alerta | Severidade | Exemplo |
|---|---|---|
| Alerta de Qualidade | Atenção | 293 auditorias com score baixo (<60%) |
| Falhas detectadas | Erro | 18 arquivos falharam no processamento |
| Worker inativo | Crítico | Nenhum worker de transcrição respondeu |
| Fila saturada | Atenção | Mais de N tarefas pendentes há X minutos |
Configure critérios no wizard de Campanhas → passo 5. Alertas.
6 · Ações rápidas
Grid inferior com os fluxos mais usados sem precisar navegar pelo menu:
| Cartão | Fluxo |
|---|---|
| Buscar Áudios | Abre /buscar-audios com filtros |
| Gerir Qualidade | Planilhas de auditoria / critérios |
| Suas chamadas | Atalho para Suas tarefas > Suas chamadas |
| Gerir Usuários | Abre Gestão de equipe |
| Configurações | Opções globais do sistema |
7 · Atividade Recente
Painel lateral direito (abaixo de Alertas) com feed de eventos ao vivo:
Sistema processou arquivo 0381156408132-3936-...
16 abr 2026, 16:26
Alimentado via SSE, reflete o avanço dos workers.
Atalhos de teclado
Ctrl + K abre a busca global. N cria uma nova tarefa. Esc fecha o painel ativo.
Estados das tarefas
As tarefas transitam pelo pipeline com os seguintes estados:
| Estado | Significado |
|---|---|
| Pendente | Enviada, na fila do Redis, aguardando worker |
| Processando | Um worker (WhisperX / OpenAI / Deepgram) está transcrevendo |
| Completada | Transcrição e análise finalizadas |
| Erro | Falha na transcrição ou análise (ver logs em Configurações > Logs) |
| Auditada | Passou pela planilha de auditoria com score |
| Rejeitada | Auditor marcou como reprovada |
Auditada / Rejeitada são estados de workflow humano aplicados sobre uma tarefa Completada. Não afetam o pipeline técnico.
Convenções visuais
- Modo escuro por padrão com acentos ciano/azul (alternável).
- Tipografia sans-serif em toda a UI.
- Cores semânticas: verde = ok, vermelho = erro, amarelo = atenção.
- Radar charts para emoções, line charts para séries temporais, bar charts para ponderações de qualidade.