UI5 Fiori - SayımX Depo Sayım ve Stok Karşılaştırma Sistemi

UI5 Fiori - SayımX Depo Sayım ve Stok Karşılaştırma Sistemi

Çok şirketli ve çok lokasyonlu depo yapılarında SAP stok verisini fiziksel sayım sonuçlarıyla karşılaştıran, Excel tabanlı manuel süreci ortadan kaldıran uçtan uca bir web uygulaması

Teknolojiler
SQL Server Node.js SAPUI5 Fiori

Depo Sayımında Excel'den Kurtulmak: SayımX Projesi

Depo yönetiminde sıkça karşılaşılan bir problemi ele alarak, manuel Excel-tabanlı depo sayım sürecini uçtan uca bir web uygulamasına dönüştürdüm: SayımX. Proje, Freestyle SAPUI5 (SAP'ın Fiori tasarım dili), Node.js/Express ve Microsoft SQL Server üzerine kuruldu.

Sayım Oturumları listesi ekranı

Neden Bu Proje

Günümüzde birçok şirket hâlâ Excel'den vazgeçemiyor; stok analizini Excel dosyaları üzerinden yapıyor. Oysa bu veri, sistematik bir veritabanı tablosunda tutulup oradan kontrol edilebilir. Dışa aktarım ihtiyacı olduğunda bile — CSV, teknoloji olarak eski olmasına rağmen hâlâ yaygın kullanılıyor — kaynak veri sistemin kendi tablosunda tutarlı ve denetlenebilir halde kalmaya devam eder; CSV yalnızca bir çıktı formatı olur, verinin asıl adresi değil.

SayımX'te Excel'i tamamen devre dışı bırakmadım — SAP export'u zaten Excel formatında geliyor — ama onu sürecin tek kaynağı olmaktan çıkarıp, sisteme bir kez giren, sonrasında veritabanı üzerinden yönetilen bir veriye çevirdim.

Bunu mümkün kılan, sabit kolon isimlerine bağımlı olmayan dinamik bir içe aktarma ekranı: kullanıcı Excel'deki kolonları sistemdeki alanlarla kendisi eşleştiriyor, isterse bu eşleştirmeyi şablon olarak kaydedip bir sonraki seferde tekrar kullanıyor. Hiyerarşi alanları (Şirket, Üretim Yeri, Depo Yeri, Depo Kodu) da bu eşleştirmenin zorunlu bir parçası — böylece içe aktarılan her satır, hangi fiziksel bağlama ait olduğunu baştan taşıyor.

Excel Import ekranı — dinamik kolon eşleştirme

Projenin Asıl Öğretici Kısmı: Veri Modeli

Projenin en öğretici kısmı, "sayım" veya "barkod okutma" değil, aslında çok şirketli/çok lokasyonlu veri modeli oldu.

Malzeme kodu artık tek başına bir kimlik değil. Şirket, Üretim Yeri, Depo Yeri, Depo Kodu ve Malzeme Kodu bir arada bir kimlik oluşturuyor. Aynı malzeme kodu, farklı bir depoda tamamen farklı bir fiziksel stoku temsil edebiliyor — bu da sistemin her katmanının bu gerçeği hesaba katması gerektiği anlamına geliyor.

Master Veri Yönetimi — Şirket

Master Veri Yönetimi — Üretim Yeri

Master Veri Yönetimi — Depo Yeri

Master Veri Yönetimi — Depo Kodu

Bağlama Kilitli İşlemler

Bu bağlam, bir sayım oturumu açılırken belirleniyor: Şirket, Üretim Yeri, Depo Yeri ve Depo Kodu birbirine bağlı (cascading) dört seçim alanıyla, üst seviye seçilmeden alt seviye seçilemeyecek şekilde tanımlanıyor.

Yeni Sayım Oturumu — hiyerarşik bağlam seçimi

Barkod arama ve sayım kaydı, işte bu belirlenen bağlama kilitleniyor. Farklı bir depodaki malzeme, sistem tarafından mimari seviyede "görünmez" hale geliyor.

Bu bir hata değil, bilinçli bir tasarım kararı: yanlış depoya sayım girişini mimari seviyede imkânsız kılan bir güvenlik sınırı. Bir sayım oturumu, soyut bir kayıt değil, depo personelinin o an fiziksel olarak bulunduğu tek bir yeri temsil ediyor.

Sayım Girişi ekranı

Esnekliğin Bedeli ve Çözümü

"Aynı malzeme kodu tekrar edebilsin" kararı (insert-only tasarım) önemli bir esneklik sağladı — örneğin aynı malzemenin farklı parti/lot olarak birden fazla kez sisteme girmesi meşru bir senaryo. Ama bu esnekliğin raporlama katmanında bir bedeli oldu: aynı verinin yanlışlıkla iki kez yüklenmesi durumunda fark raporu tutarsız görünüyordu.

Çözüm, raporlama view'ını sabit bir teknik kimlik (ID) yerine iş anahtarı (malzeme kodu) üzerinden yeniden agregasyona geçirmekti. Bu değişiklik, insert-only tasarımın esnekliğini korurken raporun tutarlılığını garanti altına aldı.

Fark Raporu ekranı

Sonuç

Bu süreç bana şunu bir kez daha gösterdi: iyi bir veri modeli, sadece "veriyi saklamak" değil, hangi işlemin hangi bağlamda anlamlı olduğunu sisteme öğretmektir.

Kullanılan teknolojiler: Freestyle SAPUI5, Node.js, Express, Microsoft SQL Server, JWT tabanlı kimlik doğrulama, barkod entegrasyonu (fiziksel okuyucu + kamera tabanlı tarama).

04 Eylül 2026 tarihinde yayınlandı
Tüm Projelere Dön