Blueprints
Los blueprints son puntos de partida estructurados para equipos que desean una configuración rápida sin sacrificar la claridad arquitectónica. En lugar de construir cada entidad, atributo y relación desde cero, tú partes de un modelo de dominio probado y lo personalizas según tus necesidades específicas.
Lo que un blueprint proporciona
Un blueprint es un proyecto Mockomat completo y preconstruido que incluye:
- Entidades base coherentes — un conjunto de tablas de dominio que funcionan juntas como una unidad lógica (ej.
Product,Category,Reviewpara un dominio de e-commerce). - Estrategia de relaciones inicial — las relaciones entre entidades ya están definidas con la cardinalidad y dirección correctas.
- Configuración de atributos — cada entidad viene con atributos significativos, tipos y flags (ordenable, filtrable, buscable) ya definidos.
- Asociaciones de datos — los campos están pre-asociados a las fuentes de datos apropiadas (datasets reales, Faker, constantes) para que el blueprint funcione inmediatamente en previsualización.
- Expectativas de operaciones de inicio — los nombres de consultas API y la exposición de operaciones están configurados para los casos de uso típicos.
- Valores predeterminados significativos — paginación, ordenamiento y filtrado están configurados para que el comportamiento en previsualización sea útil desde el principio.
El resultado es un proyecto que tú puedes clonar y consultar en segundos — luego personalizar a tu ritmo.
Galería de blueprints con vista por categoría y complejidad.
Categorías de blueprints disponibles
Los blueprints cubren los patrones de dominio comunes que los equipos encuentran frecuentemente:
| Categoría | Entidades de ejemplo | Caso de uso típico |
|---|---|---|
| E-Commerce | Product, Category, Order, Customer, Review | Tiendas en línea, marketplaces, catálogos de productos |
| Blog / CMS | Post, Author, Category, Comment, Tag | Plataformas de contenido, flujos editoriales |
| CRM | Contact, Company, Deal, Activity, Pipeline | Equipos comerciales, seguimiento de relaciones con clientes |
| Gestión de proyectos | Project, Task, Team, Member, Sprint | Flujos ágiles, sistemas de seguimiento de tareas |
| SaaS / Suscripción | Subscription, Plan, Invoice, Customer, Payment | Facturación SaaS, gestión de suscripciones |
| Inventario | Product, Warehouse, StockLevel, Supplier, Transfer | Gestión de almacenes, cadena de suministro |
| RR.HH. / Personal | Employee, Department, Position, TimeEntry, Leave | Sistemas de RR.HH., gestión del personal |
Cada blueprint está diseñado por arquitectos experimentados y verificado por su calidad estructural. Las entidades, relaciones y convenciones de nombrado siguen los principios del domain-driven design.
Tarjetas de categorías de blueprints con cantidad de entidades e indicador de complejidad.
Cómo usar un blueprint eficazmente
1. Explorar y seleccionar
Abre la galería de blueprints y explora por categoría. Cada tarjeta de blueprint muestra:
- La categoría de dominio
- La cantidad de entidades incluidas
- Una breve descripción del caso de uso cubierto
- Un indicador de complejidad (simple, moderado, completo)
Selecciona el blueprint más cercano a tu dominio objetivo. No necesita ser una coincidencia perfecta — tú lo personalizarás en los pasos siguientes.
2. Clonar en tu workspace
Haz clic en el botón de clonar para crear una copia del blueprint en tu workspace. Esto crea un nuevo proyecto con todas las entidades, atributos, relaciones y asociaciones del blueprint. El blueprint original no se modifica.
Lo que se clona:
- Todas las tablas y sus atributos
- Todas las definiciones de relaciones
- Todas las asociaciones de datos (OFF_FIELD, FAKE, CONST)
- La configuración API (nombres de consultas, exposición de operaciones)
- Los valores predeterminados de paginación y ordenamiento
Lo que no se clona:
- El nombre del blueprint original (tú eliges un nuevo nombre de proyecto)
- Los metadatos o badges específicos del blueprint
- El historial de trabajos de importación
3. Renombrar con tu vocabulario de negocio
Reemplaza los nombres genéricos del blueprint por la terminología real de tu equipo. Si el blueprint usa Product pero tu dominio lo llama Listing o Item, renómbralo ahora. Un nombrado consistente desde el principio evita confusión después.
4. Revisar atributos tabla por tabla
Recorre cada entidad y verifica:
- ¿Todos los atributos son relevantes para tu dominio?
- ¿Necesitas atributos adicionales no presentes en el blueprint?
- ¿Los tipos son correctos (string, number, boolean, date)?
- ¿Los campos correctos están marcados como ordenables, filtrables y buscables?
Elimina los atributos que no necesitas y agrega los que faltan. El blueprint te da la estructura — tú provees las especificidades del dominio.
5. Validar mediante previsualización
Ejecuta una consulta de previsualización para confirmar que el modelo clonado y personalizado funciona correctamente. Verifica que:
- Las asociaciones de datos producen valores realistas
- Las relaciones se resuelven como se espera
- Los filtros y ordenamientos funcionan en los campos que configuraste
- La forma de respuesta general coincide con las expectativas de tu frontend
Flujo de clonación de blueprint en el workspace activo.
Estrategia de personalización
No reescribas todo de una vez. Conserva el esqueleto del blueprint y evoluciona en pasadas enfocadas. Este enfoque preserva la integridad estructural mientras permite un refinamiento progresivo.
Pasada 1: Nombrado y atributos esenciales
Enfócate únicamente en renombrar y ajustar los atributos más importantes:
- Renombrar entidades para coincidir con tu vocabulario de negocio
- Renombrar atributos clave (identificadores, nombres de visualización, valores principales)
- Agregar 1 a 2 atributos críticos por entidad que el blueprint no incluye
- Eliminar atributos claramente irrelevantes
No ajusta relaciones, configuración API o asociaciones en esta pasada.
Pasada 2: Limpieza de relaciones
Con los nombres estabilizados, verifica y ajusta las relaciones:
- Verificar que la cardinalidad es correcta para tu dominio (1:1, 1:n, m:n)
- Ajustar la dirección si el modelo de propiedad del blueprint no coincide con el tuyo
- Agregar relaciones que el blueprint no incluye
- Eliminar relaciones que no aplican
Ejecuta una previsualización después de esta pasada para confirmar que las consultas anidadas aún se resuelven correctamente.
Pasada 3: Alineación de la exposición API
Configura qué operaciones están disponibles y cómo se nombran:
- Renombrar consultas para coincidir con tus convenciones API
- Activar o desactivar operaciones de lista/detalle por entidad
- Ajustar los valores predeterminados de paginación
- Definir configuraciones de filtro y ordenamiento apropiadas
Pasada 4: Validación runtime
Pasada de validación final:
- Ejecutar consultas completas contra cada entidad
- Probar todos los filtros y ordenamientos
- Verificar el recorrido de relaciones en cada nivel
- Resolver todas las indicaciones o advertencias restantes
Después de esta pasada, tu blueprint personalizado debería estar listo para producción como API mock.
Personalización de blueprint en las vistas de modelo y API.
Criterios de calidad de los blueprints
Cada blueprint de la galería cumple estándares de calidad mínimos:
- Al menos 2 entidades con nombres y descripciones significativos
- Al menos 1 relación conectando las entidades
- Asociaciones de atributos completas — ningún campo sin asociar
- Convenciones de nombrado correctas — entidades en PascalCase, atributos en camelCase
- Sin nombres placeholder o aleatorios — todos los nombres reflejan conceptos de dominio reales
- Previsualización funcional — el blueprint produce resultados de consulta válidos desde el inicio
Estos criterios garantizan que cada blueprint sea inmediatamente útil, y no solo un esqueleto.
Blueprints oficiales y comunitarios
Los blueprints se dividen en dos categorías:
Blueprints oficiales
Creados y mantenidos por el equipo Mockomat. Son:
- Verificados por calidad estructural y convenciones de nombrado
- Actualizados con nuevas funcionalidades y buenas prácticas
- Marcados con un badge "Oficial" en la galería
- Garantizados de funcionar con la versión actual de la plataforma
Blueprints comunitarios (próximamente)
Publicados por usuarios registrados y compartidos con la comunidad. Los blueprints comunitarios:
- Pasan por una revisión de calidad automatizada (nombrado, estructura, completitud)
- Son moderados por el equipo Mockomat
- Muestran el nombre del autor y la cantidad de clonaciones
- Pueden ser promovidos a estado oficial si la calidad es excepcional
Envío y flujo de revisión de blueprints comunitarios.