ISO/IEC 18004 Standartlarında Minimalist QR Kod Üretimi ve Optik Çözümleme Mimarisi Üzerine Kapsamlı Rehber (Bu yazı, QR Kod Tasarımcısı Skills tasarımının teknik ve işlevsel yapısını tanıtmakta olup; Skills Doküman Sayfası bağlantısı ile herkesin kendi sisteminde doğrudan indirip kullanabileceği SKILL.md dosyasını barındıran Google Drive klasör bilgilerini yazının sonunda sunmaktadır.)

Yazar: Aydın Tiryaki

Dijital dünyada fiziksel yüzeyler ile çevrimiçi veri akışları arasındaki en hızlı ve evrensel köprülerden biri olan QR (Quick Response) kodlar, günümüzde web adreslerinden Wi-Fi erişim noktalarına, dijital kartvizitlerden (vCard) coğrafi koordinatlara kadar sayısız alanda kullanılmaktadır. Ancak standart dışı görsel müdahaleler, gereksiz yere yüksek tutulan matris versiyonları veya sessiz bölge (Quiet Zone) ihlalleri, üretilen kodların optik okuyucular tarafından taranamaması gibi ciddi mühendislik sorunlarına yol açmaktadır. Aynı zamanda kullanıcıların karşılaştıkları bir QR kod görselinin arka planında hangi veriyi veya yönlendirme adresini barındırdığını güvenle çözümleyebilmesi de bir o kadar kritik bir ihtiyaçtır. İşte bu iki temel gereksinimi tek bir çatı altında, uluslararası standartlara tam sadakatle karşılamak üzere “QR Kod Tasarımcısı (Skills Edition)” geliştirilmiştir.

Çift Yönlü Çalışma Mimarisi ve Otomatik Niyet Algılama QR Kod Tasarımcısı, hem içerikten QR kod üreten bir matris tasarımcısı hem de yüklenen QR kod görsellerini çözümleyen bir optik analizör olarak çift yönlü bir mimariyle çalışır. Yeni bir etkileşim başladığında kullanıcı henüz bir veri veya görsel paylaşmamışsa sistem “✨Ne için QR kod hazırlansın?” sorusuyla açılır ve Görev 1 (İçerikten QR Kod Üret) ile Görev 2 (Görselden QR Kod Oku/Çözümle) seçeneklerini sunar. Buna karşılık Otomatik Niyet Algılama protokolü sayesinde kullanıcı doğrudan bir metin, web adresi (URL) veya veri girdiğinde soru sormaksızın Görev 1’i tetikler; doğrudan bir görsel yüklediğinde ise zaman kaybetmeden Görev 2’yi çalıştırarak görseli analiz eder.

Minimalist ve Saf QR Kod Tasarım İlkeleri (Görev 1) Üretim aşamasında sistem, “az çoktur” mühendislik felsefesini temel alan beş sıkı kural uygular:

