Divisão de Motoristas

Divisão de Motoristas

Visão Geral

O módulo "Divisão de Motoristas" permite gerenciar equipes de motoristas por divisões organizacionais, associando tipos de avisos a endereços de e-mail específicos. Esta funcionalidade ajuda a organizar a estrutura operacional da frota e a definir rotas de comunicação para diferentes eventos relacionados aos veículos.

Estrutura da Interface

O módulo consiste em duas telas principais:

• Tela de Listagem: Exibe as divisões cadastradas em formato de tabela
• Tela de Edição/Cadastro: Permite criar ou modificar uma divisão de motoristas

Tela de Listagem (Divisões de Motoristas)

Elementos da Interface

A tela de listagem apresenta as divisões cadastradas no sistema, com os seguintes elementos:

1. Seção de Filtros

   • Campo "Nome": Campo de texto para filtrar divisões pelo nome
   • Botões de Ação:
     • Botão de Pesquisa (ícone de lupa): Executa a pesquisa conforme filtros
     • Botão Limpar Filtros (ícone de documento): Limpa todos os campos de filtro
     • Botão Novo (ícone de adição): Abre a tela de cadastro de nova divisão
     • Botão Exportar para CSV (ícone de salvar): Exporta os dados da tabela para um arquivo CSV

2. Tabela de Divisões

   • Colunas:
     • CÓDIGO: Código identificador da divisão
     • NOME: Nome da divisão
   • Paginação: Controles de navegação entre páginas de resultados
   • Contador de Registros: Exibe a quantidade de registros exibidos e o total

Funcionamento e Fluxo de Trabalho

1. A tela carrega inicialmente mostrando todas as divisões cadastradas
2. O usuário pode filtrar os resultados digitando no campo "Nome" e clicando no botão de pesquisa
3. Para adicionar uma nova divisão, o usuário clica no botão "Novo"
4. Para editar uma divisão existente, o usuário clica na linha correspondente na tabela
5. Os dados podem ser exportados em formato CSV através do botão específico

Tela de Edição/Cadastro (Divisão de Motoristas)

Elementos da Interface

A tela de edição/cadastro permite criar ou modificar as informações de uma divisão:

1. Dados Básicos

   • Campo "Código": Identificador da divisão (texto alfanumérico)
   • Campo "Nome": Nome da divisão (texto obrigatório)

2. Parâmetros de Envio de Email

   • Seção "Tipo do Aviso": Dropdown com tipos de avisos do sistema
   • Campo "Email destino": Campo para inserir endereço de email válido
   • Botão "Adicionar Email e Tipo Aviso": Adiciona a combinação de tipo de aviso e email à lista
   • Lista de Destinatários: Exibe os emails/tipos de avisos já cadastrados
   • Botões para remover destinatários (ícone de menos)

3. Botões de Ação

   • Botão "Gravar": Salva as alterações
   • Botão "Excluir": Remove a divisão (visível apenas ao editar um registro existente)
   • Botão "Voltar": Retorna à tela de listagem sem salvar

Validações e Regras

1. Campo Código

   • Tipo: Texto alfanumérico
   • Validação: Nenhuma obrigatória

2. Campo Nome

   • Tipo: Texto
   • Validação: Campo obrigatório

3. Campo Email destino

   • Tipo: Texto (email)
   • Validação: Formato de email válido

4. Tipo do Aviso

   • Tipo: Seleção (dropdown)
   • Valores: Lista de tipos de avisos do sistema (proveniente de CONSTANTE_TIPOS_AVISOS_SEM_TODOS)
   • Exemplos incluem: Abastecimento, Abertura Capô, Aceleração Brusca, Freada Brusca, etc.

5. Lista de Destinatários

   • Validação: Não permite adicionar combinações duplicadas de email/tipo de aviso

Instruções Passo a Passo

Pesquisar Divisões

1. Acesse o menu principal e navegue até a opção "Divisões de Motoristas"
2. A tela de listagem será exibida com todas as divisões cadastradas
3. Para filtrar, digite o nome da divisão desejada no campo de filtro "Nome"
4. Clique no botão de pesquisa (ícone de lupa)
5. Os resultados filtrados serão exibidos na tabela

Criar Nova Divisão

