Müşteri İtirazında Ürün Bazlı Video Kanıtı: QR Kod ve Barkodla Hızlı Sorgulama için Teknik Rehber

Giriş: Hedeflenen tek problem — Müşteri İtirazında Hızlı ve Güvenilir Video Kanıtı

Bu yazıda tek odak noktamız var: sahada bir müşteri şikâyeti geldiğinde, elinizdeki ürünün üretim anına ait kalite kontrol videosunu QR kod, barkod veya seri numarası kullanarak nasıl hızlıca sorgulayacağınız, doğrulayacağınız ve gerekirse dışarı aktaracağınız. Çözüm hem operasyonel (kamera tetikleme, veri toplama) hem de yazılımsal (indeksleme, sorgu API'si, doğrulama) adımları içerir. Uygulama örnekleri üretim hatlarında gerçekçi senaryolara dayanmaktadır ve doğrudan uygulanabilir teknik detay sağlar.

Ön gereksinimler: Donanım ve temel mimari

İyi çalışan bir ürün bazlı video takip çözümü için şu yapı taşlarına ihtiyacınız var:

• Ürün üzerinde okunabilir barkod/QR/seri numarası (etiket veya lazer gravür).
• Kalite kontrol istasyonlarında endüstriyel kamera(lar) (ör. 2–8 MP, 30–60 fps, global shutter tercihi) ve uygun aydınlatma.
• Okuyucu tetikleyici: barkod okuyucu veya PLC/NPN tetik sinyali ile video segmentleme.
• Edge cihaz/PC ile anlık metadata ilişkilendirmesi (kamera ID, timestamp, barcode/serial, operasyon adımı ID).
• Video depolama: sıcak katman (kısa süreli hızlı erişim) ve soğuk katman (uzun dönem arşiv).
• SQL Server veya benzeri bir ilintili veri tabanı, ayrıca indeksleme için bir arama servisi (Elasticsearch/SQL full-text).
• ASP.NET Core tabanlı API katmanı ve yönetim paneli.

İlk adım: Ürün ile video arasındaki güvenilir bağ nasıl kurulur?

Temel kural: her video segmenti mutlaka ürünün benzersiz kimliği (barcode/QR/seri) ile ilişkilendirilmeli. Bunu sağlamak için iki yaygın yaklaşım vardır:

• Trigger-based capture: Barkod okutulduğunda kamera veya edge cihaz bir zaman penceresi başlatır (ör. -2s / +5s) ve bu aralığı bir video segmenti olarak kaydeder. Okuma anı ve barkod değeri segment metadata'sına yazılır.
• Continuous capture with indexing: Kamera sürekli kaydeder; barcode okuma anı bir event olarak kaydedilir ve bu event timestamp'i kullanılarak ilgili video dosyasından doğru segment kesilir ve indekslenir.

Her iki yaklaşımın da avantajları var. Tetiklemeli yöntem bant genişliği ve depolamada tasarruf sağlar; sürekli yakalama ise tetikleyicinin arızalandığı durumlarda eksiksiz kayıt sunar. Fabrika ortamına göre hibrit yaklaşım tercih edilebilir.

Zaman damgası tutarlılığı: Neden kritik ve nasıl sağlanır?

Birden çok kamera, PLC ve barkod okuyucu olduğunda zaman uyumsuzluğu yanlış segment ilişkilerine yol açar. Aşağıdaki uygulamalar gereklidir:

• Her cihaz için NTP veya PTP ile zaman senkronizasyonu. Hassasiyet ihtiyacı: eğer segment penceresi dar (<100 ms), PTP (IEEE 1588) tercih edilebilir.
• Edge cihazlar timestamp'leri UTC olarak yazsın; veritabanında tek bir zaman ekseni kullanın.
• Video dosyalarına hem dosya sistem level'da hem de container level'da (ör. MP4 moov metadata) zaman bilgisi gömün.

Metadata tasarımı: Video segmenti için minimum alanlar

Bir video segmentinin doğrulanabilir ve sorgulanabilir olması için metadata şu alanları içermelidir:

• segment_id (GUID)
• ürün_id (barkod/QR/seri)
• kamera_id
• başlangıç_timestamp, bitiş_timestamp (UTC)
• tetikleyen_event_id (ör. barcode_scan_id veya plc_event_id)
• hash (örn. SHA-256) — segmentin değişmediğini doğrulamak için
• operasyon_adımı (montaj, test, vizyon_kontrol vb.)
• dosya_path veya object_storage_uri

Bu metadata SQL Server'da bir tabloya yazılır; ağır sorgular için Elasticsearch benzeri bir arama dizini oluşturulabilir.

Depolama stratejileri: sıcak/soğuk katman ve retention

Video verileri büyük yer kaplar. Önerilen strateji:

• Hızlı geri çağırma için son X günün segmentlerini yerel NAS veya hızlı object storage'da tutun (sıcak katman).
• Daha eski verileri maliyet etkin bulut arşivine taşıyın (soğuk katman) ama indeks metadata'sını veri tabanında tutun.
• Retention politikalarını mevzuata ve müşteri SLA'sına göre belirleyin; silme işlemlerini audit log ile izleyin.

API ve sorgu akışı (ASP.NET Core için uygulanabilir öneri)

Temel kullanıcı senaryosu: müşteri isim/seri/şikâyet bilgisi ile geldiğinde operatör ilgili ürünün video kanıtını bulmalı. Örnek akış:

1. Frontend'den sorgu: /api/videos/query?serial=XYZ123&from=2026-01-01T00:00:00Z&to=2026-01-02T00:00:00Z
2. API (ASP.NET Core) önce SQL Server'da metadata tablosunu sorgular; eğer çok sayıda sonuçsa Elasticsearch'e yönlendirir.
3. Eşleşen segmentlerin listesi döner; her sonuçta play URI, başlangıç/bitis, kamera ve hash bulunur.
4. Operatör bir segment seçer; sistem object storage'dan M3U8/stream URL döndürür veya segment dosyasını signed URL ile indirime açar.
5. Export talebi varsa API, segment hash ve metadata ile birlikte ZIP/MP4 paket oluşturur; erişim ve indirme loglanır.

Pratik ASP.NET Core önerileri:

• Kayıt ve sorgu için Entity Framework yerine Dapper veya raw SQL kullanın; metadata sorguları yüksek frekansta optimize edilmelidir.
• Signed URL ve role-based erişim için JWT + claim tabanlı yetkilendirme uygulayın.
• Video akışı için CDN veya edge caching kullanın; doğrudan sunucudan stream yerine presigned URL'lerle object storage servisini kullanın.

Doğrulama ve itiraz anında kanıtın güvenliği

Müşteri itirazında sadece videoyu göstermek yetmez; video bütünlüğünü kanıtlamanız gerekir:

• Her segmentin SHA-256 hash'ini kaydedin ve güvenli bir logta (append-only) saklayın.
• Hash'leri zaman damgalı bir logda (ör. write-once database veya blokzincir benzeri dış kayıt) saklamak bütçeye göre değerlendirilebilir.
• İndirilen paketlerde metadata, hash ve sistem logları (kim erişti, ne zaman) bulunmalı.

Pratik problemler ve çözüm önerileri

• Barkod okunamıyor: fallback olarak görüntüden OCR/vision ile seri tanıma (eğer gravür varsa) veya iş parçasına atanan üretim sıra numarası ile ilişkilendirme yapın.
• Zaman tutarsızlığı: olayları korele etmek için toleranslı eşleştirme (ör. ±200 ms) uygulayın ve sistem sağlığını dashboard ile izleyin.
• Depolama maliyeti yüksek: görüntüleri H.264/H.265 ile sıkıştırın, segment penceresini daraltın ve sadece gerekli çözünürlük ve FPS'yi kaydedin.
• Arama yavaş: metadata için uygun indeksler oluşturun; sık kullanılan sorgular için önbellekleme katmanı ekleyin.

Edge entegrasyonu: PLC, barkod okuyucu ve IoT mesajları

Pratik olarak üretim hattında tetikleyicilerin güvenilir olması gerekir:

• Barcode scanner / vision system bir event yayınladığında (MQTT/HTTP/Kafka), edge cihaz anlık olarak segment metadata'sını oluşturmalı.
• PLC ile entegrasyon gerekiyorsa, PLC event id'lerini metadata'ya ekleyin; böylece üretim adımı seviyesinde korelasyon sağlanır.
• Edge cihazlar ağ kesintisine karşı ring buffer (local disk) tutmalı; bağlantı geri geldiğinde metadata ve segmentler upload edilmeli.

Kullanıcı arayüzü ve yönetim paneli için öneriler

Operatörün hızlı çalışabilmesi için yönetim panelinde olması gerekenler:

• Seri/barkod ile doğrudan arama alanı ve zaman filtresi.
• Arama sonuçlarında küçük önizleme görüntüleri (thumbnail) ve başlangıç/bitis zamanları.
• Hash, kamera ID, operasyon adımı gibi doğrulama bilgilerini görünür kılın.
• Export ve log kaydı butonlarıyla denetim izini otomatik oluşturun.

Çözüm tasarımına dair daha detaylı entegrasyon örnekleri ve Kalite Kontrol & IoT entegrasyonu uygulama modelleri için mevcut yönlendirmelerle birlikte kurum içi gereksinimlerinizi karşılayacak mimariler kurulabilir.

Sonuç ve uygulanacak ilk 30 günlük yol haritası

Özetle, müşteri itirazı durumunda QR kod veya barkod bazlı video kanıtı sunmak teknik olarak mümkün ve uygulanabilir. Önerilen 30 günlük pilot yol haritası:

1. Bir hat/istasyonda trigger-based capture ile pilot kurulum (kamera + barkod okuyucu + edge).
2. Zaman senkronizasyonu ve metadata şeması tanımlama; SQL Server tabloları oluşturma.
3. Basit ASP.NET Core API ile sorgu ve oynatma akışı geliştirme.
4. Retention ve storage politikalarının belirlenmesi; audit log mekanizmasının etkinleştirilmesi.
5. Kullanıcı eğitimi ve operasyonel testler — gerçek müşteri şikayeti senaryolarıyla doğrulama.

Pilot başarılıysa, sisteme ek istasyonlar ekleyerek ölçeklendirme yapılabilir. Daha fazla teknik detay veya pilot planı için İletişim sayfasından ulaşabilirsiniz.

Ek kaynaklar ve ileri okuma

• Zaman senkronizasyonu: NTP vs PTP karşılaştırmaları.
• Video container metadata yönetimi (MP4, MKV).
• İş süreçleri otomasyonu ve ERP entegrasyonu için webhook/event-driven mimariler.

Bu rehber, gerçek üretim senaryolarında karşılaşılan teknik sıkıntılara uygulanabilir çözümler sunar. Sorunuz spesifik bir hat, kamera modeli veya mevcut ERP/SQL Server mimarinizle ilgiliyse, detay vererek hedefe yönelik bir adım planı çıkartabiliriz.