Início
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Início — Painel
A tela Início é a página inicial exibida no Painel assim que a transportadora efetua login — é a primeira tela que o usuário vê ao acessar o sistema.
Visão Geral
A tela Início é a página inicial exibida no Painel assim que a transportadora efetua login — é a primeira tela que o usuário vê ao acessar o sistema. Ela funciona como um painel resumo (dashboard) do período mais recente de entregas: mostra contadores de entregas por status, um gráfico de distribuição por status, um gráfico de utilização do aplicativo pelos motoristas e indicadores gerais (veículos utilizados, peso total transportado e valor total das notas fiscais). A partir dela, o usuário decide para qual área do sistema navegar em seguida (Clientes, Motoristas, Entregas, Rastreio, entre outras), inclusive por meio de um tour guiado que a própria tela Início pode iniciar.
Pré-requisitos
Para que a tela Início exiba o painel de indicadores, as seguintes condições precisam estar atendidas:
- Sessão ativa no sistema. Sem uma sessão ativa, o painel não carrega.
- Perfil de usuário diferente de administrador do sistema. Um administrador do sistema, ao acessar a tela Início, não vê filtros, indicadores nem gráficos — vê apenas uma imagem de fundo decorativa, pois esse perfil utiliza uma área administrativa própria do Painel.
- Vínculo do usuário a uma transportadora. Os indicadores são sempre calculados apenas com as entregas dessa transportadora; uma transportadora sem entregas no período filtrado simplesmente exibe indicadores zerados, sem erro.
Fluxo Operacional
- O usuário efetua login e é direcionado automaticamente à tela Início.
- A tela recupera o último filtro de período utilizado; se for a primeira vez, usa o filtro HOJE por padrão.
- A tela busca os indicadores do período correspondente ao filtro ativo.
- Enquanto aguarda o resultado, os cartões de indicadores e os gráficos exibem um ícone de carregamento.
- Ao receber o resultado, a tela exibe os contadores de entregas por status, o gráfico de status, o gráfico de utilização por motorista e os indicadores gerais (veículos, peso, valor de notas fiscais).
- O usuário pode trocar o filtro (HOJE, SEMANA ou INTERVALO) a qualquer momento, o que atualiza os indicadores exibidos.
- Sempre que o usuário volta para a tela Início vindo de outra tela do sistema, os indicadores são recarregados automaticamente, respeitando o filtro selecionado no momento.
Interface e Comportamentos
Filtros de Período na Tela Início
A tela Início oferece três filtros de período, exibidos como botões: HOJE, SEMANA e INTERVALO.
- Ao selecionar HOJE ou SEMANA, os indicadores são recarregados imediatamente, caso o filtro escolhido seja diferente do que já estava ativo.
- Ao selecionar INTERVALO, a tela apenas exibe dois campos de data (início e fim do período) e um botão BUSCAR; os indicadores só são recarregados quando o usuário confirma a busca.
- O filtro selecionado (e as datas do intervalo, quando aplicável) fica salvo e é reaproveitado na próxima vez que a tela Início for aberta.
Indicadores e Gráficos do Painel
A tela exibe, para o período filtrado:
- Sete cartões de contagem de entregas: Total entrega, Aguardando, A caminho, Finalizado, Não entregue, Cancelado e Desvinculada.
- Um gráfico de rosca com a distribuição das entregas entre os status Aguardando, A caminho, Finalizado, Não entregue, Cancelado e Desvinculada.
- Um gráfico de barras com o total de motoristas, quantos utilizaram o aplicativo e quantos não utilizaram, no período filtrado.
- Três cartões de indicadores gerais: veículos utilizados, peso transportado (em kg) e valor total das notas fiscais (em R$).
Enquanto os dados estão sendo buscados, todos esses cartões e gráficos exibem um ícone de carregamento no lugar do valor ou do gráfico.
Tour Guiado da Tela Início
A tela Início conta com um botão TOUR e um link ABRIR TUTORIAL (que abre um PDF de ajuda). O tour guiado destaca, em sequência, os filtros de período, o botão de tour, o link de tutorial, os contadores de status, o gráfico de status, o gráfico de utilização e os indicadores gerais.
Ao concluir o último passo do tour da tela Início, o sistema desativa o tour desta tela e encaminha automaticamente o usuário para a próxima tela do roteiro guiado, escolhida pela primeira área à qual ele tem permissão de acesso, nesta ordem de prioridade: Clientes, Centros de Distribuição, Motoristas, Veículos, Entregas, Roteirizações, Rastreio, Relatório, Configurações. Um usuário administrador da própria transportadora (perfil diferente de administrador do sistema) sempre segue para Clientes, independentemente de permissões individuais.
Acesso de Administradores do Sistema
Quando o usuário autenticado tem o perfil de administrador do sistema, a tela Início não exibe nenhum indicador — mostra apenas uma imagem de fundo decorativa.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Falha de comunicação ao carregar os indicadores | Notificação de erro | “Não foi possível obter todas as informações.” |
| Sessão expirada ao carregar os indicadores | Notificação de erro; a sessão é encerrada automaticamente 2 segundos depois | “Desculpe, sua sessão expirou.” |
| Filtro INTERVALO sem a data de início preenchida | Notificação de erro | “‘DATA DE INÍCIO’ deve ser preenchido.” |
| Filtro INTERVALO sem a data de fim preenchida | Notificação de erro | “‘DATA DE FIM’ deve ser preenchido.” |
| Filtro INTERVALO com data de início posterior à data de fim | Notificação de erro; mensagem nos dois campos de data | “‘DATA DE INÍCIO’ não pode ser maior que a ‘DATA DE FIM’.” (campo de início: “Data não pode ser maior que a de fim”; campo de fim: “Data não pode ser menor que a de início”) |
| Campo de data do intervalo, marcado como obrigatório, deixado em branco ao perder o foco | Mensagem abaixo do campo | “* {nome do campo} é obrigatório.” |
| Falha ao salvar a escolha de exibir ou não o tour guiado | Notificação de erro | “Não foi possível concluir o salvamento da escolha desejada.” |
| Situação | Feedback | Mensagem |
|---|---|---|
| Servidor recusa a requisição de indicadores por um motivo diferente de sessão expirada (ex.: filtro não identificado, período inválido) | Notificação de erro | A tela exibe, sem alteração, o texto de erro devolvido pelo servidor para aquele motivo específico. |
Regras de Negócio
As regras a seguir descrevem como a tela Início do Painel calcula os indicadores exibidos, sempre a partir das entregas da transportadora do usuário no período filtrado.
Filtro de Período (HOJE, SEMANA, INTERVALO)
- HOJE: a data de busca é a data atual.
- SEMANA: o período considerado vai de 7 dias atrás até a data atual.
- INTERVALO: o período considerado é o informado pelo usuário nos campos de data inicial e final. Se a data de início for posterior à data de fim, a busca é bloqueada.
- Para qualquer filtro diferente de HOJE, se a data de início ou a data de fim não forem informadas, a busca é recusada.
- Todas as buscas de entregas consideram exclusivamente a transportadora do usuário.
Cálculo dos Indicadores Gerais
- Veículos utilizados: contagem de placas de veículo distintas entre as entregas do período filtrado, desconsiderando entregas sem placa registrada.
- Peso transportado: soma do peso de cada entrega do período filtrado, considerando até 3 casas decimais por entrega.
- Valor total de notas fiscais: soma do valor de cada pagamento registrado na nota fiscal vinculada a cada entrega do período filtrado. Entregas sem nota fiscal vinculada, ou cuja nota fiscal não tenha dados de pagamento, não contribuem para esse total — e não geram nenhum aviso sobre a ausência.
Cálculo dos Indicadores por Status de Entrega
A contagem de entregas do período filtrado é agrupada por status. Na tela, cada status é mostrado como um indicador e como uma fatia do gráfico de distribuição, com este significado:
| Status | Indicador exibido |
|---|---|
| Aguardando | entregas ainda não iniciadas |
| A caminho | entregas em andamento |
| Finalizado | entregas concluídas |
| Não entregue | entregas com tentativa de entrega sem sucesso |
| Cancelado | entregas canceladas |
| Desvinculada | entregas sem vínculo de execução rastreado |
O indicador “Total entrega” é a soma de todos os status retornados para o período — inclusive de um eventual status fora dessa lista, que nesse caso entraria no total sem aparecer em nenhum indicador específico nem no gráfico.
Cálculo dos Indicadores de Motoristas
- Total de motoristas: contagem de motoristas distintos com pelo menos uma entrega no período filtrado, desconsiderando entregas sem motorista registrado.
- Motoristas que utilizaram o aplicativo: a mesma contagem acima, desconsiderando adicionalmente as entregas com status “Aguardando” (ou seja, considera que o motorista “utilizou o aplicativo” quando a entrega já saiu do status inicial).
- Motoristas que não utilizaram o aplicativo: a diferença entre o total de motoristas e o total que utilizou o aplicativo.
Formatação dos Valores Exibidos
- O valor total de notas fiscais é exibido no formato monetário brasileiro (separador de milhar, vírgula decimal); quando o valor formatado não tem casas decimais, o sistema completa com “,00”; quando o valor não é maior que zero, o sistema exibe “0,00”.
- O peso transportado é exibido no formato numérico brasileiro (separador de milhar); quando o valor não está definido, o sistema exibe “0”.
Evidências e Documentos Gerados
A tela Início não gera nenhum documento novo — ela apenas reaproveita a nota fiscal já vinculada a cada entrega para calcular o indicador de valor total de notas fiscais do período filtrado. Uma entrega sem nota fiscal vinculada, ou cuja nota fiscal não tenha dados de pagamento, simplesmente não contribui para esse total — sem gerar aviso ao usuário (ver T-09).
Troubleshooting
Os indicadores da tela Início não carregam e aparece um aviso de falha de comunicação
Cenário: o navegador não conseguiu se comunicar com o servidor ao buscar os indicadores (ex.: instabilidade de rede).
Mensagem exibida: “Não foi possível obter todas as informações.”
O que fazer: verificar a conexão com a internet e recarregar a tela; se o problema persistir, contatar o suporte.
A tela Início informa que a sessão expirou
Cenário: a sessão do usuário não é mais válida no momento de buscar os indicadores.
Mensagem exibida: “Desculpe, sua sessão expirou.”
O que fazer: aguardar o encerramento automático da sessão (ocorre 2 segundos após o aviso) e efetuar login novamente.
O filtro de intervalo não permite buscar sem a data de início
Cenário: o usuário selecionou o filtro INTERVALO e clicou em BUSCAR sem preencher o campo “Início do período”.
Mensagem exibida: “‘DATA DE INÍCIO’ deve ser preenchido.”
O que fazer: preencher a data de início do período e buscar novamente.
O filtro de intervalo não permite buscar sem a data de fim
Cenário: o usuário selecionou o filtro INTERVALO e clicou em BUSCAR sem preencher o campo “Fim do período”.
Mensagem exibida: “‘DATA DE FIM’ deve ser preenchido.”
O que fazer: preencher a data de fim do período e buscar novamente.
O filtro de intervalo rejeita uma data de início posterior à data de fim
Cenário: o usuário informou, no filtro INTERVALO, uma data de início posterior à data de fim.
Mensagem exibida: “‘DATA DE INÍCIO’ não pode ser maior que a ‘DATA DE FIM’.” (com destaque adicional nos dois campos: “Data não pode ser maior que a de fim” e “Data não pode ser menor que a de início”)
O que fazer: corrigir as datas informadas, garantindo que a data de início não seja posterior à data de fim.
O painel informa que não foi possível identificar o filtro
Cenário: uma falha de comunicação impediu que o filtro de período selecionado chegasse corretamente ao servidor.
Mensagem exibida: “Não foi possível identificar o filtro.”
O que fazer: recarregar a tela Início; se o problema persistir, contatar o suporte técnico.
O painel informa que não foi possível definir o período de início e fim
Cenário: uma falha de comunicação impediu que as datas do período selecionado chegassem corretamente ao servidor.
Mensagem exibida: “Não foi possível definir o período de início e fim.”
O que fazer: recarregar a tela Início e refazer a seleção do filtro; se o problema persistir, contatar o suporte técnico.
Não é possível salvar a escolha de exibir o tour guiado
Cenário: o usuário clicou no botão TOUR (ou concluiu/cancelou o tour) e não foi possível salvar a preferência.
Mensagem exibida: “Não foi possível concluir o salvamento da escolha desejada.”
O que fazer: tentar novamente; se o problema persistir, contatar o suporte técnico.
O valor total de notas fiscais exibido parece menor do que o esperado
Cenário: uma ou mais entregas do período filtrado não têm nota fiscal vinculada, ou a nota fiscal vinculada não contém dados de pagamento.
Mensagem exibida: Nenhuma — o indicador de valor total de notas fiscais simplesmente não soma o valor dessas entregas, sem qualquer aviso na tela.
O que fazer: conferir, entrega a entrega, se a nota fiscal correspondente foi corretamente vinculada; se necessário, contatar o suporte técnico para verificar o arquivo da nota fiscal.
Casos de Uso
Caso 1 — Consulta rápida do dia com o filtro HOJE
Um usuário da transportadora acessa a tela Início do Painel pela manhã. A tela abre já com o filtro HOJE selecionado (padrão) e exibe, por exemplo, 40 entregas no total: 12 aguardando, 18 a caminho, 8 finalizadas, 1 não entregue e 1 cancelada, além de 5 veículos utilizados e o valor total das notas fiscais do dia.
Caso 2 — Consulta comparativa com o filtro SEMANA
Na tela Início, o mesmo usuário troca o filtro para SEMANA para acompanhar o desempenho dos últimos 7 dias. Os indicadores são recarregados automaticamente com o total acumulado do período, incluindo o gráfico de utilização do aplicativo mostrando, por exemplo, 15 motoristas no total, dos quais 13 utilizaram o aplicativo e 2 não.
Caso 3 — Consulta de um período específico com o filtro INTERVALO
Na tela Início, um usuário precisa conferir os indicadores do mês anterior. Ele seleciona o filtro INTERVALO, informa a data de início (primeiro dia do mês anterior) e a data de fim (último dia do mês anterior) e clica em BUSCAR. Os indicadores são recarregados apenas com as entregas desse intervalo.
Caso 4 — Primeiro acesso com tour guiado ativo
Ao acessar a tela Início do Painel pela primeira vez, um usuário vê o tour guiado iniciar automaticamente, destacando os filtros de período, o botão de tour, o link de tutorial e cada indicador/gráfico em sequência. Ao concluir o último passo, o sistema o encaminha automaticamente para a primeira área à qual ele tem permissão de acesso.
