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 progetto Mockomat pronto all'uso per un dominio comune (Utenti & Profili, E-Commerce, Auto & Veicoli, Immobiliare, Arredamento & Casa, Cibo & Ristoranti). I blueprint possono essere clonati in un workspace e personalizzati. Vedi Blueprints.
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 di mock API: un modello di dominio, i suoi mapping dei dati e la sua configurazione API. Ogni progetto ha uno slug univoco e un proprio endpoint di mock API.
Workspace Un gruppo di progetti all'interno del Tuo account. Ogni account ha un workspace; a partire da Professional puoi crearne altri. La sezione Workspace di questa documentazione tratta la board di modellazione, l'editor delle tabelle, la vista di design API e l'anteprima runtime.
Modellazione
Attribute Un campo di una tabella. Ogni attributo ha un nome, un tipo (es. String, Integer, Float, Boolean, Date, JSON, Enum), un mapping dei dati e flag come Required e Searchable.
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 di attributo salvato con il modello. Il mock runtime non lo legge: il filtro usa i parametri di un'operazione (vedi API Design (in inglese)).
Hint Un messaggio nell'anteprima runtime che spiega perché una tabella non mostra dati o cosa configurare dopo — ad esempio, che una tabella non è mappata su dati importati.
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 di attributo che indica che il campo deve avere un valore. L'export OpenAPI lo riporta come proprietà obbligatoria.
Searchable Un flag di attributo che include il campo nella ricerca searchTerm, senza distinzione tra maiuscole e minuscole, delle operazioni di lista.
Sortable Un flag di attributo salvato con il modello e usato per le colonne di lista dell'export del codice. Il mock runtime non lo legge: sortField accetta qualsiasi attributo collegato a una colonna di dati.
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
COMPUTED Un tipo di data mapping che memorizza un'espressione su altri campi dello stesso record. Il runtime non valuta le espressioni, quindi un campo calcolato non fa parte della risposta. L'editor degli attributi non offre più Calcolato; un attributo che ha già un mapping calcolato lo mantiene ed è contrassegnato come non valutato.
CONSTANT Un tipo di data mapping che fissa un unico valore su un attributo (es. "active" per un campo di stato); il runtime lo restituisce su ogni riga, sia nelle righe di dati importati sia nelle righe composte da pool di valori.
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 colonna di una tabella del pool di dati di Mockomat, proposta nel pannello di mapping quando colleghi un attributo con un mapping SOURCE.
Dataset Un insieme di dati che Mockomat importa nel suo pool di dati — dati aperti dove esiste una fonte verificata, dati di esempio generati per i blueprint; gli attributi ne leggono le colonne tramite mapping SOURCE.
SOURCE (Sorgente dati) Un tipo di data mapping che collega un attributo a una colonna dei dataset importati nel pool di dati di Mockomat; il runtime restituisce le righe importate e non inventa mai valori.
Value Pool (pool di valori) Una tabella di valori senza contesto (nomi, vie) da cui altre tabelle compongono le proprie righe: combinazioni coerenti, mai valori inventati.
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 Un filtro di scope o un parametro di operazione che restringe i risultati delle query. Tutte le condizioni di un'operazione si combinano con AND.
Filter Operator Un confronto usato da parametri e filtri di scope: eq, neq, gt, gte, lt, lte, in, like; i filtri di scope anche notIn, isNull, isNotNull.
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(page: 1, pageSize: 20) { items { … } total }).
Page-Based Pagination Il metodo di paginazione utilizzato da Mockomat: page (numero di pagina, da 1) + pageSize (record per pagina, al massimo 100).
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.
DTO (Data Transfer Object) Le classi di input di creazione e aggiornamento di un backend generato, una coppia per tabella, con decoratori class-validator.
Export La funzionalità che esporta un progetto come specifica OpenAPI o, a partire da Professional, come pacchetto di codice NestJS generato. Il codice generato appartiene all'utente. Vedi Export.
Generated Backend Il progetto NestJS di un pacchetto di codice: un modulo per tabella con entità, resolver, service e tipi di input, più autenticazione e configurazione.
NestJS Il framework Node.js dei backend generati. Il codice generato segue le convenzioni standard di NestJS.
Resolver Il livello API GraphQL del codice NestJS generato: le query e le mutation di una tabella.
TypeORM La libreria ORM (Object-Relational Mapping) dei backend generati; le entità generate puntano a MySQL / MariaDB.
Autenticazione e sicurezza
Actor Token Un token opzionale a tempo limitato che distingue i consumer di una stessa API key per il tracciamento della concorrenza. Inviato nell'header X-Actor-Token.
API Key Una credenziale emessa per progetto per autenticare i consumer esterni verso la mock API di quel progetto, obbligatoria per ogni progetto di un account. Inviata nell'header Authorization: Bearer (oppure X-API-Key); le API key sono incluse dal piano Professional in su.
Concurrent Session Essere connessi su più di un dispositivo o browser contemporaneamente. Su Starter, un account può essere connesso in un solo posto alla volta: un accesso altrove chiude la sessione precedente. Su Professional, Business ed Enterprise il proprietario dell'account può restare connesso su più dispositivi contemporaneamente. I membri invitati non ottengono questa possibilità dall'account a cui si uniscono: possono essere connessi in un solo posto alla volta, a meno che non siano proprietari di un account il cui piano consenta di più.
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: l'endpoint di ogni progetto di un account.
Public Endpoint Un endpoint mock API raggiungibile senza API key. Solo i progetti ospite ne hanno uno: si apre con il token di condivisione del progetto ed è soggetto a rate limiting per IP.
Rate Limiting I limiti delle richieste alla mock API: un limite per indirizzo IP e la quota di richieste del Tuo piano (al giorno o per mese di calendario). Entrambi rispondono HTTP 429 (Too Many Requests) se superati; il limite per IP invia anche un header Retry-After.
Session Un accesso su un dispositivo o browser. Una sessione termina quando esci, dopo un periodo di inattività o quando la Tua password cambia.
Piani e accesso
Business (Piano) Un livello a pagamento, fatturato mensilmente, che estende Professional con team più grandi, più gestori e analytics degli endpoint.
Enterprise (Piano) Un livello concordato con il nostro team commerciale (prezzo su richiesta, nessun checkout self-service); i suoi limiti — progetti, richieste, dimensione del team — vengono adattati per contratto.
Guest (Piano) Il livello istantaneo senza login che offre un progetto temporaneo basato su sessione, il cui endpoint si apre con il suo token di condivisione. Il lavoro resta nel browser per un tempo limitato; quando ti registri, l'app offre di spostarlo nel Tuo account.
Professional (Piano) Un livello a pagamento, fatturato mensilmente, che offre endpoint privati, API key, accesso del team basato sui ruoli e una quota mensile di richieste.
Starter (Piano) Il livello gratuito che richiede la registrazione dell'account, con progetti persistenti e una quota giornaliera di richieste nell'app; chiamare la mock API dal proprio codice richiede API key (dal piano Professional).
I limiti attuali di ogni piano sono sulla pagina dei prezzi e in Account e piani.
Team e governance
Domain Ownership Responsabilità assegnata per una specifica area di dominio aziendale e le relative definizioni del modello all'interno del team.
Editore (editor) Un ruolo di workspace che costruisce il modello, crea progetti, gestisce le API key ed esegue l'export del codice. Comprende tutto ciò che può fare un Reporter.
Gestore (maintainer) Un ruolo di workspace che aggiunge a tutto ciò che può fare un Editore l'eliminazione dei progetti, la gestione dei membri e del loro accesso ai progetti e la gestione dei workspace. I gestori vedono tutti i progetti dell'account.
Governance Politiche e controlli che assicurano coerenza e qualità negli sforzi di modellazione del team: convenzioni di denominazione, gate di revisione e criteri di validazione.
Multi-Tenancy L'architettura che separa progetti, modelli, membri e configurazione di ogni account attraverso un accesso con ambito account. I dati mock provengono dal pool condiviso in sola lettura.
Proprietario La persona che ha creato l'account. Il proprietario ha un'appartenenza da Gestore, gestisce la fatturazione e non può essere rimosso dall'account.
Reporter (reporter) Un ruolo di workspace che aggiunge note della board e commenti a tutto ciò che può fare un membro in Solo lettura.
Review Gate Un checkpoint in cui le modifiche al modello, all'API o all'esportazione vengono validate prima che i consumer vi facciano affidamento — ad esempio la validazione runtime prima di un export.
Solo lettura (readonly) Un ruolo di workspace che vede i progetti, il modello e l'anteprima dei dati e legge le note della board.
Team del tenant I membri del Tuo account e i loro ruoli di workspace, gestiti in Account → Tenant → Team. Vedi Team & Roles (in inglese).
Tenant Un confine organizzativo isolato con propri membri, progetti, API key, configurazione e limiti di piano. I dati mock provengono dal pool condiviso in sola lettura.
Infrastruttura e deployment
Docker Tecnologia di containerizzazione. Un pacchetto di codice contiene un file Docker Compose che avvia MySQL e Redis per il backend generato, ma nessun Dockerfile per il backend stesso; aggiungine uno per la piattaforma di destinazione per eseguirlo in un container (vedi Export).