# LogoBoss ERP Agent — Müşteri Sunucu Kurulum ve Yönetim Kılavuzu

LogoBoss ERP Agent, Logo Go3, Tiger 3 ve Enterprise kurulu müşteri sunucularında çalışan, **modemden port açma ihtiyacını tamamen ortadan kaldıran**, 7/24 arka planda Windows Servisi olarak görev yapan profesyonel bir entegrasyon aracıdır.

---

## 🌟 Temel Mimari ve Avantajları

1. **Sıfır Port Açma (Zero-Port / Outbound Security):**
   - Müşterinin modeminde veya kurumsal güvenlik duvarında (Firewall/Fortinet/Sophos vb.) hiçbir port (`1433` veya `80/443`) açılması gerekmez.
   - Agent, Cloudflare Tüneli veya giden güvenli HTTPS tüneli üzerinden LogoBoss bulut sunucusuna dışarı doğru (Outbound) bağlanır. Kurumsal siber güvenlik standartlarıyla %100 uyumludur.

2. **Otomatik Windows Servisi (7/24 Kesintisiz Çalışma):**
   - Tek tıkla Windows Görev Zamanlayıcısı'na `SYSTEM` yetkisiyle kaydedilir.
   - Sunucu yeniden başlasa bile, oturum açmaya gerek kalmadan Windows açılışında otomatik başlar.

3. **Gömülü FreeTDS & pymssql Motoru:**
   - Müşteri sunucusunda ekstra Microsoft ODBC Driver veya harici yazılım kurulumu gerektirmez.

4. **Merkezi Lisans & Kalp Atışı (Heartbeat):**
   - Her 60 saniyede bir LogoBoss merkezi sistemine durum, CPU/RAM ve bağlantı bilgisi gönderir.
   - Lisans süresi dolduğunda veya dondurulduğunda sorguları otomatik olarak askıya alır.

---

## 🚀 3 Adımda Kolay Kurulum

### Adım 1: Dosyayı Sunucuya İndirin
- LogoBoss yönetim panelinizden (`/dashboard/logoboss-lisanslar`) veya doğrudan aşağıdaki linkten indirin:
  ```
  https://sunucu-adresiniz/downloads/LogoBossAgent.exe
  ```
- `LogoBossAgent.exe` dosyasını sunucuda kalıcı bir dizine (örn: `C:\LogoBoss\`) kopyalayın.

### Adım 2: Yapılandırma ve Test
1. `LogoBossAgent.exe` dosyasına sağ tıklayıp **"Yönetici Olarak Çalıştır"** deyin.
2. **Lisans & Bulut Sekmesi:**
   - **Lisans Anahtarı:** Müşteriye özel oluşturulan lisans anahtarını girin (Örn: `LB-4A8F-9C12-E56B-88F1`).
   - **Merkezi Sunucu:** LogoBoss bulut adresiniz (Varsayılan: `https://logoboss.com.tr`).
3. **Logo MSSQL Sunucu Sekmesi:**
   - **SQL Sunucu:** `localhost` veya SQL Instance adı (Örn: `127.0.0.1\SQLEXPRESS`).
   - **Port:** `1433` (Standart SQL portu).
   - **Veritabanı Adı:** Logo veritabanı adı (Örn: `TIGER3` veya `GO3`).
   - **SQL Kullanıcı Adı & Şifre:** `sa` veya sadece Logo tablolarını okuma/yazma yetkisi verilmiş kullanıcı.
   - **Firma & Dönem No:** Örn: Firma `001`, Dönem `01`.
4. **Bağlantıyı Test Et:**
   - Alt kısımdaki **"🔍 Bağlantıyı Test Et"** butonuna basın.
   - Sistem hem SQL sunucusuna bağlanıp malzeme/cari sayılarını denetler hem de LogoBoss bulut lisansını teyit eder.
   - Ekranda **"Bağlantı Başarılı & Lisans Doğrulandı"** mesajını görün.

### Adım 3: Servis Olarak Başlatma
1. **"🛡️ Kaydet ve Servis Olarak Başlat"** butonuna basın.
2. Ayarlar şifrelenerek yerel sisteme kaydedilir ve Windows Servisi devreye alınır.
3. Durum rozeti yeşil **"● ÇEVRİMİÇİ (SERVİS ÇALIŞIYOR)"** olacaktır.
4. Pencereyi kapattığınızda sistem saatinin yanında (System Tray) arka planda sessizce çalışmaya devam eder.

---

## 🛠️ Komut Satırı & Otomasyon Parametreleri

`LogoBossAgent.exe` hem modern bir grafik arayüz (GUI) hem de sessiz arka plan motoru (Daemon) içerir:

| Komut | Açıklama |
|---|---|
| `LogoBossAgent.exe` | Grafik arayüzü (Ayar ekranı) açar. |
| `LogoBossAgent.exe --daemon` | Ekransız, sessiz Windows servis modunda çalıştırır. |

---

## 🔒 Güvenlik Notları
- Tüm SQL sorguları yalnızca lisans anahtarı doğrulanmış güvenli Bearer Token ile yetkilendirilir.
- Müşterinin SQL şifresi merkezi sunucuya asla gönderilmez; yalnızca yerel makinede şifrelenmiş olarak saklanır.
- Buluttan gelen talepler yalnızca Logo standart veri yapıları üzerinden işlenir.
