Blueprints

Les blueprints sont des points de départ structurés pour les équipes qui veulent une mise en place rapide sans sacrifier la clarté architecturale. Au lieu de construire chaque entité, attribut et relation à partir de zéro, tu pars d'un modèle de domaine éprouvé et le personnalises selon tes besoins spécifiques.

Ce qu'un blueprint fournit

Un blueprint est un projet Mockomat complet et préconstruit qui inclut :

• Entités de base cohérentes — un ensemble de tables de domaine qui fonctionnent ensemble comme une unité logique (ex. Product, Category, Review pour un domaine e-commerce).
• Stratégie de relations initiale — les relations entre entités sont déjà définies avec la cardinalité et la direction correctes.
• Configuration des attributs — chaque entité est livrée avec des attributs significatifs, des types et des flags (triable, filtrable, recherchable) déjà définis.
• Associations de données — les champs sont pré-associés aux sources de données appropriées (jeux de données réels, Faker, constantes) pour que le blueprint fonctionne immédiatement en prévisualisation.
• Attentes d'opérations de démarrage — les noms de requêtes API et l'exposition des opérations sont configurés pour les cas d'utilisation typiques.
• Valeurs par défaut significatives — pagination, tri et filtrage sont configurés pour que le comportement en prévisualisation soit utile dès le départ.

Le résultat est un projet que tu peux cloner et interroger en quelques secondes — puis personnaliser à ton rythme.

bp-01-blueprint-galleryMissing

Galerie de blueprints avec aperçu par catégorie et complexité.

Catégories de blueprints disponibles

Les blueprints couvrent les patterns de domaine courants que les équipes rencontrent fréquemment :

Catégorie	Entités exemples	Cas d'utilisation typique
E-Commerce	Product, Category, Order, Customer, Review	Boutiques en ligne, places de marché, catalogues produits
Blog / CMS	Post, Author, Category, Comment, Tag	Plateformes de contenu, workflows éditoriaux
CRM	Contact, Company, Deal, Activity, Pipeline	Équipes commerciales, suivi de relations clients
Gestion de projet	Project, Task, Team, Member, Sprint	Workflows agiles, systèmes de suivi de tâches
SaaS / Abonnement	Subscription, Plan, Invoice, Customer, Payment	Facturation SaaS, gestion d'abonnements
Inventaire	Product, Warehouse, StockLevel, Supplier, Transfer	Gestion d'entrepôt, chaîne d'approvisionnement
RH / Personnel	Employee, Department, Position, TimeEntry, Leave	Systèmes RH, gestion des effectifs

Chaque blueprint est conçu par des architectes expérimentés et vérifié pour sa qualité structurelle. Les entités, relations et conventions de nommage suivent les principes du domain-driven design.

bp-01b-blueprint-categoriesMissing

Cartes de catégories de blueprints avec nombre d'entités et indicateur de complexité.

Comment utiliser efficacement un blueprint

1. Parcourir et sélectionner

Ouvre la galerie de blueprints et parcours par catégorie. Chaque carte de blueprint affiche :

• La catégorie de domaine
• Le nombre d'entités incluses
• Une brève description du cas d'utilisation couvert
• Un indicateur de complexité (simple, modéré, complet)

Sélectionne le blueprint le plus proche de ton domaine cible. Il n'a pas besoin d'être une correspondance parfaite — tu le personnaliseras dans les étapes suivantes.

2. Cloner dans ton workspace

Clique sur le bouton de clonage pour créer une copie du blueprint dans ton workspace. Cela crée un nouveau projet avec toutes les entités, attributs, relations et associations du blueprint. Le blueprint original n'est pas modifié.

Ce qui est cloné :

• Toutes les tables et leurs attributs
• Toutes les définitions de relations
• Toutes les associations de données (OFF_FIELD, FAKE, CONST)
• La configuration API (noms de requêtes, exposition des opérations)
• Les valeurs par défaut de pagination et de tri

Ce qui n'est pas cloné :

• Le nom du blueprint original (tu choisis un nouveau nom de projet)
• Les métadonnées ou badges spécifiques au blueprint
• L'historique des jobs d'import

3. Renommer avec ton vocabulaire métier

Remplace les noms génériques du blueprint par la terminologie réelle de ton équipe. Si le blueprint utilise Product mais que ton domaine l'appelle Listing ou Item, renomme-le maintenant. Un nommage cohérent dès le départ évite la confusion par la suite.

4. Vérifier les attributs table par table

Parcours chaque entité et vérifie :

• Tous les attributs sont-ils pertinents pour ton domaine ?
• Aie-toi besoin d'attributs supplémentaires non présents dans le blueprint ?
• Les types sont-ils corrects (string, number, boolean, date) ?
• Les bons champs sont-ils marqués comme triables, filtrables et recherchables ?

Supprime les attributs dont tu n'as pas besoin et ajoutes ceux qui manquent. Le blueprint te donne la structure — tu fournis les spécificités du domaine.

5. Valider via la prévisualisation

