Uyarilar ve Hatirlatmalar
SetGet Uyarilar ve Hatirlatmalar sistemi, calisma alaninizda onemli olaylar meydana geldiginde ekibinize gercek zamanli bildirimler iletir. Bir is ogesinin durumu degistiginde, bir son tarih gectiginde veya bir ekip arkadasiniz sizi bir yorumda etiketlediginde, uyari sistemi dogru kisinin dogru kanaldan dogru zamanda bilgilendirilmesini saglar.
Uyarilar calisma alani duzeyinde calisir ve calisma alani ayarlarinizdaki Hatirlatmalar bolumunden erisilebilir. Sistem uc bildirim kanalini destekler --- uygulama ici, e-posta ve SMS --- ve hangi olaylarin bildirim tetikleyecegi, kimin alacagi ve nasil iletilecegi uzerinde ayrintili kontrol saglar.
Uyarilar neden onemlidir
Bircok hareketli parcaya sahip bir proje yonetimi ortaminda kritik guncellemeler kolayca gozden kacabilir. Bir oncelik yukseltmesi, engellenmis bir is ogesi veya gecen bir son tarih, ekip uyeleri proje panosunu aktif olarak izlemiyorsa fark edilmeyebilir. Uyari sistemi, harekete gecmesi gereken kisilere proaktif olarak bildirim gondererek bu sorunu cozer.
Temel avantajlar:
- Azaltilmis yanit suresi --- Ekip uyeleri kritik degisikliklerden bir sonraki toplantida fark etmek yerine aninda haberdar olur.
- Hesap verebilirlik --- Sorumlular ve paydas kisilere, sahip olduklari veya takip ettikleri is ogeleri guncellendiginde dogrudan bildirim gonderilir.
- Son tarih takibi --- Son tarih hatirlatmalari ve gecikme uyarilari hicbir seyin gozden kacmamasini saglar.
- Denetim izi --- Gonderilen her bildirim teslimat durumuyla birlikte kaydedilir, bu da uyarilarin hedeflenen alicilara ulastigini dogrulamayi kolaylastirir.
Sistem mimarisi
Uyari sistemi alti birbiriyle baglantili alt sistemden olusur:
| Alt Sistem | Amac | Yapilandirma sayfasi |
|---|---|---|
| Trigger'lar | Hangi olaylarin bildirim olusturacagini ve kimin alacagini tanimlar | Trigger'lar |
| Sablonlar | Tutarli bicimlendirme icin kategoriye gore duzenlenmis 21 sistem e-posta sablonu | Sablonlar |
| Durum eslemeleri | Is akisinizdaki durumdan duruma gecisler icin ozellestirilmis uyarilar | Durum eslemeleri |
| SMS yapilandirmasi | Twilio veya HTTP webhook araciligiyla SMS teslimati icin saglayici kurulumu | SMS |
| Tercihler | Her olay turu icin kullanici bazinda kanal secimi | Tercihler |
| Gecmis | Teslimat durumu takibi ve sorun giderme ile gonderim kaydi | Gecmis |
Arka uc, tam uyari yasam dongusunu trigger degerlendirmesinden teslimat onayina kadar desteklemek icin 24 API endpoint, 6 ozel servis ve 6 MongoDB koleksiyonu kullanir.
Yapilandirma is akisi
SetGet'te uyarilarin kurulumu mantiksal bir ilerleme izler. Her adimi hemen tamamlamaniz gerekmez --- sistem kismi yapilandirmayla calisir ve zamanla kapsami genisletebilirsiniz.
Adim 1: SMS kurulumu (istege bagli)
Ekibinizin acil olaylar icin SMS bildirimlerine ihtiyaci varsa, once SMS saglayicinizi yapilandirin. Bu adim istege baglidir; e-posta ve uygulama ici uyarilar herhangi bir SMS yapilandirmasi olmadan calisir.
- Calisma Alani Ayarlari > Hatirlatmalar > SMS bolumune gidin.
- Bir saglayici secin: Twilio veya Genel HTTP webhook.
- Gerekli kimlik bilgilerini girin (ayrintilar icin SMS yapilandirmasi sayfasina bakin).
- Teslimati dogrulamak icin bir test SMS'i gonderin.
TIP
Ekibiniz yalnizca uygulama ici ve e-posta bildirimlerine ihtiyac duyuyorsa bu adimi atlayin. SMS'i her zaman daha sonra ekleyebilirsiniz.
Adim 2: Kullanici tercihleri
Her calisma alani uyesi, her olay turu icin hangi bildirim kanallarini almak istedigini yapilandirabilir.
- Calisma Alani Ayarlari > Hatirlatmalar > Tercihler bolumune gidin.
- Olay-kanal matrisini inceleyin.
- 16 olay turunun her biri icin kanallari (uygulama ici, e-posta, SMS) etkinlestirin veya devre disi birakin.
- Herhangi bir olay icin SMS etkinlestirildiyse, kullanici profilinde bir telefon numarasinin kayitli oldugundan emin olun.
Tam yapilandirma referansi icin Bildirim tercihleri sayfasina bakin.
Adim 3: E-posta trigger'lari
Trigger'lar uyari sisteminin cekirdegini olusturur. Her trigger, bir olay turunu bir sablon ve bir alici grubuyla iliskilendirir.
- Calisma Alani Ayarlari > Hatirlatmalar > Trigger'lar bolumune gidin.
- Trigger Olustur dugmesine tiklayin.
- Olay turunu secin (ornegin,
state_changed,due_date_passed). - Bir e-posta sablonu secin.
- Alicilari tanimlayin (sorumlular, olusturucu, aboneler veya belirli kullanicilar).
- Istege bagli olarak kapsami daraltmak icin kosullar ekleyin.
- Trigger'i etkinlestirin.
Tam 16 olay referansi ve adim adim ornekler icin Trigger'lar sayfasina bakin.
Adim 4: Durum eslemeleri
Belirli durum gecislerinin hedefli bildirimler gerektirdigi is akislari icin durum eslemeleri olusturun.
- Calisma Alani Ayarlari > Hatirlatmalar > Durum Eslemeleri bolumune gidin.
- Esleme Olustur dugmesine tiklayin.
- Kaynak durumu secin (veya "herhangi bir durum" icin bos birakin).
- Hedef durumu secin.
- Bir sablon ve alicilar secin.
- Eslemeyi etkinlestirin.
Kullanim senaryolari ve yapilandirma ayrintilari icin Durum eslemeleri sayfasina bakin.
Adim 5: Sablon onizleme ve test
Trigger'lari uretim ortaminda etkinlestirmeden once, sablonlarinizi dogru sekilde islendiginden emin olmak icin onizleyin ve test edin.
- Calisma Alani Ayarlari > Hatirlatmalar > Sablonlar bolumune gidin.
- Ornek verilerle onizlemek icin herhangi bir sablonu secin.
- Kendinize bir test e-postasi veya SMS gondermek icin Test Gonder dugmesine tiklayin.
- Bicimlendirme, degisken degistirme ve teslimati dogrulayin.
Tam sablon katalogu ve degisken referansi icin Sablonlar sayfasina bakin.
Istatistik paneli
Hatirlatmalar genel bakis sayfasi, calisma alaninizin uyari etkinligini ozetleyen gercek zamanli bir pano goruntüler:
| Metrik | Aciklama |
|---|---|
| Bugun gonderilen e-postalar | Mevcut takvim gununde gonderilen toplam e-posta bildirimleri |
| Bugun gonderilen SMS'ler | Mevcut takvim gununde gonderilen toplam SMS mesajlari |
| Aktif trigger'lar | Su anda etkin olan ve olaylari isleyen trigger sayisi |
| Basari orani | Basariyla teslim edilen (basarisiz olmayan) bildirimlerin yuzdesi |
| Son gonderimler | Durum bilgisiyle birlikte en son bildirim gonderimlerinin canli akisi |
Pano, bildirim sisteminiz icin hizli bir saglik kontrolu saglar. Dusen bir basari orani veya basarisiz gonderimlerdeki ani bir artis, Gecmis sayfasinda arastirilmasi gereken bir yapilandirma veya teslimat sorununa isaret eder.
WARNING
Istatistik panosu calisma alani genelindeki toplamlari yansitir. Bireysel kullanici gonderim sayilari Gecmis sayfasinda filtreleme ile kullanilabilir.
Bildirim kanallari
SetGet uc bildirim kanalini destekler. Her kanalin farkli ozellikleri vardir ve farkli aciliyet seviyelerine uygundur.
Uygulama ici bildirimler
Uygulama ici bildirimler, ust gezinme cubugundaki zil simgesinden erisilen SetGet bildirim panelinde gorunur. En dusuk surtunmeli kanaldir ve aninda eylem gerektirmeyen bilgilendirme guncellemeleri icin idealdir.
Ozellikleri:
- Olay meydana geldiginde aninda teslim edilir
- Yalnizca kullanici SetGet'te aktifken gorunur
- Okundu olarak isaretleme ve toplu kapatma destekler
- Harici bagimliliklari veya yapilandirma gerektirmez
- Ucretsiz ve sinirsiz
En uygun oldugu durumlar: Genel guncellemeler, yorum bildirimleri, etiket degisiklikleri, ozellik guncellemeleri.
E-posta bildirimleri
E-posta bildirimleri, calisma alani SMTP yapilandirmasi kullanilarak kullanicinin kayitli e-posta adresine gonderilir. SetGet disinda kalici bir kayit saglar ve aktif olarak oturum acmamis kullanicilara ulasabilir.
Ozellikleri:
- Calisma alani SMTP sunucusu uzerinden teslim edilir
- 21 sistem sablonu kullanilarak bicimlendirilir
- Is ogesi baglamiyla HTML islemeyi destekler
- Teslimat Gecmis kaydinda izlenir
- Ornek duzeyinde SMTP yapilandirmasi gerektirir
En uygun oldugu durumlar: Durum degisiklikleri, atama guncellemeleri, son tarih hatirlatmalari, etiketlemeler, dongu ve modul guncellemeleri.
SMS bildirimleri
SMS bildirimleri, kullanicinin kayitli telefon numarasina kisa metin mesajlari iletir. En mudahaleci kanaldir ve gercekten acil olaylar icin ayrilmalidir.
Ozellikleri:
- Twilio veya ozel bir HTTP webhook araciligiyla teslim edilir
- Kisa mesaj govdesi ile duz metinle sinirlidir
- Mesaj basina maliyet icerir (Twilio) veya webhook saglayicinizin fiyatlandirmasina baglidir
- SMS saglayici yapilandirmasi ve kullanici basina kayitli telefon numarasi gerektirir
- Teslimat Gecmis kaydinda izlenir
En uygun oldugu durumlar: Gecen son tarihler, engelleyici durum gecisleri, kritik oncelik yukseltmeleri.
TIP
SMS'i az kullanin. Gercekten aninda dikkat gerektiren olaylar icin ayirin. SMS'i asiri kullanmak bildirim yorgunluguna yol acar ve kullanicilarin kanali tamamen devre disi birakmarina neden olur.
Uyarilarin SetGet ile entegrasyonu
Uyari sistemi, SetGet'in temel varliklariyla derinden entegredir. Bu entegrasyon noktalarini anlamak, etkili bir trigger stratejisi tasarlamaniza yardimci olur.
Is ogeleri
Is ogeleri, uyari olaylarinin birincil kaynagıdır. Bir is ogesindeki hemen hemen her degisiklik --- durum, sorumlu, oncelik, etiketler, son tarih, baglantilar, iliskiler, arsiv durumu --- bir bildirim tetikleyebilir. Uyari sistemi bu olaylari, aktoru otomatik abone yapan, sorumlulari abone eden ve diger tum aboneleri bilgilendiren arka uctaki NotificationDispatcher'dan alir.
Donguler
Bir is ogesi bir donguye eklendiginde veya cikarildiginda cycle_changed olayi tetiklenir. Bu, dongu liderlerini yeni isin iterasyonlarina dahil edildigini veya ogelerin kapsam disina cikarildigini bildirmek icin kullanislidir.
Moduller
Benzer sekilde, is ogeleri modullerle iliskilendirildiginde veya cikarildiginda module_changed olayi tetiklenir. Modul sahipleri bu trigger'i kapsam degisikliklerinden haberdar olmak icin kullanabilir.
Yorumlar ve etiketlemeler
comment_added ve mentioned olaylari isbirligi katmaniyla entegre olur. Bir kullanici bir yorumda @etiketlendiginde, is ogesine abone olup olmadigina bakilmaksizin hedefli bir bildirim alir.
Son tarihler
due_date_passed olayi, gecen is ogelerini kontrol eden bir arka plan zamanlayicisi tarafindan degerlendirilir. Kullanici eylemlerinde tetiklenen diger olaylarin aksine, son tarih uyarilari zaman tabanli bir programa gore tetiklenir.
Uyarilar ve otomasyonlar karsilastirmasi
SetGet olaylara yanit veren iki sistem saglar: Uyarilar ve Otomasyonlar. Bazi trigger olaylarini paylassalar da temelden farkli amaclara hizmet ederler.
| Yon | Uyarilar | Otomasyonlar |
|---|---|---|
| Amac | Kisileri olaylar hakkinda bilgilendirmek | Olaylara yanit olarak eylemler gerceklestirmek |
| Cikti | Bildirimler (uygulama ici, e-posta, SMS) | Durum degisiklikleri, atamalar, ozellik guncellemeleri |
| Yapilandirma | Calisma alani duzeyinde Hatirlatmalar ayarlari | Proje duzeyinde Otomasyon ayarlari |
| Kapsam | Calisma alani genelinde | Proje basina |
| Kullanici kontrolu | Kullanici basina kanal tercihleri | Kural duzeyinde etkinlestirme/devre disi birakma |
| Tipik kullanim | "Bir engelleyici olusturuldiginda ekip liderine bildir" | "Yeni hatalari otomatik olarak triyaj kuyruguna ata" |
Birini bilgilendirmek istediginizde uyarilari kullanin. Bir seyi degistirmek istediginizde otomasyonlari kullanin. Bircok is akisinda her ikisini birlikte kullanirsiniz: bir otomasyon bir is ogesini yeni bir duruma tasir ve bir uyari ilgili paydas kisilere bu durum degisikligi hakkinda bildirim gonderir.
Trigger-eylem kurallarini yapilandirma ayrintilari icin Otomasyonlar sayfasina bakin.
Erisim ve izinler
Uyari yapilandirmasi calisma alani duzeyinde izinler gerektirir:
| Eylem | Gerekli rol |
|---|---|
| Uyari yapilandirmasini goruntuleme | Calisma Alani Uyesi |
| Trigger olusturma/duzenleme/silme | Calisma Alani Yoneticisi |
| Durum eslemesi olusturma/duzenleme/silme | Calisma Alani Yoneticisi |
| SMS saglayici yapilandirmasi | Calisma Alani Yoneticisi |
| Sablon onizleme ve test | Calisma Alani Yoneticisi |
| Kisisel bildirim tercihlerini duzenleme | Kimlik dogrulanmis herhangi bir kullanici |
| Gonderim gecmisini goruntuleme | Calisma Alani Yoneticisi |
WARNING
Yalnizca calisma alani yoneticileri trigger, durum eslemesi ve SMS yapilandirmasi olusturup yonetebilir. Normal uyeler yalnizca kendi bildirim tercihlerini duzenleyebilir.
Hizli baslangic kontrol listesi
Uyari sisteminizi calisir hale getirmek icin bu kontrol listesini kullanin:
- [ ] SMTP'nin ornek duzeyinde yapilandirildigini dogrulayin (e-posta uyarilari icin gereklidir)
- [ ] Istege bagli olarak Hatirlatmalar > SMS altinda bir SMS saglayici yapilandirin
- [ ] Yuksek oncelikli bir olay icin en az bir trigger olusturun (ornegin,
state_changedveyadue_date_passed) - [ ] Ekip uyelerinden Hatirlatmalar > Tercihler altinda bildirim tercihlerini incelemelerini isteyin
- [ ] Teslimati dogrulamak icin Sablonlar sayfasindan bir test bildirimi gonderin
- [ ] Basarili teslimati onaylamak icin etkinlestirme sonrasi Gecmis sayfasini izleyin
Veri modeli
Uyari sistemi, yapilandirma ve gecmisi depolamak icin alti ozel MongoDB koleksiyonu kullanir:
| Koleksiyon | Amac | Temel alanlar |
|---|---|---|
alert_triggers | Trigger tanimlarini depolar | event_type, template_id, recipients, conditions, enabled |
alert_templates | Sistem e-posta sablonu meta verilerini depolar | name, category, subject, body, sms_body, variables |
alert_state_mappings | Durum gecisi esleme kurallarini depolar | from_state, to_state, template_id, recipients, enabled |
alert_sms_config | Calisma alani basina SMS saglayici yapilandirmasini depolar | provider, credentials (sifrelenmis), workspace_id |
alert_preferences | Kullanici basina bildirim kanali tercihlerini depolar | user_id, workspace_id, event_channel_map |
alert_history | Teslimat durumuyla birlikte gonderim kaydi kayitlarini depolar | channel, recipient, template, trigger, entity, status, error, timestamp |
Tum koleksiyonlar, calisma alani basina verimli sorgular icin workspace_id uzerinde indexlenmistir. Gecmis koleksiyonunun filtreleme ve pano toplama icin timestamp, status ve channel uzerinde ek indexleri vardir.
API endpoint'leri
Uyari sistemi alt sisteme gore organize edilmis 24 REST API endpoint sunar:
| Alt Sistem | Endpoint'ler | Metodlar |
|---|---|---|
| Trigger'lar | 4 | GET (liste), POST (olustur), PUT (guncelle), DELETE |
| Sablonlar | 3 | GET (liste), GET (onizleme), POST (test gonderimi) |
| Durum eslemeleri | 4 | GET (liste), POST (olustur), PUT (guncelle), DELETE |
| SMS yapilandirmasi | 3 | GET (mevcut yapilandirma), PUT (guncelle), POST (test gonderimi) |
| Tercihler | 3 | GET (mevcut kullanici), PUT (guncelle), POST (varsayilanlara sifirla) |
| Gecmis | 4 | GET (filtreli liste), GET (detay), GET (istatistikler), GET (disari aktar) |
| Pano | 3 | GET (bugunku istatistikler), GET (basari orani), GET (son gonderimler) |
Tum endpoint'ler calisma alani duzeyinde kimlik dogrulama ve uygun rol izinleri gerektirir.
Sorun giderme
| Belirti | Olasi neden | Cozum |
|---|---|---|
| E-posta gonderilmiyor | SMTP yapilandirilmamis veya kimlik bilgileri gecersiz | Ornek SMTP ayarlarini kontrol edin |
| E-posta gonderildi ama alinmadi | Spam filtresi veya yanlis alici adresi | Spam klasorlerini kontrol edin; kullanici e-posta adreslerini dogrulayin |
| SMS teslim edilmedi | SMS saglayici yapilandirilmamis veya gecersiz kimlik bilgileri | SMS sorun giderme sayfasina bakin |
| Trigger tetiklenmiyor | Trigger devre disi veya kosullar cok kisitlayici | Trigger'lar sayfasinda trigger durumunu ve kosullari kontrol edin |
| Basari orani dususyor | Teslimat basarisizliklari birikiyor | Gecmis sayfasinda basarisiz gonderimleri inceleyin |
| Pano istatistikleri guncellenmiyor | Arka plan toplama gecikmesi | Istatistikler her 60 saniyede yenilenir; bekleyin ve yeniden yukleyin |
| Test gonderimi calisiyor ama gercek trigger'lar calismiyor | Trigger kosullari cok kisitlayici | Kosullari inceleyin; test gonderimleri kosullari atlar |
Ilgili sayfalar
- Trigger'lar --- Olay tabanli bildirim trigger'larini yapilandirin
- Sablonlar --- Sistem e-posta sablonlarini goz atin ve onizleyin
- Durum eslemeleri --- Durum gecisi uyarilari olusturun
- SMS yapilandirmasi --- SMS teslimat saglayicilarini kurun
- Bildirim tercihleri --- Kullanici basina kanal yapilandirmasi
- Uyari gecmisi --- Gonderim kayitlarini ve teslimat durumunu goruntuleyin
- En iyi uygulamalar --- Etkili bir bildirim stratejisi tasarlayin
- Otomasyonlar --- Otomatik is akislari icin trigger-eylem kurallari
- Bildirimler genel bakis --- Genel bildirim sistemi