Sıfırdan auth
JWT, refresh token, 2FA, Key Vault entegrasyonu… Her projede aynı ihtiyaç,
her seferinde yeniden yazım — ve her seferinde yeni bir güvenlik yüzeyi.
Oysa bunlar Mab.Identity'de yıllardır paketli.
● Kurumsal .NET üretim motoru — lansman
v12.0.0 · net10.0 · NuGetAynı altyapıyı her projede yeniden yazmayın.
MAB Çopxu; kimlik doğrulamadan çoklu kiracılığa, loglamadan CMS'e uzanan 25+ modüler NuGet paketini (mab framework), Clean Architecture + CQRS hazırlı bir çözüm iskeletini ve bu iskeleti 18 adımda üreten üretim sihirbazını tek çatıda toplar. Ekibiniz artık tekrar eden altyapı kodu değil, ürün yazar.
$ dotnet tool install --global Mab.Studio.Cli --source mab
- Hedef
- .NET 10 · Clean Architecture · CQRS
- Dağıtım
- NuGet · private Azure Artifacts feed (mab)
- Sürüm
- v12.0.0 — tek sürüm kaynağı, CPM uyumlu
- Çopxu
- 18 adımlı web sihirbazı · CLI · AI skill'leri
- Modüller
- İdempotent kurulum · bayt-bayt geri alma
01 Sorun
Her kurumsal proje, aynı ilk haftaları yaşar.
Yeni bir çözüm açtığınızda değer üreten tek satır kod yazmadan önce hep aynı tablo kurulur. MAB Çopxu bu tabloyu bir kez kurar, her projede ortaya çıkarır.
İskelet haftaları
Katmanlar, CQRS akışı, çoklu kiracılık, CI, Docker… Repo hazır olmadan
sprint'ler geçer. mab bu iskeleti dotnet new mab-solution ile
dakikalar içinde, tüm seçimleri sizin yerinize yaparak üretir.
Bağlamsız yapay zekâ
AI asistanları projenizin konvansiyonlarını bilmez; her yanıtta tahmin yürütür.
mab'ın kullanım kılavuzları Cline Agent Skills formatında — asistanınıza kurulunca
framework bilgisi otomatik devreye girer.
çözüm
Üç katman, tek çerçeve: paketlenmiş altyapı + üretim motoru + asistanınıza kurulabilen kullanım bilgisi.
02 Ürün
Üç katman: Framework · Çopxu · Skills
MAB Çopxu tek bir parça değil; birbirini tamamlayan üç yüzey. Her biri tek başına değerli, birlikte bütünü kurar.
01 — Framework
25+ modüler NuGet paketi
İhtiyacınız olan paketi referans alın, gerisini getirmezsiniz. Bağımlılık akışı tek
yönlüdür: Abstractions → Core → kategori paketleri — asla tersine referans yok.
Aynı çözümde sürüm karışmaz: CPM ile tüketici tarafı sürümsüz yazılır.
Result/PagedResultgeneric repositorySmartLoggerKey VaultRedis · Solr
02 — Çopxu
IProjectEngine — üretim motoru
18 adımlı web sihirbazı, mab new CLI'sı ve Cline project-init
skill'i aynı motoru çalıştırır — üç kapı, tek davranış. Üretim öncesi dry-run,
üretim sırasında SignalR ile canlı ilerleme, sonrasında restore + git + ilk commit.
mab studiomab newdry-runSignalR ilerlememodül kataloğu
03 — Skills
AI dokümantasyon katmanı
Her paketin kullanım kılavuzu Cline Agent Skills formatında yazılmıştır: kurulum, DI kaydı, appsettings, ✅/❌ listeleri, sorun giderme. Asistanınıza kurulumundan itibaren projenin konvansiyonlarını bilir.
40+ SKILL.mdrouter skillOWASP ASVS denetimi
03 MAB Çopxu
Seçimler ekrana dökülür, motor üretir.
Sihirbaz tercihleri tek akışta toplar; modül kataloğu kaynaklardan canlı okunur, özet ekranında dry-run planı gösterilir. Hiçbir şey gizli değil — ne üretileceğini üretmeden önce görürsünüz.
Canlı modül kataloğu. Bağımlılıklar otomatik seçilir — CMS Kit işaretlendi, file-management kendi kendine kilitlendi.
Özet + dry-run planı. Maskeli komut satırı, modül sırası, post-processor adımları — hiçbir dosya yazılmadan.
Canlı ilerleme merdiveni. SignalR üzerinden akar; tarayıcı bağlantıyı kaysa bile üretim sunucuda tamamlanır.
Üretim tamamlandı. Süre, hedef dizin ve tam işlem günlüğü — ne yapıldığının kaydı her zaman elinizin altında.
Sihirbazı sevmeyenler için: tek satır.
Aynı motor, komut satırından: mimari, veritabanı, tema ve modüller tek komutta.
Sık kullanılan senaryolar --help altında hazır.
mab new— parametrik çözüm üretimimab add-module/remove-module— modül yaşam döngüsümab check— çözüm bütünlük denetimimab test-connection— canlı DB bağlantı testi
04 Modül sistemi
Kurulum sözleşmeli, geri alma garantili.
Modüller kodunuzu marker-slot enjeksiyonuyla değiştirir — rastgele dosya yazımı değil, planlı ve denetlenebilir bir süreç. Üç garantisi var:
İdempotent kurulum
Aynı modülü ikinci kez kurmak dosyalara dokunmaz. Enjeksiyon planı deterministiktir; aynı girdi her koşumda aynı snapshot'ı üretir.
Bayt-bayt geri alma
mab remove-module dosyaları kurulum öncesindeki orijinal hallerine
bayt-bayt döndürür. Deneme-yanılma bedava; bağımlı modül varsa silme hiç başlamaz.
Bağımlılık koruması
Başka bir modülün bağımlı olduğu paket silinmek istendiğinde işlem başlamadan reddedilir. Grafik tutarlılığı kullanıcıya bırakılmaz.
05 Süreç
Seç → Önizle → Üret → Geliştir
Fikirdan çalışan iskelete giden yol dört adım. Her adımın çıktısı bir sonrakinin girdisi — ve hiçbir adım sürpriz çıkarmaz.
01
Seç
18 adımlı sihirbaz ya da tek satır CLI. Geçersiz kombinasyonlar
(separate-schema + MySQL gibi) ilgili adımda anında yakalanır.
02
Önizle
Dry-run: maskeli dotnet new komutu, modül kurulum sırası ve post-processor
planı. Hiçbir dosya yazılmaz; admin şifresi asla görünmez.
03
Üret
Motor çalışır: şablon → modül enjeksiyonları → dotnet restore →
git init + ilk commit. İlerleme SignalR ile canlı akar.
04
Geliştir
Örnek Product CRUD'u, test projesi ve AGENTS.md ile başlayın.
Skill dokümanları asistanınızı proje konvansiyonlarıyla başlatır.
06 Paket kataloğu
25+ paket, tek defterde.
Her satır bağımsız bir NuGet paketi. Kataloğun tamamı private mab feed'inde; CPM ile referans verirsiniz, sürümü framework yönetir.
Çekirdek
6 paketMab.AbstractionsOrtak sözleşmeler: Result/PagedResult, DynamicQuery, ICurrentUserService — saf model katmanı
Mab.CoreYardımcılar, security headers, ortam/feature yönetimi
Mab.AspNetCore.MvcResult→IActionResult dönüşümleri, dosya yanıtları, CSP nonce TagHelper
Mab.Extensions.AutoMapperAutoMapperHelper — ad bazlı, tip güvenli eşleme
Mab.RestDış API istemcisi: ApiConnectManager (retry + token yenileme)
Mab.Core.Soap · legacySOAP/WCF istemci fabrikası — izole hat
Kimlik ve Erişim
3 paketMab.IdentityJWT, session/refresh token, 2FA, Azure Key Vault (Managed Identity/sertifika/ClientSecret)
Mab.Identity.EntraAuthEntra ID (Azure AD): OIDC/SSO, Graph, grup→rol eşleme
Mab.Identity.ActiveDirectory · legacyWindows-only LDAP/AD — izole hat
Veri ve Kalıcılık
8 paketMab.EntityFrameworkCoreProvider-bağımsız base: generic repository, soft delete, audit interceptor
Mab.EntityFrameworkCore.SqlServerSQL Server provider + Bulk* toplu işlem yüzeyi
Mab.EntityFrameworkCore.PostgreSqlPostgreSQL provider, snake_case naming convention
Mab.EntityFrameworkCore.MySqlMySQL provider — EF Core 10 uyumlu Oracle paketi
Mab.EntityFrameworkCore.SqliteSQLite: göreli yol + :memory: desteği
Mab.DapperHam SQL / stored procedure, çoklu result set
Mab.RedisCacheRedis cache + attribute tabanlı declarative caching
Mab.SolrFull-text arama, audit/access log arama
Loglama ve Gözlemlenebilirlik
2 paketMab.LoggingSmartLogger, audit/access/performance/security log, canlı log seviyesi (Serilog → Seq/Sentry/File)
Mab.Logging.SqlServerSQL Server'a özgü health check + exception middleware
Altyapı
4 paketMab.MailingSMTP e-posta, HTML tema, ek optimizasyonu
Mab.HangfireArka plan işleri: fire&forget, delayed, recurring, continuation
Mab.FilesDosya I/O, hash, MIME, SkiaSharp görsel işleme
Mab.BrowserAutomationHeadless Playwright ile scripted login doğrulama
İçerik ve Modüller
6 modülMab.Cms.* · 4 paketCMS Kit: 27 alan tipi, draft/sürüm/diff, çoklu dil, slug/sitemap, delivery + admin API
Mab.BlobStoring · 5 providerBLOB deposu: FileSystem · Database · Azure · AWS S3 · InMemory
Mab.FileManagement · +EF CoreMetadata, klasör ağacı, yükleme güvenlik hattı, paylaşım, kota, thumbnail
Mab.AuditLogging · +EF CoreDenetim izi: kim ne değiştirdi, eski/yeni değer, PII maskesi, saklama süresi
Mab.Localization · +EF CoreÇalışma zamanı dil CRUD'u, veritabanı tabanlı çeviri, JSON içe aktarma
Mab.TextTemplating · +EF CoreScriban tabanlı şablon, layout zinciri, çok dilli içerik, RenderEmailAsync
Yapılandırma
2 paketMab.Configuration.MyAuthMerkezi konfigürasyon kaynağı, canlı reload watcher, SecretRef çözümü, health check
Mab.Configuration.MyAuth.SqlTransportSQL üzerinden konfigürasyon taşıma — izole hat
07 Yapay zekâ katmanı
Asistanınız mab'ı doğuştan bilir.
Kullanım kılavuzları insan için değil, aynı zamanda asistanınız için yazıldı. Skill paketini yüklediğinizde framework bilgisi sohbete otomatik dahil olur.
çalıştığı araçlar
Cline
OpenCode
DSH Harness
+ markdown okuyan her agent
Nasıl çalışır? Kullanıcı "cache ekle" dediğinde router skill niyeti çözer, doğru paketi (Mab.RedisCache) ve doğru kurulum reçetesini seçer. Kılavuzlar ✅/❌ listeleriyle gelir; asistan tahmin değil, reçete uygular.
- 40+SKILL.md dokümanı — her paket için kurulum, DI kaydı, appsettings ve sorun giderme reçetesi
- →Router davranışı — "loglama kur", "JWT ayarla" gibi niyetler doğru skill'e yönlendirilir
- ASVSGüvenlik çapraz kontrolü — modül tasarımları OWASP ASVS 5.0.0 denetim skill'i ile sınanır
- zipKolay kurulum — Cline, OpenCode, DSH Harness benzeri araçlarla çalışır; tüketici projeye de taşınabilir
--- name: mab-framework description: Mab Framework ana haritası ve paket seçim rehberi — hangi NuGet paketinin hangi ihtiyaca karşılık geldiğini (caching, loglama, kimlik doğrulama, veri erişimi…) gösterir. --- # Mab Framework — Ana Skill Haritası ## Cline Protokolü 1. Niyeti çözümle — "cache ekle" → Mab.RedisCache 2. Skill'i bul — setup-caching 3. Girdileri topla · Uygula · Doğrula 4. Güvenlik — secure-sdlc-audit ile çapraz kontrol
08 Üretilen çözüm
İskelet boş gelmez.
mab ile üretilen çözüm, ilk commit'ten itibaren çalışabilir bir kurumsal uygulamadır. İçinde ne var?
✓Domain · Application · Infrastructure katmanları — ya da Basit yapıda tek Core projesi
✓HttpApi + Host ve UI projesi
(MVC · React)✓Örnek Product CRUD modülü — listeleme → detay → güncelleme akışı
✓Test projesi (xUnit) — üretime hazır iskelet
✓
Directory.Packages.props — CPM ile sürümsüz PackageReference✓
deploy/docker-compose.yml + Dockerfile — koşulsuz üretilir✓
deploy/k8s/ manifestleri (opsiyonel) — sır sızıntısı denetimli✓Çoklu kiracılık — per-database · separate-schema · shared
✓Diller
(tr, en) + IStringLocalizer kablolaması✓Seed admin hesabı — şifre log'lara asla yazılmaz
✓
git init + feat: initial commit (MAB Çopxu)✓AGENTS.md + agent rules — asistanınız için proje sözleşmesi
25+NuGet paketi
5hazır modül
18sihirbaz adımı
4veritabanı
3UI teması
40+skill dokümanı
09 Üretim olgunluğu
Ciddi iş için, ciddi disiplinle.
Bir framework'e güvenmek, sürüm sürecine güvenmektir. mab'ın yayın hattı öngörülebilir ve denetlenebilir tasarlandı.
a.Tek sürüm kaynağı
Tüm paketler tek bir <VersionPrefix> ile aynı sürümde çıkar — 12.0.0.
Tüketici projede CPM ile sürümsüz referans; sürüm karmaşası yapısal olarak engellenir.
b.Öngörülebilir CI hattı
main dalı stable yayınlar, feature dalları -preview-{BuildId}
sonekiyle çıkar. Yayın manuel tetiklemelidir — tesadüfü sürüm yok.
c.Test güvencesi
Framework birim + smoke testleri ve MAB Çopxu'nun CLI/Core/Web entegrasyon testleri her koşumda kompozisyonu gerçek kayıtlarla doğrular — sahteyle değil.
d.Güvenlik duruşu
OWASP ASVS 5.0.0 tabanlı denetim skill'i, CSP + güvenlik başlıkları, PII maskesi ve K8s sır sızıntısı denetimi üretim hattının içine gömülüdür.
10 Başlangıç
Bir komut. Bir çözüm.
Private mab feed'ine erişiminiz varsa kurulum tek komut. Erken erişim programına dahil olmak için bize yazın.
$ dotnet tool install --global Mab.Studio.Cli --source mab
$ mab studio # → https://localhost:5050
$ mab new Example.Project --db postgresql --modules audit-logging,cms-kit
Erken erişim ve kurumsal lisanslama için: irtibat@ayemsolutions.com
11 Sık sorulanlar
Merak edilenler
+MAB Çopxu'yu mevcut projeme ekleyebilir miyim?
Evet. Paketler birbirinden bağımsız — ihtiyacınız olan paketi NuGet referansı
olarak ekleyip DI kaydını yapmanız yeterli. Hazır modüller
mab add-module ile
mevcut çözümünüze kurulur; marker-slot enjeksiyonu idempotent olduğundan ikinci kurulum
dosyaları bozmaz.+Hangi .NET sürümünü hedefliyor?
net10.0. Üretilen çözümde SDK sürümü global.json ile
sabitlenir; framework ve tüketici aynı TFM üzerinde kalır.+Üretilen kod benim mi? Kilitlenme (lock-in) var mı?
Üretilen çözümün tüm kodu sizin dizininizde, sizin deponuzda. Paketler
standart .NET bağımlılıklarıdır;
mab remove-module her modülü
bayt-bayt geri alabilir. Altyapıyı bırakmak isterseniz kodunuz çalışmaya devam eder.+Veritabanını sonradan değiştirebilir miyim?
Sağlayıcılar EF Core soyutlamasının arkasında: PostgreSQL, SQL Server, MySQL ve
SQLite aynı repository yüzeyini paylaşır. SQLite ile başlayıp PostgreSQL'e geçmek yaygın bir
geliştirme senaryosudur; sadece
separate-schema izolasyonu SQL Server ve
PostgreSQL'e özgüdür.+Yapay zekâ kullanımı zorunlu mu?
Hayır. Skill katmanı tamamen opsiyonel — sihirbaz ve CLI'dan bağımsız çalışır.
Asistanınız (Cline) varsa skill'ler konvansiyonları öğretir; yoksa aynı kılavuzlar
insan için de okunabilir düzende durur.
+Nasıl erişebilirim? Fiyatlandırma nasıl?
Paketler private Azure Artifacts feed'i (
mab) üzerinden dağıtılıyor.
Şu anda erken erişim programıyla kurumsal ekipler alıyoruz —
irtibat@ayemsolutions.com adresine yazın, kurulumu birlikte yapalım.