===========================================================
  KG ARŞİV — KURULUM VE KULLANIM
  Sürüm: 1.0.0
  Hazırlayan: Liga Technology · Kıbrıs Gazetesi arşiv sistemi
===========================================================

Bu paket, ofisteki arşiv sunucusuna kurulur. Kurulduktan sonra
arşivdeki fotoğraf ve videolar Kıbrıs Gazetesi yönetim panelinden
aranabilir, önizlenebilir ve habere eklenebilir.

Kurulum bir kez yapılır. Sonraki sürümler kendiliğinden iner;
bilgisayara tekrar gelmemiz gerekmez.


-----------------------------------------------------------
1. KURULUMDAN ÖNCE
-----------------------------------------------------------

Gerekenler:

  · Windows 10 / 11 veya Windows Server 2016 ve üstü (64 bit)
  · Yönetici hakkı olan bir kullanıcı
  · Arşiv klasörünün tam yolu (örnek: D:\Arsiv)
  · Bizim size ilettiğimiz iki anahtar:
      - API anahtarı
      - Kanal (tünel) anahtarı

Bilgisayar 7/24 açık kalmalıdır. Kapatılırsa arşiv panelden
görünmez; yeniden açıldığında kendiliğinden devam eder.


-----------------------------------------------------------
2. KURULUM ADIMLARI
-----------------------------------------------------------

ADIM 1 — Dosyaları çıkartın
  Zip dosyasını C:\KGArsiv gibi bir klasöre çıkartın.
  Zip'in içinden çalıştırmayın.

ADIM 2 — Anahtarları tanımlayın
  Başlat menüsünde "cmd" yazın, "Komut İstemi"ne sağ tıklayıp
  "Yönetici olarak çalıştır" seçin. Şu iki komutu, tırnaklar
  dahil, size verdiğimiz anahtarlarla çalıştırın:

      setx /M KGARSIV_API_SECRET   "size-verilen-anahtar"
      setx /M KGARSIV_TUNNEL_TOKEN "size-verilen-kanal-anahtari"

  Sonra bu pencereyi kapatın. (Yeni değerler ancak yeni açılan
  pencerelerde görünür.)

ADIM 3 — Ayar dosyasını doldurun
  kgarsiv.yaml dosyasını Not Defteri ile açın. İçinde
  "<<< DOLDURUN ... >>>" yazan üç satır var:

      arşiv klasörünüzün yolu
      önizleme klasörü
      veritabanı dosyası

  Yolları çift ters bölü ile yazın:  D:\\Arsiv
  Önizleme klasörü arşivin İÇİNDE olmamalı.
  Kaydedip kapatın.

ADIM 4 — Kurun
  kur.bat dosyasına sağ tıklayın, "Yönetici olarak çalıştır"
  seçin. Betik ayarları denetler, hizmeti kurar ve başlatır.
  Ekranda "KURULUM TAMAMLANDI" yazmasını bekleyin.

ADIM 5 — Bekleyin
  İlk tarama arşivin büyüklüğüne göre birkaç saatten uzun
  sürebilir. Bu sırada bilgisayar normal kullanılabilir.
  Panelde dosyalar tarama ilerledikçe görünmeye başlar.


-----------------------------------------------------------
3. SORUN GİDERME
-----------------------------------------------------------

"Yönetici olarak çalıştırın" hatası
  kur.bat'a çift tıkladınız. Sağ tıklayıp "Yönetici olarak
  çalıştır" seçmeniz gerekiyor.

"kgarsiv.yaml içinde doldurulmamış alanlar var"
  ADIM 3 atlanmış. Dosyada hâlâ "DOLDURUN" yazan satır var.

"KGARSIV_API_SECRET tanımlı değil"
  ADIM 2 yapılmamış ya da komut penceresi kapatılıp yeniden
  açılmamış. Komutu çalıştırdıktan sonra pencereyi kapatın,
  kur.bat'ı yeni bir pencereden çalıştırın.

"Hizmet başlatılamadı"
  Sebebi logs klasöründeki günlük dosyasında yazar (bkz. bölüm 4).
  Dosyayı bize gönderin.

Arşiv panelde görünmüyor
  Komut İstemi'nde şunu çalıştırın:

      kgarsiv.exe status

  "Running" yazmıyorsa hizmet durmuş demektir; kur.bat'ı yeniden
  çalıştırın. "Running" yazıyorsa tarama sürüyor olabilir.

Bilgisayar yeniden başlatıldı
  Bir şey yapmanız gerekmez. Hizmet, Windows açılırken kimse
  oturum açmasa bile kendiliğinden başlar.

Sunucu yavaşladı
  kgarsiv.yaml içinde scan bölümündeki initial_workers değerini
  2 yapıp hizmeti yeniden başlatın (kaldir.bat + kur.bat).


-----------------------------------------------------------
4. GÜNLÜK (LOG) DOSYALARI
-----------------------------------------------------------

Kurulum klasörünün altındaki "logs" klasöründe tutulur:

      C:\KGArsiv\logs

  Günlük olarak yeni dosya açılır, eskiler bir süre saklanır.
  Bir sorun bildirirken en yeni dosyayı bize göndermeniz
  çözümü çok hızlandırır.

Gizli anahtarlar günlüğe YAZILMAZ. Dosyayı gönül rahatlığıyla
paylaşabilirsiniz.


-----------------------------------------------------------
5. GÜNCELLEMELER
-----------------------------------------------------------

Servis günde birkaç kez yeni sürüm olup olmadığına bakar.
Yeni sürüm yalnızca bizim dijital imzamızı taşıyorsa indirilir
ve kurulur; imzasız ya da bozuk bir dosya kabul edilmez.

Güncelleme sırasında hizmet birkaç saniye durur, sonra kendi
kendine devam eder. Yeni sürüm açılmazsa bir önceki sürüm
kendiliğinden geri yüklenir.

Elle denetlemek isterseniz (Yönetici Komut İstemi):

      kgarsiv.exe update --check
      kgarsiv.exe update --now


-----------------------------------------------------------
6. KALDIRMA
-----------------------------------------------------------

kaldir.bat dosyasına sağ tıklayıp "Yönetici olarak çalıştır"
seçin. Hizmet durdurulur ve kaydı silinir.

ARŞİV DOSYALARINIZA DOKUNULMAZ. Önizleme klasörü, veritabanı
ve arşivin kendisi yerinde kalır. Yeniden kurarsanız arşiv
baştan taranmaz, kaldığı yerden devam eder.


-----------------------------------------------------------
7. GÜVENLİK — NE YAPAR, NE YAPMAZ
-----------------------------------------------------------

Yapar:
  · Arşivi okur ve listesini çıkarır
  · Önizleme resmi ve sıkıştırılmış video kopyası üretir
    (yalnızca kendi klasöründe)
  · İnternete KENDİSİ bağlanır ve bu kanalı açık tutar

Yapmaz:
  · Arşiv dosyalarınızı silmez, taşımaz, değiştirmez
  · Dışarıdan bağlantı KABUL ETMEZ (modeminizde port
    açılmasına gerek yoktur)
  · İmzasız hiçbir güncellemeyi kurmaz


-----------------------------------------------------------
DESTEK
-----------------------------------------------------------

Liga Technology
Sorun bildirirken şunları ekleyin:
  · logs klasöründeki en yeni günlük dosyası
  · "kgarsiv.exe status" çıktısı
  · Ekranda gördüğünüz hata metni
