Blueprint

I blueprint sono punti di partenza strutturati per team che desiderano una configurazione rapida senza sacrificare la chiarezza architetturale. Invece di costruire ogni entità, attributo e relazione da zero, si parte con un template di dominio collaudato e lo si personalizza per le proprie esigenze specifiche.

Cosa fornisce un blueprint

Un blueprint è un progetto Mockomat completo e predefinito che include:

• Entità di base coerenti — un insieme di tabelle di dominio che funzionano insieme come unità logica (es. Product, Category, Review per un dominio e-commerce).
• Strategia di relazioni iniziale — le relazioni tra entità sono già definite con cardinalità e direzione corrette.
• Configurazione degli attributi — ogni entità include attributi significativi, tipi e flag (sortable, filterable, searchable) già impostati.
• Mapping dei dati — i campi sono già mappati a fonti dati appropriate (dataset reali, Faker, costanti) così il blueprint funziona immediatamente nell'anteprima.
• Aspettative operative di partenza — i nomi delle query API e l'esposizione delle operazioni sono configurati per i casi d'uso tipici.
• Valori predefiniti significativi — paginazione, ordinamento e filtri sono configurati in modo che il comportamento dell'anteprima sia utile fin da subito.

Il risultato è un progetto che puoi clonare e interrogare in pochi secondi — per poi personalizzarlo con i Tuoi tempi.

bp-01-blueprint-galleryMissing

Galleria dei blueprint con panoramica di categorie e complessità.

Categorie di blueprint disponibili

I blueprint coprono pattern di dominio comuni che i team incontrano frequentemente:

Categoria	Entità di esempio	Caso d'uso tipico
E-Commerce	Product, Category, Order, Customer, Review	Negozi online, marketplace, cataloghi prodotti
Blog / CMS	Post, Author, Category, Comment, Tag	Piattaforme di contenuti, workflow editoriali
CRM	Contact, Company, Deal, Activity, Pipeline	Team commerciali, tracciamento delle relazioni con i clienti
Project Management	Project, Task, Team, Member, Sprint	Workflow agili, sistemi di tracciamento task
SaaS / Subscription	Subscription, Plan, Invoice, Customer, Payment	Fatturazione SaaS, gestione abbonamenti
Inventory	Product, Warehouse, StockLevel, Supplier, Transfer	Gestione magazzino, supply chain
HR / People	Employee, Department, Position, TimeEntry, Leave	Sistemi HR, gestione del personale

Ogni blueprint è progettato da architetti esperti e revisionato per la qualità strutturale. Le entità, le relazioni e le convenzioni di denominazione seguono i principi del domain-driven design.

bp-01b-blueprint-categoriesMissing

Schede delle categorie di blueprint con conteggio entità e indicatore di complessità.

Come utilizzare un blueprint efficacemente

1. Sfogliare e selezionare

Apri la galleria dei blueprint e sfoglia per categoria. Ogni scheda blueprint mostra:

• La categoria di dominio
• Il numero di entità incluse
• Una breve descrizione del caso d'uso coperto
• L'indicatore di complessità (semplice, moderato, completo)

Seleziona il blueprint che più si avvicina al Tuo dominio di destinazione. Non è necessario che sia una corrispondenza perfetta — lo personalizzerai nei passi successivi.

2. Clonare nel Tuo workspace

Clicca il pulsante di clonazione per creare una copia del blueprint nel Tuo workspace. Questo crea un nuovo progetto con tutte le entità, gli attributi, le relazioni e i mapping del blueprint. Il blueprint originale non viene modificato.

Cosa viene clonato:

• Tutte le tabelle e i loro attributi
• Tutte le definizioni delle relazioni
• Tutti i mapping dei dati (OFF_FIELD, FAKE, CONST)
• La configurazione API (nomi delle query, esposizione delle operazioni)
• I valori predefiniti di paginazione e ordinamento

Cosa non viene clonato:

• Il nome del blueprint originale (Tu scegli un nuovo nome per il progetto)
• Eventuali metadati o badge specifici del blueprint
• Lo storico dei job di importazione

3. Rinominare con il Tuo linguaggio di business

Sostituisci i nomi generici del blueprint con la terminologia effettiva del Tuo team. Se il blueprint usa Product ma nel Tuo dominio si chiama Listing o Item, rinominalo adesso. Una denominazione coerente fin dall'inizio previene confusione in seguito.

4. Rivedere gli attributi tabella per tabella

Esamina ogni entità e verifica:

• Tutti gli attributi sono rilevanti per il Tuo dominio?
• Hai bisogno di attributi aggiuntivi non presenti nel blueprint?
• I tipi sono corretti (string, number, boolean, date)?
• I campi giusti sono contrassegnati come sortable, filterable e searchable?

Rimuovi gli attributi non necessari e aggiungi quelli mancanti. Il blueprint Ti fornisce la struttura — Tu fornisci le specificità del dominio.

5. Validare tramite anteprima