1. Minimal Boyut İlkesi: İletilen metin veya web adresini barındırabilecek en küçük matris versiyonu (Version 1 olan 21×21 modülden başlayarak yalnızca veri uzunluğunun gerektirdiği en minimal versiyon) seçilir. Gereksiz yere karmaşık ve yoğun matrisler üretilmez; böylece kodun uzaktan ve düşük çözünürlüklü kameralarla bile anında okunabilmesi sağlanır.
2. Saf Görsel Çıktı ve Kare Oran: Üretilen her QR kod birebir (1:1) kare görsel (.jpg veya .png) formatında hazırlanarak doğrudan ekranda gösterilir.
3. Siyah-Beyaz Renk Kilidi: Kullanıcı açıkça farklı bir renk talep etmediği sürece maksimum kontrast ve taranabilirlik için modüller mutlak siyah (#000000), arka plan ise mutlak beyaz (#FFFFFF) olarak üretilir.
4. Orta Kısım (Merkez) Saflık Kilidi: Kullanıcı talep etmedikçe QR kodun merkezine hiçbir logo, ikon, harf veya görsel eklenmez. Kullanıcı merkeze bir öğe eklenmesini isterse sistem Reed-Solomon hata düzeltme seviyesini otomatik olarak Seviye H (%30) düzeyine çıkarır ve öğeyi okunabilirliği bozmayacak oranda yerleştirir.
5. Çevre ve Sessiz Bölge (Quiet Zone) Saflık Kilidi: Kullanıcı istemedikçe kodun çevresine, altına veya üstüne hiçbir yazı, başlık ya da çerçeve metni yazılmaz; yalnızca tarayıcıların kodu algılaması için zorunlu olan en az 4 modül genişliğindeki saf beyaz güvenlik çerçevesi (Quiet Zone) bırakılır.

Optik QR Kod Okuma ve Güvenlik Raporlaması (Görev 2) Sisteme herhangi bir QR kod görseli yüklendiğinde, Python görüntü işleme ve barkod okuma katmanları (cv2, pyzbar, PIL) devreye girerek kodun içindeki ham veriyi eksiksiz okur ve üç aşamalı bir Çözümleme Raporu sunar:

• İçerik Dökümü: QR kodun içerdiği tam metin veya veri eksiksiz listelenir. İçerik bir web adresi (URL) ise, kullanıcıların hedefi şeffafça görmesi ve doğrudan tıklayabilmesi için Markdown gizlemesi yapılmadan tam ve açık URL olarak sunulur.
• İçerik Türü: Verinin ait olduğu kategori (Web Adresi/URL, Düz Metin, Wi-Fi Bağlantı Bilgisi, vCard/Kartvizit, E-posta, Telefon, Coğrafi Koordinat vb.) tespit edilir.
• Teknik Yapı ve Güvenlik Kontrolü: Kodun tahmini versiyon/boyut yapısı, hata düzeltme durumu ve eğer içerik bir web adresiyse alan adı ile yönlendirme güvenliği değerlendirilir.

Gömülü ISO/IEC 18004 Mühendislik Bilgi Birikimi ve Python Kesinliği QR Kod Tasarımcısı, QR kod standartlarını öğrenmek için dış kaynak araması yapmaz; dahili bilgi bankasında yer alan ISO/IEC 18004 kurallarını doğrudan uygular. Version 1 (21×21 modül) ile Version 40 (177×177 modül) arasındaki tüm boyutları “Boyut = 17 + (4 * Versiyon)” formülüyle hesaplar. Üç köşedeki 7×7 Finder Patterns (Konum Belirleme Kalıpları), 1 modüllük Separators (Ayırıcılar), 6. satır ve sütundaki Timing Patterns (Zamanlama Çizgileri), Version 2 ve üzerindeki 5×5 Alignment Patterns (Hizalama Kalıpları) ile 4 modüllük Quiet Zone yapılarını eksiksiz korur. Reed-Solomon hata düzeltme seviyeleri (L: %7, M: %15, Q: %25, H: %30) ile Sayısal, Alfanümerik, Bayt/UTF-8 (Türkçe karakterler ve evrensel metinler için tam uyum) ve Kanji kodlama modlarını Python (qrcode ve PIL/Pillow) kütüphanelerinin matris kesinliğiyle birleştirerek piksel kayması veya sanatsal bozulma barındırmayan kusursuz çıktılar üretir.

Teknik Kimlik ve Sürüm Bilgileri Geliştirilen bu tasarımın güncel sürümü v01.01 olup, Gem Dağarcığı Numarası gdn084 ve yaşam döngüsü statüsü GemStat:0 (Taslak) olarak kayıtlıdır. Türkçe sürüm (qr-kod-tasarimcisi-atg) Başlık 18, Açıklama 997 ve Talimatlar 7254 karakter olmak üzere toplam 8269 karakterden; İngilizce sürüm (qr-code-designer-atg) ise Başlık 16, Açıklama 990 ve Talimatlar 7579 karakter olmak üzere toplam 8585 karakterden oluşmaktadır. Sistem ayrıca çift perspektifli Veri Doğrulama Protokolü, Kılavuz/Yardım komutuyla devreye giren Yaşayan Asistan (Özet, Detaylı, Dizin) ve dinamik son sürüm tetikleme özellikleriyle donatılmıştır.

📄Skills Doküman Sayfası: https://aydintiryaki.org/2026/06/19/gdn084/

Google Drive Klasör Bağlantısı ve SKILL.md Dosyası Aşağıdaki klasöre giderek bu klasörden SKILL.md dosyasını indirip doğrudan kullanabilirsiniz. Eğer bu klasöre veya dosyaya ulaşamıyorsanız, ilgili Skills’in geliştirme çalışmaları devam ettiğinden bağlantı geçici olarak askıya alınmış demektir; lütfen daha sonra tekrar deneyiniz.

📁 Google Drive Klasör Yolu (TR): (HENÜZ AKTİF DEĞİL) https://drive.google.com/drive/folders/1eWdNGf-L_H4VV4o9qQQbh7SiEp3IMEQy?usp=drive_link

Not: Buradan aldığınız SKILL.md dosyası üzerinde kendi geliştirmelerinizi ve düzenlemelerinizi yapabilirsiniz. Yalnız emeğe saygı açısından buradaki Skills yaratıcısını ve editörünü korumanızı (tutmanızı) rica ederiz.

Bu makalede tanıtılan QR Kod Tasarımcısı (Skills Edition) tasarımının mimarisi ve makaledeki tüm içerik, yaklaşım ve görüşler tamamen yazar Aydın Tiryaki’ye aittir; makalenin yazım editörlüğü ve yazım asistanlığı ise aktif yapay zeka modeli Gemini Pro (Extended düşünme düzeyi) tarafından gerçekleştirilmiş olup, bu yayın paketi ATG Gem Fabrikası (Skills Edition) v14.11 ve ATG Makale ve Doküman Atölyesi v01.15 standartlarıyla 30.10.2026 10:53 tarihinde üretilmiştir.

---

| aydintiryaki.org | YouTube | Aydın Tiryaki’nin Yazıları ve Videoları │Articles and Videos by Aydın Tiryaki | Bilgi Merkezi│Knowledge Hub  | ░ Virgülüne Dokunmadan │ Verbatim ░ | ░ QR Kod Tasarımcısı │QR Code Designer (Gemini Skills) ░ 30.10.2026