1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
2. Preencha o campo "Código" com um identificador para a divisão
3. Preencha o campo "Nome" com o nome da divisão (obrigatório)
4. Para adicionar um email de notificação:
   • Selecione um tipo de aviso no dropdown "Tipo do Aviso"
   • Digite um endereço de email válido no campo "Email destino"
   • Clique no botão "Adicionar Email e Tipo Aviso"
   • O email será adicionado à lista abaixo
5. Repita o passo 4 para adicionar mais emails, se necessário
6. Clique no botão "Gravar" para salvar a nova divisão
7. O sistema retornará à tela de listagem mostrando a divisão criada

Editar Divisão Existente

1. Na tela de listagem, clique na linha da divisão que deseja editar
2. A tela de edição será aberta com os dados da divisão selecionada
3. Modifique os campos desejados (Código, Nome)
4. Para adicionar novos emails de notificação, siga o mesmo processo de criação
5. Para remover um email, clique no botão de remoção (ícone de menos) ao lado da entrada na lista
6. Clique em "Gravar" para salvar as alterações
7. O sistema retornará à tela de listagem

Excluir Divisão

1. Na tela de listagem, clique na linha da divisão que deseja excluir
2. Na tela de edição, clique no botão "Excluir"
3. Confirme a exclusão quando solicitado
4. O sistema retornará à tela de listagem sem a divisão excluída

Exportar Dados para CSV

1. Na tela de listagem, utilize os filtros se desejar exportar um subconjunto de dados
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O arquivo será baixado com os dados da tabela no formato CSV

Lógica de Funcionamento e Regras de Negócio

A tela de listagem realiza uma chamada ao servidor para buscar as divisões cadastradas. O sistema:

1. Envia os parâmetros de filtro ao servidor (nome da divisão, se fornecido)
2. Recebe e exibe os dados na tabela com paginação automática
3. Permite navegação entre as páginas de resultados

Na tela de edição/cadastro, o sistema:

1. Carrega os dados da divisão selecionada, se for uma edição
2. Permite adicionar combinações de tipos de avisos e emails
3. Valida os dados antes de enviar ao servidor:
   • Nome é obrigatório
   • Email deve estar em formato válido
   • Não permite duplicação de combinação email/tipo aviso
4. Ao gravar, envia todos os dados ao servidor, incluindo a lista de destinatários
5. Se a operação for bem-sucedida, retorna à tela de listagem

O módulo integra-se com outros componentes do sistema que enviam notificações aos emails cadastrados quando ocorrem eventos do tipo especificado.

Perguntas Frequentes

O que é uma Divisão de Motoristas?

Uma Divisão de Motoristas é uma unidade organizacional que agrupa motoristas conforme critérios específicos da empresa, como departamento, região geográfica ou tipo de operação.

Qual é o propósito de configurar emails para tipos de avisos?

Esta configuração permite que notificações específicas relacionadas a eventos dos veículos (como frenagens bruscas, abastecimentos, etc.) sejam enviadas automaticamente aos responsáveis adequados dentro da organização.

Posso cadastrar o mesmo email para diferentes tipos de avisos?

Sim, é possível cadastrar o mesmo email para receber notificações de diferentes tipos de avisos, mas cada combinação email/tipo aviso deve ser adicionada separadamente.

É possível enviar uma notificação para múltiplos emails quando ocorre um tipo específico de aviso?

Sim, basta adicionar múltiplos destinatários com o mesmo tipo de aviso mas diferentes endereços de email.

O que acontece se eu excluir uma divisão que possui motoristas associados?

O sistema pode ter restrições que impedem a exclusão de divisões com motoristas vinculados. É recomendável verificar e reassociar os motoristas antes da exclusão.

Como posso ver quais motoristas estão associados a uma divisão específica?

Esta funcionalidade normalmente estaria disponível no módulo de cadastro de motoristas, onde você poderia filtrar motoristas por divisão.

Posso importar uma lista de divisões de motoristas em massa?

A interface atual não possui esta funcionalidade, mas a exportação para CSV pode ajudar a preparar dados para importação através de outras ferramentas administrativas do sistema.

É necessário configurar emails para todos os tipos de avisos para cada divisão?

Não, você pode configurar apenas os tipos de avisos relevantes para cada divisão. Não há obrigatoriedade de configurar todos os tipos.