Primeros pasos

Esta sección ayuda a un usuario nuevo a pasar del primer acceso a un primer flujo de trabajo fiable en una sola sesión. Al final, dispondrás de un modelo de dominio funcional con datos asociados, una API GraphQL operativa que puedes consultar, y una comprensión clara de los pasos siguientes.

Lo que vas a construir

En esta guía, tú vas a:

1. Acceder a Mockomat y elegir tu modo de trabajo.
2. Crear una tabla de dominio que represente un concepto de negocio real.
3. Agregar atributos con los tipos y asociaciones apropiados.
4. Establecer al menos una relación con otra entidad.
5. Previsualizar tu modelo a través del runtime en vivo.
6. Validar que la API devuelve las estructuras de datos esperadas.

El proceso completo toma aproximadamente 15 minutos.

gs-01-start-entryMissing

Punto de entrada desde la página de inicio al workspace de la aplicación.

Paso 1: Elige tu modo de acceso

Mockomat ofrece dos modos de acceso, cada uno diseñado para una fase de trabajo diferente:

Modo invitado (inicio rápido)

El modo invitado es la forma más rápida de obtener una API mock funcional. Sin registro, sin configuración — simplemente abre Mockomat y comienza a modelar.

Lo que obtienes:

• Un proyecto temporal cuyo endpoint mock se abre con su token de compartición
• Acceso completo al board de modelado, configuración de atributos y previsualización
• El mismo pool de datos compartido y los mismos tipos de asociación que en todos los planes
• Un endpoint GraphQL operativo que puedes consultar inmediatamente

Limitaciones:

• Tu trabajo se conserva en este navegador hasta que termina tu sesión de invitado de 24 horas. Las 24 horas cuentan desde el inicio de tu sesión de invitado, que la aplicación inicia la primera vez que la abres en este navegador, así que un proyecto que crees más tarde tiene menos tiempo. Una limpieza que se ejecuta cada hora elimina después el proyecto, por lo que puede quedarse hasta una hora más.
• Borrar las cookies hace que tu trabajo se pierda antes; regístrate para conservarlo — la aplicación ofrece mover el proyecto a tu cuenta
• Un solo proyecto a la vez
• Sin compartición en equipo
• Sin claves API: el endpoint se abre con el token de compartición del proyecto

El modo invitado es ideal para la validación rápida de ideas, demostraciones y la evaluación de la pertinencia de Mockomat para tu flujo de trabajo.

Modo cuenta (workspace persistente)

El modo cuenta agrega persistencia, gestión de proyectos y la posibilidad de evolucionar con el tiempo.

Lo que obtienes (Starter, gratuito):

• 1 proyecto guardado (más a partir de Professional)
• Modelos persistentes que sobreviven a las sesiones del navegador
• 1000 solicitudes API por día
• La vista previa del runtime de cada proyecto en la aplicación (las llamadas desde tu propio código requieren claves API, a partir del plan Professional)

Cuándo cambiar:

• Cuando tu primer modelo resulta útil y deseas conservarlo
• Cuando quieres compartir tu trabajo — mediante enlaces de vista previa y de colaboración o, a partir de Professional, invitando a miembros del equipo
• Cuando deseas iterar a lo largo de múltiples sesiones

Consejo para Guest y Starter

Free User

Comienza en modo invitado para probar rápidamente un escenario de dominio concreto. Enfócate en la claridad del nombrado, los campos obligatorios y el comportamiento de los datos. Si tu modelo se mantiene después de algunas consultas, crea una cuenta gratuita para guardarlo.

Consejo para usuario registered

Registered User

Pasa al modo cuenta en cuanto tu primer modelo sea útil. La persistencia y la repetibilidad se vuelven más valiosas que la sola velocidad inmediata. Con una cuenta, tu proyecto se conserva hasta que lo elimines y, a partir de Professional, puedes invitar a tu equipo.

gs-02-guest-workspaceMissing

Workspace invitado con primera tabla de dominio.

