Controles de Frota - Ocorrências

Sistema de Gerenciamento de Ocorrências de Veículos

Descrição Geral

O sistema de Gerenciamento de Ocorrências de Veículos é uma plataforma desenvolvida para registrar, acompanhar e gerenciar eventos relacionados aos veículos da frota. A interface permite aos usuários registrar diferentes tipos de ocorrências, anexar documentos, definir status e acompanhar todo o ciclo de vida de cada registro.

O sistema é dividido principalmente em duas áreas funcionais:

Listagem de Ocorrências - onde os usuários podem visualizar, filtrar e gerenciar todas as ocorrências registradas
Formulário de Cadastro/Edição - onde os usuários podem criar novas ocorrências ou editar as existentes

Elementos da Interface

Tela de Listagem (Ocorrências de Veículos)

Área de Filtros

Veículo: Campo de seleção com busca avançada que permite filtrar por placa, marca, modelo ou etiqueta personalizada
Tipo: Seletor com tipos predefinidos de ocorrências
Período: Campo duplo de data (De/Até) para filtrar ocorrências por intervalo de datas
Motorista: Seletor com lista de motoristas cadastrados no sistema
Status: Seletor com opções de estado da ocorrência (ABERTA, FINALIZADA, etc.)
Checklist: Campo de texto para busca por número de checklist
Item Checklist: Seletor com lista de itens de checklist disponíveis

Botões de Ação

Pesquisar: Botão para aplicar os filtros selecionados
Limpar Filtros: Botão para resetar os critérios de pesquisa
Novo: Botão para criar uma nova ocorrência
Exportar para CSV: Botão para exportar os dados filtrados em formato CSV
Adicionar Todas: Botão para adicionar todas as ocorrências à lista de seleção
Seleção de Ocorrências: Botão com contador de itens selecionados

Tabela de Resultados

Colunas: #, Checklist, Veículo, Tipo, Motorista, Descrição, Status, Data
Registros: Linhas com dados de cada ocorrência
Contador: Informação sobre o número total de registros exibidos

Novo Status: Seletor para alterar o status de múltiplas ocorrências
Botões de Ação:
- Limpar Seleção: Remove todas as ocorrências da lista
- Gravar Novo Status: Aplica o status selecionado a todas as ocorrências na lista
Tabela de Selecionados: Exibe Veículo, Tipo, Status, Data e botão para remover item

Tela de Cadastro/Edição (Ocorrência de Veículo)

Informações da Ocorrência

Veículo: Seletor obrigatório com busca avançada
Motorista: Seletor com lista de motoristas disponíveis
Tipo da Ocorrência: Seletor obrigatório com tipos predefinidos
Data/Hora: Campo obrigatório de data e hora da ocorrência
Status: Seletor obrigatório com opções predefinidas
Descrição: Área de texto obrigatória com limite de 400 caracteres
Data/Hora do Cadastro: Campo informativo (somente exibição)

Área de Anexos

Tabela de Anexos: Lista os arquivos anexados à ocorrência
Botões de Ação:
- Ver: Visualiza o anexo selecionado
- Excluir: Remove o anexo selecionado
Upload de Arquivos:
- Selecione o arquivo: Botão para escolher um arquivo
- Nome do arquivo: Campo de texto com o nome do arquivo selecionado
- Upload: Botão para enviar o arquivo para o servidor

Botões de Ação Principal

Gravar: Salva as informações da ocorrência
Excluir: Remove a ocorrência (disponível apenas para registros existentes)
Voltar: Retorna à tela de listagem

Fluxo de Trabalho

Processo de Consulta

O usuário acessa a tela de listagem de ocorrências de veículos
Por padrão, o sistema exibe as ocorrências do mês atual
O usuário pode aplicar filtros para encontrar ocorrências específicas
Os resultados são exibidos na tabela, que pode ser ordenada por qualquer coluna
O usuário pode selecionar uma ocorrência para editar, clicando sobre ela
Alternativamente, pode selecionar múltiplas ocorrências para alterar seu status em lote

Processo de Cadastro

O usuário clica no botão "Novo" na tela de listagem
O sistema apresenta o formulário de cadastro com campos em branco
O usuário preenche os campos obrigatórios (Veículo, Tipo, Data/Hora, Descrição, Status)
Ao clicar em "Gravar", o sistema valida os dados e cria a ocorrência
Após o cadastro, o usuário pode anexar arquivos relacionados à ocorrência

Processo de Edição

O usuário seleciona uma ocorrência na tabela de listagem
O sistema abre o formulário preenchido com os dados da ocorrência selecionada
O usuário pode modificar os campos desejados
Ao clicar em "Gravar", o sistema valida e salva as alterações
O usuário pode adicionar ou remover anexos conforme necessário

Processo de Exclusão

O usuário acessa o formulário de edição de uma ocorrência existente
Clica no botão "Excluir"
O sistema remove a ocorrência e retorna à tela de listagem

Processo de Alteração em Lote

O usuário seleciona ocorrências na tela de listagem
Clica no ícone de seleção para abrir o modal de ocorrências selecionadas
Escolhe um novo status para aplicar a todas as ocorrências
Clica em "Gravar Novo Status" para confirmar a alteração em lote

