Tapis.Core.Infrastructure 1.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Tapis.Core.Infrastructure --version 1.3.0
                    
NuGet\Install-Package Tapis.Core.Infrastructure -Version 1.3.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.Infrastructure" Version="1.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Tapis.Core.Infrastructure" Version="1.3.0" />
                    
Directory.Packages.props
<PackageReference Include="Tapis.Core.Infrastructure" />
                    
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.Infrastructure --version 1.3.0
                    
#r "nuget: Tapis.Core.Infrastructure, 1.3.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.Infrastructure@1.3.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.Infrastructure&version=1.3.0
                    
Install as a Cake Addin
#tool nuget:?package=Tapis.Core.Infrastructure&version=1.3.0
                    
Install as a Cake Tool

Tapis.Core.Infrastructure

ASP.NET Core middleware, EF Core audit/concurrency interceptorları, Refit ürün API client'ları, permission attribute'ları, TapisExceptionHandler, IServiceExceptionHandler uygulaması ve isteğe bağlı Elasticsearch ILogger sağlayıcısı (AddTapisElasticsearch).

Tapis.Core.Shared üzerine ProjectReference.

1.0.4'ten itibaren Guid damga üreten VersiyonSaveChangesInterceptor ve modelBuilder.ConfigureVersiyonluEntities() uzantısı kaldırıldı: damga PostgreSQL'in xmin sistem sütunu (PERSISTENCE-STANDARDS §8).

Yerine modelBuilder.ConfigureXminConcurrency() geldi. Ürün DbContext'i bunu OnModelCreating sonunda, kendi yapılandırmalarından sonra çağırır:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    // ... ürünün kendi yapılandırmaları
    modelBuilder.ConfigureXminConcurrency();
}

Uzantı tabloya eşlenmiş her entity'ye xmin gölge özelliğini concurrency token olarak bağlar; owned, anahtarsız ve türetilmiş TPH tiplerini atlar. Satıra yeni bir sütun eklenmez — xmin PostgreSQL'in zaten tuttuğu sistem sütunudur.

1.0.5: eşleme EF'in standart mekanizmasıyla kurulur — gölge uint xmin özelliği IsRowVersion() olur, Npgsql 7+ convention'ı onu xmin/xid'e eşler (sütun adı ve tipi elle verilmez). Özellik gölge kalır: CLR özelliği olsaydı nesne eşleyiciler istemci damgasını CurrentValue'ya yazar ve kontrol sessizce kapanırdı. Uzantı yalnız Npgsql üzerinde çağrılır (if (Database.IsNpgsql())); yalnız PostgreSQL desteklenir. Paket Npgsql'e bağımlı değildir.

1.0.6: modelBuilder.ConfigureTurkishCaseInsensitive() — Türkçe, büyük/küçük harfe duyarsız ICU collation'ı (tr_ci = tr-TR-u-ks-level2, deterministic: false) modele ekler ve tabloya eşlenmiş her metin özelliğine atar; eski SQL Server TURKISH_CI_AS davranışının PostgreSQL karşılığıdır. PostgreSQL 18+ gerekir (nondeterministic collation ile LIKE/strpos). Harf farkının anlam taşıdığı teknik değerler yapılandırmada .HarfDuyarli() ile işaretlenir. Bu kolonlarda ILIKE ve regex desteklenmez; düz Contains/StartsWith yeterlidir.

if (Database.IsNpgsql())
{
    modelBuilder.ConfigureXminConcurrency();
    modelBuilder.ConfigureTurkishCaseInsensitive();
}

Bu sürümden itibaren paket Npgsql.EntityFrameworkCore.PostgreSQL (10.0.0) paketine bağımlıdır (HasCollation).

Audit interceptor (AuditSaveChangesInterceptor) ve IServiceExceptionHandler değişmedi.

1.0.8: ISistemTanimDbContext ve SistemTanimStore kaldırıldı — Core ürün DbContext'ine bağlı sözleşme taşımaz. Ürün ISistemTanimStore'u (Shared) kendi DbContext'i üzerinden gerçekleştirir; SistemTanim entity'si Shared'da kalır ve ürün DbContext'ine eklenir.

