﻿UYAP DOSYA ALACAĞINA HACİZ OTOMASYONU - KULLANIM KILAVUZU  (sürüm 1.0.11)
=========================================================================

NE YAPAR
  Bir icra dosyasından (haczi koyan dosya), o dosyadaki bir tarafın başka icra dairelerindeki dosyalarına
  "Dosya Alacağına Haciz" ekler. UYAP'ta elle yapılan şu işi otomatikleştirir:
    İcra Genel Dosya Sorgulama > Detaylı Dosya Arama: dosyayı bul > Seç
    Haciz & Mal & Satış > Dosya Alacağına Haciz Ekleme/Kaldırma İşlemleri
    Taraf Bilgileri: tarafı seç > İl > Dosya No Yıl > Vekil/Yediemin/Bilirkişi/Borçlu/Alacaklı
    Listelenen dosyalar (50'şer sayfa): Tümünü Seç > Haciz Tipi > Nedeni > Ekleme Nedeni > Miktar >
    Haciz Ekle > Evet > "Haciz Eklenildi" Tamam > >> sonraki sayfa ... > Aramayı Temizle > sonraki yıl ... > Kapat
  Sonunda kaç dosyaya haciz konulduğunu gösterir ve Excel rapor yazar.


ÇALIŞTIRMA
  1. UYAP'ta oturum açın (İş Listesi açık olsun). UYAP penceresini program kendisi konumlandırır.
  2. DosyaAlacaginaHaciz.exe'yi açın. Üstte "✓ Ön kontrol tamam" yazmalı.
  3. Alanları doldurun (veya "Son dosya" düğmesiyle son çalışmanın bilgilerini getirin):

     DOSYA
       Dosya No / Dosya Türü  : haczi koyan dosya (ör. 2026/373007 - İcra Dosyası)
     TARAF
       Taraf Adı              : Taraf Bilgileri listesindeki ad / unvan (tamamı veya bir kısmı)
       Vergi/TC No            : ikisi de karşılaştırılır; uyan TEK satır yoksa program durur
     ARAMA
       Yıllar                 : 2026  |  2018-2026  |  2019, 2021   (yazıldığı sırayla aranır)
       İl                     : (Tüm iller) = bütün iller tek aramada (UYAP en fazla ~1000 kayıt gösterir!)
                                (İl il ara - 81 il) = her il ayrı aranır; 1000'den fazla dosya varsa bunu seçin
                                veya tek bir il seçin
       Taraf türü             : karşı dosyalarda tarafın sıfatı (Vekil/Yediemin/Bilirkişi/Borçlu/Alacaklı)
     HACİZ
       Haciz Tipi / Nedeni    : UYAP'taki seçenekler
       Haciz Konulan Miktar   : 141.529.208,33  veya  141529208,33  (".TL" yazılabilir)
       Sadece bu dosyalar     : BOŞ = listelenen BÜTÜN dosyalar. Doluysa (ör. 2026/7337, 2026/15) sadece bunlar.
     AYARLAR
       Mod: Onaylı      = dosya sorgusu, taraf seçimi ve HER "Haciz Ekle" öncesi sorar (ilk kullanımda önerilir)
            Tam otomatik = sormaz
       Tekrar: "Daha önce haciz konulan dosyaları atla" - işaretli bırakın (aşağıya bakın)
       Oturum: "UYAP oturumu kapanırsa yeniden girişi bekle, sonra devam et" - işaretli bırakın

  4. Başlat. Çalışırken fareye ve klavyeye DOKUNMAYIN.
     DURDURMAK: F12, "Durdur" düğmesi veya fareyi ekranın SOL ÜST köşesine götürmek.
     (Fare yanlışlıkla sol üst köşeye giderse program da durur - bkz. Kaldığı yerden devam.)

  SÜRE: UYAP her sayfa geçişinde 30-120 sn bekletir. 50'lik bir sayfa ~1,5-2 dk; 1000 dosya ~40 dk.


KALDIĞI YERDEN DEVAM / MÜKERRER HACİZ ÖNLEME
  "Daha önce haciz konulan dosyaları atla" işaretliyken program raporlar\tum_hacizler.csv dosyasına bakar:
  AYNI haczi koyan dosyadan, AYNI taraf (vergi/TC no) ve taraf türü için daha önce haciz konulmuş dosyalar
  (birim + dosya no + dosya türü birlikte) ATLANIR:
    - sayfadaki bütün dosyalar eskiyse sayfa hacizsiz geçilir,
    - hepsi yeniyse Tümünü Seç ile eklenir,
    - karışıksa sadece yeniler tek tek işaretlenir.
  Yarıda kalan bir iş: UYAP'ta tekrar giriş yapın > programda "Son dosya" > Başlat. Eski sayfalar hacizsiz
  geçilir (yine de UYAP her sayfada bekletir), yeni dosyalara devam edilir.
  ÖNEMLİ: tum_hacizler.csv silinir/taşınırsa bu kontrol yapılamaz. Program klasörünü taşırken raporlar\
  klasörünü de birlikte taşıyın.


UYAP 1000 KAYIT SINIRI / İL İL ARAMA
  UYAP bir aramada en fazla ~1000 dosya (20 sayfa) listeler. "Tüm iller" araması 20 sayfaya ulaşırsa raporda
  "UYAP ~1000 kayıt sınırına ulaşıldı, liste EKSİK olabilir" uyarısı çıkar: aynı işi "İl il ara" ile tekrar
  çalıştırın (daha önce konulanlar atlanır). İl il modunda her yıl için 81 il sırayla aranır (UYAP her aramada
  15-140 sn bekletir: yıl başına 1-3 saat). Bitirilen her il/yıl araması raporlar	amamlanan_aramalar.csv'ye
  yazılır; iş yarıda kalırsa Son dosya > Başlat ile devam edildiğinde biten iller hiç aranmadan geçilir.
  UYAP aynı aramada her seferinde FARKLI bir ~1000'lik dilim döndürüyor: 1000 sınırına takılan bir arama yeni haciz
  çıkardıkça program aynı aramayı tekrarlar (en fazla 5 kez); yeni dosya çıkmayınca o il/yıl tamamlanmış sayılır.
  5 tekrardan sonra bile yeni çıkıyorsa raporda "liste henüz tükenmedi" yazar; işi tekrar çalıştırın.

UYAP PENCERELERİ (program kendisi cevaplar)
  "Dosya ... Hakkında Durdurulmuştur. Devam Etmek İstiyor Musunuz?"   -> Evet  (sadece bu soruya)
  "Seçili Olan Dosyalarda ... Haciz Eklenecektir. Devam ...?"          -> Evet
  "Dosya Alacağına Haciz Eklenildi. Rapor Kaydedildi ..."                -> Tamam
  "Kayıt Bulunamadı." (ICR_GNL_10376)                                    -> Tamam (o yıl bitti, sonraki yıla geçilir)
  "Zaman Aşımı Oluştu. Uygulamaya Tekrar Giriş Yapmak İster misiniz?"   -> CEVAPLAMAZ (giriş size aittir):
       UYAP oturumu ~35 dakikada bir kapanabiliyor. Ayarlar'da "UYAP oturumu kapanırsa yeniden girişi bekle"
       işaretliyse (varsayılan) program dakikada bir sesli uyarı verip bekler; siz soruyu cevaplayıp e-imza ile
       yeniden giriş yapınca 30 sn sonra KENDİLİĞİNDEN kaldığı yerden devam eder (en fazla 4 saat bekler).
       İşaretli değilse program durur: yeniden giriş yapıp Son dosya > Başlat.
  Başka (beklenmeyen) bir soru çıkarsa program cevap vermeden durur ve mesajı gösterir.


RAPORLAR  (raporlar\ klasörü; arayüzde "Son rapor" ve "Raporlar" düğmeleri)
  haciz_TARİH.xlsx   -> "Özet": dosya, taraf, il, haciz bilgileri, yıl yıl sonuç, atlanan sayısı, UYAP uyarıları
                        "Haciz Konulanlar": Birim Adı, Dosya Durumu, Dosya No, Dosya Türü, Sıfatı,
                        Takip Şekli/Yolu/Türü/Mahiyeti, yıl, sayfa, UYAP sonucu (filtrelenebilir)
                        Program yarıda durursa o ana kadar konulanlar yine yazılır ("YARIDA KALDI").
  haciz_TARİH.csv    -> aynı liste
  tum_hacizler.csv   -> bütün çalıştırmalarda konulan hacizler alt alta (kontrol ve mükerrer önleme için)


LOGLAR  (loglar\ klasörü; arayüzde "Loglar" ve "Son hata")
  calisma_TARİH.log  -> her adım, her tıklama, okunan metinler
  hatalar\...        -> her hata için ekran görüntüsü (ekran.png) + hata.txt. Sorun olduğunda bu klasörü iletin.
  ogrenme\           -> ara ekran görüntüleri
  Bu dosyalar kişisel veri içerir; sadece yetkili kişilerle paylaşın, gerektikçe silin.


ŞARTLAR
  - Windows ekran ölçeği %100; ekran en az 1280 genişlik / 900 kullanılabilir yükseklik (1920x1200'de denendi).
  - Windows Türkçe OCR yüklü (yoksa Turkce_OCR_Kur.bat > sağ tık > Yönetici olarak çalıştır).
  - Kurulum_Kontrol.bat ile kontrol edin: "KURULUM KONTROLÜ: HAZIR ✓".


SIK SORULANLAR
  İl ilk denemede yanlış seçiliyor?  -> Normal: UYAP listesi Home tuşunda bir satır kayıyor; program okuyup düzeltir.
  "Taraf bulunamadı"                 -> Taraf adını / vergi no'yu Taraf Bilgileri listesindeki gibi yazın.
  "Birden çok taraf satırı uyuyor"   -> Vergi/TC No girin.
  Aynı numaralı iki dosya (ör. 2025/342 İcra ve Talimat) -> ayrı dosyalardır; ikisine de haciz konur.
