Tapis.Core.Reminders 1.0.6

Tapis.Core.Reminders

Notlar ve hatırlatıcılar modülünün sözleşme paketi. Her ürün (ServiceManagement, HostelManagement) bu paketi kendi API'sinde barındırır ve kendi tenant veritabanında kendi tablolarını tutar. Paket tenant çözümlemesi, kimlik doğrulama ya da ürün varlıkları bilmez; ihtiyaç duyduğu her şeyi port üzerinden alır.

1.0.2'den beri uygulama servisleri ürünün içindedir (kullanıcı kararı S1, 2026-10-13). Paket not, hatırlatıcı, bildirim ve ek servislerinin yalnız arayüzünü verir; implementasyon ürünün kendi repository/UnitOfWork katmanını kullandığı için ürün projesinde yaşar. Paket container'dan DbContext çözmez.

İçerik

Ürüne bağlama

// Program.cs
builder.Services.AddRemindersModule(builder.Configuration);
builder.Services.AddScoped<IReminderDbContextFactory, ServiceManagementReminderDbContextFactory>();

// Uygulama servisleri ürünün kendisindedir (S1): paket yalnız arayüzü tanımlar.
builder.Services.AddScoped<INoteService, NotService>();
builder.Services.AddScoped<IReminderService, HatirlaticiService>();
builder.Services.AddScoped<INotificationService, HatirlaticiBildirimService>();
builder.Services.AddScoped<IAttachmentService, HatirlaticiEkService>();
builder.Services.AddControllers().AddRemindersControllers();
...
app.MapRemindersModule();   // hub

// DbContext.OnModelCreating
builder.ApplyRemindersModel();

Yapılandırma Reminders bölümünden okunur (MaxSleepMinutes, BatchSize, IdleShutdownMinutes, HubConnectionLifetimeMinutes, Attachments:MaxSizeMb, Attachments:AllowedExtensions, Attachments:MaxFilesPerRecord, Attachments:LocalRootPath).

Kurallar

• Uygulama servisi yazan ürün kendi IUnitOfWork/repository'lerini kullanır, DbContext'i doğrudan açmaz; doğrulama FluentValidation validator'ıyla ürün tarafında yapılır (paket DTO'ları ürünün global ValidationFilter'ından geçer); kullanıcıya dönen her ileti ISharedLocalizer ile RemindersLocalizationConsts anahtarından çözülür.
• Kayıtlar varsayılan olarak kişiseldir (Visibility = Personal); işletme kayıtları için aşağıdaki bölüme bakın. Her not/hatırlatıcı sorgusu RecordAccess kuralından geçer, erişilemeyen kayıt olmayan kayıtla aynı 404'ü alır. Bildirimler her zaman OwnerUserId == ben ile süzülür.
• Bildirim yalnız uygulama içidir: e-posta, SMS, WhatsApp gönderilmez ve bunlar için soyutlama yoktur.
• Ek dosyalar yalnız yetki denetimi yapan indirme ucundan akar; depolama anahtarı istemciye hiç verilmez.
• Tüm tarihler yerel saat (Europe/Istanbul) yazılır; modülde UTC kullanılmaz.
• Elle transaction yalnız ürünün yürütme stratejisinin içinde açılır. Ürünler PostgreSQL context'ini EnableRetryOnFailure(3) ile kuruyor; EF, yeniden deneyen bir strateji altında BeginTransaction'ı InvalidOperationException ile reddeder. Yeni bir transaction gerekiyorsa gövde db.Database.CreateExecutionStrategy().ExecuteAsync(...) içine konur ve yeniden denenebilir yazılır (her denemede ChangeTracker.Clear() + veriyi sıfırdan oku). 1.0.0'da alarm turu bu kuralı ihlal ettiği için zamanlayıcı PostgreSQL'de hiç çalışmadı; SQLite testleri yeniden denemediği için göstermedi (regresyon testi: AlarmYenidenDenemeStratejisiTests).

Bildirim modeli ve WebSocket (1.0.6, kırıcı, ürün migration ister)

Kullanıcı kararları 2026-10-19: hatırlatıcının saati bildirimin kendisidir (Apple Anımsatıcılar gibi) ve canlı bildirim WebSocket üzerinden gelir.

