Application Foundation · BaseORM
Şemayı tanımlayın, motor gerisini türetsin.
Go için tasarlanmış bir veri erişim motorudur; tablo şeması, migration, yetki filtresi, önbellek ve sayfalama tek bir metadata tanımından türetilir. Kimlik doğrulama veya transport katmanını üstlenmez — dışarıdan verilen bağlamla çalışan bağımsız bir modüldür.
- Durum
- Prototip
- Doğrulanan sürüm
- 2026-07-18
- Erişim
- TODO_CONTENT_CONFIRMATION
Çözdüğü problem
Go projelerinde veri erişim katmanı genellikle elle yazılır: şema, migration, yetki kontrolü ve sayfalama mantığı her serviste yeniden kurulur ve zamanla senkron dışı kalma riski taşır.
BaseORM bunların tek bir metadata tanımından türetilmesini sağlayarak elle senkronizasyon ihtiyacını azaltmayı hedefler.
Nasıl çalışır
Varlığı metadata'da tanımlayın — alanlar, ilişkiler, tenantScoped ve mask bayrakları.
Motor şemayı türetir, migration'ı Atlas ile yürütür.
Sorgu tanımı minimal JOIN'li, parametreli SQL'e derlenir.
Yetki, maskeleme, önbellek ve sayfalama her sorguda otomatik uygulanır.
Doğrulanmış yetenekler
Deterministik SQL derleyicisi
Reflection kullanılmaz; aynı sorgu tanımı her koşuda aynı parametreli SQL'i üretir — bu davranış golden-vektör testleriyle kontrol edilir.
Sorgu içine gömülü yetki
Yetki filtresi SQL'in WHERE koşuluna derlenir; yetkisiz satırların uygulama belleğine taşınmaması hedeflenir.
Sayaç tabanlı önbellek geçersizleştirme
Her varlığın kendi artan sayacı vardır; yazma işleminde sayaç artar ve eski önbellek anahtarları geçersiz sayılır — tarama veya toplu silme gerekmez.
Motor içinde sayfalama seçimi
Küçük sayfalarda LIMIT/OFFSET, derin sayfalarda keyset sorgusu motor tarafından seçilir; sıralamaya birincil anahtar otomatik olarak eklenir.
Mimari ve entegrasyon
BaseORM bağımsız bir Go modülüdür; pgx ve Atlas Community Edition üzerine kurulu kendi deterministik AST→SQL üretici katmanını kullanır.
F0 sözleşmesindeki criteria/SecurityContext/metadata tiplerini ortak şema deposundan içe aktarıp uygular; arayüz tarafı uiHint alanlarını doğrudan geçirir (pass-through), UI'ye özel mantık taşımaz.
Güven ve kontrol modeli
Kimlik doğrulama ve transport katmanını üstlenmez — bu sorumluluklar çağıran servise aittir; BaseORM yalnız kendisine verilen güvenlik bağlamını uygular.
Önbellek geçersizleştirme ve sorgu derleyici davranışı gerçek PostgreSQL'e karşı geliştirme ortamında test edilmektedir; kapsamlı ve bağımsız doğrulanmış bir test raporu henüz yayımlanmadı.
Bilinen sınırlar / geliştirme alanları
Erişim modeli netleşmedi
Erişim biçimi henüz proje sahibi tarafından teyit edilmedi.
Bağımsız performans doğrulaması yok
Önbellek geçersizleştirme maliyetine dair iddialar bir tasarım hedefidir; bağımsız ölçüm veya benchmark raporu henüz yayımlanmadı.
Prototip olgunluk seviyesi
Motor prototip aşamasındadır; üretim yükü altında sertleştirme sürmektedir.
Kanıtlar
Golden-vektör testleri ve gerçek PostgreSQL'e karşı geliştirme-ortamı testleri iç süreçte koşuyor; kamuya açık, bağımsız doğrulanabilir bir test raporu veya kanıt bağlantısı henüz yok. Yayımlandığında bu bölüm güncellenecektir.