Shennext QR

01 / CONTEXT

Proje neydi?

Shennext QR, tekstil fuarlarında ziyaretçi, firma, koleksiyon ve kartela süreçlerini tek bir merkezden yönetmek için geliştirdiğim özel bir web uygulamasıdır.

Fuar operasyonunda birbirine bağlı çok sayıda kayıt ve tekrar eden işlem vardı. Amaç, bu ilişkileri tek bir yönetim sistemi altında toplamak ve büyüdükçe zorlaşan operasyonları güvenilir biçimde otomatikleştirmekti.

02 / PROBLEM

Operasyon büyüdükçe manuel takip yetersiz kalıyordu.

Ziyaretçi ve kartela ilişkilerini ayrı adımlarla takip etmek hem zaman kaybettiriyor hem de toplu işlemlerde hata riskini artırıyordu.

• Toplu kartela işlemleri zorlaşıyordu.
• QR hazırlama süreci kayıt sayısı arttıkça yönetilemez hale geliyordu.
• Ziyaretçi seçimleri ile kartelalar arasındaki ilişkiyi izlemek güçleşiyordu.
• Hatalı ve tekrar eden kayıtları ayırmak manuel kontrol gerektiriyordu.

03 / APPROACH

Problemi veri iş akışlarına ayırdım.

Tek bir büyük özellik yerine; veri girişi, doğrulama, ilişki yönetimi, QR üretimi ve çıktı alma adımlarını birbirinden ayrılabilen süreçler olarak ele aldım.

04 / SYSTEM

Oluşturulan temel sistem

Uygulama; ziyaretçi yönetimini, firma / koleksiyon / kartela ilişkilerini, kartela seçimini ve ziyaretçi seçimlerini merkezi hale getirdi. Aktif ve pasif kartelalar aynı yönetim panelinden kontrol edilebilirken QR çıktıları da ilgili kayıtlarla birlikte üretilebilir hale geldi.

05 / DATA FLOW

Toplu veri, kontrollü bir üretim akışına dönüştü.

XLSX ve CSV dosyaları doğrudan sonuca dönüşmüyor; önce doğrulanıyor, ayrıştırılıyor ve raporlanıyordu.

• kartela_adi zorunlu alan olarak kontrol edildi.
• durum boş olduğunda kayıt aktif kabul edildi.
• Hatalı ve tekrar eden satırlar ayrıştırılarak raporlandı.
• Geçerli kayıtlar işleme alınırken sorunlu satırlar görünür kaldı.

06 / QR ENGINE

Tekil ve toplu QR çıktıları aynı yapıdan üretildi.

Aktif kartelalar için tekil QR üretimi ile PNG ve SVG indirme seçenekleri geliştirildi. Toplu ihtiyaçlarda çıktılar ZIP paketi halinde hazırlanabildi.

Sistem küçük veri setlerinin yanında yüzlerce karteladan oluşan toplu işlemlerle de test edildi. ZIP çıktısının 0 KB oluşmasına neden olan üretim problemi tespit edilerek giderildi.

07 / TECHNICAL CHALLENGES

Üretim problemlerini sistemi durdurmadan izole ettim.

Geliştirme yalnızca yeni özellik eklemekten ibaret değildi. Mevcut akışı etkileyen hatalar, nedenleri bulunarak ayrı ayrı düzeltildi.

• Route ve controller parametre uyuşmazlıkları giderildi.
• Eksik controller metotları tamamlandı ve API tarafındaki 500 hataları çözüldü.
• PDO sorgularında tekrar kullanılan :search parametresinin yol açtığı hata izole edildi.
• Toplu ZIP üretimindeki bozuk ve boş çıktı senaryosu düzeltildi.

08 / UX IMPROVEMENTS

Yönetim paneli operasyonun gerçek ihtiyaçlarına göre sadeleştirildi.

09 / OUTCOME

Dağınık operasyonlar tek bir uygulamada birleşti.

Toplu veri aktarımı ve QR üretimi sayesinde manuel işlemler azaltılırken, ziyaretçi ve kartela ilişkileri merkezi olarak yönetilebilir hale geldi.

Sonuç yalnızca daha fazla özellik sunan bir panel değil; hatalı veriyi görünür kılan, toplu işlemleri güvenli biçimde tamamlayan ve gerçek fuar operasyonuna uyum sağlayan bir çalışma sistemi oldu.

10 / WHAT I LEARNED

Küçük görünen operasyonel adımlar, ölçek büyüdüğünde ürünün merkezine yerleşiyor.

Bu proje, sağlam veri doğrulama, toplu işlem güvenliği ve hata senaryolarının arayüz kadar ürünün kendisinin de önemli bir parçası olduğunu yeniden gösterdi.

Teknik yaklaşımım; ideal akışı kurmanın yanında eksik, tekrar eden veya beklenmeyen veride sistemin nasıl davranacağını da tasarlamak oldu. Böylece özellikler yalnızca çalışmakla kalmadı, gerçek operasyon koşullarında yönetilebilir kaldı.