i-educar icon indicating copy to clipboard operation
i-educar copied to clipboard

Fix/cep validation message 1060

Open MuriloM676 opened this issue 1 month ago • 1 comments

DESCRIÇÃO:

Este PR resolve o issue #1060 que identificou a ausência de mensagens de validação ao inserir CEPs inválidos ou inexistentes no formulário de cadastro de pessoa física.

Problema identificado:

  • O sistema aceitava CEPs obviamente inválidos (00000-000, 99999-999, sequências repetidas)
  • Não exibia mensagem quando o CEP não era encontrado na API
  • Usuário não recebia feedback sobre problemas com o CEP digitado
  • Possibilidade de cadastrar pessoas com endereços inconsistentes

Solução implementada:

Foram adicionadas validações e mensagens de erro no arquivo Addresses.js:

  1. Validação de formato: Verifica se o CEP está no formato correto (00000-000) antes de buscar
  2. Validação de CEPs inválidos: Detecta padrões inválidos como 00000-000, 99999-999 e sequências repetidas (11111-111, etc)
  3. Tratamento de erro 404: Exibe mensagem clara quando o CEP não é encontrado na base de dados
  4. Mensagens descritivas: Todas as mensagens orientam o usuário sobre o problema e como resolvê-lo
  5. Limpeza automática: Remove mensagens de erro quando o usuário corrige o campo

Mensagens adicionadas:

  • "CEP inválido. Por favor, verifique o número digitado." (para padrões inválidos)
  • "CEP não encontrado. Verifique se o número está correto ou preencha o endereço manualmente." (para erro 404)
  • "Erro ao buscar CEP. Tente novamente ou preencha o endereço manualmente." (para outros erros)
  • "Formato de CEP inválido. Use o formato: 00000-000" (para formato incorreto)

Arquivo modificado:

  • public/vendor/legacy/Cadastro/Assets/Javascripts/Addresses.js

Fixes #1060


AMBIENTE:

  • Plataforma utilizada: Docker
  • Sistema operacional: Linux (Ubuntu/Debian)
  • Navegador: Chrome 141.0.7390.66
  • Tecnologias: JavaScript (jQuery), API REST

MuriloM676 avatar Nov 17 '25 20:11 MuriloM676