Skip to main content

Controles de Frota - Agenda de Eventos

Descrição da Interface

O sistema apresentado é uma solução completa de gerenciamento de agenda de eventos para veículos, projetada para empresas que gerenciam frotas. A interface possui um design limpo e organizado, utilizando um esquema de cores neutro com elementos destacados em cores primárias para ações importantes.

A plataforma "CONCEPT RASTREAMENTO" fornece uma maneira estruturada para agendamento, acompanhamento e documentação de eventos relacionados à manutenção e inspeção de veículos. A interface está dividida em duas partes principais: uma lista de visualização de eventos agendados e um formulário detalhado para criação/edição de eventos.

Elementos das Telas

Tela de Listagem de Eventos (AgendaEventos)

Seção de Filtros

  • Tipo: Dropdown (Todos os tipos de eventos disponíveis + opção "Todos")
  • Status: Dropdown (ABERTO, CONCLUÍDO, CANCELADO, + opção "Todos")
  • Veículo: Dropdown (Lista de veículos disponíveis com placa e identificação)
  • Período: Dropdown (Opções: "Com Data", "Sem Data", "Todos")
  • Data Início: Seletor de data (formato DD-MM-YYYY)
  • Data Fim: Seletor de data (formato DD-MM-YYYY)
  • Número: Campo de texto (busca por número de registro)
  • Botões de Ação:
    • Pesquisar (ícone lupa): Inicia busca com os filtros aplicados
    • Limpar Filtros (ícone arquivo): Restaura filtros para valores padrão
    • Novo (ícone +): Cria novo evento
    • Exportar para CSV (ícone salvar): Exporta dados filtrados para arquivo CSV

Tabela de Resultados

  • Colunas:
    • #: Numeração sequencial
    • No.: Número do evento
    • VEÍCULO: Placa do veículo
    • TIPO: Categoria do evento
    • NOME: Nome descritivo do evento
    • DATA: Data agendada (formato DD-MM-YYYY)
    • ODÔMETRO: Leitura do odômetro
    • HORÍMETRO: Leitura do horímetro
    • STATUS: Situação atual (ABERTO, CONCLUÍDO, CANCELADO)
    • EMAIL: Endereço para notificações
  • Funcionalidade: Seleção de linha única, clicável para edição

Tela de Edição de Evento (AgendaEventosEdit)

Barra de Ações

  • Botões de Alteração de Status (quando o evento existir):
    • CONCLUIR: Define status para CONCLUÍDO
    • CANCELAR: Define status para CANCELADO
  • Botões de Ação:
    • Gravar: Salva alterações
    • Excluir: Remove o evento (apenas visível para registros já salvos)
    • Imprimir: Abre tela de impressão
    • Voltar: Retorna à listagem

