Glossario
Un riferimento completo dei termini, concetti e vocabolario tecnico utilizzati in tutta la documentazione di Mockomat. I termini sono raggruppati per categoria e ordinati alfabeticamente all'interno di ogni gruppo.
Piattaforma e prodotto
Blueprint Un template di progetto Mockomat predefinito che copre un pattern di dominio comune (es. E-Commerce, CRM, Blog). I blueprint possono essere clonati in uno workspace e personalizzati. Vedere Blueprint.
Domain Model La fondazione semantica di un progetto. Definisce entità, attributi e relazioni che descrivono la struttura e il significato dei dati prima che vengano decisi dettagli relativi all'API o all'implementazione.
Domain Slice Un sottoinsieme piccolo e coerente del proprio modello di business — tipicamente una o due entità correlate utilizzate come punto di partenza per la modellazione.
Mockomat Una piattaforma SaaS multi-tenant per la modellazione del dominio, la simulazione di mock API e la generazione di codice backend. Gli utenti definiscono schemi visivamente, mappano i dati e ottengono API GraphQL attive istantaneamente.
Project Una definizione completa di mock API che include un domain model, mappature dati, configurazione API e dati mock associati. Ogni progetto ha uno slug e un endpoint univoci.
Workspace L'ambiente centrale in cui gli utenti costruiscono, configurano, validano e iterano su un progetto di mock API. Contiene la modelling board, il table editor, la vista API design e l'anteprima runtime.
Modellazione
Attribute Un campo o colonna di un'entità. Ogni attributo ha un nome, un tipo (string, number, boolean, date, json) e flag di configurazione che controllano il comportamento dell'API.
Cardinality La relazione quantitativa tra entità: uno-a-uno (1:1), uno-a-molti (1:n) o molti-a-molti (m:n).
Entity / Table Un concetto di business fondamentale rappresentato nel modello (es. Customer, Order, Invoice). Visualizzato come una table card sulla modelling board.
Filterable Un flag dell'attributo che abilita le operazioni di filtro sul campo nelle query GraphQL. Solo i campi filterable accettano espressioni di filtro.
Hint Un segnale operativo nell'anteprima che avvisa l'utente di problemi nel modello: attributi non mappati, disallineamenti di configurazione o target di relazione mancanti.
Modelling Board Il canvas visivo nello workspace in cui le entità vengono create, posizionate e connesse tramite interazione drag-and-drop.
Naming Convention Pattern standardizzati: PascalCase singolare per le entità (es. Customer), camelCase per gli attributi (es. firstName).
Relation Una connessione tra due entità che definisce come i dati fluiscono tra di esse. Ha una direzione (sorgente → destinazione) e una cardinalità (1:1, 1:n, m:n).
Required Un flag dell'attributo che indica che il campo deve sempre avere un valore. Influisce sulla nullability GraphQL nello schema generato.
Searchable Un flag dell'attributo che include il campo nella risoluzione delle query di ricerca.
Sortable Un flag dell'attributo che abilita le operazioni di ordinamento sul campo. Solo i campi sortable possono essere utilizzati nei parametri sort.
Table Card La rappresentazione visiva di un'entità sulla modelling board, che mostra il nome della tabella, le colonne, gli indicatori di relazione e i pulsanti di azione.
Table Editor Il pannello di configurazione che si apre selezionando una tabella sulla modelling board, fornendo la configurazione dettagliata di attributi e relazioni.
Fonti dati e mappatura
CONST Un tipo di data mapping che assegna un valore fisso e costante a ogni record (es. "active" per un campo di stato).
Data Mapping La configurazione che collega un attributo di un'entità a una fonte dati, determinando quali valori il campo restituisce a runtime.
Data Object Una definizione semantica di campo con tag e dati di esempio, utilizzata come sorgente per le mappature OFF_FIELD. Parte del corpus semantico.
Dataset Una collezione di dati del mondo reale (es. cataloghi prodotti da Open Food Facts) che può essere mappata agli attributi tramite mappatura OFF_FIELD.
FAKE Un tipo di data mapping che utilizza Faker per generare dati sintetici realistici: nomi, email, indirizzi, date, prezzi e altro.
Faker Una libreria open-source che genera dati sintetici realistici seguendo pattern del mondo reale (formati di nomi corretti, strutture email valide, prezzi realistici).
OFF_FIELD Un tipo di data mapping che mappa un attributo a un campo di un dataset del mondo reale (es. Open Food Facts), producendo valori realistici e diversificati.
Synthetic Data Dati generati da Faker che imitano pattern reali ma sono fittizi, mai derivati da fonti di produzione.
API e GraphQL
API Contract La specifica formale dei nomi delle query, delle strutture dei campi e della disponibilità delle operazioni da cui dipendono i consumer esterni.
API Design View Un'area dello workspace in cui gli utenti controllano quali operazioni GraphQL sono esposte e come sono denominate le query.
Code-First GraphQL L'approccio utilizzato da Mockomat in cui gli schema GraphQL sono generati dalle definizioni del modello e dai decoratori, anziché scritti manualmente come file SDL.
Detail Query Una query GraphQL che restituisce un singolo record tramite il suo identificatore (es. product(id: "abc-123")).
Dynamic Schema Generation Il processo in cui Mockomat genera uno schema GraphQL completamente tipizzato al volo dalle definizioni del modello di un progetto.
Endpoint Il percorso URL in cui i consumer interrogano una mock API: POST /mock/{slug}/graphql.
Filter Expression Una condizione o un insieme di condizioni utilizzate per restringere i risultati delle query. Supporta l'algebra booleana con operatori AND/OR e annidamento.
Filter Operator Un'operazione di confronto utilizzata nelle espressioni di filtro: EQ, NE, LT, GT, LE, GE, LIKE, IS_NULL, IS_NOT_NULL.
GraphQL Il linguaggio di query e il pattern di API design utilizzato da Mockomat sia per la management API che per gli endpoint del mock runtime.
List Query Una query GraphQL che restituisce una collezione paginata di record con filtro e ordinamento opzionali (es. products(limit: 20)).
Offset-Based Pagination Il metodo di paginazione utilizzato da Mockomat: offset (elementi da saltare) + limit (elementi da restituire).
Operation Exposure La configurazione di quali operazioni GraphQL (elenco, dettaglio) sono disponibili per ogni entità.
Query Naming La denominazione personalizzata dei punti di ingresso GraphQL: le query di elenco hanno come predefinito il plurale (es. products), le query di dettaglio il singolare (es. product).
Slug / Project Slug Un identificatore URL-safe per un progetto utilizzato nel percorso dell'endpoint API (es. customer-portal → /mock/customer-portal/graphql).
Runtime
Aggregation Pipeline Il framework di elaborazione dati multi-stage di MongoDB, utilizzato dal query builder del runtime per eseguire query, filtri, ordinamenti e lookup delle relazioni.
Mock Runtime / Runtime Engine Il motore principale che accetta query GraphQL e le traduce in operazioni MongoDB attraverso una pipeline a quattro stadi: parse → plan → build → assemble.
MongoDB Query Builder Il terzo stadio della pipeline del runtime che traduce un piano di esecuzione in una aggregation pipeline MongoDB.
Preview L'interfaccia runtime nell'applicazione in cui gli utenti testano il proprio modello con query live e ispezionano i dati delle risposte insieme agli hint di prontezza.
Query Planner Il secondo stadio della pipeline del runtime che analizza una query analizzata insieme ai metadati del modello per creare un piano di esecuzione.
Relation Traversal La capacità del runtime di simulare dati relazionali a partire da collezioni MongoDB piatte costruendo stage di lookup nella aggregation pipeline.
Request Parser / GraphQL Request Parser Il primo stadio della pipeline del runtime che analizza una stringa di query in ingresso trasformandola in un abstract syntax tree (AST).
Result Assembler Il quarto stadio della pipeline del runtime che rimodella i risultati MongoDB nella struttura di risposta GraphQL attesa.
Runtime Validation Il processo di conferma che le decisioni di dominio e API di un modello si comportino correttamente sotto l'esecuzione di query reali.
Views Diverse prospettive sullo stesso modello: vista board, vista dettaglio tabella, vista API design, anteprima runtime — navigabili tramite cross-link.
Esportazione e generazione del codice
Code Generation / Codegen Il processo automatizzato di creazione di un progetto backend funzionante a partire da un domain model Mockomat.
Controller Il livello REST API nel codice NestJS generato, che espone endpoint HTTP con decoratori di route e annotazioni Swagger.
DTO (Data Transfer Object) Oggetti strutturati con decoratori class-validator (@IsString(), @IsNumber(), @IsOptional()) che applicano la validazione degli input nei backend generati.
Export La funzionalità che genera un backend NestJS pronto per la produzione a partire da un progetto Mockomat. Il codice generato è di proprietà al 100% dell'utente.
Generated Backend Un progetto NestJS completo prodotto dalla funzionalità di esportazione: moduli, controller/resolver, service, entity, DTO e configurazione.
Mongoose Una libreria ODM (Object-Document Mapping) per MongoDB, disponibile come opzione di persistenza nei backend generati.
NestJS Il framework Node.js utilizzato come target principale di generazione del codice. I backend generati seguono le convenzioni standard di NestJS.
Resolver Il livello API GraphQL nel codice NestJS generato, che espone endpoint di query e mutation utilizzando decoratori GraphQL.
TypeORM Una libreria ORM (Object-Relational Mapping) per database SQL (PostgreSQL, MySQL, MariaDB), disponibile come opzione di persistenza nei backend generati.
Autenticazione e sicurezza
Actor Token Un token a tempo limitato emesso ai consumer API esterni per il tracciamento della concorrenza. Incluso tramite l'header X-Actor-Token.
API Key Una credenziale emessa per progetto per autenticare i consumer esterni rispetto agli endpoint privati della mock API. Inclusa tramite l'header Authorization: Bearer.
Concurrent Session Una connessione utente autenticata simultaneamente attiva. Ogni livello di piano ha un limite massimo di sessioni simultanee.
JWT (JSON Web Token) Un formato di token utilizzato per l'autenticazione stateless nella management API di Mockomat.
Private Endpoint Un endpoint mock API che richiede l'autenticazione tramite API key, disponibile nei piani Business e superiori.
Public Endpoint Un endpoint mock API accessibile senza autenticazione, soggetto a rate limiting per IP.
Rate Limiting Il sistema che applica i limiti di richieste per periodo di fatturazione. Restituisce HTTP 429 (Too Many Requests) con un header Retry-After quando viene superato.
Session Una connessione browser autenticata che viene conteggiata nel limite di sessioni simultanee del tenant.
SSO / SAML Single Sign-On e Security Assertion Markup Language — protocolli di gestione dell'identità enterprise (funzionalità pianificata).
Piani e accesso
Business (Piano) Un livello a pagamento ($19/mese) che offre endpoint privati, API key, accesso basato su ruoli, 50.000 richieste/mese e fino a 25 progetti.
Business Pro (Piano) Un livello a pagamento ($49/mese) che aggiunge team multi-utente, analytics degli endpoint, 250.000 richieste/mese e progetti illimitati.
Enterprise (Piano) Un livello a prezzo personalizzato che offre richieste illimitate, dataset personalizzati, SSO/SAML, SLA, deployment on-premise e limiti di sessione configurabili.
Free (Piano) Un livello gratuito che richiede la registrazione dell'account, che offre fino a 5 progetti, 1.000 richieste/giorno e endpoint pubblici.
Quick (Piano) Il livello istantaneo senza login che offre un progetto temporaneo basato su sessione con un endpoint pubblico. Il lavoro viene perso al termine della sessione del browser.
Team e governance
Admin Un ruolo utente con accesso completo a progetti, gestione del team e configurazione del tenant.
Domain Ownership Responsabilità assegnata per una specifica area di dominio aziendale e le relative definizioni del modello all'interno del team.
Governance Politiche e controlli che assicurano coerenza, qualità e conformità negli sforzi di modellazione del team: convenzioni di denominazione, gate di revisione e criteri di validazione.
Guest Un ruolo utente con accesso in sola lettura ai progetti condivisi e all'anteprima.
Multi-Tenancy L'architettura di sistema che isola i dati, gli schemi e la configurazione di ogni organizzazione attraverso un accesso con ambito tenant.
Review Gate Un checkpoint obbligatorio in cui le modifiche al modello, all'API o all'esportazione vengono validate prima della promozione — ad esempio la validazione runtime pre-esportazione.
Tenant Un confine organizzativo isolato con collezioni dati dedicate, configurazione indipendente e rate limiting separato.
User Un ruolo utente che può creare, modificare ed esportare progetti all'interno del team.
User Admin Un ruolo utente che può gestire i membri del team e assegnare ruoli senza accesso completo di amministrazione.
Infrastruttura e deployment
Data Sovereignty Il requisito che tutti i dati rimangano all'interno dell'infrastruttura del cliente, soddisfatto dall'opzione di deployment on-premise.
Docker Tecnologia di containerizzazione utilizzata per il packaging e il deployment delle istanze Mockomat.
On-Premise Deployment Un'installazione Mockomat self-hosted in esecuzione sull'infrastruttura del cliente per un controllo completo dei dati ($1.000 di setup + $199/mese).
SLA (Service Level Agreement) Un impegno formale su disponibilità, tempi di risposta e livelli di supporto per i clienti Enterprise.