Sistem Gereksinimleri

MüşavirFlow, WordPress üzerinde çalışan modüler bir platformdur. Çekirdek modüller paylaşımlı hosting ortamlarında çalışabilecek şekilde tasarlanmıştır; ancak AI analizi, PDF/OCR işlemleri, dış kaynak okuma ve e-posta gönderim profilleri için sunucu yapılandırmasının doğru hazırlanması gerekir.

Minimum ve önerilen ortam

Gereksinim	Minimum	Önerilen
WordPress	6.4+	6.7+ veya güncel stabil sürüm
PHP	8.1+	8.2 / 8.3
MySQL / MariaDB	MySQL 5.7 / MariaDB 10.3	MySQL 8.0 / MariaDB 10.6+
PHP bellek limiti	256 MB	512 MB veya üzeri
PHP maksimum çalışma süresi	60 sn	120 sn veya üzeri
Dosya yükleme limiti	32 MB	64 MB veya üzeri
Disk yazma izni	`wp-content/uploads/`	PDF, log ve geçici dosya işlemleri için yazılabilir uploads klasörü

Gerekli PHP uzantıları

Uzantı	Durum	Kullanıldığı alan
OpenSSL	Zorunlu	Credential şifreleme, güvenli API bağlantıları ve HTTPS işlemleri.
mbstring	Zorunlu	Türkçe karakterli metin işleme, mevzuat ve e-posta içerikleri.
json	Zorunlu	AJAX, REST, AI ve dış API payload işlemleri.
curl	Önerilen	AI sağlayıcıları, Resmi Gazete, GİB, mevzuat.gov.tr ve Mail Transport API çağrıları.
gd	Önerilen	Görsel, logo ve PDF çıktılarında medya işleme.
imagick	Opsiyonel	Taranmış PDF / OCR kalitesini artıran gelişmiş belge işleme.
zip	Önerilen	Excel/CSV içe aktarma ve dosya paketleme senaryoları.

WordPress yapılandırması

Kalıcı bağlantılar açık olmalıdır. Önerilen yapı: Yazı ismi.
Site saat dilimi Türkiye için UTC+3 / Europe/Istanbul olarak ayarlanmalıdır.
WP-Cron kapatıldıysa sunucu cron'u WordPress cron endpoint'ini düzenli tetiklemelidir.
Dosya izinleri, plugin ve uploads klasörlerinde okuma/yazma işlemlerine izin vermelidir.
Canlı ortamda WP_DEBUG_DISPLAY kapalı olmalı; debug log erişilebilir web path'inde bırakılmamalıdır.

AI özellikleri için ek gereksinimler

AI özellikleri opsiyoneldir. Sirkü yönetimi, E-Posta Merkezi, Vergi Takvimi, Pratik Bilgiler, hesaplama araçları ve temel yayın akışları AI olmadan da çalışır. AI kullanılacaksa AI Merkezi üzerinden en az bir sağlayıcı yapılandırılır ve genel AI özelliği etkinleştirilir.

Sağlayıcı	Bağlantı alanı	Kullanım notu
Google Gemini	`generativelanguage.googleapis.com`	Resmi kaynak okuma, özetleme, RG/Mevzuat analizleri ve uygun görevlerde hızlı yorumlama.
OpenAI	`api.openai.com`	Metin üretimi, SEO yardımcıları ve içerik operasyonları.
Anthropic Claude	`api.anthropic.com`	Uzun metin okuma ve yapılandırılmış mevzuat değerlendirme senaryoları.
MiniMax	Sağlayıcı endpoint'i	PDF/OCR ve önceki belge analiz hatları için teknik sağlayıcı seçeneği.
Grok / xAI	`api.x.ai`	Registry destekli metin sağlayıcı seçeneği; gerçek kullanım yapılandırma ve provider durumuna bağlıdır.

Not: AI sağlayıcıları ayrı ürün paketi değildir. MüşavirFlow içinde AI tek bir yardımcı katman olarak yönetilir; sağlayıcı seçimi teknik yapılandırmadır.

E-posta ve Mail Transport gereksinimleri

E-posta gönderimi için MüşavirFlow yerleşik Mail Transport katmanını kullanır. WordPress varsayılan mail akışı korunabilir; istenirse Custom SMTP, Google, Microsoft 365, Microsoft Graph API, SendGrid veya Mailgun profilleri yapılandırılır.

SMTP kullanılacaksa sunucu çıkış portları hosting tarafından engellenmemiş olmalıdır.
API tabanlı gönderimlerde sağlayıcı API anahtarı veya client bilgileri gerekir.
Alan adı e-posta teslimatı için SPF, DKIM ve DMARC kayıtlarının kontrol edilmesi önerilir.
Kurulumdan sonra dry run, bağlantı testi ve gerçek test maili ayrı ayrı doğrulanmalıdır.

PDF ve OCR desteği

PDF üretimi için uploads klasörü yazılabilir olmalıdır.
Türkçe karakter desteği ve tablo/liste düzeni için PDF motorunun dosya erişimi engellenmemelidir.
Taranmış PDF veya görsel tabanlı belge analizi gerekiyorsa Imagick ve mümkünse Ghostscript önerilir.
OCR desteği bulunmayan hostinglerde metin tabanlı PDF analizi çalışabilir; taranmış belgelerde kalite sınırlı kalabilir.

Dış kaynak bağlantıları

Resmi Gazete, GİB Takipçisi, mevzuat.gov.tr, Open Graph metadata ve AI sağlayıcıları dış bağlantı kullanan alanlardır. Hosting veya güvenlik eklentileri bu bağlantıları engelliyorsa ilgili modüllerde bağlantı, önizleme veya analiz hataları görülebilir.

resmigazete.gov.tr
mevzuat.gov.tr
dijital.gib.gov.tr
Seçili AI sağlayıcısının API endpoint'i
Seçili e-posta sağlayıcısının SMTP veya API endpoint'i

Önerilen kurulum kontrolü

Kurulumdan sonra yalnız eklentinin aktif görünmesi yeterli değildir. İlk doğrulamada Ghost Admin açılmalı, sistem ayarları kaydedilmeli, Mail Transport test edilmeli, bir sirkü taslağı oluşturulmalı, PDF çıktısı alınmalı ve kaynak operasyonları için en az bir manuel bağlantı kontrolü yapılmalıdır.

Dokümantasyon