Veri Göç + Sınıflandırma Sihirbazı, HAL modülünden önce elinizde bulunan mevcut stok kartlarını HAL'in ürün cinsi yapısına taşımanızı sağlar. Ekran açıklaması bunu özetler: "Mevcut stok kartlarını hal ürün cinslerine sınıflandırarak taşıyın."
Amaç, hâlihazırdaki katalogunuzu sıfırdan yeniden girmeden HAL ekranlarında (mal kabul, satış, fiyat bülteni) kullanılabilir hâle getirmektir. Sihirbaz bunu adım adım ve güvenli biçimde yapar.
Sihirbaz dört adımdan oluşur: Adaylar (henüz HAL ürün cinsine bağlanmamış stok kartlarının listesi), Önizle (seçtiklerinizin taşınınca ne olacağını yazmadan gösteren prova), Göçü Çalıştır (gerçek taşıma) ve ardından bir Rapor (sonucun durum kırılımı).
Aday listesi bir DataTable'dır; kod veya ad ile arayabilir, sayfalayabilirsiniz. Yalnızca HAL ürün cinsine henüz bağlanmamış kartlar aday olarak gelir; bir kez taşınan kart tekrar listede görünmez.
Sihirbaz her aday için ürün adından bir Grup tahmin eder: ad içinde bilinen bir meyve geçiyorsa Meyve, bilinen bir sebze geçiyorsa Sebze, hiçbiri tutmuyorsa Diğer olarak etiketlenir. Örneğin "Elma" → Meyve, "Domates" → Sebze, tanınmayan bir ad → Diğer.
Bu isim tabanlı bir sezgidir, kesin bir sınıflandırma değildir. "Diğer" grubu bir hata değil, geçerli bir geçici kutudur; taşıma sonrası bu cinslerin grubunu dilediğiniz gibi düzeltebilirsiniz.
Önizle bir kuru koşudur (dry-run): seçtiğiniz kartlar için ne olacağını hesaplar ama hiçbir şey kaydetmez. Sonuçta üç sayı görürsünüz: Taşınacak, Atlanacak ve Hatalı; ayrıca her satırın hangi gruba düşeceği veya neden atlanacağı/hatalı olacağı listelenir.
Böylece gerçek göçten önce sonucu güvenle görürsünüz. Hiç kayıt seçmeden çalıştırırsanız "Lütfen taşınacak kayıtları seçin." uyarısını alırsınız.
Göçü Çalıştır gerçek taşımayı tek bir işlem (transaction) içinde yapar ve önce onay ister: "Seçili kayıtlar hal ürün cinslerine taşınacak. Onaylıyor musunuz?" Sistem fail-closed çalışır — çözülemeyen kayıt taşınmaz:
Stok adı boşsa kayıt Hatalı işaretlenir ("Ad boş", cins oluşturulamaz); kart zaten bir cinse bağlıysa veya kod çakışıyorsa Atlandı olur ("Zaten bağlı"); grubu addan çıkarılamayan ama adı dolu kayıt ise Diğer grubuyla taşınır. Sonunda "Göç tamamlandı: … taşındı, … hatalı, … atlandı." özetini alırsınız.
Göçten sonra Rapor adımı durum kırılımını verir (aktarıldı / hatalı / atlandı) ve son göç oturumlarını listeler. Her taşınan kartın ham hâli bir kayıt tablosuna (ham JSON) yazılır; bu, gerektiğinde geri dönüş için kaynak oluşturur.
Göç idempotenttir: zaten bağlanmış kartlar "Atlandı" sayıldığı için sihirbazı ikinci kez çalıştırmanız mükerrer cins oluşturmaz. Bu yüzden büyük katalogları partiler hâlinde, birkaç oturumda güvenle taşıyabilirsiniz.
Gerçek göçten önce mutlaka Önizle ile prova yapın; taşınacak/atlanacak/hatalı sayılarını gördükten sonra çalıştırın. Adları eksik kartları göç öncesi düzeltirseniz daha azı "Hatalı" olur. "Diğer" grubuna düşenleri sonradan tek tek doğru gruba çekebileceğiniz için, önce hepsini taşıyıp sonra sınıflandırmayı ince ayar yapmak pratik bir yoldur.
Sihirbaz güvenli tarafta durur: adı boş bir stok kartı asla taşınmaz (Hatalı işaretlenir), çünkü adsız bir ürün cinsi oluşturulamaz. Zaten HAL cinsine bağlı kartlar sessizce atlanır, üzerine yazılmaz. Yani göç hiçbir mevcut cinsi bozmaz; yalnızca yeni cinsler ekler. Yanlış gruba düşen kayıtlar veri kaybı değildir — taşıma sonrası cins grubunu düzeltebilirsiniz.
Veri Göç ve Sınıflandırma Sihirbazı mevcut stok kartlarınızı HAL ürün cinsi yapısına Adaylar → Önizle → Çalıştır → Rapor akışıyla taşır; grupları addan otomatik tahmin eder (Sebze/Meyve/Diğer). Fail-closed'dur: adı boş kayıt taşınmaz, zaten bağlı kart atlanır.
Önizle yazmadan prova yapar, çalıştırma idempotenttir ve ham kayıtlar geri dönüş için saklanır. Bu ders HAL Akademi modülünün son dersidir; artık modülü baştan sona kullanabilirsiniz.