1.0.12: Hata olayı yayıncısı (opt-in). services.AddTanilamaOlayYayini(configuration) çağrılmazsa bağlantı ve hosted service açılmaz. ITanilamaOlayKuyrugu.TryWrite(olay) kullanıcı yolunda senkron çalışır, bekletmez, fırlatmaz; olay sınırlı bellek kanalına girer, arka plan yayıncısı maskeler ve RabbitMQ'ya publisher-confirm ile bırakır (user_id = bağlantı kullanıcısı). Kanal doluysa, olay MaksOlayBayt'ı aşarsa, deneme hakkı bitmişse veya Tanilama:Broker:* (Host, Username, Password, Exchange) eksikse olay düşürülür ve sayılır (Tapis.Core.Tanilama meter'ı); başka kimliğe ya da HTTP'ye yedek yoktur. Uygulama istemcisi topoloji declare etmez. Tüketici Core'da değildir (Master'ın Monitoring klasöründe).

1.0.13: Destek eki köprüsü (opt-in, F2.3). services.AddMasterDestekEkKoprusu(configuration) (Tenancy:MasterUrl/ClientId/ ClientSecret) IMasterDestekEkKoprusuApi'yi kendi named HttpClient'ı ve kendi keyed token sağlayıcısıyla (MasterDestekEkKoprusuServiceCollectionExtensions.TokenProviderKey) kaydeder; token yalnız support.ticket.attachment.read ister. AddMasterDestekKoprusu'nun [write, read] token'ı değişmez: Master bu scope'u client'a vermemişse yalnız ek indirme düşer. EkIndirAsync(MasterDestekTalebiEkIndirDTO) HttpResponseMessage döner (başlıklar önce, gövde tamponlanmaz, 4xx/5xx fırlatmaz). Ürün adapter'ı durumu okur (404 → 404, 429 → 429, token reddi/401/403/taşıma → 503) ve başarılı yanıtı SayanEkAkisi.AcAsync(yanit) ile sarar: akış baytları sayar, DestekEkSinirlari.IndirmeEnFazlaBayt (9.000.000) aşılınca EkBoyutSiniriAsildiException fırlatır, bildirilen Content-Length sınırın üstündeyse hiç okumaz; dispose edilince yanıtı da bırakır (yanıtın ömrü akışa bağlı). HttpResponseMessage ürünün Application port'unu geçmez.

1.0.17: Destek talebi görünürlüğü (eklemeli). IMasterDestekYonetimKoprusuApi.GorunurlukDegistirAsync(MasterDestekTalebiGorunurlukDTO) (UrundenGorunurlukDegistir, support.ticket.manage) güncel detayı döner. Tapis.Core.Shared 2.0.19 gerekir. Ürün: kimlik alanlarını token'dan doldurur, Gorunurluk'u kullanıcıdan aynen iletir; yetki, sahiplik ve "İşletme yalnız açıkken" kuralı Master'dadır.

1.0.19: Bildirim yayıncısı (opt-in, Tapis.Notification). services.AddBildirimYayincisi(configuration) IBildirimYayincisi'ni Bildirim:Broker:* (Host, Port, VirtualHost, Username, Password, Exchange, UseTls, OnayZamanAsimiSaniye) ile kaydeder; bağlantı ilk yayında açılır. EpostaGonderAsync(EpostaBildirimMesajiDTO, ct) mesajı EpostaBildirimDogrulayici ile denetler, serileştirir, 220 KB'ı aşarsa yayınlamaz ve kalıcı, publisher-confirm, mandatory: true olarak routing key eposta ile yayınlar (type = eposta.v1, message_id = MesajId, user_id = bağlantı kullanıcısı). Sonuç Kabul (broker kabul etti, teslim değil), Reddedildi(hatalar) ya da Ulasilamadi(neden): AyarYok, Baglanti, Onaylanmadi, Yonlendirilemedi (basic.return). Ayar eksikse mesaj sessizce düşürülmez, her yayın Ulasilamadi(AyarYok) döner; çağıran kendi "gönderilmedi" durumunu korur. Fırlatmaz; yalnız çağıranın iptali OperationCanceledException'dır. Ek yükleme bu pakette değildir. Tanılama ve bildirim yayıncıları aynı bağlantı kodunu paylaşır, ayrı kullanıcı ve ayrı bağlantıyla çalışır.

