Tapis.Core.Portal 1.0.0

Tapis.Core.Portal

Müşteri portalı modül paketi (Reminders gibi: tek paket, ürün *.Services + *.Infrastructure projelerinden referanslar; *.Core referans vermez). Her ürün (HostelManagement, ServiceManagement) bu paketi kendi API'sinde barındırır ve kendi tenant veritabanında kendi tablolarını tutar. Paket tenant bağlantısı çözmez, CariHesap bilmez, veri okuma uçlarını ve maskelemeyi içermez: ihtiyaç duyduğu her şeyi port üzerinden alır.

İçerik ve yön tablosu

Yön tablosu PortalPaketYuzeyiTests ile imza ve metot gövdesi (IL) taramasıyla doğrulanır. Pakette somut controller yoktur.

Kayıt noktaları

// *.Infrastructure/DependencyInjection.cs (Reminders'ın AddRemindersModule emsali)
services.AddTapisPortal(configuration, o =>
{
    o.UrunHarfi = 'H';                    // HM 'H', SM 'S'  (KALICI)
    o.AnahtarBaglami = "hm";              // HM "hm", SM "sm" (KALICI); ilk harf UrunHarfi'nin küçüğü olmak zorunda
    o.VarsayilanIssuer = "HostelManagement";
    o.VarsayilanAudience = "HostelManagement.Portal";
    o.VarsayilanCerezYolu = "/api/hostel/PortalKimlik";
});
services.AddScoped<IPortalVeritabani, UrunPortalVeritabani>();
services.AddSingleton<IPortalYerelSaat, UrunPortalYerelSaat>();
services.AddSingleton<IPortalAydinlatmaKaynagi, UrunAydinlatmaKaynagi>();

// *.HttpAPI/Program.cs
builder.Services.AddTapisPortalAspNetCore(builder.Configuration, builder.Environment);

// DbContext.OnModelCreating  (SIRA ZORUNLU)
builder.ApplyConfigurationsFromAssembly(...);
builder.ApplyRemindersModel();
builder.ApplyTapisPortalModel();
if (Database.IsNpgsql()) { builder.ConfigureXminConcurrency(); builder.ConfigureTurkishCaseInsensitive(); }

PortalSecenekleri varsayılansızdır ve kalıcıdır: UrunHarfi + AnahtarBaglami yayımdan sonra değişirse açık oturumlar ve davetler düşer. Eksik/uyumsuz değer başlangıçta InvalidOperationException; ürün portları kayıtlı değilse uygulama açılmaz.

Port sözleşmesi (güvenlik)

IPortalVeritabani (ihlali tenant karışmasıdır):

• TenantIcinAcAsync(tenantId): yalnız bu sürecin uygulaması (Tenancy:UygulamaId) için, tenant'ı Master üzerinden çözer. Çözülemezse (tenant yok, başka uygulama, pasif, bağlantı yok) null döner; istisna sızdırmaz. Dönen oturumun TenantId'si istenen tenant olmak zorundadır: paket bunu doğrular, uyuşmazsa oturumu kapatıp reddeder.
• IstektenAcAsync(): tenant'ı yalnız doğrulanmış principal'in TenantId claim'inden ve AppId eşitliğinden alır; header, sorgu dizesi, gövde asla.
• İkisi de kurucuda (DI çözülürken) tenant çözmez ve bağlantı açmaz.
• Açılan context denetim interceptor'ı olmadan kurulur (hash/özet işlemleri audit'e girmesin).
• Paket istisnalarda yalnız tür adını loglar (ex.Message ve tenant DB adı asla); port da bağlantı dizesini mesajına koymamalıdır.

Diğer portlar: IPortalMusteriKaynagi (cari kart okuma, işletme adı, işlem geçmişi izi: kod/telefon/token içermeyen sabit metin; yazılamazsa akış bozulmaz), IPortalYerelSaat (işletme yerel saati), IPortalAydinlatmaKaynagi (ürüne özgü metin ve varsayılan sürüm; Portal:AydinlatmaSurumu önceliklidir).

PortalDavetIslemleri (IPortalDavetIslemleri) yetkisizdir: yalnız yetkili personel servisleri buna bağımlı olmalıdır (ürün mimari testi). Tenant parametresi yoktur; koda gömülen tenant IstektenAcAsync oturumunun tenant'ıdır.

Ürün kontrol listesi

