
İlk kodun girdiği gün Hamsayeh'te UserRole üç değer taşıyordu: Admin, Builder ve Resident. Bir kişinin bir rolü vardı, kullanıcı satırında saklanıyor ve token'da taşınıyordu. Bina yönetimi ürünü bu modeli erkenden zorlar, çünkü bir kişi bir binada oturup başka bir binayı yönetebilir ve sistemi de işletebilir. Yönetim bir kişiden diğerine de geçer ve kayıtların bu devri atlatması gerekir.
Vaka çalışması sayfası yalnızca rollerin binaya bağlı olduğunu söylüyor. Oraya varmak nisan ile haziran arasında birkaç değişiklik gerektirdi ve bir veri parçası altı günde iki kez taşındı. Bu yazının ikinci yarısı ilgili bir sorunu ele alıyor: sayfalarını paylaşan bir kitle için kitleye göre bölünmüş bir API.
Eski modelin söyleyemedikleri
Bu yeniden düzenlemenin başladığı gün olan 5 Nisan'da eklenen bir kontrol listesi sorunları adlandırıyor. User.Role "tek bir global rol"dü. Building.CreatedByUserId "hem oluşturma metaverisi hem de aktif erişim kontrolü olarak" kullanılıyordu. Sakin erişimi aktif daire üyeliklerinden çıkarılıyordu ve token tek bir rol gösteriyordu.
Aynı dosya hedefi de koyuyor. Bir kişi binalar arasında aynı anda birden çok atamaya sahip olabilir, bir binanın aynı anda birkaç yöneticisi olabilir ve sakin geçmişi asOfUtc ile sorgulanabilen tarih aralıkları olarak tutulur. Dosya ayrıca yönetim devredildiğinde bina geçmişinin değişmez kalmasını istiyor: "bir atamayı sonlandırıp başka bir atama oluşturarak". Gönüllü yönetici personası aynı şeyi ürün diliyle istiyor: tüm kayıtlar korunarak yeni yöneticiye devir.
Bina rolü için iki ev
5 Nisan'da yaklaşık iki buçuk saat içinde dört commit ilk hamleyi yaptı. UserAccessAssignment, backfill migration'ıyla birlikte zamana bağlı bir kayıt olarak geldi (13 dosya, 2.642 eklenen satır). Oturumlar erişim snapshot'larına geçti, bina yönetimi zamana bağlı atamalardan çözümlenmeye başladı ve front end de bu snapshot'ları benimsedi. 7 Nisan'da enum Admin ve User değerlerine indi.
11 Nisan'da bina rolleri yine taşındı, bu kez kendi BuildingRole aggregate'ine ve tablosuna. UserAccessAssignment tarafında yalnızca sistem düzeyinde erişim kaldı. O commit 35 dosyaya dokundu. Mesajı sonucu anlatıyor ve encapsulation'dan söz ediyor. Altı günlük bir tasarımda neyin yanlış olduğunu kaydetmiyor. Aggregate, burada önemli olan alanlara kırpıldığında şöyle görünüyor:
public sealed class BuildingRole : AggregateRoot
{
public Guid BuildingId { get; private set; }
public Guid UserId { get; private set; }
public BuildingRoleType RoleType { get; private set; }
public Guid? GrantedByUserId { get; private set; }
public Guid? EndedByUserId { get; private set; }
public DateTime EffectiveFromUtc { get; private set; }
public DateTime? EffectiveToUtc { get; private set; }
public bool IsActiveAt(DateTime atUtc)
=> EffectiveFromUtc <= atUtc && (!EffectiveToUtc.HasValue || EffectiveToUtc > atUtc);
}
BuildingRoleType iki değere sahip: Manager ve BoardMember. Sakin olmak ayrı bir olgu; kendi taşınma ve ayrılma tarihleriyle UnitMembership üzerinde tutuluyor. Yani bir binadaki bir kişinin rol satırı, üyelik satırı, ikisi birden ya da hiçbiri olabilir. AuthAccessSnapshotFactory de belirli bir an için bu kaynakları sistem atamaları ve organizasyon bağlantılarıyla birlikte birleştiriyor.
Devir, kontrol listesinin istediği gibi çalışıyor. Bir handler mevcut rolü sonlandırıyor ve yerine gelen kişi için yenisini oluşturuyor, böylece eski satır geçmiş olarak kalıyor. Çakışma denetimi kişi, bina ve rol türü başına çalışıyor; bu da iki farklı kişinin aynı anda bir binayı yönetmesine izin veriyor. Bu denetim uygulama kodunda yaşıyor. Tablodaki index'ler unique değil, dolayısıyla iki yazma yarışırsa veritabanında aynı kişi için çakışan iki satırı engelleyen bir şey yok.
[Authorize] olmayan bir controller
Bu iki hamlenin arasında, 9 Nisan'da, system-admin ve bina yöneticisi erişimini ayıran bir commit, SystemAdminsAdminController için "was missing [Authorize] entirely" diye kaydetti. O commit'teki kodun gösterdiği kadarıyla istekler yine de reddediliyordu: anonim bir çağıran için mevcut kullanıcı id'sini okuma 401 ile başarısız oluyordu ve controller'ın arkasındaki beş handler'ın hepsi sistem admin rolünü denetliyordu. Eksik olan, HTTP katmanındaki bildirimdi. Commit [Authorize(Roles = "Admin")] ekledi ve diğer dört sistem controller'ını düz [Authorize] yerine aynı role yükseltti. Öznitelik bugün o controller'ın üzerinde duruyor.
Kontrol listesi ise ters yönü göstermişti: [Authorize(Roles = ...)] yerine kimliği doğrulanmış erişim ve uygulama düzeyinde denetimler planlıyordu. Kod sonunda ikisine de sahip oldu. Bunun gibi sistem controller'ları rol öznitelikleri taşıyor, handler'lar da bina erişimini AdminAccessHelper, TicketAccessHelper ve DocumentAccessScopeResolver gibi yardımcılarla yeniden denetliyor.
Ayakta kalan varsayım
Kontrol listesi 5 Nisan'da CreatedByUserId alanını adlandırdı, yine de arkasındaki fikir mayıs sonuna kadar yaşadı. Kayıt olan herkes geleceğin yöneticisi, bina oluşturan kişi de o binanın kalıcı yöneticisi sayılıyordu. 19 Mayıs'ta bir bekleme sayfası otomatik yönetici varsayımının yerini aldı. 21 Mayıs'ta başka bir commit gerisini kapattı ve mesajı eski davranışı açıkça yazıyor: üç repository metodu için "treated any creator as a permanent manager regardless of their chosen role" diyor. Aynı mesaj düzeltmenin etkisini de veriyor: "A resident who created the building can no longer reach the admin panel after a page refresh."
Güncel sorguyu kontrol ettim: oluşturanın erişimi artık yalnızca IsOnboardingComplete false iken geçerli. Bu dönemde snapshot factory yönetici erişimini sentezliyor. Sonrasında yalnızca açıkça tanımlanmış aktif bir yönetici rolü sayılıyor. Buna ihtiyaç duyan sihirbazı 3. bölüm ele alıyor.
Başkası tarafından verilen rollerin bir kuralı daha var:
public static bool RequiresAcceptance(BuildingRole role)
=> role.GrantedByUserId.HasValue && role.GrantedByUserId.Value != role.UserId;
public static bool IsAccepted(BuildingRole role, IReadOnlyDictionary<Guid, DateTime?> lastLoginByUser)
=> !RequiresAcceptance(role)
|| (lastLoginByUser.TryGetValue(role.UserId, out var lastLoginAtUtc)
&& lastLoginAtUtc.HasValue
&& lastLoginAtUtc.Value >= role.EffectiveFromUtc
&& lastLoginAtUtc.Value >= role.CreatedAtUtc);
Böyle bir rol, kişi rolün verildiği anda ya da sonrasında başarıyla giriş yapana kadar Pending, sonra Active, sonra Ended olarak raporlanıyor. Yani burada kabul, sonraki bir giriş anlamına geliyor. Bu yardımcıda ayrı bir kabul eylemi yok ve başka bir nedenle yapılan giriş de sayılıyor.
Kural eskiden üç repository sorgusunun içinde satır içi duruyor, bir bina sorgusunun içinde kimlik context'inden giriş etkinliğini join ediyordu. 4 Haziran'daki bir commit bunu üç adımla değiştirdi: aday rolleri yükle, giriş zamanlarını yükle, bellekte filtrele. Mesajı gerekçe vermiyor. Diff'in gösterdiği kadarıyla iki context'e yayılan tek bir LINQ ifadesi ayrı okumalara dönüştü; context bölünmesinin başka yerlerde neye mal olduğunu 4. bölüm ele alıyor. Kural artık iki yerde var, BuildingRoleAcceptanceHelper içinde ve BuildingRepository içindeki özel bir IsAcceptedRole metodunda, iki ayrı kod parçası olarak.
İki host, tek sayfa kümesi
10 Nisan saat 23:08'de tek API, Hamsayeh.Api.Admin ve Hamsayeh.Api.User oldu; paylaşılan altyapı Hamsayeh.Api.Shared içine girdi. Commit 80 dosyaya dokundu ve bölünmeyi "Api.Admin for SystemAdmin, Api.User for BuildingManager/residents" diye tanımladı.
İlk düzeltme 35 dakika sonra geldi: "SubscriptionController was only in Admin API but BuildingManagers need it". İkincisi 00:07'de geldi ve dashboard ile erişim durumu endpoint'lerini taşıdı. Gerekçesi, dashboard ve bekleyen ödeme sayfaları için yazdığı şu ifade: "are accessible to BuildingManagers (no requiredScope="system") but were calling Admin API endpoints".
Sebep front end tarafında. Yönetim portalı, sistem adminlerine ve bina yöneticilerine hizmet eden, bir scope ile ayrılan tek bir kod tabanı:
export type AdminAccessScope = 'building' | 'system'
Sistem scope'uyla requiredScope işaretli bir route, bina yöneticilerini başka yere yönlendiriyor. Bu koruma bir yönlendirmeden ibaret ve sunucu tarafında hiçbir şey kanıtlamıyor. Ama hangi sayfaların yalnızca sisteme ait olduğunu kayda geçirdi; onsuz her sayfa, hangi klasörde durursa dursun, yöneticilere de aitti. Bu sayfalar verilerini sistem adminleri için olduğu söylenen bir host'tan alamazdı.
HTTP metot özniteliklerini grep ile sayınca (iki özniteliği olan bir action iki kez sayılıyor) Api.Admin bugün 8 controller ve 30 özniteliğe, Api.User ise 27 controller ve 209 özniteliğe sahip. Yönetim portalının verilerinin neredeyse tamamı User API'de, 9 Mayıs'tan beri building-manager route önekinin altında. Kodun gösterdiği kadarıyla host'lar sonunda "admin portalına karşı bina portalı"ndan çok "sistem operatörüne karşı geri kalan herkes" ayrımına yaklaştı. Önemli olan sınır sayfa düzeyindeki scope'tu ve host'lar onu izlemek zorunda kaldı.
Auth, 15 Mayıs'a kadar iki host'ta da controller olarak çoğaltılmıştı; o gün Api.Shared içindeki sekiz Minimal API route'u onların yerini aldı ve iki host'a da eşlendi (5 dosya, 149 satır eklendi, 228 satır kaldırıldı). Front end'in istemcileri sonucu üç satırda gösteriyor:
export const adminApiClient = createApiClient(ADMIN_API_BASE_URL) export const userApiClient = createApiClient(USER_API_BASE_URL) export const buildingApiClient = userApiClient
Bir build script'i, check-default-api-client-imports.mjs, istemcinin default import'larını reddediyor, böylece her özellik kullandığı istemciyi adıyla belirtmek zorunda. Bu, seçimi review'da görünür kılıyor. Seçimin doğru olup olmadığını ise söyleyemiyor; yanlış host'a yönlendirilmiş bir sayfa yine geçer.
Bitmeyenler
Kontrol listesi User.Role için "domain, auth ve UI varsayımlarından kaldırılmalı" diyordu. Kaldırılmadı. Enum küçüldü ve hâlâ sistem düzeyindeki denetimlere katılıyor, dolayısıyla o köşede eski model ile yenisi bir arada yaşıyor.
Tüm bunlar için test kanıtı mütevazı. AuthAccessSnapshotFactoryTests içinde üç test var: sakin üyeliği olmayan bir yönetici, bir sakin ve henüz erişimi olmayan bir kişi. Dört güvenlik senaryosu ve bir portallar arası erişim testi Playwright spec'i olarak duruyor. Repoda CI sonucu yok; testlerin neyi kanıtlayıp neyi kanıtlamadığına 7. bölüm dönüyor.
3. bölüm onboarding sihirbazına geçiyor: bekleme sayfasının geldiği ve mayısın büyük bölümünün gittiği yere.
Bu not İngilizce ve Farsça olarak da yayımlandı: İngilizce · Farsça.
