ŞİMDİ İSTE — KASA POS MASAÜSTÜ AJANI KURULUM KILAVUZU
=====================================================

AMAÇ
  Restoranınızın YEREL kasa POS veritabanına (MSSQL) buluttan erişmek.
  Port açmanız veya statik IP almanız GEREKMEZ: ajan buluta TERS yönde
  (Reverse WebSocket) bağlanır.

PAKET İÇERİĞİ
  SimdiIste-Kasa.exe  : Ajan (kurulum gerektirmez, taşınabilir)
  config.json         : Yapılandırma (restoranınıza ÖZEL anahtar içerir)
  pos-bul.bat         : POS veritabanı bilgilerinizi BULUR (otomatik keşif)
  msnodesqlv8-kur.bat : ŞİFRESİZ bağlantı kurulumu (opsiyonel, aşağıya bakın)
  KURULUM.txt         : Bu kılavuz

──────────────────────────────────────────────────────────────
ADIM 1 — POS BİLGİLERİNİZİ BULUN (en kolay yol)
──────────────────────────────────────────────────────────────
  pos-bul.bat dosyasına ÇİFT TIKLAYIN.
  Açılan siyah pencerede şunları listeler:
    [1] Çalışan SQL Server servisleri
    [2] SQL Server örnek (instance) adları
    [3] 1433 portu dinleniyor mu? (varsayılan MSSQL portu)
    [4] VERİTABANI ADLARI  ← ASIL İHTİYACINIZ BU

  [4] listesinde POS sisteminize ait veritabanını bulun.
  Yaygın adlar:
    YemekPOS    →  YemekPOS_DB
    SambaPOS    →  SambaPOS  (veya SambaPOS5)
    NarPOS      →  NARPOS
    Cento       →  CentoDB / CENTO
  Emin değilseniz: POS programınızı açın → Ayarlar → Veritabanı
  bölümünde de yazar.

──────────────────────────────────────────────────────────────
ADIM 2 — config.json DOSYASINI DÜZENLEYİN
──────────────────────────────────────────────────────────────
  config.json dosyasını Not Defteri ile açın. Şu alanları güncelleyin:

    "mssql": {
      "host": "127.0.0.1",        ← POS veritabanı bu bilgisayardaysa DEĞİŞTİRMEYİN
      "port": 1433,               ← SQL Server portu (varsayılan 1433)
      "database": "YemekPOS_DB",  ← ADIM 1'de bulduğunuz adı yazın
      "trustedConnection": true   ← Windows kimlik doğrulaması (genelde true)
      "user": "",                 ← SQL kullanıcı adı (gerekirse)
      "password": ""              ← SQL şifresi (gerekirse)
    }

  ÖNEMLİ: "pairingToken" ve "serverUrl" alanlarına DOKUNMAYIN —
  bunlar restoranınıza özel olarak panelden üretildi.

  ── BAĞLANTI TÜRÜ (2 seçenek) ──

  SEÇENEK A — ŞİFRESİZ (önerilen, Windows tümleşik kimlik doğrulaması)
     "user" ve "password" alanlarını BOŞ BIRAKIN.
     "trustedConnection": true olsun.
     Ajan, Windows'a giriş yaptığınız kullanıcı ile bağlanır — şifre gerekmez.
     ⚠️ Bunun için paketteki "msnodesqlv8-kur.bat" dosyasını BİR KEZ çalıştırın.
        (ODBC Driver 17 for SQL Server gerektirir; genelde POS PC'lerinde kuruludur.)

  SEÇENEK B — SQL KULLANICI ADI + ŞİFRE
     "trustedConnection": false yapın.
     "user" ve "password" alanlarını SQL Server yöneticinizden alın.
     (SQL Server'da karma mod / Mixed Mode açık olmalı.)

  Hangisini seçeceğinizi bilmiyorsanız: ÖNCE SEÇENEK A'yı deneyin.
  Ajan konsolda hangi yöntemi kullandığını açıkça yazar:
     🔐 Windows tümleşik kimlik doğrulaması ... şifre gerekmez   (Seçenek A)
     🔑 SQL kimlik doğrulaması kullanılıyor (kullanıcı: xxx)      (Seçenek B)

──────────────────────────────────────────────────────────────
ADIM 3 — AJANI ÇALIŞTIRIN
──────────────────────────────────────────────────────────────
  SimdiIste-Kasa.exe dosyasına ÇİFT TIKLAYIN.
  Konsol penceresinde sırayla görmelisiniz:
    📍 Restoran: #<id> | POS: YEMEKP
    💾 Yerel MSSQL Hedefi: 127.0.0.1:1433 [<veritabani>]
    🌐 Bulut Sunucu: https://simdiiste.com
    ✅ [Yerel SQL] MSSQL veritabanına bağlanıldı
    ✅ Buluta bağlanıldı

  Panelde: Restoranlar → ilgili restoran → POS entegrasyonu
  durumu "ÇEVRİMİÇİ" olmalıdır.

──────────────────────────────────────────────────────────────
SORUN GİDERME
──────────────────────────────────────────────────────────────
  ❌ "MSSQL bağlantısı kurulamadı"
     • ADIM 1'i tekrar çalıştırın, veritabanı adını doğrulayın
     • SQL Server servisi çalışıyor mu? ([1] çıktısına bakın)
     • Windows Güvenlik Duvarı "Özel ağlar" için izin verin
     • TCP/IP protokolü açık mı? (SQL Server Configuration Manager)

  ❌ "Buluta bağlanılamadı"
     • İnternet bağlantısını kontrol edin
     • config.json içindeki "serverUrl" https://simdiiste.com olmalı
     • "pairingToken" değiştirilmişse panelden yeniden indirin

  ❌ Ajan açılıp hemen kapanıyor
     • cmd açın, exe'yi sürükleyip Enter'a basın → hata mesajı görünür

  ⚠️ "mssql modülü yüklü değil — simülasyon modunda çalışılıyor"
     • Bu uyarı görünüyorsa ajan SQL Server'a BAĞLANMIYOR demektir.
     • Paketi panelden YENİDEN indirin (güncel exe mssql içerir).
     • Kaynak koddan derliyorsanız: cd agent && npm run tools && npm run build

  ⚠️ "Şifresiz bağlantı istendi ancak msnodesqlv8 sürücüsü bulunamadı"
     • msnodesqlv8-kur.bat dosyasını çalıştırın (bir kez yeter).
     • ODBC Driver 17 for SQL Server kurulu değilse önce onu kurun.
     • Alternatif: config.json'a "user" ve "password" girip
       "trustedConnection": false yapın.

──────────────────────────────────────────────────────────────
GÜVENLİK NOTLARI
──────────────────────────────────────────────────────────────
  • config.json içindeki "pairingToken" restoranınıza özeldir.
    Başkasıyla paylaşmayın. Sızarsa panelden yeniden üretin.
  • Tüm okuma sorguları "WITH (NOLOCK)" ile yürütülür — kasa DONMAZ.
  • Ajan yalnızca DIŞA bağlanır; port açmaz, dışarıdan erişilemez.

DESTEK: kurumsal@simdiiste.com  ·  +90 (850) 532 00 20
