Tapis.Core.Reminders 1.1.0

dotnet add package Tapis.Core.Reminders --version 1.1.0
                    
NuGet\Install-Package Tapis.Core.Reminders -Version 1.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Tapis.Core.Reminders" Version="1.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Tapis.Core.Reminders" Version="1.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Tapis.Core.Reminders" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Tapis.Core.Reminders --version 1.1.0
                    
#r "nuget: Tapis.Core.Reminders, 1.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Tapis.Core.Reminders@1.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Tapis.Core.Reminders&version=1.1.0
                    
Install as a Cake Addin
#tool nuget:?package=Tapis.Core.Reminders&version=1.1.0
                    
Install as a Cake Tool

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

Alan Ne yapar
Entities/ Note, Reminder, ReminderChecklistItem, ReminderAlarm, Notification, Attachment — hepsi OwnerUserId taşır
Persistence/ ApplyRemindersModel(ModelBuilder) ile tablolar ürünün kendi DbContext'ine katılır (xmin damgası ve denetim interceptor'ı böylece otomatik gelir)
Services/ servis arayüzleri (INoteService, IReminderService, INotificationService, IAttachmentService), tekrar kuralı (RecurrenceService), alarm işleyici (ReminderDispatchService) ve ek eşlemesi (AttachmentMap)
RemindersLocalizationConsts ileti ve işlem anahtarları (İngilizce); metinler ürünün kaynak dosyalarında, ISharedLocalizer ile çözülür
Scheduling/ tek dağıtıcı (ReminderDispatcherHostedService), kaynaklı tenant kaydı (ReminderTenantRegistry) ve sinyal — aşağıda "Zamanlayıcı (1.1.0)"
Hubs/ RemindersHub — kullanıcı bazlı grup, NotificationCreated / UnreadCount olayları; RemindersHubTicket (Master'ın bağlantı bileti, ürün tarafı doğrulama) ve tek kullanım deposu
Controllers/ api/Notes, api/Reminders, api/ReminderAttachments, api/ReminderNotifications
Ports/ IFileStorage, IReminderDbContextFactory, IReminderSchedulerSignal, IReminderRealtimeNotifier, IReminderClock, IReminderRecipientResolver; isteğe bağlı IReminderTenantKaynagi, IReminderPushBildirimi (1.1.0)
Services/RecordAccess erişim kuralının tek kaynağı (aşağıda "İşletme görünürlüğü")
Services/ReminderAlarmPlanner bildirim noktalarının tek kaynağı (aşağıda "Bildirim modeli (1.0.6)")

Ü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, TenantListValidityMinutes, DispatchConcurrency, 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 uygulama içidir; 1.1.0'dan beri ürün isteğe bağlı IReminderPushBildirimi ile personel cihazlarına push da gönderebilir (aşağıda). 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).

Zamanlayıcı (1.1.0, davranış değişti, migration gerekmez)

Kullanıcı kararı 2026-11-19 (personel push tasarımı v2, M1): ürün aktif tenant listesini Master'dan alır, zamanlayıcı hep çalışır. 1.0.x'teki Ş11/Ş12 kuralı ("tenant kayda yalnız istekle girer, Master'a tenant listesi sorulmaz") bu kararla değişti; TENANT-SECURITY'de adlı, sınırlı bir istisnadır.

  • Tek dağıtıcı. Tenant başına uzun döngü yok; ReminderDispatcherHostedService her tenant için bir "sonraki an" tutar (TurAsync'in döndürdüğü bekleyen en yakın alarm, en geç MaxSleepMinutes). Tenant yalnız bu an geçince, alarm değişiminde (IReminderSchedulerSignal; canlı tenant'ta alarm tam zamanında çalar) ya da en geç MaxSleepMinutes'ta işlenir. Körlemesine dakikalık sorgu yok. Aynı anda en çok DispatchConcurrency (1–8, varsayılan 4) tenant işlenir; tur sürerken gelen sinyal kaybolmaz (tur bitince tenant hemen yeniden işlenir).
  • İki kaynak (ReminderTenantRegistry): İstek (claim-doğrulamalı istek ve hub bağlantısı; IdleShutdownMinutes = 180 dk) ve Liste (IReminderTenantKaynagi, 5 dk'da bir tazelenir). Başarılı listede olmayan tenant'ın liste kaynağı hemen düşer; istek kaynağı kendi süresiyle kalabilir, tersi de. Liste alınamazsa son başarılı liste en çok TenantListValidityMinutes (1–15, varsayılan 15) dk geçerlidir, sonra bütün liste kaynakları düşer; liste asla süresiz yaşamaz. Geçerlilik 10 dk'nın altına ayarlanırsa tazeleme aralığı onun yarısına iner (liste dolmadan en az bir kez yeniden denenir).
  • Liste yalnız zamanlama ipucudur. Her turda veri erişimi IReminderDbContextFactory.CreateAsync(tenantId) → ürünün ResolveForBackgroundAsync yolundan; tenant pasifse ya da çözülemezse null → tur yok, tenant bir sonraki başarılı liste tazelemesine kadar (liste kaynağı yoksa 5 dk) askıya alınır; bu sürede istek dokunuşu da onu geri getirmez (Master'a sık deneme yok). Listeyi yalnız zamanlayıcı tüketir (test: ZamanlayiciTests.Tenant_kaynagini_yalniz_zamanlayici_cagirir).
  • IReminderTenantKaynagi kayıtlı değilse davranış 1.0.x gibidir: yalnız istek yolundaki canlı tenant'lar.
  • Ürün uygulaması: Tapis.Core.Infrastructure 1.2.0 AddMasterHatirlaticiTenantKoprusu(configuration) + IMasterHatirlaticiTenantOkuyucu.OkuAsync(ct) (null → HatirlaticiTenantKaynagiSonucu.Ulasilamadi(), liste → HatirlaticiTenantKaynagiSonucu.Liste(liste)); ham HttpClient yok. Runtime client'a tenant.reminder.list scope'u verilir, *.Provision client'ına asla.

Bağlantı bütçesi

  • Eşzamanlı: arka planda aynı anda en çok DispatchConcurrency (varsayılan 4) tenant bağlantısı + istek yolunun kendi bağlantıları. Her turun context'i turla açılır ve tur sonunda kapanır (await using); bağlantı tur boyunca tutulmaz.
  • Boşta (Npgsql havuzu): kapanan bağlantı tenant'ın havuzuna döner ve Connection Idle Lifetime (varsayılan 300 sn) boyunca boşta kalabilir; Minimum Pool Size 0 olduğu için sonra kapanır. Bu, Pooling kapatılarak ya da tur sonunda ClearPool çağrılarak değil, turlar arası uzun uyku (sonraki alarm anı) ile sınırlanır.
  • Ölçek hesabı (en kötü durum): son 300 sn içinde işlenmiş her tenant ürün başına, replika başına bir boşta bağlantı tutabilir: tenant × ürün × replika. Örnek: 200 tenant × 2 ürün (SM, HM) × 1 replika = en çok 400 boşta bağlantı. MaxSleepMinutes = 5 (300 sn) ile her liste tenant'ı en geç 5 dk'da bir işlendiği için bu üst sınıra yaklaşılır; MaxSleepMinutes = 30 ile oran yaklaşık 300/1800 ≈ %17'ye (≈ 67 bağlantı) iner. Alarmı yaklaşan tenant'lar sonraki alarm anına göre zaten işlenir; MaxSleepMinutes yalnız başka bir süreçten gelen ve sinyal üretmeyen değişiklikler için emniyettir. PostgreSQL max_connections'ı bu hesaba göre seçilir.

Personel push portu (1.1.0)

IReminderPushBildirimi.GonderAsync(DbContext tenantDb, Guid tenantId, IReadOnlyList<HatirlaticiPushHedefi> hedefler, CancellationToken ct); HatirlaticiPushHedefi { KullaniciId, BildirimId }. ReminderDispatchService'e isteğe bağlı enjekte edilir (kayıtlı değilse hiçbir şey olmaz). Commit'ten sonra, SignalR yayınının yanında, tur başına tek çağrı, o turda üretilen bütün bildirimler için (kişisel ve işletme). Geri alınan turda çağrılmaz; hata yalnız tip adıyla loglanır, yeniden yayın yok (en fazla bir kez). Uygulama yalnız verilen tenantDb'yi ve tenantId'yi kullanır; resolver, fabrika, HttpContext, current-user, UoW, repository almaz.

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).

İşlem anahtarı (1.0.7, eklemeli, ürün migration ister)

ReminderCreateDTO.IslemAnahtari (Guid?) isteğe bağlıdır; boş ya da Guid.Empty eski davranıştır. Paket entity, DTO alanı ve indeksi taşır; servis mantığı üründedir: CreateAsync önce aynı anahtarlı kaydı arar (kayıt sahibi başkasıysa sızdırmadan 409), varsa ilk kaydı döner, yoksa anahtarı yazar; eşzamanlı yarışta tekil indeks ihlali yakalanıp ilk kayıt döner (ServiceManagement #211 deseni). Ürün migration'ı: Hatirlaticilar.IslemAnahtari uuid NULL + tekil indeks IX_Hatirlaticilar_IslemAnahtari ("IslemAnahtari" IS NOT NULL). Önerilen ad: HatirlaticiIslemAnahtari.

Not işlem anahtarı (1.0.8, eklemeli, ürün migration ister)

Hatırlatıcıdaki 1.0.7 kuralının aynısı: NoteCreateDTO.IslemAnahtari (Guid?) isteğe bağlıdır; boş ya da Guid.Empty eski davranıştır. Paket entity, DTO alanı ve indeksi taşır; servis mantığı üründedir: CreateAsync önce aynı anahtarlı notu arar (sahibi başkasıysa sızdırmadan 409), varsa ilk notu döner, yoksa anahtarı yazar; eşzamanlı yarışta tekil indeks ihlali yakalanıp ilk kayıt döner. Ürün migration'ı: Notlar.IslemAnahtari uuid NULL + tekil indeks IX_Notlar_IslemAnahtari ("IslemAnahtari" IS NOT NULL). Önerilen ad: NotIslemAnahtari.

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.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.0 55 11/19/2026
1.0.8 108 11/6/2026
1.0.7 98 11/6/2026
1.0.6 220 10/19/2026
1.0.5 137 10/17/2026
1.0.4 120 10/16/2026
1.0.3 175 10/13/2026
1.0.2 113 10/13/2026
1.0.1 113 10/13/2026
1.0.0 118 10/13/2026

1.1.0 (eklemeli API, ZAMANLAYICI DAVRANISI DEGISTI, migration gerekmez; kullanici karari 2026-11-19, personel push tasarimi v2 1.3): zamanlayici artik tenant basina dongu degil tek barindirilan dagitici - her tenant icin sonraki an (TurAsync donusu), tenant yalniz o an gecince, IReminderSchedulerSignal gelince ya da en gec MaxSleepMinutes icinde islenir; ayni anda en cok Reminders:DispatchConcurrency (1-8, varsayilan 4) tenant ve bagi. Yeni istege bagli IReminderTenantKaynagi (AktifTenantlarAsync -> HatirlaticiTenantKaynagiSonucu: Ulasilamadi ya da Liste): kayitliysa zamanlayici Master in aktif tenant listesini 5 dk da bir tazeler ve tenant ta kimse cevrimici degilken de calisir (S11/S12 degisti; liste yalniz zamanlama ipucu, veri erisimi her turda IReminderDbContextFactory.CreateAsync); kayit girdileri kaynak tasir (Istek/Liste), basarili listede olmayan tenant in liste kaynagi hemen duser, liste alinamazsa son liste en cok Reminders:TenantListValidityMinutes (1-15, varsayilan 15) gecerli, sonra duser; cozulemeyen tenant bir sonraki liste tazelemesine kadar askida. Kayitli degilse eski davranis (yalniz istek yolu). Yeni istege bagli IReminderPushBildirimi.GonderAsync(DbContext, Guid tenantId, IReadOnlyList of HatirlaticiPushHedefi {KullaniciId, BildirimId}, ct): ReminderDispatchService commit ten sonra SignalR yayininin yaninda tur basina tek cagri, kisisel ve isletme hatirlaticilarinin hepsi; geri alinan turda cagrilmaz, hata yalniz tip adiyla loglanir, yeniden yayin yok. ReminderTenantRegistry nin public Dusur ve tenant basina BekleAsync uyeleri kalkti (urunlerde kullanilmiyor). 1.0.8 1.0.8 (eklemeli, urun migration ister): not olusturmada islem anahtari (idempotency) - NoteCreateDTO.IslemAnahtari (Guid?, istege bagli), Note.IslemAnahtari ve Notlar.IslemAnahtari uzerinde suzgecli tekil indeks (IslemAnahtari IS NOT NULL); anahtarsiz istek eski davranis. Paket servis kodu tasimaz: ayni anahtarla ikinci olusturmada ilk kaydi donme urunun NoteService.CreateAsync kodundadir. Yukseltmede urun migration eklemelidir. 1.0.7 (eklemeli, urun migration ister): islem anahtari (idempotency) - ReminderCreateDTO.IslemAnahtari (Guid?, istege bagli), Reminder.IslemAnahtari ve Hatirlaticilar.IslemAnahtari uzerinde suzgecli tekil indeks (IslemAnahtari IS NOT NULL); anahtarsiz istek eski davranis. Paket servis kodu tasimaz: ayni anahtarla ikinci olusturmada ilk kaydi donme urunun ReminderService.CreateAsync kodundadir. Yukseltmede urun migration eklemelidir. 1.0.6 (kirici, urun migration ister): saat bildirimin kendisidir - ReminderAlarm yeniden sekillendi (Kind Due/EarlyWarning/Snooze, OffsetMinutes goreli, FireAt nullable, LastFiredAt; Status/FiredAt/Error/AttemptCount/FromRecurrence ve ReminderAlarmStatus kalkti), ReminderAlarmPlanner tek kaynak, Reminder.OccurrenceCount/Color/Tags (ReminderTag), Notification.AlarmId yerine FireAt ve (ReminderId, FireAt, OwnerUserId) tekil indeksi, DTO EarlyWarningMinutes/Color/Tags, AddAlarm/RemoveAlarm kalkti, api/Reminders/Tags, ReminderLimits; hub yalniz WebSocket ve Master bileti (RemindersHubTicket, tek kullanim deposu, HubConnectionLifetimeMinutes), RemindersOptions MaxAttempts/RetryDelayMinutes kalkti. 1.0.5 (migration gerekmez): bildirim listesi - NotificationDTO.Visibility (kaynak hatirlaticinin simdiki gorunurlugu, hatirlatici yoksa null), NotificationQueryDTO.Arama ve Gorunurluk (NotificationVisibilityFilter), NotificationQuery yardimcisi (Normalize/Validate/ApplyFilter/Project); bildirim erisimi yine yalniz OwnerUserId == ben. 1.0.4: Isletme notlari/hatirlatici (kirici, urun migration ister): RecordVisibility (Personal=0, Business=1) ve RecordVisibilityFilter; Note.Visibility, Reminder.Visibility (varsayilan 0) ve indeksler (Visibility, IsPinned) / (Visibility, IsCompleted, DueAt); Notification tekil indeksi AlarmId yerine (AlarmId, OwnerUserId). RecordAccess: erisim kuralinin tek kaynagi (NoteReadable/NoteWritable, ReminderReadable/ReminderWritable, alt madde/alarm/etiket/ek ifadeleri, liste suzgecleri, CanChangeVisibility, RemoveNonOwnerNotificationsAsync); bos kullanici kimligi hicbir satirla eslesmez. Yeni IReminderRecipientResolver (ActiveUserIdsAsync, DisplayNamesAsync): ReminderDispatchService isletme hatirlaticisinda her aktif kullaniciya ayri bildirim uretir (ayni transaction), commit sonrasi alici basina tek push; cozumleyici yoksa ya da bos donerse bildirim uretilmez. DTO'lara Visibility, CreatedByName, IsMine ve Gorunurluk suzgeci eklendi.