Blueprint'ler
Blueprint'ler, mimari netliği feda etmeden hızlı kurulum isteyen takımlar için yapılandırılmış başlangıç noktalarıdır. Her entity, attribute ve ilişkiyi sıfırdan oluşturmak yerine, kanıtlanmış bir domain şablonuyla başlar ve özel ihtiyaçlarına göre özelleştirirsin.
Bir Blueprint Ne Sağlar
Blueprint, şu unsurları içeren eksiksiz, hazır bir Mockomat projesidir:
- Tutarlı temel entity'ler — mantıksal bir birim olarak birlikte çalışan bir domain tabloları seti (örneğin bir e-ticaret domaini için
Product,Category,Review). - Başlangıç ilişki stratejisi — entity'ler arasındaki ilişkiler doğru kardinalite ve yönle zaten tanımlanmıştır.
- Attribute yapılandırması — her entity, anlamlı attribute'lar, türler ve bayraklarla (sortable, filterable, searchable) birlikte gelir.
- Veri eşleştirmeleri — alanlar uygun veri kaynaklarına (gerçek veri setleri, Faker, sabitler) önceden eşlenmiştir, böylece blueprint önizlemede hemen çalışır.
- Başlangıç işlem beklentileri — API sorgu adları ve işlem açılımı tipik kullanım senaryoları için yapılandırılmıştır.
- Anlamlı varsayılanlar — sayfalandırma, sıralama ve filtreleme, önizleme davranışının kutudan çıktığında faydalı olması için yapılandırılmıştır.
Sonuç, saniyeler içinde klonlayıp sorgulayabileceğin bir projedir — ardından kendi hızında özelleştirebilirsin.
Kategori ve karmaşıklık genel görünümüyle blueprint galerisi.
Mevcut Blueprint Kategorileri
Blueprint'ler, takımların sıklıkla karşılaştığı yaygın domain desenlerini kapsar:
| Kategori | Örnek Entity'ler | Tipik Kullanım Senaryosu |
|---|---|---|
| E-Ticaret | Product, Category, Order, Customer, Review | Online mağazalar, pazar yerleri, ürün katalogları |
| Blog / CMS | Post, Author, Category, Comment, Tag | İçerik platformları, editöryal iş akışları |
| CRM | Contact, Company, Deal, Activity, Pipeline | Satış takımları, müşteri ilişkisi takibi |
| Proje Yönetimi | Project, Task, Team, Member, Sprint | Agile iş akışları, görev takip sistemleri |
| SaaS / Abonelik | Subscription, Plan, Invoice, Customer, Payment | SaaS faturalandırma, abonelik yönetimi |
| Envanter | Product, Warehouse, StockLevel, Supplier, Transfer | Depo yönetimi, tedarik zinciri |
| İK / İnsan Kaynakları | Employee, Department, Position, TimeEntry, Leave | İK sistemleri, iş gücü yönetimi |
Her blueprint deneyimli mimarlar tarafından tasarlanmış ve yapısal kalite için incelenmiştir. Entity'ler, ilişkiler ve adlandırma kuralları domain-driven design ilkelerini takip eder.
Entity sayısı ve karmaşıklık göstergesiyle blueprint kategori kartları.
Bir Blueprint Nasıl Etkili Kullanılır
1. Göz At ve Seç
Blueprint galerisini aç ve kategoriye göre göz at. Her blueprint kartı şunları gösterir:
- Domain kategorisi
- Dahil edilen entity sayısı
- Kapsanan kullanım senaryosunun kısa açıklaması
- Karmaşıklık göstergesi (basit, orta, kapsamlı)
Hedef domain'ine en yakın eşleşen blueprint'i seç. Mükemmel bir eşleşme olması gerekmez — sonraki adımlarda özelleştireceksin.
2. Workspace'ine Klonla
Blueprint'in bir kopyasını workspace'inde oluşturmak için klonla düğmesine tıkla. Bu, blueprint'in tüm entity'leri, attribute'ları, ilişkileri ve eşleştirmeleriyle yeni bir proje oluşturur. Orijinal blueprint değiştirilmez.
Neler klonlanır:
- Tüm tablolar ve attribute'ları
- Tüm ilişki tanımları
- Tüm veri eşleştirmeleri (OFF_FIELD, FAKE, CONST)
- API yapılandırması (sorgu adları, işlem açılımı)
- Sayfalandırma ve sıralama varsayılanları
Neler klonlanmaz:
- Orijinal blueprint adı (yeni bir proje adı seçersin)
- Blueprint'e özgü meta veriler veya rozetler
- İçeri aktarma iş geçmişi
3. Kendi İş Dilinle Yeniden Adlandır
Blueprint'in genel adlarını takımının gerçek terminolojisiyle değiştir. Blueprint Product kullanıyor ancak domain'in buna Listing veya Item diyorsa, şimdi yeniden adlandır. Başından itibaren tutarlı adlandırma, ilerleyen aşamalarda karışıklığı önler.
4. Attribute'ları Tablo Tablo İncele
Her entity'yi gözden geçir ve kontrol et:
- Tüm attribute'lar domain'inle ilgili mi?
- Blueprint'te olmayan ek attribute'lara ihtiyacın var mı?
- Türler doğru mu (string, number, boolean, date)?
- Doğru alanlar sortable, filterable ve searchable olarak işaretlenmiş mi?
İhtiyacın olmayan attribute'ları kaldır ve eksik olanları ekle. Blueprint sana yapıyı verir — domain detaylarını sen sağlarsın.
5. Önizleme ile Doğrula
Klonlanmış ve özelleştirilmiş modelin doğru çalıştığını teyit etmek için bir önizleme sorgusu çalıştır. Şunları kontrol et:
- Veri eşleştirmeleri gerçekçi değerler üretiyor
- İlişkiler beklendiği gibi çözümleniyor
- Filtreler ve sıralamalar yapılandırdığın alanlarda çalışıyor
- Genel yanıt yapısı frontend beklentilerine uyuyor
Aktif workspace'e blueprint klonlama akışı.
Özelleştirme Stratejisi
Her şeyi bir anda yeniden yazma. Blueprint iskeletini koru ve odaklanmış geçişlerle geliştir. Bu yaklaşım, kademeli iyileştirmeye izin verirken yapısal bütünlüğü korur.
Geçiş 1: Adlandırma ve Temel Attribute'lar
Yalnızca yeniden adlandırma ve en önemli attribute'ları ayarlamaya odaklan:
- Entity'leri iş diline uygun şekilde yeniden adlandır
- Anahtar attribute'ları yeniden adlandır (tanımlayıcılar, görüntüleme adları, birincil değerler)
- Blueprint'in içermediği entity başına 1-2 kritik attribute ekle
- Açıkça ilgisiz olan attribute'ları kaldır
Bu geçişte ilişkileri, API yapılandırmasını veya eşleştirmeleri ayarlama.
Geçiş 2: İlişki Temizliği
Adlar kararlı hale geldiğinde, ilişkileri incele ve ayarla:
- Kardinalite domain'in için doğru mu doğrula (1:1, 1:n, m:n)
- Blueprint'in sahiplik modeli seninkine uymuyorsa yönü ayarla
- Blueprint'in içermediği ilişkileri ekle
- Geçerli olmayan ilişkileri kaldır
İç içe sorguların hâlâ doğru çözümlendiğini teyit etmek için bu geçişten sonra önizleme çalıştır.
Geçiş 3: API Açılım Hizalaması
Hangi işlemlerin kullanılabilir olacağını ve nasıl adlandırılacağını yapılandır:
- Sorguları API kurallarına uygun şekilde yeniden adlandır
- Entity bazında liste/detay işlemlerini etkinleştir veya devre dışı bırak
- Sayfalandırma varsayılanlarını ayarla
- Uygun filtre ve sıralama yapılandırmalarını belirle
Geçiş 4: Runtime Doğrulama
Son doğrulama geçişi:
- Her entity'ye karşı kapsamlı sorgular çalıştır
- Tüm filtreleri ve sıralamaları test et
- Her düzeyde ilişki geçişini doğrula
- Kalan ipuçlarını veya uyarıları gider
Bu geçişten sonra, özelleştirilmiş blueprint'in mock API tüketimi için üretime hazır olmalıdır.
Model ve API görünümlerinde blueprint özelleştirmesi.
Blueprint Kalite Kriterleri
Galerideki her blueprint, minimum kalite standartlarını karşılar:
- Anlamlı adlara ve açıklamalara sahip en az 2 entity
- Entity'leri bağlayan en az 1 ilişki
- Eksiksiz attribute eşleştirmeleri — eşleştirilmemiş alan yok
- Doğru adlandırma kuralları — PascalCase entity'ler, camelCase attribute'lar
- Yer tutucu veya rastgele ad yok — tüm adlar gerçek domain kavramlarını yansıtır
- Çalışan önizleme — blueprint kutudan çıktığında geçerli sorgu sonuçları üretir
Bu kriterler, her blueprint'in yalnızca bir iskelet değil, hemen faydalı olmasını sağlar.
Resmi ve Topluluk Blueprint'leri
Blueprint'ler iki kategoride gelir:
Resmi Blueprint'ler
Mockomat takımı tarafından oluşturulmuş ve bakımı yapılmaktadır. Bunlar:
- Yapısal kalite ve adlandırma kuralları için incelenmiştir
- Yeni özellikler ve en iyi uygulamalarla güncellenir
- Galeride "Resmi" rozetiyle işaretlenmiştir
- Mevcut platform versiyonuyla çalışması garanti edilmiştir
Topluluk Blueprint'leri (Yakında)
Kayıtlı kullanıcılar tarafından yayınlanır ve toplulukla paylaşılır. Topluluk blueprint'leri:
- Otomatik bir kalite incelemesinden (adlandırma, yapı, tamlık) geçer
- Mockomat takımı tarafından moderasyon yapılır
- Yazarın adını ve klonlama sayısını gösterir
- Kalite olağanüstü ise resmi statüye terfi ettirilebilir
Topluluk blueprint gönderim ve inceleme akışı.