• Alarm satırları (HatirlaticiAlarmlar): Kind = Due (saat; saat varsa her zaman vardır, sistem kurar), EarlyWarning (saatten OffsetMinutes dakika önce, göreli) ya da Snooze (mutlak, bir kez çalar, sonra silinir). FireAt bir sonraki çalma anı (null = bu oluşum için çaldı ya da geçti), LastFiredAt son çaldığı an. Durum, deneme sayısı ve hata kolonları yok; tur başarısızsa transaction geri alınır, noktalar yerinde kalır.
• ReminderAlarmPlanner tek kaynaktır: ürün servisleri kayıt/güncelleme (Planla), tamamlama (TamamlanmaDegisti), erteleme (Ertele) için, zamanlayıcı her tetiklenmede (Caldi) çağırır. Tekrarlı hatırlatıcının saati geçtiyse kuralın sonraki oluşumuna ilerler (OccurrenceCount, RRULE COUNT için), göreli satırlar onunla kayar. Geçmiş ve bu an için zaten çalmış nokta kurulmaz.
• Zamanlayıcı yalnız alarm satırlarını günceller; hatırlatıcı satırı (eşzamanlılık damgası) yalnız tekrarlı kayıtta saat ilerlerken değişir. Birlikte gecikmiş noktalardan yalnız en geç olanı bildirim üretir.
• Notification.AlarmId kalktı; FireAt geldi, tekil indeks (ReminderId, FireAt, OwnerUserId).
• Hatırlatıcıda Color ve etiketler (HatirlaticiEtiketleri alt tablosu, notlardaki gibi); GET api/Reminders/Tags.
• DTO: girişte Alarms (mutlak anlar) yerine EarlyWarningMinutes; AddAlarm/RemoveAlarm uçları kalktı. Sınırlar ReminderLimits'te. Yeni ileti anahtarları: EarlyWarningInvalid, EarlyWarningRequiresDueAt.
• RemindersOptions.MaxAttempts ve RetryDelayMinutes kalktı; HubConnectionLifetimeMinutes (15, [1, 30]) geldi.

Hub bağlantı bileti

Hub yalnız WebSocket'tir ve yalnız Master'ın imzaladığı biletle bağlanılır (RemindersHubTicket): audience tapis-hatirlatici-hub, token_use hatirlatici_hub_bilet, kapsam Hatirlatici, hub /api/hubs/reminders, 30 sn. Master POST api/Auth/HatirlaticiHubBileti ile üretir, Gateway durumsuz doğrular, ürün yeniden doğrular: claim'ler → app = Tenancy:UygulamaId → kullanıcı aktif (biletteki tenant'la, IReminderDbContextFactory + IReminderRecipientResolver) → jti tüketimi en son. Bağlantı HubConnectionLifetimeMinutes sonunda kapanır; istemci yeni biletle bağlanır. Pasife alınan kullanıcı en çok bu süre kadar bildirim alabilir (bilinen sınır).

jti deposu ve SignalR grupları süreç içidir: ürün API'leri tek kopya. Birden fazla kopyaya geçilirse paylaşılan depo, backplane ve yeni bir güvenlik incelemesi gerekir.

Ürün kontrol listesi (1.0.6)

1. Migration: HatirlaticiAlarmlar yeniden şekillenir (Kind, OffsetMinutes, FireAt nullable, LastFiredAt; Status/FiredAt/Error/AttemptCount/FromRecurrence kalkar; tekil indeks (ReminderId, Kind, OffsetMinutes)), Hatirlaticilar.OccurrenceCount ve Color, HatirlaticiEtiketleri, Bildirimler.FireAt + yeni tekil indeks. Veri dönüşümü: saati olan her tamamlanmamış hatırlatıcıya Due satırı; bekleyen ve saatten önceki alarmlar EarlyWarning'e (dakika farkı); geçmiş bildirimlerin FireAt'i eski alarmın anından.
2. Servis: Planla/TamamlanmaDegisti/Ertele çağrıları, AddAlarm/RemoveAlarm silinir, TagsAsync, renk/etiket.
3. Validator: ReminderLimits ile erken uyarı, etiket ve renk sınırları; saat yokken erken uyarı reddi.
4. Kimlik: RemindersHubTicket.Scheme adıyla JwtBearer şeması (Master issuer/anahtarı, audience RemindersHubTicket.Audience, HS256, RequireExpirationTime, RequireSignedTokens, ClockSkew 5 sn, MapInboundClaims = false); olaylar TokenOku / DogrulaAsync / BaglantiBitisi'yi çağırır. Şema varsayılan ya da fallback değildir. MapRemindersModule şema ya da çözümleyici yoksa başlangıçta hata verir.
5. Angular imajı nginx: location = /api/hubs/reminders (WebSocket upgrade, access_log off).

Bildirim listesi: görünürlük, arama, süzgeç (1.0.5)

Migration gerekmez (şema aynı). Bildirimler hâlâ yalnız alıcısınındır: OwnerUserId == ben tek erişim kuralıdır, RecordAccess'in işletme kuralı bildirimlere uygulanmaz; hatırlatıcıyla ilişki satır eklemez, yalnız görünürlüğü taşır ve (süzgeçte) eler.

