Proje Nedir?
tcknvkn.com; yazılım geliştiriciler, test mühendisleri ve QA ekipleri için TC Kimlik Numarası (TCKN) ve Vergi Kimlik Numarası (VKN) algoritma/format doğrulaması yapan ve test ortamlarında kullanılmak üzere geçerli formatlı rastgele test verisi üreten ücretsiz bir mühendislik projesidir.
Tüm işlemler tarayıcınızda gerçekleşir; girdiğiniz veya ürettiğiniz numaralar hiçbir sunucuya gönderilmez, saklanmaz ve hiçbir resmi sistemde (MERNİS, NVİ, GİB) sorgulanmaz. Araçların kaynak kodu ve algoritmaların birebir implementasyonları açık kaynaktır.
Neden Geliştirildi?
Yazılım projelerinde kimlik/vergi numarası alanlarını test etmek için gerçek kişilere ait verilerin kullanılması hem KVKK açısından risklidir hem de etik değildir. Bu proje, geliştiricilerin gerçek veri kullanmadan — yalnızca algoritma kurallarına uygun, rastgele üretilmiş numaralarla — test yapabilmesi için doğdu.
Aynı ihtiyacın her programlama dilinde tekrar tekrar çözülmesini önlemek için doğrulama ve üretim algoritmaları 19 programlama dilinde açık kaynak kütüphane olarak yayımlanmaktadır.
İçerik Nasıl Hazırlanıyor?
Sitedeki algoritma anlatımları ve kod örnekleri yeniden yazılmaz; 19 dilde yayımlanan açık kaynak kütüphanelerin gerçek implementasyonlarından türetilir. Tüm kütüphaneler tek bir doğrulama spesifikasyonuna ve ortak bir test veri setine (golden dataset) karşı test edilir — yani sayfada okuduğunuz kural ile paketin çalıştırdığı kod aynı kaynaktan gelir.
Yayımlanan her sayfa, otomatik bir kalite denetiminden geçer: kanonik adres tutarlılığı, yapısal veri geçerliliği, iç bağlantı erişilebilirliği ve örnek numaraların doğrulayıcıdan geçtiği makine tarafından kontrol edilir. Doğrulama algoritmaları ayrıca regresyon testleriyle bağımsız bir referans implementasyona karşı karşılaştırılır.
Açık Kaynak Ekosistemi
Sitede kullanılan doğrulama ve üretim algoritmalarının tamamı, tcknvkn GitHub organizasyonu altında açık kaynak olarak yayımlanmaktadır:
- 19 programlama dili: JavaScript/TypeScript, Python, C#, Java, Kotlin, Go, Rust, PHP, Ruby, Swift, Dart, C, C++, R, Crystal, SQL ve framework paketleri (React, Angular, jQuery)
- Paket yöneticileri: npm (
@tcknvkn), PyPI (tcknvkn), NuGet (TcknVkn) ve diğerleri - Ortak test seti: Tüm kütüphaneler aynı doğrulama spesifikasyonuna ve golden dataset'e karşı test edilir
Detaylar ve kurulum komutları için Kütüphaneler sayfasına bakabilirsiniz.
Etik İlkeler ve Sorumlu Kullanım
- Gerçek veri yok: Site hiçbir resmi kaynaktan (MERNİS, NVİ, GİB) veri sorgulamaz, çekmez veya barındırmaz. Üretilen bir numaranın gerçek hayatta bir karşılığı olup olmadığı bilinemez.
- Veri saklanmaz: Doğrulama ve üretim tamamen tarayıcıda çalışır; girilen numaralar sunucuya iletilmez.
- Kötüye kullanım yasaktır: Üretilen numaraların kimlik taklidi, dolandırıcılık veya gerçek sistemlerde sahtecilik amacıyla kullanılması yasa dışıdır ve kullanım şartlarımıza aykırıdır.
- Şeffaflık: Algoritmaların nasıl çalıştığı Nasıl Çalışır? sayfasında ve açık kaynak kodda denetlenebilir durumdadır.
İletişim
Soru, öneri ve hata bildirimleri için:
- E-posta: [email protected]
- Hata bildirimi: GitHub Issues
- X (Twitter): @tcknvkn
Bir Bakışta
- Yayın: Şubat 2026
- 19 dilde açık kaynak kütüphane
- Veri saklamaz, tarayıcıda çalışır
- Tamamen ücretsiz