Türk yargı sisteminin ana belge formatı olan .udf dosyaları günlük hayatta avukatların, hukuk öğrencilerinin ve müvekkillerin önüne çıkar. Ancak bu dosyayı açmak için kurumun ürettiği UYAP Doküman Editörü yalnızca Windows'ta çalışıyor. Mac, Linux ve mobil kullanıcılar çaresiz kalıyor. Bu boşluğu kapatmak için tarayıcıda çalışan bir UDF Dönüştürücü geliştirdik.
UDF formatı aslında ne?
UDF (UYAP Doküman Formatı), dış görünüşte özel bir uzantı olsa da içeride standart bir ZIP arşivi. Açtığınızda XML formatında yapısal veri, RTF olarak metin blokları ve PKCS#7 standardında bir dijital imza görürsünüz. İmza, belgenin kim tarafından, ne zaman oluşturulduğunu ve sonradan değiştirilip değiştirilmediğini matematiksel olarak kanıtlıyor. Islak imzanın dijital karşılığı bu.
Client-side mimari neden önemli?
Aracımız %100 tarayıcıda çalışıyor; dosya hiçbir zaman sunucuya gitmiyor. Üç temel kütüphane kullanıyoruz:
- JSZip — UDF'in ZIP yapısını açmak için
- jsPDF — PDF çıktısı oluşturmak için
- pdf-lib — Sayfa birleştirme ve post-processing
Avukat–müvekkil gizliliği söz konusu olduğunda "dosyayı internete yükleyin" diyen çözümler kabul edilemez. Client-side çözüm, tarayıcı kapandığında dosyanın uçmasını sağlıyor. Bu mimari UDF dosyası açma ihtiyacı olan herkes için kritik.
Türkçe karakter desteği
jsPDF'in varsayılan fontları Türkçe karakterleri (ş, ğ, ç, ö, ü) düzgün render etmiyor. Biz Noto Serif TTF dosyalarını base64 olarak gömüp jsPDF'e runtime'da kayıt ediyoruz. Sonuç: çıktı PDF'te karakterler hem okunaklı hem de aranabilir. Dilekçe metinleri büyük/küçük harf farkı korunarak, italik ve bold biçimlendirmesiyle birlikte render ediliyor.
TIFF ve CCITT G4 tuzakları
UYAP bazen taranmış ek delilleri fax-sıkıştırmalı TIFF (CCITT Group 4) olarak sunuyor. Popüler UTIF.js kütüphanesi standart TIFF'i çözüyor ama CCITT G4 encoding'i atlıyor. Kendi G4 decoder'ımızı yazıp typed array'lerle neredeyse WebAssembly hızında çalıştırdık. Niche ama Türk yargısında yeterince yaygın olduğu için vazgeçilmezdi.
Toplu dönüşüm ve merge
Hukuk bürosu ekipleri için UYAP PDF Dönüştürücü aracının toplu dönüşüm özelliği pratik. Birden fazla UDF, Word veya görsel dosyayı aynı anda seçip tek bir birleşik PDF olarak indirebiliyorsunuz. Merge işlemi pdf-lib ile yine tarayıcıda, sunucusuz.
UDF to PDF sadece tek yön değil
Word belgesinde hazırladığınız dilekçeyi UYAP'a yüklemeden önce UDF'ye dönüştürme özelliğini de ekledik. Avukat, alışık olduğu Microsoft Word'de yazıp doğrudan UYAP-uyumlu formatta dışa aktarabiliyor.
Teknik detaylar
Tüm dönüşüm mantığı tek bir converter.js dosyasında, yaklaşık 2400 satır. Bundler yok, framework yok. Statik site olarak GitHub Pages'te yayında. Browser testleri Windows, macOS, Linux, Android Chrome ve iOS Safari'de tamamlandı.
Nasıl kullanılır
- Dosyayı tarayıcıda convertudftopdf.com'a sürükle-bırak
- Çıkış formatını seç (PDF veya DOCX)
- Dönüştür → anında indirme
- Orijinal UDF'i silme — yasal delil niteliği için saklanmalı
Sıra dışı kullanım senaryoları
- Duruşma koridorunda mobil erişim: Avukat telefonundan UDF'i PDF olarak açıp hakim beye gösterebiliyor
- Uluslararası hukuk yazışmaları: Türk UDF'ini yabancı hukuk firmasına okunabilir PDF olarak yollama
- Arşivleme: Tüm UDF'leri toplu olarak PDF'e çevirip yıllık arşiv backup'ı
Geliştiriciler için notlar
Tarayıcıda dosya dönüşümü yapan araçlar yazıyorsanız üç deneyim paylaşımı:
- Client-side hassas belgelerde güven kazandırır — "sunucuya yükleyin" diyen her çözüm kurumsal müvekkiller tarafından reddediliyor
- Latin olmayan alfabe için font yönetimi her katmanda test gerektirir — sadece CSS değil, PDF/canvas/image altyazı ayrı ayrı
- Legacy formatlar mainstream kütüphanelerin atladığı niche yollar içerir — özel decoder yazmaya hazırlıklı olun
Proje açık kaynak ve convertudftopdf.com üzerinden erişilebilir. Benzer Türk hukuk/yargı dosya formatları üzerine geliştiren varsa yorumlarda konuşalım.
Top comments (0)