1.2.0: Hatırlatıcı tenant listesi köprüsü (opt-in, ARCH-024; kullanıcı kararı 2026-11-19). services.AddMasterHatirlaticiTenantKoprusu(configuration) (Tenancy:MasterUrl/ClientId/ClientSecret) IMasterHatirlaticiTenantApi'yi (GET api/Tenant/HatirlaticiTenantlari, parametresiz: ürün token'ın client'ından belirlenir) kendi named HttpClient'ı ve kendi keyed token sağlayıcısıyla (MasterHatirlaticiTenantKoprusuServiceCollectionExtensions.TokenProviderKey) kaydeder; token yalnız tenant.reminder.list ister (ayrı token, başka scope isteğine eklenmez). Ürün doğrudan API'yi değil IMasterHatirlaticiTenantOkuyucu.OkuAsync(ct)'yi çağırır: yanıt sıkı ayrıştırılır (başarılı zarf, data.tenantIdler var ve Guid.Empty içermez, tekrarlar teke iner); taşıma/401/4xx/5xx/JSON hatası ya da bozuk, kısmi yanıt null (= ulaşılamadı) döner, kısmi liste asla dönmez; log yalnız istisna tipini yazar. Ürünün Tapis.Core.Reminders IReminderTenantKaynagi uygulaması null'u HatirlaticiTenantKaynagiSonucu.Ulasilamadi()'ya, listeyi HatirlaticiTenantKaynagiSonucu.Liste(...)'ye çevirir. Liste yalnız zamanlama ipucudur; veri erişimi her turda ürünün arka plan çözüm yolundandır. Yalnız SM/HM runtime client'ı bu scope'u taşır, *.Provision asla. Tapis.Core.Shared 2.2.0 gerekir.

1.3.0: Push cihaz komutu ve Master hedefli push (cihaz kaydı merkezi tasarımı, 2026-11-20). AddBildirimYayincisi aynı tek örnekle IPushCihazYayincisi'ni de kaydeder; IMasterPushYayincisi yalnız Master'ın çağırdığı AddMasterPushYayincisi() ile (aynı örnek) kaydedilir. IPushCihazYayincisi.KomutGonderAsync(PushCihazKomutuDTO, ct): komutu PushCihazKomutuDogrulayici ile (saat = yayın anı) denetler, 4 KB'ı ölçer, routing key pushcihaz, type pushcihaz.v1 ile yayınlar (kuyruk bildirim.pushcihaz.<uretici>); ret BildirimYayinSonucu.PushCihazHatalari'ndadır. Ürün bunu kendi Infrastructure'ındaki cihaz komutu portunun uygulamasından çağırır; Services katmanı yayıncıya başvurmaz. IMasterPushYayincisi.HedefliPushGonderAsync(PushBildirimMesajiDTO, MasterPushHedefi, ct) yalnız Master içindir: routing key kapalı MasterPushHedefi'nden türer (ServiceManagement → push.sm, HostelManagement → push.hm), serbest routing key yoktur; mesaj yalnız Alicilar ve dolu TenantId ile kabul edilir (AlicilarZorunlu, TenantIdZorunlu, tanımsız hedef HedefGecersiz). Ürün exchange'lerinde bu routing key'lerin bağı yoktur. Token ve kullanıcı/sahip kimliği loglanmaz. Tapis.Core.Shared 2.3.0 gerekir.

Target Framework

  • .NET 10

Installation

dotnet add package Tapis.Core.Infrastructure

Gizli bilgi sertleştirme (1.0.18)

Data Protection kalıcılığı. services.AddTapisDataProtection(configuration, applicationName) anahtarları DataProtection:KeysPath dizinine (yoksa /app/keys) yazar; dizin yoksa oluşturulur. Her ortamda aynı kod yolu çalışır: geliştirme ve testler DataProtection:KeysPath değerini yerel/geçici bir klasöre verir (ör. appsettings.Development.json ya da testte AddInMemoryCollection). applicationName ürün başına farklıdır (Master, HostelManagement, ServiceManagement); anahtarlar ürünler arasında paylaşılmaz. Docker'da ürün başına adlandırılmış volume /app/keys'e bağlanır; yoksa her yeniden başlatmada anahtarlar yenilenir ve önceden üretilmiş şifre sıfırlama/ilk giriş token'ları geçersiz olur.

