Glosario
Una referencia completa de términos, conceptos y vocabulario técnico utilizados en la documentación de Mockomat. Los términos están agrupados por categoría y ordenados alfabéticamente dentro de cada grupo.
Plataforma y producto
Blueprint Un proyecto de Mockomat listo para usar para un dominio común (Usuarios & Perfiles, Comercio Electrónico, Coches & Vehículos, Bienes Raíces, Muebles & Hogar, Comida & Restaurantes). Los blueprints se pueden clonar en un workspace y personalizar. Ver Blueprints.
Domain Model (modelo de dominio) La fundación semántica de un proyecto. Define entidades, atributos y relaciones que describen la estructura y el significado de tus datos antes de cualquier decisión de API o implementación.
Domain Slice (porción de dominio) Un pequeño subconjunto coherente de tu modelo de negocio — típicamente una o dos entidades relacionadas usadas como punto de partida para el modelado.
Mockomat Una plataforma SaaS multi-tenant para modelado de dominio, simulación de API mock y generación de código backend. Los usuarios definen esquemas visualmente, asocian datos y obtienen APIs GraphQL operativas al instante.
Project (proyecto) Una definición de mock API: un modelo de dominio, sus asociaciones de datos y su configuración de API. Cada proyecto tiene un slug único y su propio endpoint de mock API.
Workspace (espacio de trabajo) Un grupo de proyectos dentro de tu cuenta. Cada cuenta tiene un workspace; a partir de Professional puedes crear más. La sección Workspace de esta documentación cubre el board de modelado, el editor de tablas, la vista de diseño de API y la vista previa del runtime.
Modelado
Attribute (atributo) Un campo de una tabla. Cada atributo tiene un nombre, un tipo (ej. String, Integer, Float, Boolean, Date, JSON, Enum), una asociación de datos y flags como obligatorio y buscable.
Cardinality (cardinalidad) La relación cuantitativa entre entidades: uno a uno (1:1), uno a muchos (1:n) o muchos a muchos (m:n).
Entity / Table (entidad / tabla) Un concepto de negocio central representado en el modelo (ej. Customer, Order, Invoice). Visualizado como una tarjeta de tabla en el board de modelado.
Filterable (filtrable) Un flag de atributo que se guarda con el modelo. El runtime mock no lo lee: el filtrado usa los parámetros de una operación (ver API Design (en inglés)).
Hint (indicación) Un mensaje en la vista previa del runtime que explica por qué una tabla no muestra datos o qué configurar a continuación — por ejemplo, que una tabla no está asignada a datos importados.
Modelling Board (board de modelado) El canvas visual en el workspace donde las entidades se crean, posicionan y conectan mediante interacción de arrastrar y soltar.
Naming Convention (convención de nombrado) Patrones estandarizados: PascalCase singular para entidades (ej. Customer), camelCase para atributos (ej. firstName).
Relation (relación) Una conexión entre dos entidades que define cómo fluyen los datos entre ellas. Tiene una dirección (origen → destino) y una cardinalidad (1:1, 1:n, m:n).
Required (obligatorio) Un flag de atributo que indica que el campo debe tener un valor. La exportación OpenAPI lo lista como propiedad obligatoria.
Searchable (buscable) Un flag de atributo que incluye el campo en la búsqueda searchTerm, sin distinguir mayúsculas, de las operaciones de lista.
Sortable (ordenable) Un flag de atributo que se guarda con el modelo y se usa para las columnas de lista de la exportación de código. El runtime mock no lo lee: sortField acepta cualquier atributo vinculado a una columna de datos.
Table Card (tarjeta de tabla) La representación visual de una entidad en el board de modelado, mostrando el nombre de la tabla, columnas, indicadores de relación y botones de acción.
Table Editor (editor de tabla) El panel de configuración que se abre al seleccionar una tabla en el board de modelado, proporcionando la configuración detallada de atributos y relaciones.
Fuentes de datos y asociación
COMPUTED Un tipo de asociación que guarda una expresión sobre otros campos del mismo registro. 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.
CONSTANT Un tipo de asociación que fija un valor único en un atributo (ej. "active" para un campo de estado); 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.
Data Mapping (asociación de datos) La configuración que vincula un atributo de entidad a una fuente de datos, determinando qué valores devuelve el campo en tiempo de ejecución.
Data Object (objeto de datos) Una columna de una tabla del pool de datos de Mockomat, que el panel de asociación ofrece cuando vinculas un atributo con una asociación SOURCE.
Dataset Un conjunto de datos que Mockomat importa a su pool de datos — datos abiertos donde existe una fuente verificada, datos de ejemplo generados para los blueprints; los atributos leen sus columnas mediante asociaciones SOURCE.
SOURCE (fuente de datos) Un tipo de asociación que vincula un atributo a una columna de los datasets importados del pool de datos de Mockomat; el runtime sirve las filas importadas y nunca inventa valores.
Value Pool (pool de valores) Una tabla de valores sin contexto (nombres de pila, calles) a partir de la cual otras tablas componen sus filas — combinaciones coherentes, nunca valores inventados.
API y GraphQL
API Contract (contrato API) La especificación formal de nombres de consultas, estructuras de campos y disponibilidad de operaciones de la que dependen los consumidores externos.
API Design View (vista de diseño API) Un área del workspace donde los usuarios controlan qué operaciones GraphQL se exponen y cómo se nombran las consultas.
Code-First GraphQL El enfoque usado por Mockomat donde los esquemas GraphQL se generan a partir de definiciones de modelo y decoradores en lugar de escribirse manualmente como archivos SDL.
Detail Query (consulta de detalle) Una consulta GraphQL que devuelve un solo registro por su identificador (ej. product(id: "abc-123")).
Dynamic Schema Generation (generación dinámica de esquema) El proceso donde Mockomat genera un esquema GraphQL completamente tipado al vuelo a partir de las definiciones de modelo de un proyecto.
Endpoint La ruta URL donde los consumidores consultan una API mock: POST /mock/{slug}/graphql.
Filter Expression (expresión de filtro) Un filtro de alcance o parámetro de operación que refina los resultados de consulta. Todas las condiciones de una operación se combinan con AND.
Filter Operator (operador de filtro) Una comparación que usan los parámetros y los filtros de alcance: eq, neq, gt, gte, lt, lte, in, like; los filtros de alcance también notIn, isNull, isNotNull.
GraphQL El lenguaje de consulta y patrón de diseño API usado por Mockomat tanto para la API de gestión como para los endpoints mock runtime.
List Query (consulta de lista) Una consulta GraphQL que devuelve una colección paginada de registros con filtrado y ordenamiento opcionales (ej. products(page: 1, pageSize: 20) { items { … } total }).
Page-Based Pagination (paginación por páginas) El método de paginación usado por Mockomat: page (número de página, desde 1) + pageSize (registros por página, como máximo 100).
Operation Exposure (exposición de operaciones) La configuración de qué operaciones GraphQL (lista, detalle) están disponibles para cada entidad.
Query Naming (nombrado de consultas) El nombrado personalizado de los puntos de entrada GraphQL — las consultas de lista usan por defecto el plural (ej. products), las de detalle el singular (ej. product).
Slug / Project Slug Un identificador URL-safe para un proyecto usado en la ruta del endpoint API (ej. customer-portal → /mock/customer-portal/graphql).
Runtime
Aggregation Pipeline (pipeline de agregación) El framework de procesamiento de datos multi-etapa de MongoDB, usado por el query builder del runtime para ejecutar consultas, filtros, ordenamientos y lookups de relación.
Mock Runtime / Runtime Engine (motor de mock runtime) El motor central que acepta consultas GraphQL y las traduce en operaciones MongoDB mediante una pipeline de cuatro etapas: parse → plan → build → assemble.
MongoDB Query Builder La tercera etapa de la pipeline runtime que traduce un plan de ejecución en una pipeline de agregación MongoDB.
Preview (previsualización) La interfaz runtime integrada donde los usuarios prueban su modelo con consultas en vivo e inspeccionan los datos de respuesta junto con indicaciones de disponibilidad.
Query Planner (planificador de consultas) La segunda etapa de la pipeline runtime que analiza una consulta parseada junto con los metadatos del modelo para crear un plan de ejecución.
Relation Traversal (recorrido de relaciones) La capacidad del runtime de simular datos relacionales a partir de colecciones MongoDB planas construyendo etapas de lookup en la pipeline de agregación.
Request Parser / GraphQL Request Parser (parseador de solicitudes) La primera etapa de la pipeline runtime que parsea una cadena de consulta entrante en un árbol de sintaxis abstracta (AST).
Result Assembler (ensamblador de resultados) La cuarta etapa de la pipeline runtime que reestructura los resultados de MongoDB en la estructura de respuesta GraphQL esperada.
Runtime Validation (validación runtime) El proceso de confirmar que las decisiones de dominio y API de un modelo se comportan correctamente bajo ejecución real de consultas.
Views (vistas) Diferentes perspectivas sobre el mismo modelo — vista del board, vista de detalle de tabla, vista de diseño API, previsualización runtime — navegables mediante enlaces cruzados.
Exportación y generación de código
Code Generation / Codegen (generación de código) El proceso automatizado de crear un proyecto backend funcional a partir de un modelo de dominio Mockomat.
DTO (Data Transfer Object) Las clases de entrada de creación y actualización de un backend generado, un par por tabla, con decoradores de class-validator.
Export (exportación) La funcionalidad que exporta un proyecto como especificación OpenAPI o, a partir de Professional, como paquete de código NestJS generado. El código generado pertenece al usuario. Ver Export.
Generated Backend (backend generado) El proyecto NestJS de un paquete de código: un módulo por tabla con entidad, resolver, servicio y tipos de entrada, además de autenticación y configuración.
NestJS El framework Node.js de los backends generados. El código generado sigue las convenciones estándar de NestJS.
Resolver La capa de API GraphQL del código NestJS generado: las consultas y mutaciones de una tabla.
TypeORM La biblioteca ORM (Object-Relational Mapping) de los backends generados; las entidades generadas apuntan a MySQL / MariaDB.
Autenticación y seguridad
Actor Token (token de actor) Un token opcional con tiempo limitado que distingue a los consumidores de una misma clave API para el seguimiento de concurrencia. Se envía en la cabecera X-Actor-Token.
API Key (clave API) Una credencial emitida por proyecto para autenticar a los consumidores externos ante la API mock de ese proyecto; obligatoria para cada proyecto de una cuenta. Se envía en la cabecera Authorization: Bearer (o X-API-Key); las claves API están incluidas a partir del plan Professional.
Concurrent Session (sesión concurrente) Tener una sesión iniciada en más de un dispositivo o navegador a la vez. En Starter, una cuenta solo puede tener la sesión iniciada en un lugar a la vez: iniciar sesión en otro lugar cierra la sesión anterior. En Professional, Business y Enterprise, el propietario de la cuenta puede mantener la sesión iniciada en varios dispositivos a la vez. Los miembros invitados no lo obtienen de la cuenta a la que se unen: solo pueden tener la sesión iniciada en un lugar a la vez, salvo que sean propietarios de una cuenta cuyo plan permita más.
JWT (JSON Web Token) Un formato de token usado para autenticación sin estado en la API de gestión de Mockomat.
Private Endpoint (endpoint privado) Un endpoint de API mock que requiere autenticación por clave API: el endpoint de cada proyecto de una cuenta.
Public Endpoint (endpoint público) Un endpoint de API mock accesible sin clave API. Solo los proyectos de invitado tienen uno: se abre con el token de compartición del proyecto y está sujeto a limitación de tasa por IP.
Rate Limiting (limitación de tasa) Los límites de las solicitudes a la mock API: un límite por dirección IP y la cuota de solicitudes de tu plan (por día o por mes natural). Ambos responden HTTP 429 (Too Many Requests) al superarse; el límite por IP envía además una cabecera Retry-After.
Session (sesión) Un inicio de sesión en un dispositivo o navegador. Una sesión termina cuando cierras la sesión, tras un periodo sin actividad o cuando cambia tu contraseña.
Planes y acceso
Business (plan) Un nivel de pago, facturado mensualmente, que amplía Professional con equipos más grandes, más mantenedores y analítica de endpoints.
Enterprise (plan) Un nivel acordado con nuestro equipo comercial (precio bajo consulta, sin compra en autoservicio); sus límites — proyectos, solicitudes, tamaño del equipo — se ajustan por contrato.
Guest (plan) El nivel instantáneo sin inicio de sesión que ofrece un proyecto temporal basado en sesión cuyo endpoint se abre con su token de compartición. El trabajo se conserva en el navegador durante un tiempo limitado; al registrarte, la aplicación ofrece moverlo a tu cuenta.
Professional (plan) Un nivel de pago, facturado mensualmente, que ofrece endpoints privados, claves API, acceso de equipo basado en roles y una cuota mensual de solicitudes.
Starter (plan) El nivel gratuito que requiere registro de cuenta, con proyectos persistentes y una cuota diaria de solicitudes en la aplicación; llamar a la API mock desde tu propio código requiere claves API (a partir de Professional).
Los límites actuales de cada plan están en la página de precios y en Cuenta y planes.
Equipo y gobernanza
Domain Ownership (propiedad de dominio) Responsabilidad asignada para un área de dominio de negocio específica y sus definiciones de modelo dentro del equipo.
Editor (editor) Un rol de workspace que construye el modelo, crea proyectos, gestiona las claves API y ejecuta la exportación de código. Incluye todo lo que puede hacer un Reportero.
Equipo del tenant Los miembros de tu cuenta y sus roles de workspace, gestionados en Cuenta → Tenant → Equipo. Ver Team & Roles (en inglés).
Governance (gobernanza) Políticas y controles que aseguran consistencia y calidad a través de los esfuerzos de modelado del equipo — convenciones de nombrado, puntos de control de revisión y criterios de validación.
Mantenedor (maintainer) Un rol de workspace que añade a todo lo que puede hacer un Editor la eliminación de proyectos, la gestión de miembros y de su acceso a proyectos, y la gestión de workspaces. Los mantenedores ven todos los proyectos de la cuenta.
Multi-Tenancy (multi-tenencia) La arquitectura que separa los proyectos, modelos, miembros y la configuración de cada cuenta mediante un acceso limitado a la cuenta. Los datos mock provienen del pool compartido de solo lectura.
Propietario La persona que creó la cuenta. El propietario tiene una membresía de Mantenedor, gestiona la facturación y no puede ser eliminado de la cuenta.
Reportero (reporter) Un rol de workspace que añade notas del board y comentarios a todo lo que puede hacer un miembro de Solo lectura.
Review Gate (punto de control de revisión) Un checkpoint donde los cambios de modelo, API o exportación se validan antes de que los consumidores dependan de ellos — ej. validación runtime antes de una exportación.
Solo lectura (readonly) Un rol de workspace que ve los proyectos, el modelo y la vista previa de datos, y lee las notas del board.
Tenant (inquilino) Un límite organizacional aislado con sus propios miembros, proyectos, claves API, configuración y límites de plan. Los datos mock provienen del pool compartido de solo lectura.
Infraestructura y despliegue
Docker Tecnología de contenedores. Un paquete de código incluye un archivo Docker Compose que inicia MySQL y Redis para el backend generado, pero ningún Dockerfile para el backend en sí; añade uno para tu plataforma de destino para ejecutarlo en un contenedor (ver Export).