Abas

  1. DADOS (Principal)

    • Seção de Identificação:

      • Evento No.: Número do evento (somente leitura quando editando)
      • Veículo: Dropdown (obrigatório) - Lista de veículos disponíveis
      • Odômetro Atual: Campo numérico - Exibe odômetro atual do veículo selecionado
      • Botão "Calibrar": Envia comando para calibrar odômetro no dispositivo
      • Horímetro Atual: Campo numérico - Exibe horímetro atual do veículo selecionado
      • Botão "Calibrar": Envia comando para calibrar horímetro no dispositivo
      • Tipo: Dropdown (obrigatório) - Tipos de eventos disponíveis
      • Nome: Campo de texto (obrigatório) - Nome descritivo do evento
      • Status: Dropdown (obrigatório) - ABERTO, CONCLUÍDO, CANCELADO
      • Descrição: Área de texto - Detalhamento do evento (máx. 400 caracteres)
      • Email: Área de texto (obrigatório) - Endereços para notificação (separados por ;)
      • Checkbox "Email inválido": Indica problemas de entrega nas notificações

    • Seção de Parâmetros:

      • Data do Evento: Seletor de data
      • Checkbox "Recorrente por Data": Habilita configuração de recorrência por data
      • Configurações de recorrência por data: Intervalo e tipo (dias, semanas, meses)
      • KM: Campo numérico - Leitura do odômetro para agendamento
      • Checkbox "Recorrente por KM": Habilita configuração de recorrência por quilometragem
      • Configurações de recorrência por KM: Intervalo em quilômetros
      • Horímetro: Campo numérico - Leitura do horímetro para agendamento
      • Checkbox "Recorrente por Horímetro": Habilita configuração de recorrência por horímetro
      • Configurações de recorrência por horímetro: Intervalo em horas
      • Indicador de data/hora de cadastro (somente leitura)
      • Indicador de data/hora de envio de email (somente leitura)

  2. ITENS (Para eventos com itens associados)

    • Seletor de Tipo de Item: Dropdown para adicionar itens ao evento
    • Botão de Adição: Adiciona o item selecionado à lista
    • Tabela de Itens:
      • Código: Identificador do item
      • Descrição: Nome descritivo do item
      • Status: Dropdown (SIM/NÃO) - Indica se o item foi atendido
      • Observação: Área de texto - Comentários sobre o item

  3. ANEXOS (Documentos relacionados)

    • Tabela de Anexos Existentes:
      • Arquivo: Nome do documento
      • Criado às: Data e hora de upload
    • Botões de Ação:
      • Ver Anexo: Abre o documento selecionado
      • Excluir Anexo: Remove o anexo selecionado
    • Seção de Upload:
      • Seletor de Arquivo: Permite escolher o arquivo para upload
      • Campo de Nome: Exibe o nome do arquivo selecionado
      • Botão de Upload: Envia o arquivo para o servidor

Tela de Impressão (ImpressaoAgendaEvento)

  • Cabeçalho:

    • Botão Imprimir: Aciona a impressão pelo navegador
    • Botão Voltar: Retorna à tela de edição

  • Conteúdo do Relatório:

    • Título: Evento, tipo e placa do veículo
    • Informações do veículo
    • Data de cadastro e data de envio de lembrete
    • Endereço de email para notificações
    • Número do evento
    • Nome do evento
    • Parâmetros de agendamento (data, KM e horímetro)
    • Descrição completa
    • Lista de itens (se existirem)
    • Seção para assinaturas dos responsáveis (Encarregado, Mecânico, Eletricista, Motorista, Borracheiro, Lubrificador, Lanterneiro, Operador)

Propósito e Fluxo de Trabalho

Propósito

O sistema foi desenvolvido para gerenciar eventos relacionados à manutenção preventiva e corretiva de veículos em uma frota. Ele permite o agendamento baseado em diferentes parâmetros (data, quilometragem ou horímetro), o acompanhamento do status de cada evento, a documentação detalhada das atividades realizadas e o envio de notificações automáticas.

Fluxo de Trabalho Principal

  1. Visualização da Agenda: O usuário acessa a tela de listagem para ver todos os eventos agendados, podendo filtrar por diferentes critérios.

  2. Criação de Evento:

    • O usuário clica no botão "Novo"
    • Preenche os dados obrigatórios (Veículo, Tipo, Nome, Email)
    • Define pelo menos um parâmetro de agendamento (Data, KM ou Horímetro)
    • Configura recorrência se necessário
    • Adiciona itens específicos se aplicável
    • Clica em "Gravar"

  3. Acompanhamento:

    • Os eventos são monitorados na tela de listagem
    • Notificações por email são enviadas conforme configurado
    • O status dos eventos é atualizado (ABERTO → CONCLUÍDO ou CANCELADO)

  4. Finalização:

    • Ao concluir um evento, o usuário acessa o registro e clica em "CONCLUIR"
    • Se o evento for recorrente, o sistema pergunta se deve criar o próximo evento
    • Os detalhes da execução são documentados (itens realizados, observações)
    • Anexos podem ser adicionados para documentação

  5. Documentação:

    • O relatório pode ser impresso para assinatura dos responsáveis
    • Os registros ficam armazenados no sistema para histórico e consulta

Instruções Passo a Passo