Exécute une requête de prévisualisation pour confirmer que le modèle cloné et personnalisé fonctionne correctement. Vérifie que :

• Les associations de données produisent des valeurs réalistes
• Les relations se résolvent comme attendu
• Les filtres et tris fonctionnent sur les champs que tu as configurés
• La forme de réponse globale correspond aux attentes de ton frontend

bp-02-blueprint-cloneMissing

Flux de clonage de blueprint dans le workspace actif.

Stratégie de personnalisation

Ne réécris pas tout d'un coup. Conserve le squelette du blueprint et fais évoluer en passes focalisées. Cette approche préserve l'intégrité structurelle tout en permettant un affinement progressif.

Passe 1 : Nommage et attributs essentiels

Concentre-toi uniquement sur le renommage et l'ajustement des attributs les plus importants :

• Renommer les entités pour correspondre à ton vocabulaire métier
• Renommer les attributs clés (identifiants, noms d'affichage, valeurs principales)
• Ajouter 1 à 2 attributs critiques par entité que le blueprint n'inclut pas
• Supprimer les attributs clairement non pertinents

Ne pas ajuster les relations, la configuration API ou les associations dans cette passe.

Passe 2 : Nettoyage des relations

Avec les noms stabilisés, vérifie et ajuste les relations :

• Vérifier que la cardinalité est correcte pour ton domaine (1:1, 1:n, m:n)
• Ajuster la direction si le modèle de propriété du blueprint ne correspond pas au vôtre
• Ajouter les relations que le blueprint n'inclut pas
• Supprimer les relations qui ne s'appliquent pas

Exécute une prévisualisation après cette passe pour confirmer que les requêtes imbriquées se résolvent encore correctement.

Passe 3 : Alignement de l'exposition API

Configure quelles opérations sont disponibles et comment elles sont nommées :

• Renommer les requêtes pour correspondre à tes conventions API
• Activer ou désactiver les opérations de liste/détail par entité
• Ajuster les valeurs par défaut de pagination
• Définir des configurations de filtre et de tri appropriées

Passe 4 : Validation runtime

Passe de validation finale :

• Exécuter des requêtes complètes contre chaque entité
• Tester tous les filtres et tris
• Vérifier la traversée des relations à chaque niveau
• Résoudre toutes les indications ou avertissements restants

Après cette passe, ton blueprint personnalisé devrait être prêt pour la production en tant qu'API mock.

bp-03-blueprint-customizeMissing

Personnalisation de blueprint dans les vues modèle et API.

Critères de qualité des blueprints

Chaque blueprint de la galerie respecte des standards de qualité minimaux :

• Au moins 2 entités avec des noms et descriptions significatifs
• Au moins 1 relation connectant les entités
• Associations d'attributs complètes — aucun champ non associé
• Conventions de nommage correctes — entités en PascalCase, attributs en camelCase
• Aucun nom placeholder ou aléatoire — tous les noms reflètent de vrais concepts de domaine
• Prévisualisation fonctionnelle — le blueprint produit des résultats de requête valides dès le départ

Ces critères garantissent que chaque blueprint est immédiatement utile, et pas seulement un squelette.

Blueprints officiels et communautaires

Les blueprints se déclinent en deux catégories :

Blueprints officiels

Créés et maintenus par l'équipe Mockomat. Ils sont :

• Vérifiés pour la qualité structurelle et les conventions de nommage
• Mis à jour avec les nouvelles fonctionnalités et bonnes pratiques
• Marqués d'un badge « Officiel » dans la galerie
• Garantis de fonctionner avec la version actuelle de la plateforme

Blueprints communautaires (à venir)

Publiés par des utilisateurs enregistrés et partagés avec la communauté. Les blueprints communautaires :

• Passent par une revue qualité automatisée (nommage, structure, complétude)
• Sont modérés par l'équipe Mockomat
• Affichent le nom de l'auteur et le nombre de clonages
• Peuvent être promus au statut officiel si la qualité est exceptionnelle

bp-04-community-blueprintsMissing

Soumission et flux de revue de blueprints communautaires.

Conseil pour utilisateur free

Free User

Les blueprints sont le moyen le plus rapide d'apprendre les patterns de qualité de modèle. Clone un blueprint, explore sa structure et compare les conventions de nommage et les patterns de relations avec tes propres décisions. C'est un moyen pratique d'améliorer tes compétences en modélisation.

Conseil pour utilisateur registered

Registered User

Sauvegarde tes blueprints personnalisés comme des projets séparés. Cela te permet de maintenir une bibliothèque personnelle de modèles de domaine que tu peux réutiliser entre projets et partager avec tes coéquipiers.

Conseil enterprise

Enterprise User

Maintiens un catalogue de blueprints interne par domaine métier. Définis des conventions de nommage et des patterns de relations à l'échelle de l'organisation dans tes blueprints, puis distribue-les aux équipes comme point de départ standard pour les nouveaux projets. Cela améliore la gouvernance et accélère les démarrages de projets cohérents.