Kabul edilen risk: Linux konteynerde DPAPI yoktur ve bu turda sertifikayla anahtar şifreleme kurulmadı; anahtarlar diskte şifresiz XML'dir. Koruma volume'a ve dosya sahipliğine dayanır.

Cryptography v2. EncryptString artık v2: + Base64(nonce(12) | etiket(16) | şifreli metin) yazar (AES-256-GCM; anahtar = HKDF-SHA256(passphrase, sabit uygulama tuzu, info tapis-aes-gcm-v2)). DecryptString v2: önekini GCM ile çözer (etiket tutmazsa CryptographicException); önek yoksa eski AES-CBC biçimini okur (yalnız okuma, eski biçim bir daha yazılmaz). Kayıtlar güncellendikçe kendiliğinden v2'ye geçer.

ProductionSecretGuard. RequireMinimumKeyLength(configKey, value) JWT/simetrik/portal anahtarının UTF-8 bayt uzunluğu 32'nin altındaysa her ortamda InvalidOperationException fırlatır. RequireInitialAdminPassword(value, isProduction) IlkYonetici:Sifre için: boş her ortamda, yer tutucu ve 12 karakter altı üretimde reddedilir.

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.3.1 0 11/21/2026
1.3.0 76 11/20/2026
1.2.0 68 11/19/2026
1.1.0 74 11/19/2026
1.0.19 89 11/18/2026
1.0.18 146 10/23/2026
1.0.17 235 10/17/2026
1.0.16 195 10/14/2026
1.0.15 195 10/12/2026
1.0.14 96 10/12/2026
1.0.13 295 10/3/2026
1.0.12 146 10/2/2026
1.0.11 120 10/1/2026
1.0.10 174 10/1/2026
1.0.9 167 9/30/2026
1.0.8 179 9/26/2026
1.0.7 122 9/26/2026
1.0.6 178 9/25/2026
1.0.5 177 9/21/2026
1.0.4 120 9/20/2026
Loading failed

