Bildirimler

Başlangıç seviyesinde izlenecek yol

Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun, Web yerel kurulumunu tamamlayın ve bu monorepo'yu düzenleyicinizde kökünden açın. Web ayarları apps/web/.env.local'ye aittir; Next.js, .env kökünü okumaz. Varsayılan sahte modda /dashboard, veritabanı olmayan bir demodur; /auth'nin taşınan bir veritabanına ihtiyacı var.

Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır.

1. Test üyesi olarak oturum açın ve mevcut kanal tercihlerini incelemek için Ayarlar → Bildirimler'i açın.

2. Bir çalışma alanında iki test üyesi kullanın ve EMAIL_PROVIDER=local ile davet gibi yerel bir test etkinliğini tetikleyin.

3. Uygulamada veya yerel giden kutusunda yalnızca uygun üyelerin ve etkin kanalların bildirim aldığını doğrulayın. Gerçek üyelere test mesajları göndermeyin.

Özel kod için, sağlanan prompts/README.md ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için prompts/new-app-screen.md veya genel bir sayfa için prompts/new-landing-page.md. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan AGENTS.md, .ai/PROJECT_CONTEXT.md ve eşleşen .ai/ aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın.

• Başlamadan önce
• Terminal temelleri
• Web yerel kurulumu
• Aracı istemleri ve proje belleği

Ürün etkinliği ardışık düzenini kullanma

notification-events.ts, faturalandırma, bütçe, davet, üyelik ve bağlı hesap etkinliklerini yerelleştirilmiş kopya ve üye başına dağıtım planlarıyla eşleştirir. API ve uygulama istemcileri, oturum açılmış çalışma alanının bildirimlerini okur; tercihler uygun kanalları kontrol eder.

Bazı etkinlikler kasıtlı olarak uygulamada kalır. Örneğin, bağlantılı hesap yenileme hataları, belirteç ayrıntılarını açığa çıkarmamalı veya istenmeyen e-postayı tetiklememelidir.

Alıcı tercihlerine saygı gösterin

Her üyeye bağımsız olarak mesaj göndermek yerine mevcut teslimat planlayıcıyı, varsayılan tercihleri ve aktör hariç tutma seçeneklerini kullanın. İşlemsel e-posta hâlâ yapılandırılmış sağlayıcıyı kullanıyor ve kendi teslim sonucunu kaydediyor.

Alıcıları ve durumu doğrulayın

Devre dışı bırakılan bir tercihi, hariç tutulan aktörü, kaldırılan üyeyi, okunmamış/okunmamış davranışı ve başka bir çalışma alanını test edin. Dinamik güncellemeleri erişilebilir tutun ve yerelleştirilmiş mesajları doğrulayın.

• E-posta teslimi
• Bildirim sözlükleri

Kurulum ve yapılandırma

Bildirim servisi (notification-service.ts) çalışma alanı kapsamlı uygulama içi kayıtlar saklar; GET /api/notifications giriş yapmış üyeninkileri listeler ve okundu işaretleme rotası durumu günceller. Kullanıcı başına tercih bayrakları, ürün güncellemeleri ve güvenlik uyarıları gibi kategorileri kapılar.

Üyeler tercihleri /settings/notifications altında yönetir. Platform duyuruları announcement-actions üzerinden yazılır ve aynı hattan teslim edilir.

GET   /api/notifications
PATCH /api/notifications   (mark-read)

Emitted on mutations, e.g.:
  member.left
  member.role_changed

Uygulama iş akışı

Bildirimi başarılı bir mutasyondan sonra yayınlayın — asla yazma commit'inden önce değil. Yükleri yapılandırılmış tutun (tip, çalışma alanı, referanslar), böylece arayüz düz metni ayrıştırmadan işleyebilir ve yönlendirebilir.

Devre dışı bırakılabilen bir kategoriyi teslim etmeden önce tercih bayrağını kontrol edin; güvenlikle ilgili bildirimler (yeni oturum, anahtar değişiklikleri) zorunlu kalmalıdır.

Doğrulama ve sorun giderme

Devre dışı tercihin teslimatı bastırdığını, okundu işaretlemenin oturumlar arasında kalıcı olduğunu, başka bir çalışma alanının kayıtları listeleyemediğini ve duyuruların hedeflenen üyelere ulaştığını doğrulayın. Hacim büyüdüğünde bildirim dağıtımını isteğin kritik yolundan uzak tutun.