Sistem Konsolu — Entegrasyonlar
Sistem Konsolu (/console), platform yöneticileri (süper yönetici) için
ayrılmış bir kontrol panelidir. Entegrasyonlar (/console/integrations)
sayfası, platformun bağlı olduğu 9 dış servis/altyapı entegrasyonunun
durumunu tek panoda gösterir, bir kısmında canlı bağlantı testi ve bildirim
kanallarında (SMTP e-posta, SMS, WhatsApp) yapılandırma yapmanızı sağlar.
Entegrasyonlar sayfası yalnızca süper yönetici yetkisine sahip platform operatörlerine açıktır. Firma (tenant) kullanıcıları bu ekranı görmez.
Pano yaklaşık 30 saniyede bir otomatik tazelenir; başlığın yanında "Son kontrol" saati görünür. Bu bir sağlık raporudur: bir (veya birden çok) entegrasyon çökük olsa bile sayfa hata vermez — ilgili kart kırmızı Kapalı rozetiyle görünür.
Durum rozetleri
Her kartın sağ üstünde entegrasyonun genel durumu görünür:
| Rozet | Anlamı |
|---|---|
| Çalışıyor | Entegrasyon yapılandırılmış ve erişilebilir/sağlıklı. |
| Kısmi | Çalışıyor ama tam sağlıklı değil (ör. bağlantılardan bir kısmı sorunlu, devre toparlanıyor, canlı bağlantı yok). |
| Kapalı | Yapılandırılmış ama erişilemiyor / devre kesik. |
| Ayarlanmadı | Gerekli yapılandırma (adres, kimlik bilgisi, kayıt) henüz yok. |
Rozetin altında ayrıca Ayarlı / Ayarlanmadı göstergesi, kısa bir açıklama ve entegrasyona özgü meta bilgiler (sayımlar/bayraklar) listelenir.
Yapılandırılabilir kanalların (SMTP, SMS, WhatsApp) kartlarında ek olarak:
- Kaynak rozeti — kanalın o an hangi yapılandırmayla çalıştığı: DB (konsoldan girilen yapılandırma etkin) veya Env (sunucu ortam değişkenlerindeki varsayılanlar etkin). Konsol yapılandırması kaydedilmemiş ya da kapalıysa kanal Env ile çalışır.
- "Son test" göstergesi — kanal için en son yapılan bağlantı testinin zamanı ve sonucu (başarılı/başarısız + kısa hata özeti). Yapılandırmayı değiştirdikten sonra testin güncel olup olmadığını buradan anlarsınız.
Kartlar yalnızca "ayarlı mı" bilgisini ve durumu gösterir. Parola, API anahtarı, bağlantı adresi içindeki kimlik bilgisi gibi değerler bu ekranda hiçbir zaman görünmez (yapılandırma penceresi dahil — aşağıya bakın). Test sonuç mesajları da kimlik bilgisi içermez.
9 entegrasyon kartı
| Kart | Ne izlenir | Meta bilgiler |
|---|---|---|
| SMTP E-posta | E-posta sunucusu yapılandırması + gönderim devre kesici durumu (devre açık → Kapalı, yarı açık → Kısmi). | Dakikalık hız limiti. |
| WhatsApp Bridge | WhatsApp köprüsünün yapılandırması + canlı bağlantı durumu (köprü bağlı → Çalışıyor; erişilemiyor → Kapalı; bağlı değil → Kısmi). | Köprü oturum durumu. |
| SMS (Posta Güvercini) | SMS sağlayıcısı kimlik bilgilerinin varlığı. Devre kesici/hız limiti bu kanalda izlenmez. | — |
| MQTT (Uygulama) | Uygulamanın kendi MQTT istemcisinin broker bağlantısı (bağlı ve sağlıklı → Çalışıyor). | — |
| EMQX Broker | MQTT broker'ına ağ erişimi (TCP probe). | Yönetim REST arayüzünün yapılandırılıp yapılandırılmadığı. |
| Redis | Önbellek/kuyruk sunucusuna PING (yanıt süresi açıklamada görünür). | — |
| OSOS DSO | Aktif DSO (dağıtım şirketi) bağlantılarının devre kesici toplamı: devresi kesik bağlantı varsa Kapalı, toparlanan varsa Kısmi. | Bağlantı sayısı, devresi kesik sayısı. |
| OCPP Şarj Ağı | Kayıtlı şarj cihazı sayısı + çevrimiçi cihaz / canlı bağlantı durumu (hiç canlı bağlantı yoksa Kısmi). | Toplam/çevrimiçi cihaz, canlı bağlantı sayısı. |
| EPİAŞ Portal | Kayıtlı EPİAŞ portal hesapları + son yetkilendirme sonucu. | Hesap sayısı, aktif sayısı, son yetkilendirmesi başarılı sayısı. |
"Test Et" — canlı bağlantı testi
SMTP, SMS, EMQX, Redis ve WhatsApp kartlarında Test Et düğmesi bulunur. Düğmeye bastığınızda sistem ilgili servise o anda gerçek bir bağlantı denemesi yapar ve sonucu bir bildirim (toast) olarak gösterir: Bağlantı başarılı ya da Bağlantı başarısız + kısa açıklama. Yapılandırılabilir kanallarda test sonucu ayrıca karttaki "Son test" göstergesine yazılır.
Testler yalnızca bağlantı/erişim doğrulamasıdır ve yan etkisizdir:
- SMTP — sunucuya bağlanır ve (yapılandırılmışsa) kimlik doğrulaması dener; e-posta göndermez.
- SMS — sağlayıcıya (Posta Güvercini) kredi bakiyesi sorgusu yapar; SMS göndermez, ücretlendirme oluşturmaz. Kimlik bilgileri geçerliyse test başarılıdır.
- EMQX — broker'a ağ erişimini ve (yapılandırılmışsa) yönetim arayüzünü yoklar; mesaj yayınlamaz.
- Redis — PING atar (yanıt süresi ms olarak döner).
- WhatsApp — köprünün durum ucunu sorgular; mesaj göndermez.
Diğer kartlarda Test Et bilerek yoktur:
- MQTT (Uygulama) — uygulamanın kendi bağlantısı salt-gözlemdir; kart durumu zaten canlı bağlantıyı yansıtır.
- OSOS / EPİAŞ — bağlantı-bazlı testler kendi yönetim sayfalarında yapılır (karttaki Yönet linki oraya götürür).
- OCPP — cihaz-bazlı canlı bağlantı durumu kartta zaten görünür.
Her Test Et denemesi (hangi entegrasyon, sonuç) Denetim · Güvenlik kaydına işlenir ve Genel Bakış'taki "Son Olaylar" akışında görünür.
"Yapılandır" — SMTP / SMS / WhatsApp yapılandırması
SMTP E-posta, SMS ve WhatsApp kartlarındaki Yapılandır düğmesi, kanalın bağlantı ayarlarını konsoldan girmenizi sağlar — sunucuya dosya/ortam değişkeni müdahalesi gerekmeden.
Alanlar
| Kanal | Yapılandırılabilen alanlar |
|---|---|
| SMTP E-posta | Sunucu adresi (host), port, TLS, gönderen adresi/adı, kullanıcı adı + parola (sır). |
| SMS | Servis adresi (base URL), kullanıcı adı + parola (sır). |
| Yalnızca etkin/kapalı anahtarı. Köprü (bridge) bağlantısı sunucu tarafında yönetildiğinden adres/kimlik alanları konsoldan düzenlenemez (pencerede bilgi notu görünür). |
Her pencerede ayrıca "Etkin" anahtarı vardır: yapılandırma kaydedilmiş olsa bile anahtar kapalıysa kanal sunucu varsayılanlarıyla (Env) çalışmaya devam eder — konsol yapılandırması ancak anahtar açıkken devreye girer.
Parola alanı her açılışta boş gelir; mevcut parola hiçbir zaman ekrana getirilmez. Alanı boş bırakırsanız kayıtlı parola aynen korunur — yalnızca yeni bir değer girdiğinizde değişir. Sırlar veritabanında şifreli saklanır ve hiçbir ekrana/rapora düz metin dönmez.
"Env varsayılanlarına dön"
Yapılandırma penceresindeki "Env varsayılanlarına dön" düğmesi (satır içi onayla) konsoldan girilen yapılandırmayı tamamen siler; kanal, sunucu ortam değişkenlerindeki varsayılanlara geri döner. Karttaki kaynak rozeti DB → Env olarak değişir. Konsol yapılandırmasıyla ilgili bir sorunda hızlı geri dönüş yoludur.
Kaydettikten sonra
- Değişiklik uygulama tarafında anında geçerlidir; arka plan görevlerinde (bildirim gönderen işçiler) en geç ~2 dakika içinde devreye girer — servislerin yeniden başlatılması gerekmez.
- Kaydetme sonrası Test Et ile bağlantıyı doğrulamanız önerilir; sonuç "Son test" göstergesine işlenir.
- Yapılandırma değişiklikleri Denetim · Güvenlik kaydına yazılır (sır değerleri kayda geçmez).
Yapılandırma penceresi kaydetme sırasında "şifreleme yapılandırılmamış" uyarısı gösterirse, platformun sır şifreleme anahtarı sunucuda tanımlı değil demektir — bu durumda konsoldan sır kaydedilemez (güvenlik gereği açık metin yazılmaz). Sistem yöneticinize başvurun; kanal o ana kadar sunucu (Env) varsayılanlarıyla çalışmaya devam eder.
WhatsApp — "Yönet": köprü durumu ve QR eşleştirme
WhatsApp Bridge kartındaki Yönet düğmesi, köprünün (bridge) canlı
yönetim panelini sağdan açılan bir pencere olarak açar. Bu panel, daha önce
ayrı bir sayfada (/admin/whatsapp) bulunan QR eşleştirme ve durum görünümünün
yeni evidir — eski adres otomatik olarak buraya yönlendirilir.
Panelde şunlar bulunur:
- Bağlantı durumu — Bağlı / Bağlanıyor / Bağlı değil / Oturum kapandı. Görünüm panel açıkken 3 saniyede bir kendini tazeler (panel kapalıyken arka planda sorgu yapılmaz).
- Bilgi satırları — eşleşen telefon numarası (maskeli), çalışma süresi (uptime) ve yeniden bağlanma deneme sayacı. Deneme sayısı olağandışı yükselirse panel uyarı gösterir.
- QR kod — köprü bağlı değilken ekranda belirir: telefonda WhatsApp → Bağlı cihazlar → Cihaz bağla ile taranır; eşleşme tamamlanınca durum kendiliğinden Bağlı'ya döner.
- "Oturum kapandı" uyarısı — telefon tarafında oturum sonlandırıldıysa panel yeniden eşleştirme yapılması gerektiğini açıkça söyler (QR yeniden taranır).
- Yenile — durumu elle tazeler.
Bildirimler sayfasındaki WhatsApp kanal kartı, köprü bağlı değil veya oturum kapandı durumundaysa "Eşleştirme gerekli — Entegrasyonlar'da yönet" bağlantısı gösterir; tek tıkla bu panel açık şekilde Entegrasyonlar'a gelirsiniz.
"Yönet" linki
OSOS DSO, OCPP Şarj Ağı ve EPİAŞ Portal kartlarında Yönet linki, ilgili entegrasyonun asıl yönetim sayfasına götürür (OSOS bağlantıları, OCPP ayarları, EPİAŞ API Portalı). WhatsApp Bridge kartındaki Yönet ise sayfa değiştirmez — yukarıda anlatılan köprü yönetim panelini açar. Bağlantı ekleme/düzenleme ve bağlantı-bazlı testler o sayfalarda yapılır; Entegrasyonlar panosu özet görünümdür.
Ne zaman kullanılır?
- Bir kesinti/arıza bildiriminde ilk bakılacak yer: hangi entegrasyon Kapalı / Kısmi?
- SMTP sunucusu veya SMS sağlayıcı bilgileri değiştiğinde yeni ayarları Yapılandır ile girmek ve Test Et ile anında doğrulamak — sunucu müdahalesi olmadan.
- Kanalın konsol yapılandırmasıyla mı (DB), sunucu varsayılanlarıyla mı (Env) çalıştığını kaynak rozetinden görmek; sorunda "Env varsayılanlarına dön" ile hızlı geri almak.
- Bildirim sorunlarında Bildirimler sayfasıyla birlikte kök nedeni ayırt etmek (kanal devresi mi açık, servis mi erişilemez?).
- OSOS/EPİAŞ senkron sorunlarında bağlantı/hesap sağlığını özetten görüp Yönet ile ilgili sayfaya geçmek.