Como Gerar CNH para Testes de Software (Guia Prático)

O número de registro da CNH é composto por 11 dígitos decimais. Diferente do RG, que varia por estado, a CNH tem um registro nacional centralizado no RENACH (Registro Nacional de Condutores Habilitados). Os 9 primeiros dígitos formam a base do número, e os 2 últimos são dígitos verificadores (DV) calculados através de um algoritmo específico de Módulo 11.

É importante notar que, em versões muito antigas da CNH, o número de registro podia ser menor, mas o padrão atual de 11 dígitos é o que deve ser seguido por qualquer sistema moderno. Ao gerar um número para teste, você precisa garantir que esses dois últimos dígitos correspondam ao resultado da conta matemática sobre os 9 primeiros, caso contrário, o seu sistema (se tiver validação) rejeitará o dado.

Para fins de teste de software, não precisamos nos preocupar com a existência real do condutor na base do governo, mas apenas com a "validade formal" do número. Isso permite que preenchamos formulários, testemos máscaras de input e validemos lógicas de banco de dados sem depender de conexões externas com APIs do governo, que costumam ser lentas ou pagas.

A Lei Geral de Proteção de Dados (LGPD) transformou a maneira como tratamos informações sensíveis. A CNH é um dado pessoal altamente identificável. Se um desenvolvedor usa a própria CNH ou a de um colega em um banco de dados de teste, e esse banco é acessado por terceiros ou fica exposto em um log, há uma quebra grave de privacidade.

Além da questão legal, o uso de geradores permite a criação de cenários de teste em escala. Você pode precisar testar como o sistema reage à inserção de 1.000 motoristas simultaneamente. Obter 1.000 CNHs reais seria impossível e antiético. Com um gerador, você cria essa massa de dados em milissegundos.

Outra vantagem é a diversidade. Um bom gerador permite simular CNHs com diferentes categorias (A, B, D, etc.) e datas de validade, ajudando a testar lógicas de negócio complexas, como sistemas que bloqueiam motoristas com CNH prestes a vencer ou que só aceitam motoristas com categoria D para certas rotas.

Embora existam ferramentas prontas, entender o algoritmo é útil para depuração. O cálculo envolve multiplicar cada um dos primeiros 9 dígitos por pesos decrescentes (de 9 a 1), somar os resultados e encontrar o resto da divisão por 11. Esse processo é repetido para o segundo dígito verificador, mas com uma lógica de ajuste caso o resultado seja 10 ou 11.

Na prática, fazer isso manualmente é tedioso e propenso a erros. Por isso, os desenvolvedores criam pequenas funções utilitárias em suas linguagens de preferência (JavaScript, Python, Java) que automatizam esse cálculo. No entanto, para um teste rápido de interface, a forma mais comum é usar um gerador online que já entrega o número pronto e formatado.

Ao usar nosso gerador online, você tem a opção de gerar o número limpo (apenas os 11 dígitos) ou formatado, se o seu sistema exigir alguma máscara específica. Basta um clique para ter um dado pronto para o seu ambiente de staging.

Um erro comum em sistemas de cadastro é não limpar a pontuação antes de salvar no banco de dados. Ao testar com CNHs geradas, experimente colar o número com espaços, hifens ou pontos. Um sistema robusto deve ser capaz de ignorar esses caracteres não numéricos ou alertar o usuário de forma clara.

Teste também os limites. O que acontece se você tentar digitar 12 dígitos? Ou se tentar digitar letras onde deveria haver apenas números? Usar um gerador garante que você tem o "caso de sucesso" garantido, permitindo que você foque nos "casos de falha" para tornar seu software mais resiliente a erros do usuário.

Valide também a persistência. Certifique-se de que o campo no banco de dados (geralmente um `VARCHAR(11)` ou `CHAR(11)`) está recebendo o valor completo e que o índice de busca está funcionando corretamente. Como a CNH é um número longo, o tipo de dado correto no banco impacta na performance de busca em grandes frotas.

Em sistemas de logística, a "validade formal" do número da CNH é apenas o começo. Você deve testar a lógica de negócio atrelada ao documento. Por exemplo: "O sistema permite que um motorista com CNH categoria B seja escalado para dirigir um caminhão?".

Para testar isso, gere uma lista de motoristas fictícios e atribua a eles diferentes categorias de CNH (A, B, C, D, E). Verifique se os filtros de pesquisa e as travas de segurança do seu software estão funcionando como esperado de acordo com a regra de trânsito brasileira.

Outro ponto crítico é a data de validade. Crie motoristas com CNHs vencidas e CNHs a vencer em 30 dias. Teste se os alertas de e-mail ou notificações push do seu aplicativo são disparados corretamente. Usar dados gerados com datas controladas é a única forma de garantir que esses fluxos automáticos funcionam antes de ir para produção.

Lembre-se: mesmo que o número da CNH seja fictício, se você associar esse número a um nome real de um funcionário em um ambiente de teste, você ainda pode estar criando riscos. A recomendação de ouro é usar "Double Mocking": gere um nome aleatório E um número de CNH aleatório.

Ferramentas que geram personas completas (Nome, CPF, CNH, Endereço) são ideais para popular bancos de dados de teste (Seeding). Isso cria um ambiente que se comporta exatamente como o real, mas sem qualquer dado sensível que precise de proteção extrema sob a LGPD.

Sempre apague os dados de teste após a conclusão das sprints de QA ou utilize bancos de dados efêmeros que são destruídos ao final de cada rodada de testes automatizados. Isso mantém sua infraestrutura limpa e segura contra vazamentos acidentais.