• NotificationDTO.Visibility (RecordVisibility?): kaynak hatırlatıcının şu anki görünürlüğü; hatırlatıcı silinmişse ya da ReminderId boşsa null (arayüz rozet göstermez). Alarmın anlık push DTO'sunda da dolu gelir.
• NotificationQueryDTO: mevcut Skip, Take, SadeceOkunmamis yanında Arama (string?, kırpılır, en çok NotificationQuery.MaxSearchLength = 100, başlık + metinde düz Contains; Türkçe büyük/küçük harf duyarsızlığı ürünün tr_ci collation'ından gelir, paket ToLower/ILike kullanmaz) ve Gorunurluk (NotificationVisibilityFilter: All 0, Personal 1, Business 2; hatırlatıcısı silinmiş bildirimler yalnız All'da).
• NotificationQuery (Tapis.Core.Reminders.Services): ApplyFilter(hatirlaticilar, ownerUserId, sorgu) (owner + okunmamış + arama + görünürlük), Project(hatirlaticilar) (DTO + Visibility), NormalizeSearch, IsSearchValid, IsValidVisibilityFilter.

Ürün kontrol listesi (HostelManagement / ServiceManagement)

1. BildirimRepository.SayfaAsync (ve INotificationService.ListAsync) kendi OwnerUserId == ben / SadeceOkunmamis süzgecini bırakıp bildirimler.ApplyFilter(hatirlaticilar, kullaniciId, sorgu) çağırır; toplam sayı bu süzülmüş sorgudan, sırala (okunmamışlar önce, sonra OlusturmaTarihi azalan) + Skip/Take sonra Project(hatirlaticilar) ile DTO'ya. hatirlaticilar = ürünün Set<Reminder>()'ı (AsNoTracking). UnreadCount sayacı süzgeçsiz kalır (zil rozeti).
2. Validator: Arama için NotificationQuery.IsSearchValid (ya da MaximumLength(100)), Gorunurluk için IsInEnum; mesaj Türkçe, WithMessage ile. Paketin FluentValidation bağımlılığı yoktur.
3. /api-regen, Angular Bildirimler sayfası: visibility rozeti (Kişisel/İşletme; null = rozet yok), arama kutusu, görünürlük süzgeci. Başka kullanıcının satırı hiçbir süzgeçle dönmez.
4. Ürün CLAUDE.md'sindeki bildirim bölümü güncellenir.

İşletme görünürlüğü (1.0.4)

Note ve Reminder bir Visibility taşır: RecordVisibility.Personal (0, varsayılan, mevcut satırlar) ya da Business (1). İşletme kaydını tenant'ın kimliği doğrulanmış her kullanıcı oturumu okur ve yazar (düzenleme, silme, tamamlama, erteleme, alarm, alt madde, etiket, ek). İşletme hatırlatıcısının alarmı tenant'ın her aktif kullanıcısına ayrı bildirim üretir. Kişisele geri almayı yalnız oluşturan (OwnerUserId) yapar; işletmeye alma her yazarın hakkıdır. OwnerUserId yalnız oluşturmada yazılır, hiçbir güncelleme DTO'su onu taşımaz ve görünürlük değişimi onu değiştirmez.

Pakette olanlar

• RecordAccess (Tapis.Core.Reminders.Services): NoteReadable/NoteWritable, ReminderReadable/ReminderWritable, ChecklistItemAccessible, AlarmAccessible, NoteTagAccessible, AttachmentAccessible (ek, üst kaydı okunabiliyorsa okunur; ek + üst kayıt + kural tek sorguda), NoteFilter/ReminderFilter (Gorunurluk süzgeci), CanChangeVisibility, IsValidVisibility, IsOwner, RemoveNonOwnerNotificationsAsync. Boş/boşluk kullanıcı kimliği hiçbir satırla eşleşmez (işletme satırıyla da).
• IReminderRecipientResolver: ActiveUserIdsAsync(DbContext, ct) ve DisplayNamesAsync(DbContext, ids, ct). ReminderDispatchService işletme hatırlatıcısında alıcıları tur başına bir kez, alarmı Fired yapan transaction'ın içinde çözer; her alıcıya bir Notification satırı yazar, commit'ten sonra alıcı başına tek push yollar (mevcut t:{tenant}:u:{user} grubu; yeni grup, Clients.All/User/Others yok; okunmamış sayaçları alıcı başına sorgu değil parça başına gruplu sorguyla). Çözümleyici kayıtsızsa ya da boş dönerse bildirim üretilmez (sahibe ya da başka birine düşülmez). Çözümleyici ReminderDispatchService'e isteğe bağlı enjekte edilir.
• Notification tekil indeksi (AlarmId, OwnerUserId); (ReminderId, FireAt) değişmedi.
• Entity/EF: Visibility (zorunlu, varsayılan 0), indeksler Notlar (Visibility, IsPinned) ve Hatirlaticilar (Visibility, IsCompleted, DueAt).
• DTO: create/update/list/detail'de Visibility; list/detail'de CreatedByName, IsMine; filtre DTO'larında Gorunurluk.

