Sözlük
Mockomat dokümantasyonunda kullanılan terimlerin, kavramların ve teknik kelimelerin kapsamlı bir referansı. Terimler kategoriye göre gruplandırılmış ve her grup içinde alfabetik olarak sıralanmıştır.
Platform ve Ürün
Blueprint Yaygın bir alan kalıbını kapsayan, önceden oluşturulmuş bir Mockomat proje şablonu (örneğin E-Ticaret, CRM, Blog). Blueprint'ler bir çalışma alanına klonlanabilir ve özelleştirilebilir. Bak: Blueprint'ler.
Alan Modeli (Domain Model) Bir projenin anlamsal temeli. Herhangi bir API veya uygulama detayı kararlaştırılmadan önce verilerinin yapısını ve anlamını tanımlayan varlıkları, özellikleri ve ilişkileri tanımlar.
Alan Dilimi (Domain Slice) İş modelinin küçük, tutarlı bir alt kümesi — genellikle modelleme için başlangıç noktası olarak kullanılan bir veya iki ilişkili varlık.
Mockomat Alan modelleme, mock API simülasyonu ve backend kod oluşturma için çok kiracılı bir SaaS platformu. Kullanıcılar şemaları görsel olarak tanımlar, verileri eşler ve anında canlı GraphQL API'ler elde eder.
Proje (Project) Bir alan modeli, veri eşlemeleri, API yapılandırması ve ilişkili mock verilerini içeren eksiksiz bir mock API tanımı. Her projenin benzersiz bir slug'ı ve endpoint'i vardır.
Çalışma Alanı (Workspace) Kullanıcıların bir mock API projesini oluşturduğu, yapılandırdığı, doğruladığı ve üzerinde yinelediği merkezi ortam. Modelleme panosunu, tablo düzenleyicisini, API tasarım görünümünü ve runtime önizlemesini içerir.
Modelleme
Özellik (Attribute) Bir varlığın alanı veya sütunu. Her özelliğin bir adı, tipi (string, number, boolean, date, json) ve API davranışını kontrol eden yapılandırma bayrakları vardır.
Kardinalite (Cardinality) Varlıklar arasındaki niceliksel ilişki: bire-bir (1:1), bire-çok (1:n) veya çoka-çok (m:n).
Varlık / Tablo (Entity / Table) Modelde temsil edilen temel bir iş kavramı (örneğin Customer, Order, Invoice). Modelleme panosunda bir tablo kartı olarak görselleştirilir.
Filterable Bir özellik bayrağı; alanda GraphQL sorgularında filtre işlemlerini etkinleştirir. Yalnızca filterable olarak işaretlenmiş alanlar filtre ifadelerini kabul eder.
İpucu (Hint) Önizlemede kullanıcıları model sorunları konusunda uyaran eyleme geçirilebilir bir sinyal — eşlenmemiş özellikler, yapılandırma uyumsuzlukları veya eksik ilişki hedefleri.
Modelleme Panosu (Modelling Board) Çalışma alanında varlıkların oluşturulduğu, konumlandırıldığı ve sürükle-bırak etkileşimi ile bağlandığı görsel tuval.
Adlandırma Kuralı (Naming Convention) Standartlaştırılmış kalıplar: varlıklar için PascalCase tekil (örneğin Customer), özellikler için camelCase (örneğin firstName).
İlişki (Relation) İki varlık arasında verilerin nasıl aktığını tanımlayan bir bağlantı. Bir yönü (kaynak → hedef) ve kardinalitesi (1:1, 1:n, m:n) vardır.
Required Alanın her zaman bir değere sahip olması gerektiğini gösteren bir özellik bayrağı. Oluşturulan şemada GraphQL null edilebilirliğini etkiler.
Searchable Alanı arama sorgusu çözümlemesine dahil eden bir özellik bayrağı.
Sortable Alanda sıralama işlemlerini etkinleştiren bir özellik bayrağı. Yalnızca sortable olarak işaretlenmiş alanlar sort parametrelerinde kullanılabilir.
Tablo Kartı (Table Card) Modelleme panosundaki bir varlığın görsel temsili; tablo adını, sütunları, ilişki göstergelerini ve eylem düğmelerini gösterir.
Tablo Düzenleyicisi (Table Editor) Modelleme panosunda bir tablo seçildiğinde açılan, ayrıntılı özellik ve ilişki kurulumu sağlayan yapılandırma paneli.
Veri Kaynakları ve Eşleme
CONST Her kayda sabit, değişmeyen bir değer atayan bir veri eşleme türü (örneğin bir durum alanı için "active").
Veri Eşlemesi (Data Mapping) Bir varlık özelliğini bir veri kaynağına bağlayan ve alanın runtime'da hangi değerleri döndüreceğini belirleyen yapılandırma.
Veri Nesnesi (Data Object) Etiketler ve örnek veriler içeren anlamsal bir alan tanımı; OFF_FIELD eşlemeleri için kaynak olarak kullanılır. Anlamsal külliyenin bir parçasıdır.
Veri Seti (Dataset) Özelliklerle OFF_FIELD eşlemesi yoluyla eşleştirilebilen gerçek dünya verileri koleksiyonu (örneğin Open Food Facts'ten ürün katalogları).
FAKE Gerçekçi sentetik veri oluşturmak için Faker kullanan bir veri eşleme türü — isimler, e-postalar, adresler, tarihler, fiyatlar ve daha fazlası.
Faker Gerçek dünya kalıplarını izleyen gerçekçi sentetik veriler oluşturan open-source bir kütüphane (doğru isim formatları, geçerli e-posta yapıları, gerçekçi fiyatlar).
OFF_FIELD Bir özelliği gerçek dünya veri setindeki bir alana eşleştiren bir veri eşleme türü (örneğin Open Food Facts); gerçekçi ve çeşitli değerler üretir.
Sentetik Veri (Synthetic Data) Faker tarafından oluşturulan, gerçek kalıpları taklit eden ancak kurgusal olan, asla üretim kaynaklarından türetilmeyen veri.
API ve GraphQL
API Sözleşmesi (API Contract) Harici tüketicilerin bağımlı olduğu sorgu adları, alan yapıları ve işlem kullanılabilirliğinin resmi belirtimi.
API Tasarım Görünümü (API Design View) Kullanıcıların hangi GraphQL işlemlerinin açılacağını ve sorguların nasıl adlandırılacağını kontrol ettiği çalışma alanı bölgesi.
Code-First GraphQL Mockomat'ın kullandığı yaklaşım; GraphQL şemaları, SDL dosyaları olarak elle yazılmak yerine model tanımlarından ve dekoratörlerden oluşturulur.
Detay Sorgusu (Detail Query) Tanımlayıcısıyla tek bir kayıt döndüren bir GraphQL sorgusu (örneğin product(id: "abc-123")).
Dinamik Şema Oluşturma (Dynamic Schema Generation) Mockomat'ın bir projenin model tanımlarından anında tamamen tipli bir GraphQL şeması oluşturduğu süreç.
Endpoint Tüketicilerin bir mock API'yi sorgulayabileceği URL yolu: POST /mock/{slug}/graphql.
Filtre İfadesi (Filter Expression) Sorgu sonuçlarını daraltmak için kullanılan bir koşul veya koşullar kümesi. AND/OR operatörleri ve iç içe geçme ile Boole cebrini destekler.
Filtre Operatörü (Filter Operator) Filtre ifadelerinde kullanılan bir karşılaştırma işlemi: EQ, NE, LT, GT, LE, GE, LIKE, IS_NULL, IS_NOT_NULL.
GraphQL Mockomat tarafından hem yönetim API'si hem de mock runtime endpoint'leri için kullanılan sorgu dili ve API tasarım kalıbı.
Liste Sorgusu (List Query) İsteğe bağlı filtreleme ve sıralama ile sayfalanmış bir kayıt koleksiyonu döndüren bir GraphQL sorgusu (örneğin products(limit: 20)).
Offset Tabanlı Sayfalama (Offset-Based Pagination) Mockomat'ın kullandığı sayfalama yöntemi: offset (atlanacak öğeler) + limit (döndürülecek öğeler).
İşlem Açılımı (Operation Exposure) Her varlık için hangi GraphQL işlemlerinin (liste, detay) kullanılabilir olacağının yapılandırması.
Sorgu Adlandırma (Query Naming) GraphQL giriş noktalarının özel adlandırılması — liste sorguları varsayılan olarak çoğul (örneğin products), detay sorguları tekil (örneğin product).
Slug / Proje Slug'ı API endpoint yolunda kullanılan, URL-güvenli bir proje tanımlayıcısı (örneğin customer-portal → /mock/customer-portal/graphql).
Runtime
Toplama Pipeline'ı (Aggregation Pipeline) MongoDB'nin çok aşamalı veri işleme çerçevesi; runtime sorgu oluşturucusu tarafından sorguları, filtreleri, sıralamaları ve ilişki aramalarını yürütmek için kullanılır.
Mock Runtime / Runtime Motoru GraphQL sorgularını kabul eden ve dört aşamalı bir pipeline aracılığıyla MongoDB işlemlerine çeviren çekirdek motor: ayrıştırma → planlama → oluşturma → birleştirme.
MongoDB Sorgu Oluşturucusu (MongoDB Query Builder) Runtime pipeline'ının üçüncü aşaması; bir yürütme planını MongoDB toplama pipeline'ına çevirir.
Önizleme (Preview) Kullanıcıların modellerini canlı sorgularla test ettiği ve hazırlık ipuçlarıyla birlikte yanıt verilerini incelediği uygulama içi runtime arayüzü.
Sorgu Planlayıcısı (Query Planner) Runtime pipeline'ının ikinci aşaması; ayrıştırılmış bir sorguyu model meta verileriyle birlikte analiz ederek bir yürütme planı oluşturur.
İlişki Geçişi (Relation Traversal) Runtime'ın düz MongoDB koleksiyonlarından toplama pipeline'ında arama aşamaları oluşturarak ilişkisel veriyi simüle etme becerisi.
İstek Ayrıştırıcısı / GraphQL İstek Ayrıştırıcısı (Request Parser) Runtime pipeline'ının ilk aşaması; gelen bir sorgu dizesini soyut sözdizimi ağacına (AST) ayrıştırır.
Sonuç Birleştiricisi (Result Assembler) Runtime pipeline'ının dördüncü aşaması; MongoDB sonuçlarını beklenen GraphQL yanıt yapısına yeniden şekillendirir.
Runtime Doğrulama (Runtime Validation) Bir modelin alan ve API kararlarının gerçek sorgu yürütmesi altında doğru davranıp davranmadığını onaylama süreci.
Görünümler (Views) Aynı modele farklı bakış açıları — pano görünümü, tablo detay görünümü, API tasarım görünümü, runtime önizlemesi — çapraz bağlantılarla gezilebilir.
Dışa Aktarım ve Kod Oluşturma
Kod Oluşturma / Codegen Bir Mockomat alan modelinden çalışan bir backend projesi oluşturmanın otomatik süreci.
Controller Oluşturulan NestJS kodundaki REST API katmanı; rota dekoratörleri ve Swagger anotasyonlarıyla HTTP endpoint'lerini açar.
DTO (Data Transfer Object) Oluşturulan backend'lerde girdi doğrulamasını zorunlu kılan, class-validator dekoratörleriyle (@IsString(), @IsNumber(), @IsOptional()) yapılandırılmış nesneler.
Dışa Aktarım (Export) Bir Mockomat projesinden üretime hazır bir NestJS backend'i oluşturan özellik. Oluşturulan kod %100 kullanıcıya aittir.
Oluşturulan Backend (Generated Backend) Dışa aktarım özelliği tarafından üretilen eksiksiz bir NestJS projesi — modüller, controller'lar/resolver'lar, servisler, varlıklar, DTO'lar ve yapılandırma.
Mongoose MongoDB için bir ODM (Object-Document Mapping) kütüphanesi; oluşturulan backend'lerde kalıcılık seçeneği olarak mevcuttur.
NestJS Birincil kod oluşturma hedefi olarak kullanılan Node.js çerçevesi. Oluşturulan backend'ler standart NestJS kurallarını izler.
Resolver Oluşturulan NestJS kodundaki GraphQL API katmanı; GraphQL dekoratörleri kullanarak sorgu ve mutation endpoint'lerini açar.
TypeORM SQL veritabanları (PostgreSQL, MySQL, MariaDB) için bir ORM (Object-Relational Mapping) kütüphanesi; oluşturulan backend'lerde kalıcılık seçeneği olarak mevcuttur.
Kimlik Doğrulama ve Güvenlik
Actor Token Eş zamanlılık takibi için harici API tüketicilerine verilen süreli bir token. X-Actor-Token başlığı aracılığıyla dahil edilir.
API Key Private mock API endpoint'lerine karşı harici tüketicilerin kimliğini doğrulamak için proje başına verilen bir kimlik bilgisi. Authorization: Bearer başlığı aracılığıyla dahil edilir.
Eş Zamanlı Oturum (Concurrent Session) Aynı anda aktif olan kimlik doğrulanmış bir kullanıcı bağlantısı. Her plan katmanının maksimum eş zamanlı oturum limiti vardır.
JWT (JSON Web Token) Mockomat yönetim API'sinde durumsuz kimlik doğrulama için kullanılan bir token formatı.
Private Endpoint API key kimlik doğrulaması gerektiren bir mock API endpoint'i; Business planları ve üzerinde mevcuttur.
Public Endpoint Kimlik doğrulama gerektirmeyen, IP başına hız sınırlamasına tabi bir mock API endpoint'i.
Hız Sınırlaması (Rate Limiting) Faturalama dönemi başına istek limitlerini uygulayan sistem. Aşıldığında Retry-After başlığıyla HTTP 429 (Too Many Requests) döndürür.
Oturum (Session) Tenant'ın eş zamanlı oturum limitine sayılan kimlik doğrulanmış bir tarayıcı bağlantısı.
SSO / SAML Single Sign-On ve Security Assertion Markup Language — kurumsal kimlik yönetimi protokolleri (planlanmış özellik).
Planlar ve Erişim
Business (Plan) Private endpoint'ler, API key'ler, rol tabanlı erişim, aylık 50.000 istek ve 25'e kadar proje sunan ücretli bir katman ($19/ay).
Business Pro (Plan) Çok kullanıcılı takımlar, endpoint analitikleri, aylık 250.000 istek ve sınırsız proje ekleyen ücretli bir katman ($49/ay).
Enterprise (Plan) Sınırsız istek, özel veri setleri, SSO/SAML, SLA'lar, on-premise dağıtım ve yapılandırılabilir oturum limitleri sunan özel fiyatlı bir katman.
Free (Plan) Hesap kaydı gerektiren, 5'e kadar proje, günlük 1.000 istek ve public endpoint'ler sunan ücretsiz bir katman.
Quick (Plan) Public endpoint'li tek bir geçici oturum tabanlı proje sunan, anında giriş gerektirmeyen katman. Tarayıcı oturumu sona erdiğinde çalışma kaybolur.
Takım ve Yönetişim
Admin Projelere, takım yönetimine ve tenant yapılandırmasına tam erişime sahip bir kullanıcı rolü.
Alan Sahipliği (Domain Ownership) Takım içindeki belirli bir iş alanı ve onun model tanımları için atanmış sorumluluk.
Yönetişim (Governance) Takım modelleme çalışmaları genelinde tutarlılık, kalite ve uyumluluk sağlayan politikalar ve kontroller — adlandırma kuralları, inceleme geçitleri ve doğrulama kriterleri.
Guest Paylaşılan projelere ve önizlemeye salt okunur erişime sahip bir kullanıcı rolü.
Çok Kiracılı Mimari (Multi-Tenancy) Her kuruluşun verilerini, şemalarını ve yapılandırmasını tenant kapsamlı erişim yoluyla izole eden sistem mimarisi.
İnceleme Geçidi (Review Gate) Model, API veya dışa aktarım değişikliklerinin terfi ettirilmeden önce doğrulandığı zorunlu kontrol noktası — örneğin dışa aktarım öncesi runtime doğrulaması.
Tenant Özel veri koleksiyonları, bağımsız yapılandırma ve ayrı hız sınırlamasına sahip izole bir kurumsal sınır.
User Takım içinde proje oluşturabilen, düzenleyebilen ve dışa aktarabilen bir kullanıcı rolü.
User Admin Tam admin erişimi olmadan takım üyelerini yönetebilen ve roller atayabilen bir kullanıcı rolü.
Altyapı ve Dağıtım
Veri Egemenliği (Data Sovereignty) Tüm verilerin müşterinin kendi altyapısında kalma gerekliliği; on-premise dağıtım seçeneği ile karşılanır.
Docker Mockomat örneklerini paketlemek ve dağıtmak için kullanılan konteynerizasyon teknolojisi.
On-Premise Dağıtım Tam veri kontrolü için müşterinin altyapısında çalışan, kendi barındırdığı bir Mockomat kurulumu ($1.000 kurulum + $199/ay).
SLA (Service Level Agreement) Enterprise müşteriler için kullanılabilirlik, yanıt süreleri ve destek seviyelerine ilişkin resmi taahhüt.