Instruções Passo a Passo

Como Filtrar Ocorrências

Acesse a tela de listagem de ocorrências
Selecione os critérios de filtragem desejados:
- Escolha um veículo específico no seletor "Veículo"
- Selecione um tipo de ocorrência
- Defina um período de datas para a pesquisa
- Selecione um motorista específico
- Escolha um status para filtrar
- Informe um número de checklist, se aplicável
- Selecione um item específico de checklist, se necessário
Clique no botão com ícone de lupa para aplicar os filtros
Para limpar todos os filtros, clique no botão com ícone de arquivo

Como Cadastrar uma Nova Ocorrência

Na tela de listagem, clique no botão com ícone de "+" (Novo)
No formulário de cadastro:
- Selecione o veículo relacionado à ocorrência (obrigatório)
- Escolha o motorista, se houver um associado à ocorrência
- Selecione o tipo de ocorrência (obrigatório)
- Informe a data e hora do evento (obrigatório)
- Selecione o status inicial da ocorrência (obrigatório, padrão "ABERTA")
- Preencha a descrição detalhada da ocorrência (obrigatório)
Clique no botão "Gravar" para salvar a ocorrência
Se necessário, após gravar, adicione anexos relacionados:
- Clique em "Selecione o arquivo"
- Escolha o arquivo desejado em seu computador
- Clique no botão de upload (ícone de seta para cima)

Como Alterar o Status de Múltiplas Ocorrências

Na tela de listagem, selecione as ocorrências desejadas
- Para selecionar todas, clique no botão "Adicionar Todos"
- Para selecionar individualmente, clique no botão "+" de cada linha
Clique no ícone de arquivo com contador para abrir o modal de seleção
No modal, escolha o novo status a ser aplicado
Clique em "Gravar Novo Status"
Confira a mensagem de confirmação na parte superior do modal

Como Anexar um Documento a uma Ocorrência

Acesse o formulário de edição da ocorrência desejada
Na seção de anexos, clique em "Selecione o arquivo"
Escolha o arquivo em seu computador
Clique no botão de upload (ícone de seta para cima)
Aguarde a confirmação de que o arquivo foi anexado com sucesso

Regras de Negócio

Validações

Todos os campos marcados como obrigatórios devem ser preenchidos antes de gravar
O sistema exige os seguintes campos obrigatórios:
- Veículo
- Tipo da Ocorrência
- Data/Hora
- Descrição (limite de 400 caracteres)
- Status
Para alterações em lote, é necessário selecionar pelo menos uma ocorrência e definir um novo status

Permissões

O sistema controla o acesso às funcionalidades com base em perfis de usuário:
- Usuários com capacidade Master têm acesso total a todas as funcionalidades
- Usuários de Grupo podem ter permissões específicas para alterar registros
- A permissão para gravar e excluir registros é verificada antes de habilitar os botões correspondentes

Anexos

Os arquivos são armazenados em servidor específico, com referências mantidas no banco de dados
Cada anexo está vinculado a uma ocorrência específica
Os anexos podem ser visualizados e excluídos conforme necessário
O sistema registra a data e hora do upload de cada anexo

Perguntas Frequentes

Como funciona o fluxo de status de uma ocorrência?

As ocorrências geralmente começam com o status "ABERTA". À medida que são tratadas, podem passar por diferentes estados até serem finalizadas. O sistema permite a alteração do status a qualquer momento, tanto individualmente quanto em lote.

É possível anexar mais de um arquivo a uma ocorrência?

Sim, você pode anexar múltiplos arquivos a uma ocorrência. Cada arquivo é listado na tabela de anexos e pode ser gerenciado individualmente.

Como posso encontrar todas as ocorrências relacionadas a um veículo específico?

Na tela de listagem, utilize o filtro de "Veículo" para selecionar o veículo desejado. A busca permite localizar o veículo por placa, marca, modelo ou etiqueta personalizada.

É possível exportar os dados para análise externa?

Sim, a funcionalidade "Exportar para CSV" permite gerar um arquivo contendo todas as ocorrências exibidas na tabela de resultados, que pode ser aberto em programas de planilha eletrônica.

O que fazer se precisar alterar o status de várias ocorrências ao mesmo tempo?

Utilize a funcionalidade de seleção múltipla, marcando as ocorrências desejadas e, em seguida, abrindo o modal de seleção. Ali, você pode escolher um novo status e aplicá-lo a todas as ocorrências selecionadas simultaneamente.

Como filtrar ocorrências associadas a um item específico de checklist?

Utilize o filtro "Item Checklist" na tela de listagem para selecionar o item desejado. Isso mostrará todas as ocorrências vinculadas a esse item específico.

Quais tipos de ocorrências podem ser registradas no sistema?

Os tipos de ocorrências são configurados previamente e podem incluir eventos como falhas mecânicas, acidentes, manutenções preventivas, itens de checklist e outras categorias relevantes para a gestão da frota.

É possível vincular uma ocorrência a um checklist específico?

Sim, as ocorrências podem estar associadas a checklists específicos, o que permite rastrear problemas identificados durante inspeções de rotina. Essa vinculação facilita o acompanhamento das ações corretivas necessárias.