Tela de Pesquisa

Informações Gerais

Descrição: Essa tela tem como objetivo realizar a pesquisa de alunos que possuem passes cadastrados no sistema, permitindo ao usuário buscar e realizar a recarga de saldo do cartão, podendo realizar a filtragem pelos campos como: Ano de Referência, Tipo de Transporte, Número da Solicitação, entre outros que serão demonstrados nessa documentação.

URL: Tela de Pesquisa - Gerar Recarga do Cartão

Caminho para a tela: Transporte > Passe > Gerar Recarga Cartão

Seção de Informação da última atualização

• Tipo: Modal
• Validação:
  • Deverá ter a data e hora refletida de acordo com a última importação de arquivos realizada;
  • Poderá ser oculta ao clique do ícone "X"
  • Campo deverá estar visível sempre que acessar a página pela primeira vez;  
• Fonte de Dados: Link API;

Filtros

• Dependência Administrativa
  • Tipo: Dropdown;
  • Validações: Opcional, Seleção única;
  • Regra:
    • Ocultará campo : Série | Ano, se a Dependência selecionada for Municipal.
      
    • Ocultará campo : Classe  se a dependência selecionada for Estadual ou Filantrópica. e ficará visível os campos: Curso e Série | Ano;
    • Ocultará campos : Classe, Curso, Turno e Série | Ano,  se a dependência selecionada for Federal, Fundação Municipal, Municipalizada, Privada ou Privada/Comunitária.
  • Fonte de Dados: Link API (tipo="DEPENDENCIA_ADM");
    
  • Fonte da Regra: FIX/EMI-1181;
• Escola | Instituição
  • Tipo: Dropdown;
  • Validações: Opcional, Seleção única; 
  • Regras: 
    • Escolas podem ser filtradas de acordo com a Dependência Administrativa selecionada.
    •  Na chamada da rota, há dois parâmetros fixos no front-end;
      • • tipo_transporte: statusTipoTransporte.PASSE, que irá filtrar por escolas que tenham vínculos com solicitações de transprorte escolares do tipo PASSE
        • situacao: statusSolicitacaoTransporte.APROVADO, que irá filtrar por escolas que tenham vínculos com solicitações de transporte escolares que estejam com a situação APROVADA 
  • Fonte de Dados: Link API;
    
• Classe
  • Tipo: Dropdown;
  • Validações: Opcional, Seleção única;
  • Fonte da Dados: Link API;
• Curso
  • Tipo: Dropdown;
  • Validações: Opcional, Seleção única;
  • Regras: Será visível ao selecionar um escola do tipo "Estadual ou Filantrópica"
  • Fonte da Dados: Link API;
• Série | Ano
  
  • Tipo: Dropdown;
  • Validações: Opcional, Seleção única;
  • Regras: Será visível ao selecionar um escola do tipo "Estadual ou Filantrópica"
  • Fonte da Dados: Link API;
• Turno
  • Tipo: Dropdown;
  • Validações:  Opcional, Seleção única,
  • Fonte de Dados: Link API;
• Nome | RA | CPF
  
  • Tipo: Dropdown;
  • Validações: Opcional, Múltiplas seleções;
  • Regras: 
  • A chamada na rota será feita, ao digitar o terceiro dígito no campo;
  •  Na chamada da rota, há dois parâmetros fixos no frontend;
    • • tipo_transporte: statusTipoTransporte.PASSE, que irá filtrar por alunos que tenham vínculos com solicitações de transporte escolares do tipo PASSE;
      • situacao: statusSolicitacaoTransporte.APROVADO, que irá filtrar por alunos que tenham vínculos com solicitações de transporte escolares que estejam com a situação APROVADA;
      • O resultado listado deverá conter, Nome do aluno + RA | CPF, Haverá casos em que o aluno não possua CPF ou RA registrado, mas obrigatoriamente haverá de ter ao menos um.
  • Fonte de Dados: Link API;
• Matrícula de Transporte
  
  • Tipo: Numérico;
  • Validações: Opcional, Mín.: 3 caracteres, Máx.: 6 caracteres, aceita somente números;
  • Fonte das Regras: FIX/EMI-1179;
    
• Número do Cartão
  • Tipo: Numérico;
  • Validações: Opcional, aceita exatamente 17 caracteres;
• Necessidades Especiais?
  • Tipo: Radio Button;
  • Validações: Opcional, Seleção única;
  • Regras: Deverá iniciar com o valor padrão de "Todos";
    

Seção Parâmetros de Geração do Arquivo

Campo de texto: 'Escolha o formato para exportar os dados filtrados' 

• Opções de Formato de Exportação
  • Tipo: Radio Button;
  • Validações: Obrigatório, Seleção única;
  • Regras: Deverá iniciar com o valor padrão de "CSV"

Seção Informações para Recarga

• Dias Letivos
  • Tipo: Numérico;
  • Validações: Obrigatório, Máx.: 3 caracteres numéricos;
• Valor da Tarifa
  • Tipo: Numérico Decimal;
  • Validações: Obrigatório, Máx. 5 caracteres numéricos, Ex: R$ 111,11, deverá exibir no formato monetário, BRL, 
• Total
  • Tipo: Numérico Decimal;
  • Validações: Obrigatório, Permanentemente bloqueado;
  • Regras: Preenchido automaticamente ao realizar no código frontend um calculo, de multiplicação entre o valor do campo "Dias Letivos" e "Valor da Tarifa", 

Botões

• Botão "Buscar" com ícone de lupa no canto esquerdo;
  • Rota de Busca: Link API;
    
• Botão "Gerar Recarga" com ícone de seta circular sentido anti-horário no canto esquerdo
  • Regras:
    
    • Botão desabilitado, será habilitado ao selecionar um resultado da tabela, clicando no checkbox
    • Ao selecionar um ou mais resultados da tabela, e clicar no botão, irá exibir uma modal de confirmação.
    • Ao confirmar irá exibir outro modal de espera, enquanto é gerado o arquivo.
    • Após a geração da recarga, irá realizar o download do arquivo no formato selecionado previamente (CVS ou TXT)
  • Fonte de Dados: Link API;
    
    

    Imagem das modais:
    

    Modal de Confirmação

    
    
    

    Modal de Loading / Carregamento

 Modal de Confirmação da Geração

Resultado da Tabela

• Checkbox
  • Tipo: Button;
• Ano
  • Tipo: Numérico;;
• Matrícula de Transporte
  • Tipo: Texto;
• Número do Cartão
  • Tipo: Texto;
• Nome 
  • Tipo: Texto;
• Escola | Instituição 
  • Tipo: Texto;
• Data Última Recarga 
  • Tipo: Texto;
  • Formatação: 01/01/2025
• Valor da Última Recarga
  • Tipo: Texto;
  • Formatação: R$999.99
• Saldo Atual 
  • Tipo: Texto; 
    
  • Formatação: R$999.99
• Saldo a Recarregar 
  •  Tipo: Texto;
  • Formatação: R$999.99

Imagens da Tela