TEMSİLÎ VAKA · LOJİSTİK
Gümrük belge setinde eksik alan tespiti
Bir uluslararası taşıma ve gümrükleme operasyonunda ihracat dosyaları elle kontrol ediliyordu: fatura, çeki listesi, taşıma senedi, dolaşım veya menşe belgesi ve varsa uygunluk yazıları yan yana açılıp alan alan karşılaştırılıyordu. Eksik ya da çelişkili bir alan çoğu zaman dosyanın gümrükte beklemesiyle ortaya çıkıyordu; düzeltme maliyetinin en yüksek olduğu nokta da tam orasıydı. Hangi belge tipinde hangi alanın sık hata verdiği hiçbir yerde tutulmadığı için kontrol listesi uzmanın hafızasına bağlıydı. Yeni başlayan birinin hangi dosyayı kime sorduğu da kayıt dışıydı.
Beklenen etki
- Kapsam
- İhracat dosyalarında ticari ve taşıma belgeleri ön kontrolden geçiyor; kuruma özel izin yazıları doğrudan insan kuyruğuna yönleniyor
- Ölçüm
- Eksik alanın ön kontrolde mi, imza öncesi insan kontrolünde mi yoksa gümrük aşamasında mı yakalandığı ayrı izleniyor
- Görünürlük
- Belge tipi ve alan bazında hata dağılımı raporlanabiliyor; kontrol listesi kişisel hafızadan çıktı
- Karar sınırı
- Tarife pozisyonu yalnızca öneri olarak gösteriliyor, hiçbir alana otomatik yazılmıyor
Temsilî senaryo: buradaki satırlar ölçüm sonucu değil, bu kurulumda hangi büyüklüğün izlenmesi gerektiğini gösterir.
Bu kayıt gerçek bir müşteri işi değildir. Sinaptik Lab'in bu problemde izlediği yaklaşımı, mimari kararları ve ölçüm düzenini göstermek için yazılmış temsilî bir senaryodur: kurum adı taşımaz, içindeki hiçbir değer gerçek ölçüm değildir ve referans olarak gösterilemez. Gerçek projelerden vakalar müşteri onayı alındıkça bu kütüphaneye eklenir.
Problem
Bir uluslararası taşıma ve gümrükleme operasyonunda ihracat dosyaları elle kontrol ediliyordu: fatura, çeki listesi, taşıma senedi, dolaşım veya menşe belgesi ve varsa uygunluk yazıları yan yana açılıp alan alan karşılaştırılıyordu. Eksik ya da çelişkili bir alan çoğu zaman dosyanın gümrükte beklemesiyle ortaya çıkıyordu; düzeltme maliyetinin en yüksek olduğu nokta da tam orasıydı. Hangi belge tipinde hangi alanın sık hata verdiği hiçbir yerde tutulmadığı için kontrol listesi uzmanın hafızasına bağlıydı. Yeni başlayan birinin hangi dosyayı kime sorduğu da kayıt dışıydı.
Yaklaşım
Kurulan şey belgeyi okuyup karar veren tek bir model değil, okuma ile kararın ayrıldığı iki katmanlı bir akış oldu. Dil modeli belge tipini sınıflandırıyor, alanları çıkarıyor ve gerektiğinde doğrulama servislerini araç olarak çağırıyor; uygunluk kararını ise kural motoru veriyor, çünkü aynı dosyanın iki kez aynı sonucu vermesi ve her ret sebebinin bir kural kimliğine bağlanması gerekiyordu. Araçlar dar imzalı tutuldu: tarife pozisyonu arama, vergi kimliği doğrulama, birim ve ağırlık tutarlılığı, kur karşılığı. Düşük güvenli çıkarımlar karara hiç girmiyor, doğrudan insan kuyruğuna düşüyor. Beyanname imzası akışın dışında bırakıldı; sistem yalnızca imza öncesi bir ön kontrol raporu üretiyor.
Kullanılan teknolojiler
- Belge tipi sınıflandırma
- Alan bazlı güven eşiği
- Dar imzalı araç çağırma
- Deterministik kural motoru
- İnsan onay kuyruğu
- Karar izi kaydı
Bağlam, kurulum ve ölçüm
Problem ve yaklaşım özetin üstünde; burada kararların gerekçesi ve mimarinin ayrıntısı var.
Bağlam ve kısıtlar#
Bir ihracat dosyası tek bir yerde durmuyor: fatura ve çeki listesi müşteri portalından ya da e-posta ekinden geliyor, taşıma senedi taşıyıcıdan, dolaşım ve menşe belgeleri kâğıt kökenli taranmış görüntü olarak, izin ve uygunluk yazıları ise kurum yazışması olarak. Beyanname bu belgelerin toplamından kuruluyor ve elektronik gümrük sistemine giriliyor. İşin insan kararı zorunlu adımı belli: beyannameyi imzalayan gümrük müşavirinin hukuki sorumluluğu devredilebilir bir şey değil.
Kısıtların ilki hata maliyetinin asimetrik olması: bir dosyaya yanlışlıkla 'eksik' demek birkaç dakika, yanlışlıkla 'tam' demek araç limanda beklerken çözülen bir problem demek. İkincisi zaman baskısı — kontrol, aracın hareket saatiyle yarışıyor. Üçüncüsü belge kalitesi: telefonla çekilmiş eğik fotoğraflar, el yazılı düzeltmeler, aynı sette Türkçe, İngilizce ve Almanca faturalar. Bu üç kısıt birlikte, 'her şeyi okuyup karar veren tek model' fikrini baştan eledi.
Veri ve erişim#
Belgeler üç ayrı yerde birikiyordu: operasyon posta kutusu ekleri, dosya yönetim sistemi ve müşteri portalı yüklemeleri. Erişim de bu üçünde farklı kuruluydu; operasyon uzmanı kendi dosyalarını, gümrük müşaviri tümünü, muhasebe yalnızca faturayı görüyordu. Sistem tek bir servis kimliğiyle her şeyi okuyup kullanıcıya göstermek yerine, sorgu anında kullanıcının yetki kapsamını uyguluyor; ön kontrol raporu da dosyanın kendisiyle aynı yetkiye bağlı.
- Ticari fatura ve çeki listesi: portal yüklemesi veya e-posta eki; aynı dosya için birden çok sürüm bulunabiliyor
- Taşıma senedi ve araç bilgisi: taşıyıcıdan geliyor, sürücü adı ve kimlik bilgisi içeriyor
- Dolaşım ve menşe belgeleri: kâğıt kökenli, büyük kısmı taranmış görüntü
- İzin ve uygunluk yazıları: kurum yazışması; yalnızca gümrük müşaviri erişiminde
- Dosya künyesi ve beyanname taslağı: operasyon sisteminde; ön kontrol raporu buna bağlanıyor
Mimari kararlar#
Tasarımın omurgası tek bir ayrım: model okur, kural karar verir. Model belge tipini bulur, alanları çıkarır, gerektiğinde doğrulama aracını çağırır ve her çıkarıma bir güven değeri yazar; kural motoru bu alanları alıp kontrol listesini işletir ve her ret için bir kural kimliği üretir. Böylece rapor 'model böyle düşündü' değil 'şu kural şu alanda tetiklendi' biçiminde okunuyor. Aşağıdaki kararların hepsi bu ayrımın sonucu.
| Karar | Seçilen yol | Neden |
|---|---|---|
| Uygunluk kararını kim verir | Kural motoru; model yalnızca okur ve araç çağırır | Ret sebebinin bir kural kimliğine bağlanması ve aynı girdide aynı sonucun üretilmesi gerekiyordu |
| Araç tasarımı | Her doğrulama için dar imzalı ayrı araç | Tek geniş araçta model parametreleri yanlış eşliyor ve hatanın yeri görünmez oluyor |
| Düşük güvenli çıkarım | Karara hiç girmez, insan kuyruğuna düşer | Belirsiz okumayı karara katmak sessiz yanlış onay üretiyor |
| Tarife pozisyonu | Öneri olarak gösterilir, otomatik yazılmaz | Yanlış tarife beyanının idari sonucu var; öneriyi karara çevirmek sorumluluğu bulanıklaştırır |
| Belge eşleştirme anahtarı | Dosya adı değil, belge içeriğinden çözülen numara ve tarih | Yükleme sırası ve dosya adı sahada güvenilir değil |
Güvenlik ve yetki#
Bir gümrük dosyası iki tür hassas veriyi birlikte taşıyor: kişisel veri (sürücü adı ve kimlik bilgisi, alıcı temsilcisinin iletişim bilgisi) ve ticari sır (birim fiyat, müşteriye özel iskonto). KVKK tarafında veri minimizasyonu ve amaç sınırlaması bu yüzden teknik bir kısıt hâline geldi: çıkarımdan sonra saklanan alanlar kontrol için gerekenlerle sınırlandı, ham görüntünün saklama süresi dosya kapanışına bağlandı. Model sağlayıcısının yurt dışında olduğu kurulumda aktarım kapsamı ayrıca değerlendirildi ve hangi alanların dışarı çıktığı yazılı hâle getirildi. Erişim rol bazlı; denetim izinde hangi dosyada hangi araç çağrıldı ve hangi kural tetiklendi görünüyor.
Ölçüm düzeni#
- Alan bazında insan düzeltmesi: hangi belge tipinde hangi alan düzeltiliyor
- Yakalama yeri: eksikliğin ön kontrolde, imza öncesi kontrolde ya da gümrük aşamasında çıktığı ayrı ayrı
- Araç çağrısı sağlığı: zaman aşımı, boş yanıt ve şema dışı yanıt sınıfları ayrı izleniyor
- Kural motoru ile model anlaşmazlığı: okunan alanın kuralın beklediği biçime uymadığı durumlar
- İnsan kuyruğuna düşen dosyalar ve düşme sebebinin dağılımı
Devreye alma ve işletme#
- 1Gölge koşu
Ön kontrol raporu üretildi ama uzmana gösterilmedi; insanın vardığı sonuçla karşılaştırıldı
- 2Tek belge çiftiyle açılış
Yalnızca ticari fatura ile çeki listesi karşılaştırması canlıya alındı, diğer tipler kuyrukta bırakıldı
- 3Kural kümesinin genişletilmesi
Gümrükten dönen dosyaların sebepleri kural olarak yazıldı; her kurala bir kimlik ve bir sahip verildi
- 4Kuyruk ve nöbet
Düşük güvenli çıkarımlar için insan kuyruğu ve gün içi bakış nöbeti tanımlandı
- 5Sürüm dondurma
Model ve istem sürümü dosya kaydına yazıldı; sürüm değiştiğinde gölge koşu yeniden açıldı
Nerede yanıldık#
İlk sürümde tek bir istemle 'dosyayı incele ve eksikleri söyle' dendi; model eksik belgeyi eksik saymak yerine varsaydı ve raporu dolduramadığı yerde yumuşak bir dil kurdu. İkinci yanılgı daha sinsiydi: tarama kalitesini sabit varsaydık. Eğik çekilmiş fotoğraflarda alan çıkarımı bozulurken güven değeri yüksek kalmaya devam etti, yani güven değerinin kalibre edilmemiş olduğunu ancak insan düzeltmelerini alan bazında ayırmaya başladıktan sonra gördük. Bugün her yeni belge tipi, kendi küçük değerlendirme kümesi yazılmadan akışa alınmıyor.
Bir sonraki projede ne değişir?
Bir vakanın en değerli bölümü sonuç değil, tekrar edilebilir dersidir.
- 01
Modele 'bu belge seti eksiksiz mi' diye sormak yanlış soruydu; model eksik belgeyi 'muhtemelen ekte' diye tolere ediyordu. Eksiklik sorusu kural motorunun işi, okuma işi modelin.
- 02
Aynı dosyada faturanın birkaç sürümü bulunabiliyor. Dosya adına ve yükleme sırasına güvenmek sessiz hataya yol açtı; hangi sürümün geçerli olduğu belge içindeki numara ve tarihten çözülmeli.
- 03
Geniş imzalı tek bir 'doğrula' aracı, model parametreleri birbirine karıştırdığı için başlı başına hata kaynağı oldu. Araç sayısını artırıp her birinin imzasını daraltmak, istem metniyle uğraşmaktan daha çok işe yaradı.
- 04
Güven eşiğini tek bir sayı olarak tutmak işe yaramıyor; eşik alan bazında gerekiyor. Tutar alanındaki küçük bir sapmanın sonucu ile adres alanındaki sapmanın sonucu aynı değil.
- 05
Taranmış belgelerde sayfa sırası bozuk geliyor. Ayrıştırmadan önce sayfa sınıflandırma adımı konmazsa çıkarım doğru alanları yanlış belgeye yazıyor.
Vaka kütüphanesinden
- EğitimDers materyali üretiminde telif ve kaynak zinciriBir eğitim içeriği ekibinin slayt, çalışma kâğıdı ve ders notu arşivi yıllar içinde karışık kaynaklardan büyümüştü: internetten alınmış görseller, yabancı kitaplardan çevrilmiş paragraflar, farklı lisanslarla dolaşan açık ders materyalleri. Bir hak sahibi itiraz ettiğinde hangi paragrafın nereden geldiğini kimse söyleyemiyor; arama dosya adına ve ekip hafızasına kalıyordu. Model destekli üretim devreye girdikten sonra bu belirsizlik büyüdü, çünkü üretilen metnin dayandığı kaynak hiçbir yerde yazılı olmuyordu. Ekipte yaygın olan eğitim amaçlı kullanım serbesttir varsayımı da hiç denetlenmemiş bir varsayımdı.
- EğitimÖdeve biçimlendirici geri bildirim üretimiBir özel okul grubunda dil ve sosyal bilimler öğretmenleri her hafta çok sayıda yazılı ödev okuyordu; not zamanında giriliyordu ama öğrenciye dönen şey bir puan ile kısa bir genel yorumdu. Hangi öğrencinin hangi rubrik ölçütünde tekrar tekrar zorlandığı hiçbir yerde toplu olarak durmuyordu; öğretmen bunu kendi defterindeki izlenimden hatırlıyordu. Geri bildirim yazma işi mesai dışına taştığı için dönem başındaki ödevlerde ayrıntılı, dönem sonuna doğru tek cümleye inen bir kalite farkı oluşuyordu. Velinin gördüğü tabloda puan vardı, gerekçe yoktu.
- EğitimÖğrenci risk modelinde etik sınırlarBir yükseköğretim kurumunda akademik danışmanlar, dersi bırakma ya da kayıt yenilememe riski taşıyan öğrencilere ulaşmayı sezgiyle yapıyordu: yokluğu fark edilen öğrenciye yazılıyor, fark edilmeyen kimseye görünmüyordu. Devam bilgisi, ödev teslimleri ve öğrenme yönetim sistemi hareketleri ayrı sistemlerde durduğu için kimse bunları tek bir öğrenci için yan yana koymuyordu. Danışmanın haftada yapabileceği görüşme sayısı sınırlıydı ama bu sınırın kime harcandığı hiçbir kayıtta yoktu. Risk modeli gündeme geldiğinde ilk itiraz teknik değildi: skor öğrenciye yapışan bir etikete dönerse ne olacağı soruldu.
BUILD
Aynı yaklaşımı kurumunuzda kurmak ister misiniz?
Discovery oturumunda mevcut durumunuzu, veri erişiminizi ve başarı tanımınızı birlikte yazıyoruz.