Esegui una query di anteprima per confermare che il modello clonato e personalizzato funzioni correttamente. Verifica che:

• I mapping dei dati producano valori realistici
• Le relazioni si risolvano come previsto
• I filtri e gli ordinamenti funzionino sui campi configurati
• La struttura complessiva della risposta corrisponda alle aspettative del Tuo frontend

bp-02-blueprint-cloneMissing

Flusso di clonazione del blueprint nel workspace attivo.

Strategia di personalizzazione

Non riscrivere tutto in una volta. Mantieni lo scheletro del blueprint ed evolvi in passate focalizzate. Questo approccio preserva l'integrità strutturale consentendo un perfezionamento progressivo.

Passata 1: Denominazione e attributi principali

Si concentri solo sulla rinomina e sulla regolazione degli attributi più importanti:

• Rinominare le entità per corrispondere al Tuo linguaggio di business
• Rinominare gli attributi chiave (identificatori, nomi visualizzati, valori principali)
• Aggiungere 1-2 attributi critici per entità che il blueprint non include
• Rimuovere gli attributi chiaramente irrilevanti

Non modificare relazioni, configurazione API o mapping in questa passata.

Passata 2: Pulizia delle relazioni

Con i nomi stabilizzati, rivedi e regola le relazioni:

• Verificare che la cardinalità sia corretta per il Tuo dominio (1:1, 1:n, m:n)
• Regolare la direzione se il modello di ownership del blueprint non corrisponde al Tuo
• Aggiungere relazioni che il blueprint non include
• Rimuovere relazioni che non si applicano

Esegui l'anteprima dopo questa passata per confermare che le query annidate si risolvano ancora correttamente.

Passata 3: Allineamento dell'esposizione API

Configura quali operazioni sono disponibili e come sono denominate:

• Rinominare le query per corrispondere alle Tue convenzioni API
• Abilitare o disabilitare le operazioni di lista/dettaglio per entità
• Regolare i valori predefiniti di paginazione
• Impostare configurazioni appropriate di filtro e ordinamento

Passata 4: Validazione a runtime

Passata di validazione finale:

• Eseguire query complete su ogni entità
• Testare tutti i filtri e gli ordinamenti
• Verificare l'attraversamento delle relazioni a ogni livello
• Risolvere eventuali suggerimenti o avvisi rimanenti

Dopo questa passata, il Tuo blueprint personalizzato dovrebbe essere pronto per la produzione come mock API.

bp-03-blueprint-customizeMissing

Personalizzazione del blueprint nelle viste modello e API.

Criteri di qualità dei blueprint

Ogni blueprint nella galleria soddisfa standard di qualità minimi:

• Almeno 2 entità con nomi e descrizioni significativi
• Almeno 1 relazione che collega le entità
• Mapping degli attributi completi — nessun campo non mappato
• Convenzioni di denominazione corrette — entità in PascalCase, attributi in camelCase
• Nessun nome segnaposto o casuale — tutti i nomi riflettono concetti di dominio reali
• Anteprima funzionante — il blueprint produce risultati di query validi immediatamente

Questi criteri garantiscono che ogni blueprint sia immediatamente utile, non un semplice scheletro.

Blueprint ufficiali e della community

I blueprint sono suddivisi in due categorie:

Blueprint ufficiali

Creati e mantenuti dal team Mockomat. Sono:

• Revisionati per qualità strutturale e convenzioni di denominazione
• Aggiornati con nuove funzionalità e best practice
• Contrassegnati con un badge "Ufficiale" nella galleria
• Garantiti per funzionare con la versione corrente della piattaforma

Blueprint della community (in arrivo)

Pubblicati da utenti registrati e condivisi con la community. I blueprint della community:

• Sono sottoposti a una revisione di qualità automatizzata (denominazione, struttura, completezza)
• Sono moderati dal team Mockomat
• Mostrano il nome dell'autore e il conteggio delle clonazioni
• Possono essere promossi a stato ufficiale se la qualità è eccezionale

bp-04-community-blueprintsMissing

Flusso di sottomissione e revisione dei blueprint della community.

Suggerimento per utenti free

Free User

I blueprint sono il modo più rapido per apprendere i pattern di qualità nella modellazione. Clona un blueprint, esplora la sua struttura e confronta le convenzioni di denominazione e i pattern di relazione con le Tue decisioni. Questo è un modo pratico per migliorare le Tue competenze di modellazione.

Suggerimento per utenti registrati

Registered User

Salva i Tuoi blueprint personalizzati come progetti separati. Questo Ti permette di mantenere una libreria personale di template di dominio che puoi riutilizzare in diversi progetti e condividere con i colleghi.

Suggerimento enterprise

Enterprise User

Mantieni un catalogo interno di blueprint per dominio di business. Definisci convenzioni di denominazione e pattern di relazione a livello di organizzazione nei Tuoi blueprint, quindi distribuiscili ai team come punto di partenza standard per i nuovi progetti. Questo migliora la governance e accelera l'avvio coerente dei progetti.