Controles de Frota - Modelo de Checklist

Visão Geral da Interface

A interfacefuncionalidade "Modelo de Checklist" faz parte de um sistema de gerenciamento de frota e permite aos usuários criar, editar e gerenciar modelos de checklist que serão utilizados pelos motoristas antes do expediente. A tela é composta por duas partes principais: uma tela de pesquisa/listagem e uma tela de cadastro/edição.

Esta ferramenta foi projetada para garantir que todos os veículos da frota sejam verificados regularmente seguindo um padrão específico, permitindo que a empresa mantenha um registro das condições dos veículos e identifique problemas potenciais antes que se tornem graves. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE FROTA e  opção MODELOS DE CHECKLIST.

Elementos da Interface

Tela de Pesquisa (Listagem)

A tela de listagem apresenta os seguintes elementos:

1. Cabeçalho: "Modelos de Checklist" - Identifica a funcionalidade atual

2. Seção de Filtros: Expansível/retrátil

   • Campo Nome: Entrada de texto para filtrar por nome do checklist
   • Campo Descrição: Entrada de texto para filtrar pela descrição
   • Campo Veículo: Seletor dropdown para filtrar por veículo específico
   • Checkbox "Somente ativos?": Quando marcado, exibe apenas checklists ativos
   • Botões de ação:
     • Pesquisar: Inicia a busca com os filtros aplicados
     • Limpar Filtros: Remove todos os filtros aplicados
     • Novo: Direciona para a tela de criação de um novo checklist
     • Exportar para CSV: Exporta a listagem atual para um arquivo CSV

3. Tabela de Resultados: Exibe os checklists encontrados com as colunas:

   • #: Numeração sequencial
   • IDENTIFICADOR: Código único do checklist
   • NOME: Nome do checklist
   • DESCRIÇÃO: Descrição detalhada do checklist
   • ATIVO: Indica se o checklist está ativo (SIM/NÃO)

4. Contador de Registros: Exibe o número total de registros encontrados

Tela de Cadastro/Edição

A tela de cadastro/edição contém os seguintes elementos:

1. Cabeçalho: "Modelo de Checklist" - Identifica a funcionalidade

2. Botões de Ação Superior:

   • Gravar: Salva as alterações feitas
   • Excluir: Remove o checklist (visível apenas para registros existentes)
   • Voltar: Retorna à tela de listagem

3. Seção de Informações Básicas:

   • Identificador: Código único do checklist (somente leitura, visível apenas em edição)
   • Nome: Campo de texto para o nome do checklist
   • Descrição: Campo de texto para a descrição detalhada
   • Checkbox "Ativo?": Define se o checklist está ativo
   • Informações de Auditoria: Datas de criação e última alteração (somente leitura)

4. Seção de Itens:

   • Título: "Itens (X)" - onde X é o número de itens cadastrados
   • Botão de Adição: Permite adicionar um novo item ao checklist
   • Tabela de Itens: Exibe os itens com colunas:
     • #: Sequência do item
     • Nome: Descrição do item de verificação
     • Obrigatório: Indica se o item é obrigatório (SIM/não)
     • Se reprovado/não: Exibe ações necessárias se o item for reprovado
     • Se aprovado/sim: Exibe ações necessárias se o item for aprovado
     • Tipo Resposta: Formato da resposta (APROVADO/REPROVADO ou SIM/NÃO)
     • Botões de Ação: Remover item, Mover para cima, Mover para baixo

5. Seção de Veículos:

   • Título: "Veículos (X)" - onde X é o número de veículos associados
   • Mensagem Informativa: "Associe quais veículos devem responder o checklist"
   • Filtros de Veículos:
     • Categoria: Dropdown para filtrar por categoria de veículo
     • Divisão: Dropdown para filtrar por divisão
     • Veículo: Campo de seleção com busca para escolher veículos
   • Botões de Ação:
     • Adicionar Veículo: Adiciona o veículo selecionado à lista
     • Adicionar Todos: Adiciona todos os veículos filtrados à lista
     • Remover Todos: Remove todos os veículos da lista
   • Lista de Veículos Associados: Exibe os veículos associados ao checklist com botão para remover individualmente