1.3.0 IMasterPushYayincisi yalniz AddMasterPushYayincisi ile (yalniz Master); Push cihaz komutu ve Master hedefli push yayincilari (eklemeli, 2026-11-20, BILDIRIM-CIHAZ-KAYDI-MERKEZI tasarimi): IPushCihazYayincisi.KomutGonderAsync(PushCihazKomutuDTO) routing key pushcihaz, type pushcihaz.v1, saat = yayin ani (TimeProvider), 4 KB olcumu; IMasterPushYayincisi.HedefliPushGonderAsync(PushBildirimMesajiDTO, MasterPushHedefi) routing key yalniz kapali MasterPushHedefi den (ServiceManagement=1 push.sm, HostelManagement=2 push.hm), type push.v1, yalniz Alicilar ve dolu TenantId ile (aksi AlicilarZorunlu / TenantIdZorunlu, tanimsiz hedef HedefGecersiz). BildirimBrokerOptions.PushCihazRoutingKey, MasterPushSmRoutingKey, MasterPushHmRoutingKey; BildirimYayinSonucu.PushCihazHatalari ve PushCihazReddedildi. Ayni yayin altyapisi (kalici, publisher confirm, mandatory + basic.return), AddBildirimYayincisi icinde ayni tek ornek; mevcut yayincilar ve PushGonderAsync degismez. Kimlik (token) ve sahip/kullanici kimligi hicbir loga yazilmaz; log yalniz MesajId, Islem/tur ve hata kodlari. Tapis.Core.Shared 2.3.0 gerekir. 1.2.0 Hatirlatici tenant listesi koprusu (eklemeli, 2026-11-19, personel push tasarimi v2 1.2, ARCH-024): IMasterHatirlaticiTenantApi (Refit, GET api/Tenant/HatirlaticiTenantlari, parametresiz), kendi keyed ClientToken saglayicisi yalniz tenant.reminder.list ister (ayri token), IMasterHatirlaticiTenantOkuyucu.OkuAsync yaniti siki ayristirir (basarili zarf, data ve tenantIdler dolu, Guid.Empty yok, tekrarlar teke iner; bozuk ya da kismi yanit ve her hata null = ulasilamadi, kismi liste asla), AddMasterHatirlaticiTenantKoprusu(IConfiguration) Tenancy:MasterUrl/ClientId/ClientSecret ile. Tapis.Core.Shared 2.2.0 ister. 1.1.0 Push ve SMS yayincilari (eklemeli, 2026-11-19): IPushYayincisi.PushGonderAsync (routing key push, type push.v1) ve ISmsYayincisi.SmsGonderAsync (routing key sms, type sms.v1); ayni yayin altyapisi (mandatory, publisher confirm, yayindan once boyut olcumu), AddBildirimYayincisi icinde tek ornek. IBildirimYayincisi degismez. BildirimYayinSonucu.PushHatalari / SmsHatalari ve PushReddedildi / SmsReddedildi eklendi. Tapis.Core.Shared 2.1.0 gerekir. Bildirim yayincisi (eklemeli, 2026-11-18): IBildirimYayincisi.EpostaGonderAsync -> BildirimYayinSonucu (Kabul / Reddedildi(EpostaDogrulamaHatasi) / Ulasilamadi(BildirimUlasilamamaNedeni)); RabbitMQ: kalici mesaj, publisher confirm, mandatory + basic.return (yonlenmeyen mesaj kabul sayilmaz), routing key eposta, type eposta.v1, message_id MesajId, user_id baglanti kullanicisi, yayindan once 220 KB olcumu. AddBildirimYayincisi(configuration), Bildirim:Broker:* (Host, Port, VirtualHost, Username, Password, Exchange, UseTls, OnayZamanAsimiSaniye); ayar eksikse yayinci Ulasilamadi(AyarYok) doner, sessiz dusurme yok. Tanilama RabbitMQ baglanti kodu ortak sinifa tasindi (davranis ayni). Tapis.Core.Shared 2.0.27 gerekir. Gizli bilgi sertlestirme (KIRICI: Cryptography artik yalniz v2 yazar): AES-256-GCM + HKDF-SHA256, cikti v2: + Base64(nonce(12) + etiket(16) + sifreli metin); eski AES-CBC degerler yalniz okunur, uzunluk denetimi eklendi. AddTapisDataProtection(configuration, applicationName) (DataProtection:KeysPath, varsayilan /app/keys; anahtarlar diskte sifresiz, kabul edilen risk). ProductionSecretGuard.RequireMinimumKeyLength (UTF-8 >= 32 bayt) ve RequireInitialAdminPassword. Shared 2.0.22 gerekir. Destek talebi gorunurlugu (eklemeli): IMasterDestekYonetimKoprusuApi.GorunurlukDegistirAsync (POST api/DestekTalebi/UrundenGorunurlukDegistir, support.ticket.manage, MasterDestekTalebiGorunurlukDTO, guncel detay doner); Tapis.Core.Shared 2.0.19 sozlesmesi gerekir. Kalici destek bildirimleri (eklemeli): IMasterDestekKoprusuApi.BildirimListeAsync/BildirimOkunmamisSayisiAsync (read), IMasterDestekYonetimKoprusuApi.BildirimOkunduAsync/BildirimTumunuOkunduAsync/BildirimTalepOkunduAsync (manage; manage scope kalkarsa okundu isaretleme de kapanir). Shared 2.0.18 gerektirir. Destek sahip islemleri AYRI kopruye tasindi (KIRICI: IMasterDestekKoprusuApi'den dort uc kaldirildi; 1.0.14'u tuketen kod yoktu). Yeni IMasterDestekYonetimKoprusuApi (IptalAsync, GuncelleAsync, SahipYanitiAsync, multipart EkEkleAsync) + AddMasterDestekYonetimKoprusu(IConfiguration): ayri named HttpClient ve ayri keyed IMasterClientTokenProvider, token YALNIZ support.ticket.manage ister. Sebebi: AddMasterDestekKoprusu'nun token'i [write, read] tasir, manage tasimaz; sahip uclari o arayuzde kalsa Master 403 donerdi. Scope'u yapilandirmadan almak yalniz sahip islemlerini kapatir, talep olusturma ve okuma calismaya devam eder. Shared 2.0.17 gerektirir.