Ir para o conteúdo principal

Tela de Busca

📝 Visão Geral

Título:  Solicitação de Transporte Escolar 
URL: /transporte/solicitacao_escolar/solicitacao/pesquisar

Este tela permite filtrar e gerenciar as solicitações de transporte escolar para alunos que possuam uma solicitação em situação. Permitindo criar, cancelar, excluir, aprovar e visualizar sua informações atraves dos filtros e botões de ações.


📍 Localização:
Transporte > Solicitação Escolar > Solicitação > Solicitação de Transporte


1.Filtros Disponíveis


  • Ano Letivo *: Informe o ano de referência para a solicitação

    • Tipo: Numérico (Inteiro)

    • Validação: Mínimo 1 dígito e Máximo 4 dígitos

    • Valor Padrão: Ano atual.

  • Número de  Solicitação: Informe o número da solicitação
    • Tipo: Numérico (Inteiro)
    • Validação: Mínimo: 1 dígito e Máximo: 10 dígitos

  • Rota:  Selecione rotas cadastradas em solicitações.
    • Tipo: Dropdown (Seleção única)
    • Validação: Deve exibir apenas rotas com solicitações cadastradas.
      As opções devem ser filtradas conforme o “Ano de Referência” informado.

  • Tipo de transporte:  Selecione o tipo de transporte.
    • Tipo: Dropdown (Seleção única)
    • Opções Disponíveis: "FRETE",  "FROTA",  "PASSE ESCOLAR",  "FRETE + FROTA + PASSE ESCOLAR"
  • Situação:  Selecione a situação que deseja filtrar.
    • Tipo: Dropdown (Seleção única)
    • Opções Disponíveis:  Aguardando aprovação, Aprovada, Rejeitada, Cancelada
      As opções devem ser filtradas conforme os campos “Ano de Referência” e “Rota”.

  • Escola/Instituição :  Selecione a escola da solicitação.
    • Tipo: Dropdown (Seleção única)
    • Validações : Exibe somente as escolas para as quais o usuário tem permissão.
      As opções devem ser filtradas conforme os campos “Ano de Referência”, “Rota” e “Situação”.

  • Classe: Selecione a classe da solicitação. 
    • Tipo: Dropdown (Seleção única)

    • Visibilidade: Exibido somente quando a escola selecionada for do tipo Municipal.

    • Dados: Lista todas as classes referentes à escola municipal selecionada.
      Filtrado pelos campos “Ano de Referência”, “Rota”, “Situação” e “Escola/Instituição”.

  • Serie/Ano: Selecione a serie/ano da solicitação 
    • Tipo: Dropdown (Seleção única)

    • Visibilidade: Exibido somente quando a escola selecionada não for municipal.

    • Dados: Lista todas as séries referentes à escola selecionada.

  • Curso: Selecione o curso da solicitação  
    • Tipo: Dropdown (Seleção única)

    • Visibilidade: Exibido somente quando a escola selecionada não for municipal.

    • Dados: Lista todos os cursos referentes à escola selecionada.

  • Turno: Selecione o turno da solicitação 
    • Tipo: Dropdown (Seleção única)

    • Dados: Lista todos os turnos disponíveis para o município de origem.

    • Opções Disponíveis: INTEGRAL, INTEGRAL TURNO I, INTEGRAL TURNO II, MANHÃ, NOTURNO, TARDE, VESPERTINO

  • NOME | RA | CPF: Selecione o Aluno/Passageiro.
    • Tipo: Dropdown (Seleção única)

    • Funcionamento Diferenciado:

      • Lista todos os alunos da escola ou classe selecionada, considerando apenas aqueles com solicitações já cadastradas.

        • Inicia a listagem apenas após a digitação de, no mínimo, 3 caracteres referentes a RA, CPF ou Nome.

      • São considerados o Nome Civil, Nome Afetivo e Nome Social.

      • Escola Municipal:

        • Lista todos os alunos da escola ou classe selecionada, considerando apenas aqueles com solicitações já cadastradas.

      • Escolas não Municipais:

        • Inicia a listagem apenas após a digitação de, no mínimo, 3 caracteres referentes a RA, CPF ou Nome.

  • Necessidades Especiais (Todos/Sim/Não): 
    • Tipo: Radio Group

    • Opções Disponíveis:

      • Todos: Considera todos os alunos.

      • Sim: Apenas alunos com necessidades especiais.

      • Não: Apenas alunos sem necessidades especiais.

