Guia Usuario
Administração
Funcionalidades exclusivas para administradores - gerenciamento de agentes, dashboard e analytics.
Administração
As funcionalidades administrativas são acessíveis apenas para usuários com papel de admin ou supervisor.
Gerenciamento de Agentes
A página de agentes (/agents) fornece uma interface CRUD completa.
Listagem de Agentes
Tabela DataTable com colunas ordenáveis:
| Coluna | Descrição |
|---|---|
| Avatar | Inicial do nome com fundo colorido |
| Nome | Nome completo do agente |
| Endereço de e-mail | |
| Ramal | Número do ramal PJSIP |
| Status | Disponível, Em chamada, Indisponível, Offline |
| Conexão | Indicador verde (online) ou vermelho (offline) |
| Chamada Ativa | Número e duração (quando em chamada) |
| Ações | Botões de editar e excluir |
Recursos da tabela:
- Paginação (10, 25, 50 itens por página)
- Estado vazio com ícone quando não há agentes
- Filtro em tempo real
Busca e Filtros
- Busca global - Por nome, e-mail ou ramal
- Filtro de status - Dropdown: Disponível, Em chamada, Indisponível, Offline
- Limpar filtros - Botão para resetar todos os filtros
Criar Agente
Diálogo modal com formulário:
| Campo | Regra |
|---|---|
| Nome | Obrigatório |
| Obrigatório, validação de formato | |
| Ramal | Número do ramal |
| Senha | Obrigatório |
- Mensagens de erro em tempo real
- Notificação toast ao criar com sucesso
Editar Agente
- Formulário pré-preenchido com dados existentes
- Senha não obrigatória para atualização
- Validação inline
Excluir Agente
- Diálogo de confirmação com aviso
- Exibe o nome do agente na mensagem de confirmação
- Estado de carregamento durante a exclusão
- Notificação toast de confirmação
Funcionalidades em Tempo Real
- Exibição de chamada ativa com número de telefone
- Timer de duração da chamada ao vivo
- Tags de status com código de cores
- Indicador de conexão (verde/vermelho)
- Tooltips nos botões de ação
Dashboard Administrativo
A página /admin (ou /admin/dashboard) fornece monitoramento em tempo real:
Grade de Agentes
Visão de todos os agentes com:
- Status atual
- Chamada em andamento (se houver)
- Tempo de conexão
- Última atividade
Métricas em Tempo Real
- Total de agentes online
- Chamadas ativas no momento
- Fila de espera
- Taxa de ocupação
Analytics
A página /admin/analytics apresenta métricas de desempenho:
Por Agente
- Chamadas atendidas vs perdidas
- Tempo médio de atendimento
- Tempo médio de chamada
- Taxa de ocupação
- Horas trabalhadas
Visão Geral
- Volume de chamadas por período
- Horários de pico
- Desempenho comparativo entre agentes
- Tendências ao longo do tempo
Controle de Acesso
O middleware admin.ts protege as rotas administrativas:
- Rotas
/admin/*requerem papel de admin ou supervisor - Rota
/agentsrequer papel de admin - Aba "Sistema" nas configurações verificada com
v-if="authStore.isAdmin"
Tentativas de acesso não autorizado redirecionam para o dashboard principal.