Paso 2: Modela una porción real de tu dominio

Una porción de dominio es un pequeño subconjunto coherente de tu modelo de negocio. Comienza con una o dos entidades que representen algo real en tu sistema.

Elige nombres significativos

Evita nombres de ejemplos genéricos. Usa el vocabulario de negocio que tu equipo ya emplea:

Buenos ejemplos:

• Customer, Subscription, Invoice
• Order, Payment, Shipment
• Product, Category, Review
• Employee, Department, TimeEntry

A evitar:

• Table1, TestEntity, MyModel
• Data, Item, Thing

Los nombres significativos hacen que tu modelo sea autodocumentado e inmediatamente útil para las discusiones de equipo.

Agrega atributos

Cada entidad necesita atributos que describan tus datos. Al agregar atributos, considera:

Propiedad	Propósito	Ejemplo
Nombre	Identificador descriptivo	firstName, totalAmount, isActive
Tipo	Tipo de dato	String, Integer, Boolean, Date
Obligatorio	Debe tener siempre un valor	true para email, false para middleName
Buscable	Participa en la búsqueda searchTerm	true para name, title

Los flags ordenable y filtrable no cambian la mock API: puedes ordenar por cualquier atributo vinculado a una columna de datos, y el filtrado usa los parámetros que defines en una operación en el API design.

Consejo práctico: Comienza con 4 a 6 atributos esenciales por entidad. Siempre puedes agregar más después, pero un modelo enfocado proporciona mejor retroalimentación que uno amplio y superficial.

Elige las asociaciones de datos

Cada atributo necesita una fuente de datos. Mockomat soporta tres tipos de asociación:

Fuente de datos (SOURCE) — Datos importados

Vincula el atributo a una columna del pool de datos compartido — datasets importados: datos abiertos donde existe una fuente verificada, datos de ejemplo generados para los blueprints. El runtime sirve las filas importadas y nunca inventa valores. Ideal para nombres, direcciones, datos de producto, categorías, fechas e importes.

Constante (CONSTANT) — Valores fijos

Fija un valor único en el atributo, p. ej. un estado por defecto ("active"). El runtime lo devuelve en cada fila, tanto en las filas de datos importados como en las filas compuestas a partir de pools de valores.

Calculado (COMPUTED) — Expresiones

Guarda una expresión sobre otros campos, p. ej. un nombre completo a partir del nombre y el apellido. El runtime no evalúa expresiones, por lo que un campo calculado no forma parte de la respuesta. El editor de atributos ya no ofrece Calculado; un atributo que ya tiene una asociación calculada la conserva y se marca como no evaluado.

gs-03-first-tableMissing

Creación de la primera tabla y configuración de atributos.

Establece una relación

Una vez modelada una entidad, agrega una segunda y conéctalas:

1. Crea una segunda tabla (ej. Order, si tu primera fue Customer).
2. Define el tipo de relación: ¿un cliente tiene varias órdenes (1:n)? ¿Una orden pertenece a exactamente un cliente?
3. Establece la dirección: ¿qué entidad posee la relación?

Las relaciones son esenciales para probar cómo tu API maneja los datos anidados. Un modelo con al menos una relación te proporciona una retroalimentación significativamente más rica en la previsualización.

gs-03b-first-relationMissing

Primera configuración de relación entre dos entidades.

Paso 3: Valida con la previsualización

La previsualización no es solo para demostraciones. Es un punto de control de calidad del modelo. Cada vez que modificas tu modelo, ejecuta una previsualización para confirmar que el cambio se comporta como esperabas.

Qué verificar

Legibilidad de campos — ¿Los nombres de campos devueltos tienen sentido? ¿Son consistentes (camelCase en todas partes, sin abreviaturas)?

Consistencia de la estructura de datos — ¿Cada campo devuelve el tipo esperado? ¿Las cadenas son realmente cadenas, los números son realmente números?