Faz 2 ürün kontrol listesi (HostelManagement / ServiceManagement)

1. Migration: Notlar.Visibility, Hatirlaticilar.Visibility (int, NOT NULL, default 0), iki yeni indeks ve Bildirimler tekil indeksinin AlarmId → (AlarmId, OwnerUserId) olarak değişmesi (/add-migration).
2. Fail-closed kapı: servisler ClientToken çağıranlarını ve boş kullanıcı kimliğini kural değerlendirilmeden ÖNCE reddeder (mevcut FU1 denetimi); paket de boş kimlikte hiçbir şey eşleştirmez, ama bu ikinci savunmadır.
3. RecordAccess her yerde: not, hatırlatıcı, alt madde, alarm/erteleme/tamamlama, etiket, sayaç (Counts), arama, liste ve ek indirme/yükleme/silme sorguları. Elle OwnerUserId == userId yazılmaz. Bildirim sorguları (liste, sayaç, okundu, silme) OwnerUserId == ben olarak KALIR.
4. Çözümleyici: IReminderRecipientResolver'ı ürün ApplicationUser.Aktif == true ile, yalnız verilen DbContext üzerinde uygular (scoped DbContext/HttpContext enjekte etmez; arka plan yolunda ikisi de yoktur), DisplayNamesAsync yalnız görünen adı döner. DI'a kaydedilir.
5. Görünen ad: list/detail DTO'larında CreatedByName (çözümleyiciden, sayfa başına tek sorgu) ve IsMine (OwnerUserId == ben) doldurulur.
6. Bildirim temizliği: işletme kaydı silinirken ya da Personal'a çevrilirken RecordAccess.RemoveNonOwnerNotificationsAsync AYNI SaveChanges'te çağrılır.
7. Görünürlük değişimi: güncelleme DTO'larında Visibility RecordVisibility?'dir; null = mevcut değer korunur (CanChangeVisibility çağrılmaz, bildirim temizliği yapılmaz). Değer doluysa ve mevcuttan farklıysa RecordAccess.CanChangeVisibility ile denetlenir; işletmeden kişisele yalnız oluşturan. OwnerUserId yalnız oluşturmada yazılır, update DTO/mapper onu hiç yazmaz. NoteCreateDTO/ReminderCreateDTO artık NoteUpdateDTO/ReminderUpdateDTO'nun tabanı değildir (ortak taban *InputBaseDTO): mapper'lar buna göre güncellenir.
8. Validator: Visibility için IsInEnum (paketin FluentValidation bağımlılığı yoktur; validator'lar ürünündür). Oluşturmada eksik değer Personal sayılır; güncellemede null mevcut değeri korur (madde 7).
9. Denetim: ürünün denetim interceptor'ı Visibility değişimini zaten kapsar; ayrı kod gerekmez, doğrula.
10. Güvenlik dokümanları (DevelopmentStandards):
    • security/AUTHORIZATION.md, Object-level bölümüne Reminders istisnası: Personal = yalnız OwnerUserId; Business = tenant'ın kimliği doğrulanmış her kullanıcı oturumu okur+yazar; Personal'a geri alma yalnız oluşturan; sahip asla yeniden atanmaz; bildirimler yalnız sahibinindir; erişimin dışı 404; ClientToken reddedilir.
    • security/TENANT-SECURITY.md, Background work bölümüne: işletme alarm dağıtımı yalnız turun tenant DbContext'ini ve döngünün tenantId'sini kullanır, yedek alıcı yoktur, push yalnız mevcut t:{tenant}:u:{user} gruplarına gider.
11. Docs / istemci: ürün CLAUDE.md'si (Notlar & Hatırlatıcılar bölümü), /api-regen, Angular tarafı.

Bilinen sınırlama

Bir alarm turu çalışırken kayıt kişisele çevrilirse (ya da silinirse), o turun yazdığı sahip-dışı bildirim satırları temizlikten sonra kalabilir (yarış). Bu durumda sahip-dışı alıcılar o alarmın başlığını ve metnini bildirim listelerinde görmeye devam edebilir (kayıt az önceye kadar onlara zaten açıktı); satırı kullanıcı silebilir. Alıcı kimlikleri çözümleyiciden olduğu gibi alınır: kenarında boşluk olan kimlik atılır.