# Logo ERP Veritabanı Bağlantısının Kurulması ve Yapay Zeka Yapılandırması

OzBI'ın "Sıfır Ayar" mantığıyla Logo ERP verilerinizle konuşabilmesi için veritabanınıza sadece okuma (read-only) yetkisiyle bağlanması gerekir.

{% stepper %}
{% step %}

#### Ana ekrana giriş yaptıktan sonra üst menüden "**Ayarlar/Bağlantılar**" sekmesine tıklayın.

{% endstep %}

{% step %}

#### Sağ üst köşedeki "**Yeni Ekle"** butonuna basın.

{% endstep %}

{% step %}

#### Açılan listeden "**Logo Yazılım**" bağlantısına tıklayın.

{% endstep %}

{% step %}

#### Karşınıza çıkan düzenleme alanına veritabanı (SQL) erişim bilgilerinizi girin:

* **Host / IP Adresi**
* **Port Numarası** (Genellikle 1433)
* **Veritabanı Adı**
* **Kullanıcı Adı ve Şifre**
* **AI Bağlantısını Seçin** (OzBI AI Connection)
* **AI Modeli Seçin** (Önerilen: GPT-5.4 mini)
  {% endstep %}

{% step %}

#### Ekranın sol altındaki "**Bağlantıyı Test Et"** butonuna tıklayın.

Sunucu bağlantı testinin başarılı (yeşil) olduğunu gördüğünüzde "**Kaydet"** butonuna basarak sayfayı kapatın.
{% endstep %}
{% endstepper %}

### Logo ERP Asistanı ve Firma/Dönem Ayarı (Kritik Adım)

Bağlantınızı kaydedip kapattığınız anda, OzBI arka planda sizin için tüm konfigürasyonları yapar ve üst menüdeki "**Ayarlar/Asistanlar"** ekranınıza otomatik olarak bir **"Logo ERP Asistanı"** ekler. Sıfırdan bir asistan yaratmanıza veya tabloları seçmenize gerek yoktur.

Asistanınızın doğru verilerle (doğru şirket ve yılla) çalışabilmesi için yapmanız gereken **tek ve son bir ayar** bulunmaktadır:

{% stepper %}
{% step %}

#### Üst menüden "**Ayarlar/Asistanlar**" menüsüne gidin.

Sistemin otomatik oluşturduğu **"Logo ERP Asistanı"**'nı bulun ve "**Düzenle**" butonuna tıklayın.
{% endstep %}

{% step %}

#### Sayfayı aşağı kaydırarak "**Sorgu Ek Prompt**" isimli metin kutusunu bulun.

Bu alanda, asistanın Logo veritabanını hatasız okumasını sağlayan standart SQL kuralları hazır olarak beklemektedir. Metnin içindeki "**### Firma ve Dönem"** başlığını bulun. Bu başlığın altındaki örnek firma ve dönem numaralarını, **kendi şirketinizin Logo kodlarıyla** değiştirin. *(Örneğin; sizin şirket kodunuz 015 ve bulunduğunuz yılın dönem kodu 02 ise, metindeki `001` ve `01` ibarelerini buna göre güncelleyin.)*
{% endstep %}
{% endstepper %}

> ⚠️ **Uyarı:** `LG_XXX_YY_` formatındaki tabloların çalışabilmesi için asistanın hangi Firma (XXX) ve Dönem (YY) numaralarına bakacağını bu alandan kesin olarak bilmesi gerekir. Veritabanı mimariniz farklıysa bu alanı IT yöneticinizin veya iş ortağınızın tavsiyesiyle revize edin.

**Asistanınızda varsayılan olarak gelen tam kural seti (Referans İçin):**

```
## Logo ERP SQL Kuralları

### Metin Arama
Şemada "Arama alanı." işaretli kolonlarda (unvan, isim, şehir, açıklama):
1. `=` yerine `LIKE` kullan: `WHERE UPPER(CLC.DEFINITION_) LIKE UPPER(N'%ahmet%')`
2. Her iki tarafı `UPPER()` ile sarmala — collation'a güvenme.
3. Kod alanlarında (CODE, FICHENO, TRANNO, DOCODE vb.) `=` kullan, `LIKE` kullanma.

### Tarih
DATE_ kolonları `DATETIME`. Aralık: `DATE_ >= '2025-01-01' AND DATE_ < '2025-02-01'`. Gruplama: `YEAR(DATE_)`, `MONTH(DATE_)`.

### Firma ve Dönem
Mevcut firmalar:
- 001: MOBART TASARIM (Dönemler: 01)
- 002: MOBART TASARIM ve MOD.YAPI EL.INS.SAN.TIC.LTD.STI. (Dönemler: 01)

Varsayılan: 001 / 01. Belirtilmezse varsayılanı kullan. Çoklu firma/dönem sorularında her kombinasyon için ayrı sorgu yaz, UNION ALL kullanma.
Şemadaki XXX → firma no, YY → dönem no: LG_XXX_YY_INVOICE → LG_001_01_INVOICE

### Tablo Yapısı
- LG_XXX_ → firma kartları, LG_XXX_YY_ → dönemsel hareketler, LV_ → view, L_ → sistem tablosu.
- LG_SLSMAN firma prefix'siz kullanılır.
- Fatura/irsaliye satırları STLINE'dadır: STLINE.INVOICEREF = INVOICE.LOGICALREF, STLINE.STFICHEREF = STFICHE.LOGICALREF
- LINETYPE = 4 → hizmet satırı, STOCKREF → SRVCARD (ITEMS değil).

### Filtreler
- Hareket tabloları (CLFLINE, STLINE, STFICHE, INVOICE, ORFLINE, BNFLINE, KSLINES, CSROLL, CSTRANS, EMFLINE): CANCELLED = 0
- Kart tabloları (CLCARD, ITEMS, BNCARD, BANKACC, KSCARD, SRVCARD, EMUHACC, PROJECT): ACTIVE = 0 (0 = Aktif).

### Borç/Alacak
LG_XXX_YY_CLFLINE (tablo): DEBIT/CREDIT kolonu YOKTUR. Borç/alacak yönü SIGN ile belirlenir:
- SIGN = 0 → Borç, SIGN = 1 → Alacak. Tutar: AMOUNT.
- Bakiye: SUM(CASE WHEN SIGN=0 THEN AMOUNT ELSE 0 END) - SUM(CASE WHEN SIGN=1 THEN AMOUNT ELSE 0 END)

LV_XXX_YY_CLFLINE (view): DEBIT ve CREDIT kolonları hazır gelir. Bu view kullanıldığında SIGN+AMOUNT hesabına gerek yoktur.
⚠ Bu iki yapının kolonları birbirinin yerine KULLANILMAZ. Hangi tablo/view kullanılıyorsa onun kendi kolonları kullanılmalıdır.

### Döviz
Döviz bilgisi taşıyan tablolarda (CLFLINE, BNFLINE, KSLINES, INVOICE, STLINE vb.):
- TRCURR: 0=TL, 1=USD, 20=EUR.
- TRNET: Döviz tutarı, TRRATE: Döviz kuru.
Günlük kurlar: L_DAILYEXCHANGES tablosunda RATES1–RATES4 kolonlarında tutulur.

### Sipariş Bekleyen
LG_XXX_YY_ORFLINE tablosunda: AMOUNT - SHIPPEDAMOUNT (WHERE CLOSED = 0).
```