EGekremgungor.dev_

OFFLINE DOCUMENT TOOL · v1.0.0

e-Defter Yerel Görüntüleyici

e-Defter berat XML dosyalarını herhangi bir sunucuya yüklemeden, doğrudan tarayıcı içinde inceleyen tek dosyalık çevrimdışı görüntüleyici.

GELİŞTİRMEGerçek müşteri ihtiyacı
DURUMv1.0.0 yayınlandı
GİZLİLİKVeri cihazdan çıkmaz
[ 01 / OVERVIEW ]

Gerçek ihtiyaçtan ürüne

Araç, açılamayan bir e-Defter belgesini müfettişe göstermek isteyen müşterinin operasyonel ihtiyacına hızlı çözüm üretmek için başladı. İlk çalışan sürüm bir gün içinde hazırlandı; ürünleştirilen sürüm bugün iki gerçek müşteri ortamında kullanılan yaklaşımı güvenli ayrıştırma, test ve tek dosyalık dağıtım süreciyle yeniden ele alıyor.

[ PRODUCT / INTERFACE ]

Ürün görünümü

Yerel dosya seçimi, belge özeti ve taraf bilgileri
Hesap toplamları, imza bilgileri ve doğrulama kapsamı
e-Defter Yerel Görüntüleyici dosya seçim ve belge özeti ekranı
1 / 2
[ 02 / CHALLENGE ]

Problem

Berat XML dosyalarının görüntülenmesi harici defter.xslt dosyasına bağlıydı. Dosya eksildiğinde veya bozulduğunda belge tarayıcıda anlamlı biçimde açılamıyor; mali verinin çevrim içi bir servise yüklenmesi ise gizlilik açısından uygun bir seçenek oluşturmuyordu.

[ 03 / SOLUTION ]

Çözüm

XML içeriği tamamen tarayıcı içinde ayrıştırılıyor, gerekli e-Defter alanları güvenli bir veri modeline çıkarılıyor ve sade bir rapor görünümünde sunuluyor. Build süreci uygulamayı bağımsız tek HTML dosyasına paketlediği için kurulum veya sunucu gerektirmiyor.

[ 04 / ENGINEERING ]

Öne çıkan mühendislik kararları

  1. 01

    Dosyaları sunucuya göndermeyen tamamen yerel çalışma modeli

  2. 02

    Harici defter.xslt bağımlılığını kaldıran bağımsız görüntüleme

  3. 03

    Geçersiz ve riskli XML girdilerine karşı kontrollü ayrıştırma

  4. 04

    Yevmiye ve büyük defter beratları için ortak veri çıkarımı

  5. 05

    Mükellef, meslek mensubu, dönem, hesap ve imza bilgileri görünümü

  6. 06

    Vitest, coverage ve CI ile doğrulanan tek dosyalık build pipeline

[ 05 / ARCHITECTURE ]

Katmanlar ve sorumluluklar

Local File Input

Kullanıcının cihazından seçilen XML dosyası; ağ isteği oluşturulmaz

Secure Parser

Belgeyi doğrulayan ve güvenli XML ayrıştırma sınırlarını uygulayan katman

Data Extraction

Namespace farklılıklarından bağımsız e-Defter alan modeli

Report Renderer

Okunabilir, yazdırılabilir ve kurumsal belge görünümü

Single-file Build

HTML, CSS ve JavaScript kaynaklarını tek taşınabilir dosyada birleştiren süreç