6. Pop-up de Item do Checklist: Formulário para adicionar/editar itens com:

   • Checkbox "Obrigatório?": Define se o item é obrigatório
   • Tipo Resposta: Dropdown para selecionar o tipo (APROVADO/REPROVADO ou SIM/NÃO)
   • Nome: Campo de texto para o nome do item
   • Descrição: Campo de texto para a descrição do item
   • Opções para "Se Reprovado/Não":
     • Exigir Foto: Requer foto se reprovado/não
     • Exigir Observação: Requer texto explicativo se reprovado/não
     • Abrir Ocorrência: Cria automaticamente um registro de ocorrência se reprovado/não
   • Opções para "Se Aprovado/Sim":
     • Exigir Foto: Requer foto se aprovado/sim
     • Exigir Observação: Requer texto explicativo se aprovado/sim
     • Abrir Ocorrência: Cria automaticamente um registro de ocorrência se aprovado/sim
   • Botão Inserir: Adiciona o item ao checklist

Propósito e Fluxo de Trabalho

Propósito

O sistema de Modelo de Checklist permite:

• Criar padrões de verificação para diferentes tipos de veículos
• Definir itens específicos que devem ser verificados pelos motoristas
• Especificar quais ações são necessárias conforme o resultado de cada verificação
• Associar os checklists a veículos específicos
• Manter um histórico de alterações nos modelos

Fluxo de Trabalho Típico

1. Pesquisa de Modelos: O usuário pode buscar checklists existentes utilizando os filtros disponíveis
2. Criação de Novo Modelo: O usuário cria um modelo especificando nome, descrição e status
3. Adição de Itens: O usuário adiciona itens específicos para verificação, definindo:
   • Se o item é obrigatório
   • O tipo de resposta (APROVADO/REPROVADO ou SIM/NÃO)
   • Requisitos específicos para cada tipo de resposta (fotos, observações, ocorrências)
4. Organização dos Itens: O usuário pode reordenar os itens utilizando os botões de seta
5. Associação de Veículos: O usuário associa veículos específicos que deverão utilizar o checklist
6. Salvamento do Modelo: O usuário salva o modelo para disponibilizá-lo aos motoristas
7. Utilização: Os motoristas preenchem o checklist antes do expediente, respondendo a cada item

Instruções Passo a Passo

Como Pesquisar um Modelo de Checklist

1. Acesse a tela "Modelos de Checklist"
2. Na seção de filtros, preencha os campos desejados:
   • Digite o nome ou parte do nome no campo "Nome"
   • Digite a descrição ou parte da descrição no campo "Descrição"
   • Selecione um veículo específico no dropdown "Veículo"
   • Marque "Somente ativos?" se desejar visualizar apenas checklists ativos
3. Clique no botão "Pesquisar" (ícone de lupa)
4. Os resultados serão exibidos na tabela abaixo
5. Para limpar os filtros, clique no botão "Limpar Filtros" (ícone de arquivo)

Como Criar um Novo Modelo de Checklist

1. Na tela de listagem, clique no botão "Novo" (ícone de mais)
2. Preencha os campos básicos:
   • Digite um nome significativo no campo "Nome"
   • Digite uma descrição detalhada no campo "Descrição"
   • Marque o checkbox "Ativo?" se o checklist deve estar disponível imediatamente
3. Para adicionar itens:
   • Clique no botão "+" na seção "Itens"
   • No pop-up, preencha:
     • Marque "Obrigatório?" se o item for de resposta obrigatória
     • Selecione o tipo de resposta (APROVADO/REPROVADO ou SIM/NÃO)
     • Digite o nome do item de verificação
     • Digite uma descrição detalhada se necessário
     • Configure as opções para cada tipo de resposta:
       • Marque "Exigir Foto" se necessário
       • Marque "Exigir Observação" se necessário
       • Marque "Abrir Ocorrência" se necessário
     • Clique em "Inserir"
   • Repita para adicionar mais itens
4. Para associar veículos:
   • Use os filtros de "Categoria" e "Divisão" se necessário
   • Selecione um veículo no dropdown
   • Clique no botão "+" para adicionar o veículo à lista
   • Ou clique em "Adicionar todos" para incluir todos os veículos filtrados
5. Clique no botão "Gravar" para salvar o modelo

Como Editar um Modelo de Checklist

