Gestão de Entregadores — Painel Completo
Gestão de Entregadores — Painel Completo
O painel de Gestão de Entregadores é o centro de controle para gerenciar toda a equipe de entregadores da sua plataforma. Nesta tela você pode visualizar entregadores ativos, pendentes, acompanhar estatísticas, gráficos de crescimento, ranking de desempenho e muito mais.
---
📍 Como Acessar
No menu lateral do Admin, clique em **Entregadores** (ícone de capacete de motociclista).
Você será direcionado para: `https://entregasexpressas.com.br/admin/couriers`
---
🔔 Alerta de Entregadores Pendentes
No topo da página, um **banner amarelo** exibe o número de entregadores aguardando aprovação:
**"X Entregador(es) Pendente(s)"**
Descrição: "Entregadores aguardando aprovação para começar a trabalhar"
**Botão "Ver Pendentes"**: clique para ir à tela de aprovação de novos entregadores
💡 **Dica**: Acompanhe regularmente os pendentes para agilizar o onboarding de novos entregadores.
---
🔗 Link de Auto Cadastro
Logo abaixo do banner, há um link de cadastro público para entregadores:
**"Link de auto cadastro:"**
URL exibida (exemplo): `https://homolog-client.entregasexpressas.com.br/entregador/cadastro`
📋 **Uso**: Compartilhe este link com candidatos a entregador para que façam o cadastro inicial. Os cadastros ficarão pendentes até sua aprovação.
---
🎯 Cabeçalho e Ações Principais
Título da Seção
"Entregadores"
Descrição: "Gerencie os entregadores cadastrados, veja os que estão online e controle os pendentes."
Botões de Ação
1. 📱 Baixar App do Entregador
Abre uma página com links para download do aplicativo móvel dos entregadores (iOS e Android)
Link: `/admin/couriers/app`
2. ➕ Novo Entregador
Permite cadastrar manualmente um novo entregador diretamente pelo admin
Link: `/admin/users/create?default_role=entregador`
---
📊 Estatísticas em Tempo Real
Dois cards exibem métricas importantes:
1. Total de Entregadores
Número total de entregadores cadastrados (aprovados) na plataforma
Exemplo: **5**
2. Online Agora
Quantidade de entregadores atualmente conectados ao app e disponíveis para receber pedidos
Exemplo: **0**
**Status em tempo real**: atualizado conforme entregadores abrem/fecham o app
---
📅 Filtro por Período
Controle o período de análise dos gráficos e estatísticas:
**Data Inicial**: campo de data (formato AAAA-MM-DD)
**Data Final**: campo de data (formato AAAA-MM-DD)
**Botão "Aplicar Filtro"**: atualiza os gráficos e ranking com base no período selecionado
🗓️ **Padrão**: últimos 30 dias
---
📈 Gráfico de Entregadores Cadastrados
"Entregadores Cadastrados"
Gráfico de linha que mostra a evolução do número de entregadores cadastrados ao longo do período selecionado.
**Eixo X**: Datas do período filtrado
**Eixo Y**: Número total de entregadores (acumulado)
**Funcionalidade**: Visualize o crescimento da equipe de entregadores ao longo do tempo
💡 **Exemplo de uso**: Identifique períodos de maior crescimento ou estagnação no cadastro de entregadores.
---
🏆 Ranking de Entregadores
"Ranking de Entregadores"
Exibe um ranking dos entregadores com melhor desempenho no período filtrado.
**Critério de ordenação**: Número de entregas realizadas
**Status vazio**: Quando não há entregas no período, exibe: **"Nenhum dado de entregas no período"**
📊 **Função**: Identifique os entregadores mais produtivos e incentive melhores resultados.
---
📋 Lista de Entregadores
Controles de Tabela
1. Registros por página
Dropdown com opções: 10, 20, 50, 100
Controla quantos entregadores são exibidos por página
2. Campo de Busca
Pesquise entregadores por nome, telefone ou outras informações
Busca em tempo real
3. Botão Excel
**Ícone**: planilha verde
**Função**: Exporta a lista de entregadores para arquivo Excel (.xlsx)
**Uso**: Ideal para análises externas ou relatórios
---
Colunas da Tabela
A tabela exibe as seguintes informações para cada entregador:
#### 1. **Foto/Avatar**
Imagem de perfil do entregador
Padrão: avatar genérico se não houver foto
#### 2. **Nome**
Nome completo do entregador
Formatado como título (heading)
#### 3. **Telefone**
Número de telefone formatado
**Link direto para WhatsApp**: clique para abrir conversa no WhatsApp Web/App
Exemplo: `(32) 99815-7793`
Se não houver telefone cadastrado, a coluna fica vazia ("-")
#### 4. **Versão do App**
Versão do aplicativo móvel instalada no celular do entregador
Formato: `X.X.X+X.X.X`
Exemplo: `2.5.3+2.5.3`
**Importante**: Ajuda a identificar entregadores com app desatualizado
Se não houver informação, exibe "-"
#### 5. **Ativo Agora**
Status de conexão atual do entregador
**Valores**:
- **Sim** (verde): entregador online e disponível
- **Não** (vermelho): entregador offline ou desconectado
#### 6. **Último Local**
Tempo desde a última localização GPS registrada
Exemplos:
- "há 2 semanas"
- "há 4 meses"
- "há 8 meses"
**Função**: Identifique entregadores inativos há muito tempo
Se não houver informação, exibe "-"
#### 7. **Ação**
**Botão "Abrir Entregador"** (azul)
Abre a ficha completa do entregador com informações detalhadas
Link: `/admin/couriers/{id}`
---
📄 Paginação e Status
Paginação
**Anterior**: volta para a página anterior
**Números de página**: navegue diretamente para uma página específica
**Próximo**: avança para a próxima página
Status de Registros
Exibe informação sobre a visualização atual:
"Mostrando X à Y de Z registros"
Exemplo: "Mostrando 1 à 5 de 5 registros"
---
🔍 Casos de Uso Práticos
1. Aprovar Novos Entregadores
1. Observe o banner amarelo no topo
2. Clique em "Ver Pendentes"
3. Analise os cadastros e aprove/rejeite
1. Localize o entregador na lista
2. Clique no número de telefone
3. Será aberto o WhatsApp com o contato
3. Exportar Lista de Entregadores
1. Ajuste os filtros conforme necessário
2. Clique no botão "Excel" (ícone verde)
3. Arquivo será baixado automaticamente
4. Identificar Entregadores Inativos
1. Observe a coluna "Ativo Agora"
2. Verifique a coluna "Último Local"
3. Entregadores com "há X meses" podem estar inativos
5. Verificar Versões Desatualizadas do App
1. Observe a coluna "Versão do App"
2. Compare com a versão mais recente disponível
3. Entre em contato com entregadores usando versões antigas
---
⚠️ Observações Importantes
**Status Online em Tempo Real**: O campo "Online Agora" reflete o status atual do entregador no app
**Última Localização**: É atualizada somente quando o entregador está com o app aberto e GPS ativo
**Versão do App**: Essencial para garantir que todos usem recursos mais recentes e correções de bugs
**WhatsApp Direto**: Os links de telefone facilitam a comunicação rápida com a equipe
---
❓ Perguntas Frequentes
P: Como sei se um entregador está disponível para receber pedidos?
R: Verifique a coluna "Ativo Agora". Se estiver como "Sim" (verde), o entregador está online e disponível.
P: O que fazer com entregadores que não acessam há meses?
R: Você pode entrar em contato via WhatsApp ou desativar a conta do entregador se necessário.
P: Como atualizar o app de um entregador?
R: Entre em contato com o entregador e oriente-o a atualizar o app pela loja de aplicativos (Google Play ou App Store). Use o botão "Baixar App do Entregador" para compartilhar os links.
P: Posso cadastrar um entregador manualmente?
R: Sim! Clique no botão "Novo Entregador +" no topo da página e preencha o formulário.
P: Como funciona o Ranking de Entregadores?
R: O ranking ordena os entregadores por número de entregas realizadas no período filtrado. É uma forma de reconhecer os mais produtivos.