1. PortalSecenekleri tüm alanlar; HM H/hm, SM S/sm.
2. ApplyTapisPortalModel sırası: ConfigureXminConcurrency/ConfigureTurkishCaseInsensitive'ten önce.
3. 3 FK CariHesaplar (Restrict): MusteriDogrulamaKayitlari, MusteriCihazlar, MusteriRizalar (CariHesapId); paket FK taşımaz.
4. IPortalVeritabani sözleşmesi (yukarıda), audit interceptor'sız.
5. Maskeleme / allow-list DTO: veri uçları üründe; iç alan sızıntısı reflection testi ürün işi.
6. Somut PortalController / PortalKimlikController aynı adla PortalControllerBase / PortalKimlikControllerBase'ten türer; veri uçları PortalControllerBase altında rıza kapısıyla gelir. Ürün testi PortalUcDenetimi.Dogrula(endpointDataSource) çağırır (hata listesi boş olmalı).
7. Hız sınırı politikaları ürün kaydeder: PortalHizSiniri.KimlikPolitikasi / VeriPolitikasi, bölüm anahtarları KimlikAnahtari / VeriAnahtari. UseRateLimiter, UseAuthentication ve UseAuthorization'dan SONRA çağrılmalıdır (cihaz bölümü doğrulanmış claim'e bakar).
8. PortalJwt:Key ürüne özgü, ortam değişkeniyle; Master (MasterJwt:Key), tenant (Tenancy:SymmetricKey), istemci (Tenancy:ClientSecret) ve diğer ürünün anahtarından farklı.
9. Portal:CerezYolu dar (/api/<ürün>/PortalKimlik); korumalı ortamda başlangıç denetimi zorunlu kılar.
10. Tek kopya varsayımı: negatif tenant önbelleği süreç içidir (singleton örnek); çok kopyada kopya başına tutulur, güvenlik kararı değildir.
11. Gateway'de ürün başına uç listesi (HM Konaklamalar, SM Servisler).
12. Tenancy:UygulamaId geçerli Guid.
13. PortalAyarlari Portal bölümü, PortalJwtAyarlari PortalJwt bölümü; paket Tenancy:UygulamaId, MasterJwt:*, Tenancy:* anahtar adlarını okur.

Hata kodları ve iletiler

100xx kodları SharedErrorCodes'tan (not bulundu 10001, doğrulama 10009, iş kuralı 10020); pakette yalnız farklılar: PortalHataKodlari.Unauthorized = 10010 (HM değeri, SharedErrorCodes.Unauthorized = 10006'dan farklıdır) ve RizaGerekli = 12050 (portal ortak; ürün enum'ları başka anlamda kullanmaz). İletiler düz Türkçe sabit (PortalIletileri), yerelleştirme yok.

Bağımlılıklar

Tapis.Core.Shared (2.0.20), Tapis.Core.Verification (>= 1.0.0), EF Core 10.0.10, Npgsql EF 10.0.0, Microsoft.AspNetCore.Authentication.JwtBearer 10.0.10 (public yüzeyde JwtBearer tipi yoktur).

Tapis.Core.Infrastructure'a bağımlılık yoktur; HarfDuyarli anotasyonu (Tapis:HarfDuyarli) pakette tekrarlanır (PortalHarfDuyarli), Infrastructure ile eşitliği testle kilitlidir (PortalHarfDuyarliTests); host'un ConfigureTurkishCaseInsensitive için Infrastructure >= 1.0.6 kullanması kendi şema kuralıdır. Derlenmiş pakette Tapis.Core.Infrastructure assembly başvurusu da yoktur (test kilitli).

Hata davranışı ve başlangıç sıkılığı

• Bağlantı ilk sorguda açılır: EF bağlantıyı context oluşunca değil ilk komutta açar, bu yüzden "database tenant_x does not exist" gibi sürücü hataları ilk depo çağrısında çıkar. Paket bunları yakalar: JWT doğrulamasında context.Fail (401), Baglan/Yenile yolunda HM'deki genel red kodları (400 / 401), Cikis 204; log'da yalnız istisna tür adı.
• PortalJwt:Issuer/Audience doluysa PortalSecenekleri.VarsayilanIssuer/VarsayilanAudience ile aynı olmak zorundadır (başlangıç hatası).
• PortalKod kurucusu ürün harfi ile bağlam eşleşmesini PortalSecenekleri.Dogrula ile aynı kuralla doğrular.