Como Filtrar Eventos

  1. Acesse a tela de listagem de eventos
  2. Utilize os campos de filtro conforme necessário:
    • Selecione um tipo específico de evento no dropdown "Tipo"
    • Escolha um status no dropdown "Status"
    • Selecione um veículo específico no dropdown "Veículo"
    • Defina o período desejado utilizando o dropdown "Período" e os campos de data
    • Para buscar um evento específico, digite seu número no campo "Número"
  3. Clique no botão de pesquisa (ícone de lupa)
  4. Para limpar todos os filtros, clique no botão "Limpar Filtros" (ícone de arquivo)

Como Criar um Novo Evento

  1. Na tela de listagem, clique no botão "Novo" (ícone +)
  2. Na aba "DADOS", preencha as informações principais:
    • Selecione o veículo no dropdown "Veículo"
    • Escolha o tipo de evento no dropdown "Tipo"
    • Digite um nome descritivo no campo "Nome"
    • Selecione o status inicial no dropdown "Status" (normalmente "ABERTO")
    • Preencha a descrição detalhada (opcional)
    • Digite o(s) endereço(s) de email para notificação
  3. Na seção "Parâmetros", defina pelo menos um dos seguintes:
    • Data do evento (usando o seletor de data)
    • Quilometragem prevista (campo KM)
    • Leitura de horímetro prevista (campo Horímetro)
  4. Se o evento for recorrente:
    • Marque a opção "Recorrente por Data", "Recorrente por KM" ou "Recorrente por Horímetro"
    • Configure o intervalo de recorrência nos campos correspondentes
  5. Se necessário, adicione itens na aba "ITENS":
    • Selecione o tipo de item no dropdown
    • Clique no botão de adição (ícone +)
    • Repita para adicionar mais itens
  6. Clique no botão "Gravar" para salvar o evento

Como Concluir um Evento

  1. Na tela de listagem, localize e clique no evento desejado
  2. Na tela de edição, verifique se todos os dados estão corretos
  3. Se aplicável, acesse a aba "ITENS" e atualize o status (SIM/NÃO) de cada item
  4. Adicione observações nos itens conforme necessário
  5. Clique no botão "CONCLUIR" no topo da tela
  6. Se o evento for recorrente, o sistema perguntará se deseja criar o próximo evento:
    • Escolha "Concluir e criar" para finalizar e criar o próximo
    • Escolha "Concluir apenas" para finalizar sem criar o próximo
  7. O sistema atualizará o status para "CONCLUÍDO"

Como Anexar Documentos

  1. Na tela de edição do evento, acesse a aba "ANEXOS"
  2. Clique no botão "Selecione o arquivo"
  3. Escolha o arquivo desejado no seu computador
  4. O nome do arquivo aparecerá no campo abaixo
  5. Clique no botão de upload (ícone de upload)
  6. Aguarde a confirmação de que o arquivo foi enviado com sucesso
  7. O documento aparecerá na lista de anexos

Como Imprimir um Relatório

  1. Na tela de edição do evento, clique no botão "Imprimir"
  2. O sistema abrirá a tela de impressão com todos os dados do evento formatados
  3. Revise as informações apresentadas
  4. Clique no botão "Imprimir" na tela de impressão
  5. Selecione sua impressora e configurações na janela de impressão do navegador
  6. Confirme a impressão

Como Calibrar Odômetro/Horímetro

  1. Na tela de edição, selecione o veículo desejado
  2. O sistema exibirá os valores atuais de odômetro e horímetro
  3. Ajuste os valores conforme necessário
  4. Clique no botão "Calibrar" ao lado do campo que deseja atualizar
  5. O sistema enviará um comando para o dispositivo de rastreamento do veículo
  6. Aguarde a confirmação da calibração

