ARGEKA Sync

Destek ve ilk kullanim

ARGEKA Sync kurulumdan sonra yerel bilgisayarda calisir. Varsayilan adres http://localhost:8080, API adresi ise http://localhost:3000 olarak kurgulanir. Bu sayfa ilk kurulum, giris, baglanti, aktarim ve hata kontrolu icin temel rehberdir.

Ilk giris

Demo kullanici admin@argeka.local / admin123 olarak gelir. Canli kullanimda bu sifre degistirilmeli, ekip kullanicilari icin rol ve veri kapsami ayrica tanimlanmalidir.

Baglanti testi

ERP veya rapor veritabanina baglanmadan once host, port, veritabani adi, kullanici yetkisi, SSL modu ve VPN gereksinimi kontrol edilmelidir.

Yedekleme

Projedeki backup.ps1 ve restore.ps1 dosyalari veritabani yedegi almak ve geri yuklemek icin hazirlanmistir. Canli ortamda duzenli yedek planlanmalidir.

Aktarim hatasi oldugunda nasil ilerlenir?

  1. Son calisma gecmisinde okunan, yazilan ve hata alan satir sayisini kontrol edin.
  2. Kaynak SQL sorgusunu ayni parametrelerle test ortaminda calistirin.
  3. Hedef tabloda zorunlu kolon, veri tipi ve unique key kisitlarini kontrol edin.
  4. Kolon eslemesinde kaynak kolon adinin hedef kolonla dogru eslestiginden emin olun.
  5. Upsert kullaniliyorsa anahtar kolonun bos veya merrer olmadigini dogrulayin.
  6. Hatali satirlari atlamak yerine once sebebini kaydedin; sonra skip row veya quarantine politikasini kullanin.

Destek kapsami

ARGEKA Sync, teknik ekiplerin kendi ortamlarinda veri aktarim akisi kurabilmesi icin hazirlanmistir. Destek konusu kurulum, Docker servisleri, veritabani baglantisi, SQL sorgu parametreleri, kolon esleme, zamanlama, log okuma ve yedekleme basliklarini kapsar. ERP is kurallari kurumdan kuruma degistigi icin her aktarim canli sisteme alinmadan once ornek kayitlarla dogrulanmalidir.

Baglanti ve sorgu destegi

Destek surecinde ilk bakilan konu veritabani baglantisinin dogru yetkiyle yapilip yapilmadigidir. Kaynak ERP veritabani icin mumkunse yalnizca okuma yetkili kullanici tercih edilir. Hedef rapor veritabani icin ise tablo olusturma, insert veya upsert ihtiyacina gore ayrik yetki tanimlanir. Bu ayrim hem guvenlik hem de hata ayiklama acisindan onemlidir.

SQL sorgularinda tarih alanlari ozellikle kontrol edilmelidir. Kayit tarihi, belge tarihi, hareket tarihi ve kapanis tarihi ayni is anlami tasimaz. Yanlis tarih secimi, aktarim calissa bile raporun eksik veya fazla veri uretmesine neden olabilir. Bu nedenle her sorgu ornek belgeyle karsilastirilmali ve beklenen satir sayisi not edilmelidir.

Kolon esleme ve hata politikasi

Kolon esleme aktarimin en kritik adimidir. Kaynakta metin olan bir alan hedefte sayi bekliyorsa, tarih formati farkliysa veya hedef kolon zorunluysa aktarim hata verebilir. Strict politika veri kalitesini korur; ancak kesintisiz akis gereken raporlarda quarantine veya skip row yaklasimi tercih edilebilir. Hangi politikanin secilecegi teknik degil, is riski kararidir.

Canliya alma kontrol listesi

Bir aktarim isi canliya alinmadan once kaynak sorgu, hedef tablo, kolon esleme ve yazma davranisi birlikte kontrol edilmelidir. Hedef tabloda ayni anahtara sahip kayit varsa ne olacagi, iptal kayitlarinin aktarilip aktarilmayacagi, tarih filtresinin hangi alan uzerinden calistigi ve calisma sikliginin ERP performansini etkileyip etkilemeyecegi yazili hale getirilmelidir.

Destek surecinde onerilen yontem once kucuk veri setiyle manuel calisma yapmak, sonra zamanlamayi acmak, son olarak run loglarini izlemektir. Bu sira izlenirse hata oldugunda sorun sorguda mi, baglantida mi, eslemede mi yoksa hedef kisitinda mi daha hizli anlasilir.