GÜNÜN SÖZÜ VE BİLGİSİ — 1.0.0 Alpha 2
Forum KPSS / OtoVolt

Gereksinimler: XenForo 2.3+, PHP 8.1+, cURL, OpenSSL, mbstring.
XenForo çekirdek dosyası pakete dahil değildir. Dağıtım paketi API anahtarı veya site verisi içermez.

KURULUM
Önce forum dosyaları ve veritabanını yedekleyin. Alpha sürümü önce test forumunda deneyin.
ZIP içindeki upload klasörünün İÇERİĞİNİ forum köküne yükleyin.
Oluşması gereken yol: src/addons/ForumKpss/DailyInsight/addon.json
Yönetici paneli > Eklentiler > Günün Sözü ve Bilgisi > Yükle.
Arşiv yükleyiciniz zaten açıksa doğrudan ZIP seçebilirsiniz; bu eklenti yükleyiciyi açmanızı gerektirmez.

KULLANIM
Araçlar > Günün Sözü ve Bilgisi.
Önce kaynaklı kısa içerikler ekleyin; metin ve kaynağı kontrol ettiğinizde onay kutusunu işaretleyin.
Üç bağımsız havuz: siteye uygun bilgi, düşünür/filozof sözü ve hadis.
Söz/hadis metni, atıf ve kaynak yönetici tarafından sağlanır. AI söz/hadis uydurmaz.
Hadis çevirisinin doğruluğunu, eser/bölüm/numarayı ve kullanım hakkını ayrıca doğrulayın.
Her yerel günde onaylı havuzdan sıradaki kayıt seçilir; tek kayıt varsa tekrar gösterilir.
Onaylı içerik yoksa ilgili widget gizlenir. Yayına girmiş kaydın metni değişmez;
gizlemek için onayını kaldırın, düzeltme için yeni kayıt ekleyin.
İlk 100 kayıt yönetim ekranında listelenir; büyük arşivler için bu alpha sürümünde sayfalama yoktur.

YERLEŞİM
Görünüm ve diller > Widget'lar > Widget ekle > Günün Sözü ve Bilgisi.
Benzersiz widget anahtarı, başlık, konum ve görüntüleme sırası seçin.
Forum listesi üstü/altı, kenar sütunu ve temanızın tanımladığı diğer widget konumları kullanılabilir.
Her örnekte tür, kart/kompakt görünüm ve kaynak gösterimi ayrı seçilebilir.
Aynı sayfada aynı kartı birden fazla konuma koymayın.
Elle şablon çağırma: <xf:widget key="secilen_widget_anahtari" />
Kaynak gösterimini kapatmadan önce zorunlu atıf/lisans koşullarını kontrol edin.

API SAĞLAYICILARI
OpenAI Responses API, Google Gemini generateContent, Groq chat/completions.
Groq ile xAI Grok farklı servislerdir; bu sürüm Groq destekler.
Model alanına hesabınızda erişilebilir ve JSON çıktı destekli güncel model kimliğini yazın.
API anahtarını ilgili sağlayıcı seçiliyken girip kaydedin. Boş alan kayıtlı anahtarı korur.
Kaldır kutusu sadece seçili sağlayıcının anahtarını kaldırır.
Önce site konusu ve onaylı teknik kaynak notlarını girin, sonra veri aktarım onayını verin.
AI üretimini ayrıca açmanız gerekir. Sağlayıcı ücretlendirmesi kendi hesabınıza aittir;
istek sayısı sınırı parasal bütçe garantisi değildir. Varsayılan durumda API kapalıdır.
Yalnız konu ve kaynak notları seçtiğiniz sağlayıcıya gider. Üye mesajları/tam forum veritabanı taranmaz.
AI internet araştırması yapmaz. Yeni gerçekleri veya güncel fiyatları kendiliğinden doğrulamaz.
Her takvim gününde en fazla BİR teknik bilgi taslağı denemesi yapılır, toplam 800 çıktı token sınırı vardır.
Her AI taslağı yönetici incelemesinde kalır. Onaylamadan önce metin, kapsam, atıf ve kaynağı düzeltin.
Hata veya yarım yanıt günün denemesini tüketir; otomatik ücretli tekrar ve sağlayıcı değiştirme yoktur.
Gün içinde sağlayıcı/saat dilimi değiştirmek normal kullanımda önerilmez.
Anahtar AES-256-GCM ile şifrelenir. Anahtarlar ekran görüntülerinde ve pakette yer almaz.
Sunucu özel anahtarı internal_data/fkdi-master-key.php dosyasında oluşturulur.
internal_data erişimi sunucuda engellenmeli; bu dizini ve veritabanını birlikte güvenle yedekleyin.
Alternatif: src/config.php içinde $config['dailyInsightEncryptionKey'] değerini en az 32 rastgele
karakterlik sunucu sırrı olarak yöneticiniz tanımlayabilir. Anahtarı değiştirmek eski API kayıtlarını açamaz.

ZAMANLAMA VE HATALAR
XenForo görevi her saatin 07 ve 37. dakikalarında kontrol eder. Çalışma ziyaretçi/görev altyapısına bağlıdır;
az trafikte gece yarısı anında değişim garanti edilmez. Sayfa isteği API çağırmaz.
Görev gecikirse önceki onaylı kart gösterilir. Kaynak havuzu günlük seçim için API gerektirmez.
Panelde Günlük görevi kontrol et düğmesi aynı günün seçimini tekrar değiştirmez.
AI açıksa o günün ilk çalıştırılması bir API isteği yapabilir.
HTTP hata kodu tutulur; sağlayıcının ham yanıtı ve anahtar loga yazılmaz.

DEVRE DIŞI BIRAKMA / KALDIRMA
Panelde gösterimi kapatmak widget'ları gizler ve günlük üretimi durdurur.
XenForo eklentiyi devre dışı bırakmak da mümkündür.
Kaldırma içerik ve anahtar tablolarını korur; yeniden kurulum önceki kayıtları geri kullanır.
Kalıcı temizlik istenirse yedekten sonra xf_fkdi_ önekli beş tablo ve yalnız bu eklentinin
internal_data/fkdi-master-key.php dosyası sunucu yöneticisi tarafından kaldırılır.
Diğer forum tablolarını veya XF çekirdek dosyalarını değiştirmeyin.

TEST KAPSAMI
Yerelde 59 politika/sağlayıcı/şifreleme kontrolü ve 27 SQLite adaptörlü zamanlayıcı/önbellek/
onay/hata entegrasyon kontrolü geçmiştir. PHP sözdizimi, XML ve ZIP dosya hashleri doğrulanmıştır.
Bu kontroller canlı sağlayıcı hizmet testi veya tüm tema/sürüm kombinasyonları testi değildir.
Gerçek OtoVolt kurulum sonucu ve ekran görüntüleri resimli rehberde ayrıca belirtilir.