1. Na tela de listagem, localize o modelo desejado e clique em qualquer parte da linha
2. Na tela de edição, modifique os campos desejados
3. Para reordenar itens, use os botões de seta (cima/baixo) ao lado de cada item
4. Para remover um item, clique no botão com ícone de lixeira
5. Para adicionar novos itens, siga o processo descrito na criação
6. Para gerenciar veículos associados:
   • Remova veículos individualmente clicando no botão "-" ao lado de cada um
   • Adicione novos veículos usando o processo descrito na criação
7. Clique em "Gravar" para salvar as alterações

Como Excluir um Modelo de Checklist

1. Na tela de listagem, localize o modelo desejado e clique em qualquer parte da linha
2. Na tela de edição, clique no botão "Excluir"
3. Confirme a exclusão na caixa de diálogo que aparece
4. O sistema retornará à tela de listagem após a exclusão bem-sucedida

Regras de Negócio e Validações

Com base na análise do código fonte, as seguintes regras e validações são aplicadas:

1. Validações Obrigatórias:

   • O campo "Nome" do checklist é obrigatório
   • O campo "Descrição" do checklist é obrigatório
   • Pelo menos um veículo deve ser associado ao checklist
   • Cada item do checklist deve ter um nome preenchido

2. Comportamento de Itens:

   • Os itens são exibidos na ordem da sequência definida
   • A reordenação de itens atualiza automaticamente o campo "sequência"
   • Quando um novo item é adicionado, recebe uma sequência que é o valor máximo atual + 1
   • Todos os itens são enviados ao servidor na ordem de sequência atual

3. Associação de Veículos:

   • Não é permitido associar o mesmo veículo mais de uma vez
   • É possível adicionar todos os veículos filtrados de uma só vez
   • Os IDs dos veículos são enviados como uma string separada por vírgulas

4. Outras Regras:

   • As alterações são registradas com data e hora
   • Um modelo de checklist pode ser marcado como inativo sem ser excluído
   • A exclusão de um modelo não exclui as respostas que já utilizaram esse modelo
   • Os modelos de checklist são específicos para determinados veículos

Perguntas Frequentes

P: Como posso associar o mesmo checklist a todos os veículos de uma categoria?
R: Utilize os filtros de "Categoria" na seção de veículos para selecionar a categoria desejada e então clique no botão "Adicionar todos" para incluir todos os veículos dessa categoria no checklist.

P: É possível duplicar um modelo de checklist existente?
R: Não há uma função específica para duplicação, mas você pode criar um novo modelo e adicionar manualmente os mesmos itens e veículos do modelo que deseja copiar.

P: O que acontece com os checklists já preenchidos se eu alterar um modelo?
R: As alterações em um modelo não afetam os checklists já preenchidos, pois estes são registros históricos. As novas verificações utilizarão o modelo atualizado.

P: Posso desativar temporariamente um checklist sem excluí-lo?
R: Sim, basta desmarcar o checkbox "Ativo?" na tela de edição e salvar. O checklist permanecerá no sistema, mas não estará disponível para preenchimento pelos motoristas.

P: Como faço para que motoristas enviem fotos de determinadas partes do veículo?
R: Adicione itens específicos para cada parte do veículo que deseja fotografada e marque a opção "Exigir Foto" no lado apropriado (aprovado/reprovado ou sim/não).

P: Como posso abrir automaticamente uma ocorrência quando um item crítico é reprovado?
R: Ao adicionar ou editar o item, marque a opção "Abrir Ocorrência Se Reprovado" ou "Abrir Ocorrência Se Aprovado" dependendo da situação que deseja monitorar.

P: Posso configurar um item para exigir observações obrigatórias?
R: Sim, marque a opção "Exigir Observação" para o resultado desejado (aprovado/reprovado ou sim/não) ao adicionar ou editar o item.

P: Como posso organizar os itens em uma ordem específica?
R: Utilize os botões de seta (cima/baixo) ao lado de cada item na tela de edição para movê-los para a posição desejada na sequência.

P: Posso exportar a lista de modelos de checklist?
R: Sim, na tela de listagem, clique no botão "Exportar para CSV" (ícone de salvar) para exportar os dados da tabela.

P: O que significa "Tipo Resposta" nos itens do checklist?
R: Define como o item será respondido pelos motoristas. Pode ser "APROVADO/REPROVADO" (opção 1) ou "SIM/NÃO" (opção 2), alterando a terminologia apresentada no aplicativo móvel.