FAQ
Generale
Cos'è Mockomat?
Mockomat è una piattaforma di modellazione del dominio e simulazione API. Si definisce il proprio modello dati visivamente, lo si mappa a fonti dati realistiche e si ottiene un'API GraphQL attiva istantaneamente, senza scrivere codice backend. Quando il modello è pronto, è possibile esportare un backend NestJS pronto per la produzione di cui si è interamente proprietari.
A chi si rivolge Mockomat?
Mockomat è progettato per:
- Sviluppatori frontend che necessitano di un backend realistico per sviluppare prima che l'API reale sia pronta.
- Ingegneri full-stack che desiderano prototipare modelli di dominio e validare il comportamento delle API rapidamente.
- Agenzie che realizzano progetti per clienti e necessitano di mock API rapide per demo e sviluppo.
- Architetti che desiderano validare la struttura del dominio e i contratti API prima di impegnarsi nell'implementazione.
- Formatori che insegnano API design, GraphQL o sviluppo domain-driven.
- Team che necessitano di una mock API condivisa e realistica per lo sviluppo parallelo di frontend e backend.
Mockomat è solo un mock server?
No. La simulazione runtime è uno dei risultati, ma il valore fondamentale è il controllo a livello di dominio dal modello fino alla consegna dell'implementazione. Mockomat offre un percorso strutturato dalla modellazione del dominio alla definizione dell'API, dalla validazione runtime alla generazione del codice. La mock API è un mezzo per validare l'architettura, non solo per servire dati fittizi.
Mockomat sostituisce gli strumenti di intelligenza artificiale?
No. L'intelligenza artificiale accelera la generazione di codice; Mockomat mantiene struttura e intento espliciti man mano che i sistemi evolvono. Si complementano a vicenda: si utilizzi l'IA per generare codice rapidamente, si utilizzi Mockomat per assicurare che il modello di dominio sottostante e i contratti API rimangano coerenti, revisionabili e tracciabili.
Come si confronta Mockomat con strumenti come Postman o Stoplight?
Postman e Stoplight sono eccellenti per il test e la documentazione delle API. Mockomat opera a un livello diverso:
- Postman si concentra sul test di API esistenti. Mockomat crea l'API a partire da un modello di dominio.
- Stoplight si concentra sul design e la documentazione delle API. Mockomat aggiunge la simulazione runtime e la generazione di codice.
- Mockomat copre l'intera pipeline: modellare, simulare, validare, generare il backend. Non è uno strumento di test, ma una piattaforma di modellazione e generazione.
Per iniziare
È possibile iniziare senza creare un account?
Sì. La modalità ospite (livello Quick) consente di iniziare immediatamente senza registrazione. Si ottiene un progetto temporaneo con un endpoint GraphQL pubblico. Il lavoro è legato alla sessione del browser: si crei un account quando si desidera salvarlo.
Qual è la differenza tra Quick e Free?
| Quick | Free | |
|---|---|---|
| Registrazione | Non richiesta | Account richiesto |
| Progetti | 1 temporaneo | Fino a 5 persistenti |
| Persistenza | Solo sessione (perso alla chiusura della scheda) | Salvato tra le sessioni |
| Richieste API | Rate limiting per IP | 1.000 al giorno |
| Endpoint | Pubblico | Pubblico |
Quick è per l'esplorazione istantanea. Free è per il lavoro continuativo.
Quanto tempo serve per configurare una mock API funzionante?
Circa 15 minuti per un modello di base con alcune entità e relazioni. Consultare la guida Per iniziare per una procedura passo passo.
Dati e mappatura
Quali fonti dati utilizza Mockomat?
Mockomat supporta tre tipi di mappatura per la generazione dei valori dei campi:
- OFF_FIELD — mappa a campi di dataset del mondo reale (es. Open Food Facts) per dati realistici e diversificati.
- FAKE — utilizza Faker per generare dati sintetici: nomi, email, indirizzi, date, prezzi e altro.
- CONST — restituisce un valore fisso per ogni record (es. uno stato predefinito come
"active").
I clienti Enterprise possono inoltre caricare dataset proprietari personalizzati.
I dati sono realistici?
Sì. Le mappature OFF_FIELD utilizzano dati reali di prodotti provenienti da dataset con licenza aperta, e Faker genera dati sintetici realistici che seguono pattern del mondo reale (formati di nomi corretti, strutture email valide, fasce di prezzo realistiche). I dati non sono casuali e privi di senso: sono progettati per risultare autentici.
E la privacy dei dati?
Mockomat archivia i metadati del progetto (definizioni del modello, mappature, configurazione) ma non gestisce dati reali di produzione. Le mock API servono dati sintetici o supportati da dataset, mai informazioni reali dei clienti. Questo rende Mockomat intrinsecamente sicuro per gli ambienti di sviluppo ed elimina le preoccupazioni relative ai dati personali.
È possibile importare uno schema esistente?
L'importazione OpenAPI è supportata come fonte di input per la funzionalità di esportazione (generazione del codice). Formati di importazione aggiuntivi (JSON Schema, importazione code-first) sono pianificati per le versioni future.
Aspetti tecnici
Quale stack tecnologico utilizza Mockomat?
- Backend: NestJS, Apollo GraphQL (code-first), MongoDB, MariaDB, Redis
- Frontend: Angular 21, NgRx, Apollo Angular, Angular Material
- Generazione del codice: Python con template Jinja2
- Infrastruttura: Docker, distribuibile su AWS, GCP o qualsiasi ambiente di hosting Node.js
Cosa include il backend generato?
La funzionalità di esportazione genera un progetto NestJS completo con:
- Moduli di dominio (uno per entità) con controller/resolver, service, entity e DTO
- Configurazione del database (TypeORM per SQL o Mongoose per MongoDB)
- Scaffolding opzionale per l'autenticazione JWT
- Validazione degli input con decoratori class-validator
- Un README con istruzioni di configurazione
Per i dettagli completi, consultare la documentazione sull'Esportazione.
Il backend generato è pronto per la produzione?
Il codice generato compila, si avvia e serve l'API progettata. È un punto di partenza di alta qualità, non un prodotto finito. Sarà necessario aggiungere la logica di business personalizzata, integrare servizi esterni, configurare l'infrastruttura di produzione e scrivere i test. Lo si consideri come l'eliminazione della fase di scaffolding, affinché il team possa concentrarsi sul valore di business fin dal primo giorno.
È possibile utilizzare il codice generato a fini commerciali?
Sì. Il codice generato è di proprietà al 100% dell'utente, senza restrizioni di licenza. È possibile modificarlo, distribuirlo, ridistribuirlo e commercializzarlo senza attribuzione né costi.
È possibile distribuire su AWS, GCP, Azure o on-premise?
Sì. Il backend generato è un'applicazione NestJS standard che funziona ovunque Node.js sia eseguibile. Non è richiesto alcun runtime o SDK specifico di Mockomat.
È necessario conoscere NestJS per utilizzare Mockomat?
Non per modellare, simulare o esportare. La conoscenza di NestJS è necessaria per estendere il backend generato con logica di business personalizzata. Il codice generato segue le convenzioni NestJS, per cui qualsiasi sviluppatore NestJS può iniziare a lavorarci immediatamente.
Quali operazioni GraphQL sono supportate?
Ogni entità genera:
- Query di elenco — collezione paginata con filtro e ordinamento opzionali
- Query di dettaglio — singolo elemento per ID
Le mutation (create, update, delete) fanno parte del codice backend generato, non del mock runtime.
Piani e prezzi
Come funzionano i prezzi?
Mockomat offre un livello gratuito generoso e scala con le esigenze:
- Quick (gratuito) — nessun login, 1 progetto temporaneo
- Free (gratuito) — account richiesto, 5 progetti, 1.000 req/giorno
- Business ($19/mese) — endpoint privati, API key, 50k req/mese
- Business Pro ($49/mese) — team, analytics, 250k req/mese
- Enterprise (personalizzato) — illimitato, dataset personalizzati, SLA
Per i dettagli completi, consultare la pagina Account e piani.
È possibile collaborare con il proprio team?
- Free: nessuna funzionalità di collaborazione — i progetti sono personali.
- Business: accesso basato su ruoli per la condivisione di progetti con permessi controllati.
- Business Pro: team multi-utente con gestione delle sessioni simultanee.
- Enterprise: gestione completa del team con ruoli di amministrazione, limiti di sessione configurabili e funzionalità di audit.
Cosa succede se si supera il limite di richieste?
L'API restituisce HTTP 429 (Too Many Requests) con un header Retry-After. I limiti del livello Free si resettano giornalmente a mezzanotte UTC. I limiti dei livelli a pagamento si resettano alla data di fatturazione. È possibile acquistare capacità aggiuntiva di richieste come add-on.
Blueprint
Cos'è un blueprint?
Un blueprint è un template di progetto Mockomat predefinito che copre un pattern di dominio comune (es. E-Commerce, CRM, Blog). Si clona un blueprint nel proprio workspace e lo si personalizza con i propri nomi, attributi e relazioni. Evita di dover costruire strutture comuni da zero.
È possibile creare i propri blueprint?
La pubblicazione di blueprint da parte della community è una funzionalità pianificata. Attualmente tutti i blueprint sono curati dal team Mockomat. In futuro, gli utenti registrati potranno sottoporre i propri progetti come blueprint della community.
Risoluzione dei problemi
La query restituisce dati vuoti
Verificare che:
- L'importazione dei dati sia stata completata per la collezione pertinente.
- Tutti gli attributi abbiano mappature dati configurate (OFF_FIELD, FAKE o CONST).
- Le espressioni di filtro non siano troppo restrittive.
Le relazioni restituiscono array vuoti
Verificare che:
- La direzione della relazione sia corretta (sorgente → destinazione).
- L'entità di destinazione esista e abbia dati mappati.
- La cardinalità corrisponda all'aspettativa della query (1:1 restituisce un oggetto, 1:n restituisce un array).
L'ordinamento o il filtro non hanno effetto
Verificare che il campo sia contrassegnato come sortable o filterable nel table editor. Solo i campi con questi flag abilitati partecipano alle operazioni di ordinamento e filtro.
Perché alcuni screenshot sono indicati come mancanti?
La documentazione viene costruita con ID e placeholder degli screenshot in anticipo. Questo consente di procedere con la produzione dei contenuti mentre le catture finali vengono preparate. Gli screenshot mancanti saranno sostituiti con le catture reali non appena disponibili.
Funzionalità future
Sarà disponibile uno strumento CLI?
È pianificato uno strumento CLI che supporterà login, generazione del codice, anteprima locale e integrazione CI/CD dalla riga di comando.
Saranno disponibili ulteriori target di esportazione?
NestJS è il target di esportazione principale. Target aggiuntivi (Laravel, Prisma, TYPO3) sono pianificati per le versioni future in base alla domanda.
Sarà disponibile la collaborazione in tempo reale?
La modifica collaborativa in tempo reale (più utenti che modificano lo stesso modello contemporaneamente) è nella roadmap per i piani Enterprise.
Placeholder visivo della pagina FAQ.