Regras de Negócio e Validações

  1. Campos Obrigatórios:

    • Veículo
    • Tipo
    • Nome
    • Email
    • Status
    • Pelo menos um parâmetro de agendamento (Data, KM ou Horímetro)

  2. Recorrência:

    • Eventos podem ser configurados como recorrentes por data, quilometragem ou horímetro
    • Para cada tipo de recorrência, é necessário definir o intervalo correspondente
    • Quando um evento recorrente é concluído, o sistema pode criar automaticamente o próximo evento da série

  3. Status:

    • Eventos são criados inicialmente com status "ABERTO"
    • Podem ser alterados para "CONCLUÍDO" ou "CANCELADO"
    • Após concluído ou cancelado, o evento não pode ser reaberto

  4. Itens:

    • Não é possível adicionar itens duplicados ao evento
    • Itens podem ser removidos antes da conclusão do evento
    • O status dos itens (SIM/NÃO) deve ser preenchido antes da conclusão

  5. Anexos:

    • Os anexos são armazenados em um bucket S3 específico para o cliente e evento
    • O caminho segue o padrão: cliente/evento/nome_do_arquivo
    • Somente usuários com permissão de gravação podem anexar ou excluir documentos

  6. Calibração:

    • A calibração envia um comando para o dispositivo de rastreamento
    • Um comando pendente impede novas calibrações até ser processado
    • O status da calibração é verificado automaticamente ao abrir a tela

  7. Emails:

    • Múltiplos destinatários devem ser separados por ponto-e-vírgula (;)
    • O sistema armazena a data e hora do último envio de notificação
    • Emails inválidos podem ser marcados para evitar tentativas futuras

Perguntas Frequentes

1. Como faço para configurar um evento recorrente?

Para configurar um evento recorrente, crie o evento normalmente e marque uma das opções de recorrência: "Recorrente por Data", "Recorrente por KM" ou "Recorrente por Horímetro". Em seguida, especifique o intervalo desejado nos campos correspondentes. Por exemplo, para um evento recorrente a cada 10.000 km, marque "Recorrente por KM" e digite "10000" no campo de recorrência KM.

2. Como funcionam as notificações por email?

O sistema envia notificações automáticas para os endereços cadastrados no campo "Email". Você pode cadastrar múltiplos endereços separando-os por ponto-e-vírgula (;). Se houver problemas na entrega, marque a opção "Email inválido?" para evitar novas tentativas. O sistema registra a data e hora do último envio no campo "E-mail enviado em".

3. Por que não consigo excluir um evento?

Você só pode excluir eventos se tiver permissão de gravação no sistema. Além disso, eventos já concluídos ou que fazem parte de uma série recorrente podem ter restrições para exclusão. Se o botão "Excluir" não estiver visível, é porque você não tem permissão ou o evento não pode ser excluído.

4. Como funciona a calibração de odômetro e horímetro?

A calibração envia um comando para o dispositivo de rastreamento instalado no veículo, atualizando os valores de referência. Para calibrar, selecione o veículo, ajuste os valores nos campos correspondentes e clique no botão "Calibrar". O status da calibração pode ser verificado clicando no botão de atualização ao lado. Durante uma calibração em andamento, o botão exibirá "Calibração em execução...".

5. O que acontece quando concluo um evento recorrente?

Quando você conclui um evento recorrente, o sistema pergunta se deseja criar automaticamente o próximo evento da série. Se escolher "Concluir e criar", o sistema criará o próximo evento com base no intervalo configurado (adicionando o período à data ou o valor ao odômetro/horímetro). Se escolher "Concluir apenas", o evento será concluído sem criar o próximo da série.

6. Como posso ver todos os eventos atrasados?

Na tela de listagem, utilize os filtros para encontrar eventos atrasados. Selecione "ABERTO" no campo Status, escolha "Com Data" no campo Período e defina uma data fim anterior à data atual. Os eventos que aparecerem estarão atrasados em relação à data. Para eventos baseados em KM ou horímetro, verifique os valores atuais exibidos na tela de edição e compare com os valores agendados.

7. Posso imprimir vários eventos de uma vez?

Não, o sistema permite apenas a impressão individual de cada evento. Para imprimir um evento, acesse-o na tela de edição e clique no botão "Imprimir". Se precisar documentar vários eventos, você pode exportar a lista completa para CSV usando o botão "Exportar para CSV" na tela de listagem e depois formatar o arquivo conforme necessário.

8. Como sei se um veículo tem eventos pendentes?

Na tela de listagem, utilize o filtro de veículo para selecionar o veículo específico e o filtro de status para selecionar "ABERTO". Os resultados mostrarão todos os eventos pendentes para aquele veículo. Você também pode verificar a proximidade do vencimento comparando os valores atuais de odômetro e horímetro (visíveis na tela de edição) com os valores agendados.

Back to top