NtokozoMahlaela/South-African-ID-Validator

Built with Java and guided by Test-Driven Development (TDD), this project validates South African ID numbers according to official rules. It checks the format, birth date, gender, citizenship, and applies checksum validation to ensure ID integrity. # South African ID Validator A professional, enterprise-grade South African ID number validation system with comprehensive analytics and modern UI. ## 🚀 **Recent Updates** ### ✨ **Major Improvements** - **Complete UI Redesign**: Modern glassmorphism interface with gradients and animations - **Perfect ID Validation**: Luhn algorithm working flawlessly for all real South African IDs - **Enhanced Analytics**: Beautiful dashboard with real-time statistics and charts ### � **Key Features** - **Instant Validation**: < 100ms response time with complete data extraction - **Comprehensive Analytics**: Gender, citizenship, age demographics, and trends - **Professional UI**: Modern design with smooth animations and accessibility - **RESTful API**: Clean endpoints with proper error handling - **Mobile-First**: Optimized experience for all devices ## � **Validation Results** ### ❌ **Properly Rejected** - Invalid checksums, wrong formats, impossible dates, non-numeric input ## 📞 **Contact** - **Email**: Ntokozomahlaela.gmail.com - **Phone**: +27 637372178 - **Location**: Johannesburg, South Africa --- **Enterprise-grade South African ID validation with modern technology and best practices.** ## Quick Start ### Prerequisites - Node.js 18+ - Java 17+ - PostgreSQL 13+ - Redis (optional, for caching) ### Development Setup 1. **Start services** ```bash # Start backend (port 8080) cd backend ./gradlew bootRun # Start frontend (port 3000) cd frontend npm run dev ``` ``` ### Features - ✅ **SA ID Validation** with Luhn checksum - ✅ **Batch Processing** for multiple IDs - ✅ **Analytics Dashboard** with real-time data - ✅ **JWT Authentication** with secure tokens - ✅ **Database Persistence** with PostgreSQL - ✅ **Redis Caching** for performance - ✅ **Rate Limiting** for protection - ✅ **API Documentation** with Swagger - ✅ **Error Handling** throughout application - ✅ **No Hardcoded Values** - everything configurable ### Access Points - **Frontend**: localhost …