> For the complete documentation index, see [llms.txt](https://ozbi.gitbook.io/ozbi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ozbi.gitbook.io/ozbi/hos-geldiniz.md).

# Hoş Geldiniz! 🚀

Merhaba!

Bu doküman, OzBI'ı şirketinizin yerel altyapısına kurmanız, ERP ve veritabanı bağlantılarınızı tanımlamanız ve departmanlarınıza özel yapay zekâ asistanlarını devreye almanız için gereken tüm adımları içerir.

***

#### 🗺️ Dokümantasyon Rehberi & Yol Haritası

Dokümantasyonumuz ihtiyacınıza göre **4 ana modül** altında düzenlenmiştir:

| Modül                                     | Açıklama                                                                | Hızlı Bağlantılar                                                                                                 |
| ----------------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 🧠 **1. Temel Kavramlar & Mimari**        | OzBI'ın çalışma felsefesi, yapay zekâ karar katmanı ve asistan rolleri. | <p>• OzBI Nedir?<br>• Asistanlar Ne İşe Yarar?<br>• Kullanım Modları (Sorgu vs Agent)</p>                         |
| 🔌 **2. Kurulum & Veri Bağlantıları**     | Sunucu gereksinimleri, yerel kurulum ve ERP entegrasyonu.               | <p>• Kurulum ve İlk Adımlar<br>• Veritabanı Nasıl Eklenir?<br>• Logo ERP Bağlantısı<br>• Mikro ERP Bağlantısı</p> |
| 🤖 **3. Asistanlar & Şema Optimizasyonu** | Departman asistanlarını oluşturma, şema eşleme ve ince ayarlar.         | <p>• Asistan Nasıl Oluşturulur?<br>• Asistan Kalibrasyonu<br>• Tablo Şema Yapıları ve YZ Uyumu</p>                |
| 📊 **4. AI Servisleri & Raporlama**       | Model entegrasyonları (Bulut/Yerel) ve interaktif dashboard panoları.   | <p>• OpenAI API Anahtarı<br>• Bulutistan LLMaaS & Yerel Ollama<br>• Dashboard Panoları ve Raporlama</p>           |

#### ⚡ 5 Adımda Hızlı Başlangıç

Sistemi en hızlı şekilde devreye almak için şu akışı izleyebilirsiniz:

1. 💻 **Kurulum:** Sunucunuza OzBI'ı kurun ve yönetici hesabınızı açın.
2. 🔌 **Bağlantı:** Mevcut veritabanınızı veya hazır Logo / Mikro sihirbazını bağlayın.
3. 🤖 **Asistan:** Finans, Satış veya Stok asistanınızı oluşturun.
4. 🧠 **AI Modeli:** Şirket politikanıza uygun AI sağlayıcısını (OpenAI, Bulutistan LLMaaS veya Yerel Ollama) seçin.
5. 📊 **Raporlama:** Sohbetten çıkan analizleri dashboard panonuza sabitleyin.

#### 🛡️ Kurumsal Veri Güvenliği ve Çalışma Mantığı

OzBI, **"Veri Kaynağının Yerel İzolasyonu"** prensibiyle çalışır:

* **Veritabanınız Dışarı Çıkmaz:** Tüm veritabanı kütüğünüz veya ham veri ambarınız asla dışarı kopyalanmaz. Veritabanı bağlantısı ve SQL sorgularının çalıştırılması doğrudan şirketinizin yerel güvenlik duvarının (*Firewall*) arkasında gerçekleşir.