Considerações Finais

  • Fluxo Condicional:
    A exibição e os dados dos campos dependem da sequência de preenchimento dos filtros. Alguns campos só são exibidos ou atualizados após a seleção de filtros anteriores, garantindo que as informações sejam contextualizadas conforme o cenário do usuário.

image.png

Botões de Ação:

Botões serão responsáveis por Cancelar e Imprimir Comprovante.

Nova Solicitação

  • Função: Redireciona o usuário para a tela de criação de uma nova solicitação de transporte.

  • Comportamento: Abre um formulário onde o usuário pode inserir os dados necessários para cadastrar uma nova solicitação.

Buscar

  • Função: Ao ser acionado, este botão executa a pesquisa com base nos filtros preenchidos na tela.

  • Comportamento: Valida os campos obrigatórios e apresenta os resultados na mesma tela ou em uma lista atualizada dinamicamente.


Tabela de Resultados

Esta tabela conterá 9 colunas sendo elas:

  • Ano de Referência: Contém o ano cadastrado no campo “Ano” na modal de “Nova Solicitação”.

  • Nº Sol: Este número é uma sequência gerada a cada ano de referência.

  • Tipo de Transporte: Este campo contém o último tipo de transporte cadastrado, seja na criação ou na aprovação da solicitação.

  • Nome: Exibirá o nome do aluno, considerando os casos em que o aluno utilize nome social ou afetivo.

    • Observação: Em casos em que o aluno possua alguma necessidade especial, será exibido o icone  image.pngjunto ao nome do aluno. 

  • RA | CPF: Exibirá os dados de CPF e RA, caso estejam disponíveis. Se algum deles estiver ausente, retornará apenas o dado presente no cadastro do aluno.

  • Escola: Exibirá o nome da escola em que a solicitação escolar foi cadastrada.

  • Situação: Exibirá o último status da solicitação, contendo também ícones referentes a cada status.

  • Distância: Exibirá a última “distância aferida” que foi cadastrada durante a criação ou aprovação da solicitação.

  • Ações: Esta coluna contém botões para algumas ações específicas; estas ações serão explicadas no próximo tópico.

  •  

    image.png

     


‘Ações’ da Tabela de Resultado.

Nesta tela, a tabela de resultado exibe 5 botões de ação. Cada ação é apresentada ou oculta de acordo com a situação atual da solicitação de transporte, garantindo que o usuário tenha acesso apenas às operações pertinentes. A seguir, detalhamos cada ação, suas condições de exibição e as funcionalidades associadas:

  1. Editar 

    • Condição de Exibição: Exibido somente quando a solicitação de transporte está na situação "Aguardando Aprovação".

    • Comportamento: Ao ser acionado, abre um modal onde o usuário pode realizar as ações de aprovar ou rejeitar a solicitação.

  2. Excluir

    • Condição de Exibição: Exibido somente quando a solicitação de transporte está na situação "Aguardando Aprovação".

    • Comportamento: Permite a exclusão da solicitação, liberando o fluxo para que uma nova solicitação seja cadastrada para o mesmo aluno.

  3. Visualizar

    • Condição de Exibição: Exibido quando a solicitação de transporte se encontra em qualquer uma das situações: "Aprovada", "Rejeitada" ou "Cancelada".

    • Comportamento: Abre um modal que exibe informações detalhadas da solicitação, como data de criação, dados da escola e outros detalhes relevantes.

  4. Cancelar

    • Condição de Exibição: Exibido apenas quando a solicitação de transporte está na situação "Aprovada".

    • Comportamento: Ao ser acionado, abre um modal que permite o cancelamento da solicitação, possibilitando o cadastro de uma nova solicitação para o mesmo aluno.

  5. Comprovante

    • Condição de Exibição: Este botão não deve ser exibido quando a solicitação de transporte estiver na situação "Rejeitada".

    • Comportamento: Permite a geração de um comprovante em PDF da solicitação, o qual contém as informações referentes à situação atual da solicitação.