Skip to content

surieltech/gerador-de-cpf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

🧾 Gerador e Validador de CPF

Aplicação web educacional que demonstra o funcionamento do algoritmo dos dígitos verificadores do CPF, permitindo gerar e validar números com base no cálculo matemático oficial.

🔗 Deploy: https://surieltech.github.io/gerador-de-cpf/


🚀 Sobre o Projeto

O Gerador e Validador de CPF é uma aplicação frontend que demonstra de forma interativa como os dígitos verificadores do CPF são calculados matematicamente.

O projeto foi desenvolvido com foco em:

  • ✔️ Interface moderna e escura
  • ✔️ Explicação didática do algoritmo
  • ✔️ Feedback visual em tempo real
  • ✔️ Acessibilidade e atalhos de teclado
  • ✔️ Design responsivo

✨ Funcionalidades

  • 🔢 Gerar CPF - Cria números aleatórios válidos matematicamente
  • Validar CPF - Verifica se um CPF informado é válido
  • 📋 Copiar CPF - Botão com feedback visual
  • 🎨 Formatação opcional - Ative/desative a máscara do CPF
  • 📚 Tutorial interativo - 3 passos explicando o algoritmo
  • 🖱️ Feedback em tempo real - Dicas durante a digitação
  • Atalhos de teclado - Navegação otimizada
  • 📱 Responsividade - Funciona em qualquer dispositivo

🧠 Como Funciona o Algoritmo

1º Dígito Verificador

  • Multiplica-se cada um dos 9 primeiros dígitos por pesos de 10 a 2
  • Soma-se os resultados e divide-se por 11
  • Se o resto for 0 ou 1 → dígito = 0; senão → dígito = 11 - resto

2º Dígito Verificador

  • Repete o processo com os 10 dígitos (9 originais + 1º dígito)
  • Pesos de 11 a 2

🛠️ Tecnologias Utilizadas

  • HTML5 - Estrutura semântica
  • CSS3 - Estilização com variáveis CSS e animações
  • JavaScript (ES6+) - Lógica de geração e validação
  • Toastify.js - Notificações elegantes
  • Font Awesome - Ícones vetoriais

🔧 Principais Funções

Função // Descrição

  • generateCPF() // Gera um novo CPF válido
  • validateInputCPF() // Valida o CPF digitado pelo usuário
  • calculateDigit() // Calcula dígitos verificadores
  • formatCPF() // Aplica máscara ao CPF
  • copyCPF() // Copia CPF para área de transferência

📱 Responsividade

Dispositivo Suporte
💻 Desktop ✅ Completo
📟 Tablet ✅ Adaptado
📱 Mobile ✅ Otimizado

⚠️ Aviso Legal

Finalidade Educacional - Este projeto tem exclusivamente fins educacionais. Os CPFs gerados são válidos apenas matematicamente e não correspondem a documentos reais.


🚀 Como Executar

# Clone o repositório
git clone https://github.com/surieltech/gerador-de-pdf.git

# Acesse a pasta do projeto
cd gerador-de-pdf

📄 Licença

Projeto de uso livre para fins educacionais.

About

Gerador e validador de CPF com explicação didática do algoritmo dos dígitos verificadores.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors