Olá, dev!
⚠️ Este é um projeto para fins de estudo sobre algoritmos de validação de pagamentos comuns no Brasil. O foco é a implementação e demonstração didática de checksums e protocolos de mercado (EMV, Febraban, Luhn).
O PayCheckBR é uma aplicação focada na transparência e validação técnica. O projeto segue princípios de Staff-level Engineering, priorizando a simplicidade, resiliência e a prática de Narrative Coding.
O projeto foi organizado para manter a raiz limpa e as preocupações separadas:
/src: Código-fonte da aplicação (HTML, JS, CSS)./tests: Suítes de testes unitários automatizados (22 testes)./docs: Documentação técnica, especificações e histórico de mudanças.
- ES Modules (ESM): Modularização nativa.
- Vitest: Garantia de precisão dos algoritmos (Luhn, Mod10, Mod11, CRC16).
- GitHub Actions: Automação total de testes em cada push/PR.
- ESLint: Padronização e qualidade de código.
Explore a anatomia de cada meio de pagamento:
🛠️ Informações de Apoio & Ferramentas Externas
- Manual de Padrões para Iniciação do Pix (BACEN)
- Validador de Testes (QR Decoder)
- Gerador de Pix para Testes
- Guia Detalhado: Validação de Cartões
- Gerador de Dados de Cartão (4Devs)
- Validador de Número de Cartão (4Devs)
- Gerador de Imagem de Cartão Fictício
⚠️ Fator de Vencimento (Reset 2025): Em 22/02/2025, o fator de vencimento dos boletos foi reiniciado em 1000, após atingir o limite de 9999. Este validador já suporta o novo ciclo utilizando uma lógica de janela deslizante para identificar a data correta.
Acompanhe a evolução do projeto no CHANGELOG.MD.
- Todo o sistema de design e skills de UX foram acelerados pela tecnologia typeui.sh.
Fique à vontade para explorar e contribuir! 🚀 Caso encontre algum erro ou tenha sugestões, abra uma Issue ou envie um Pull Request.