Comportamiento de las relaciones — Cuando consultas una entidad padre, ¿las entidades hijas aparecen correctamente anidadas? ¿La cardinalidad es correcta (arreglo para 1:n, objeto único para 1:1)?

Señales de asociación faltante — Si una tabla no está vinculada a datos importados, la previsualización lo indica y la API no devuelve filas para ella. Vincula la tabla antes de continuar.

Comportamiento de filtros y ordenamiento — Prueba un parámetro que hayas definido en la operación y ordena por un atributo con sortField. ¿Los resultados tienen sentido?

Problemas comunes de previsualización

Problema	Causa probable	Solución
Un campo devuelve null	Ninguna asociación configurada	Vincular el atributo a una columna de datos (asociación Fuente de datos)
Una relación devuelve un arreglo vacío	Relación mal definida	Verificar la dirección de la relación y la entidad destino
El ordenamiento no tiene efecto	sortField no es el nombre de un atributo asociado	Usar el nombre de un atributo vinculado a una columna de datos
El filtro devuelve todos los registros	La operación no define ningún parámetro para ese argumento	Añadir el parámetro en el API design

gs-04-first-previewMissing

Primera previsualización con campos asociados y no asociados.

Paso 4: Consulta tu API

Una vez que la previsualización es correcta, tu API mock ya está operativa. Llámala desde cualquier cliente GraphQL o HTTP con una clave API del proyecto; las claves API están incluidas a partir del plan Professional. Un proyecto de invitado usa en su lugar su token de compartición (?token=…). Encontrarás los detalles en Integradores.

El endpoint de tu proyecto es:

POST /mock/{su-slug-de-proyecto}/graphql
Authorization: Bearer mck_your_api_key

Prueba una consulta de lista simple:

query {
  customers(page: 1, pageSize: 10) {
    items {
      id
      firstName
      lastName
      email
      orders {
        id
        totalAmount
        createdAt
      }
    }
    total
  }
}

La respuesta contiene las filas importadas a las que apuntan tus asociaciones, con las relaciones automáticamente resueltas.

gs-04b-first-queryMissing

Primera consulta GraphQL contra el endpoint mock operativo.

Paso 5: Determine los siguientes pasos

Después de tu primer ciclo modelo-consulta exitoso, se abren varias direcciones:

• Profundizar tu modelo — agregar más entidades, refinar atributos, establecer más relaciones.
• Configurar la exposición API — definir qué operaciones están disponibles, establecer las convenciones de nombrado de consultas.
• Ir hacia la exportación — si el modelo es suficientemente estable, explorar la generación de código para obtener un backend NestJS listo para producción.
• Usar blueprints — explorar modelos de dominio preconfigurados para acelerar proyectos futuros.
• Compartir con tu equipo — crear una cuenta (si está en modo invitado) e invitar colaboradores.

Consejo para usuario paid

Paid User

Después de la primera validación, estandarice el nombrado de tus tablas y tu estrategia de operaciones. Esto facilita la colaboración y la gobernanza más adelante. Define las convenciones temprano — ganan en valor a medida que el proyecto crece.

Consejo para usuario enterprise

Enterprise User

Trata el primer flujo de trabajo como un proyecto piloto. Define las convenciones temprano (nombrado, responsabilidad, criterios de validación) y reutilícelas entre equipos. Un piloto bien estructurado se convierte en el modelo para cada proyecto siguiente.

gs-05-next-stepsMissing

Punto de decisión después del primer ciclo de previsualización exitoso.

Lo que tiene ahora

Al final de esta guía, dispone de:

• Un modelo de dominio con al menos una entidad, atributos significativos y asociaciones de datos configuradas
• Un endpoint de API GraphQL operativo que devuelve filas del pool de datos
• La confirmación de que tu modelo se comporta como esperaba durante consultas reales
• Una comprensión clara del flujo de trabajo Modelo → Previsualización → Consulta

A partir de aquí, explora los Conceptos clave para comprender la arquitectura detrás de lo que acaba de crear, o sumérjase en el Workspace para una guía detallada de las herramientas de modelado.