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 Una plantilla de proyecto Mockomat preconstruida que cubre un patrón de dominio común (ej. E-Commerce, CRM, Blog). Los blueprints pueden clonarse en un workspace y personalizarse. 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 completa de API mock que incluye un modelo de dominio, asociaciones de datos, configuración API y datos mock asociados. Cada proyecto tiene un slug único y un endpoint.
Workspace (espacio de trabajo) El entorno central donde los usuarios construyen, configuran, validan e iteran sobre un proyecto de API mock. Contiene el board de modelado, el editor de tablas, la vista de diseño API y la previsualización runtime.
Modelado
Attribute (atributo) Un campo o columna de una entidad. Cada atributo tiene un nombre, un tipo (string, number, boolean, date, json) y flags de configuración que controlan el comportamiento API.
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 habilita las operaciones de filtrado en el campo en consultas GraphQL. Solo los campos filtrables aceptan expresiones de filtro.
Hint (indicación) Una señal accionable en la previsualización que alerta a los usuarios sobre problemas del modelo — atributos sin asociar, inconsistencias de configuración o destinos de relación faltantes.
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 siempre un valor. Afecta la nullabilidad de GraphQL en el esquema generado.
Searchable (buscable) Un flag de atributo que incluye el campo en la resolución de consultas de búsqueda.
Sortable (ordenable) Un flag de atributo que habilita las operaciones de ordenamiento en el campo. Solo los campos ordenables pueden usarse en parámetros sort.
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
CONST Un tipo de asociación de datos que asigna un valor fijo y constante a cada registro (ej. "active" para un campo de estado).
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 definición de campo semántico con etiquetas y datos de ejemplo, usada como fuente para las asociaciones OFF_FIELD. Parte del corpus semántico.
Dataset Una colección de datos del mundo real (ej. catálogos de productos de Open Food Facts) que puede asociarse a atributos mediante la asociación OFF_FIELD.
FAKE Un tipo de asociación de datos que usa Faker para generar datos sintéticos realistas — nombres, emails, direcciones, fechas, precios y más.
Faker Una biblioteca open-source que genera datos sintéticos realistas siguiendo patrones del mundo real (formatos de nombres correctos, estructuras de email válidas, precios realistas).
OFF_FIELD Un tipo de asociación de datos que asocia un atributo a un campo de un dataset del mundo real (ej. Open Food Facts), produciendo valores realistas y variados.
Synthetic Data (datos sintéticos) Datos generados por Faker que imitan patrones reales pero son ficticios, nunca derivados de fuentes de producción.
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) Una condición o conjunto de condiciones usado para refinar los resultados de consulta. Soporta álgebra booleana con operadores AND/OR y anidamiento.
Filter Operator (operador de filtro) Una operación de comparación usada en expresiones de filtro: EQ, NE, LT, GT, LE, GE, LIKE, IS_NULL, IS_NOT_NULL.
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(limit: 20)).
Offset-Based Pagination (paginación basada en offset) El método de paginación usado por Mockomat: offset (elementos a saltar) + limit (elementos a devolver).
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.
Controller (controlador) La capa API REST en el código NestJS generado, exponiendo endpoints HTTP con decoradores de rutas y anotaciones Swagger.
DTO (Data Transfer Object) Objetos estructurados con decoradores class-validator (@IsString(), @IsNumber(), @IsOptional()) que aplican validación de entradas en backends generados.
Export (exportación) La funcionalidad que genera un backend NestJS listo para producción a partir de un proyecto Mockomat. El código generado pertenece al 100% al usuario.
Generated Backend (backend generado) Un proyecto NestJS completo producido por la funcionalidad de exportación — módulos, controllers/resolvers, servicios, entidades, DTOs y configuración.
Mongoose Una biblioteca ODM (Object-Document Mapping) para MongoDB, disponible como opción de persistencia en backends generados.
NestJS El framework Node.js usado como destino principal de generación de código. Los backends generados siguen las convenciones estándar de NestJS.
Resolver La capa API GraphQL en el código NestJS generado, exponiendo endpoints de consulta y mutación con decoradores GraphQL.
TypeORM Una biblioteca ORM (Object-Relational Mapping) para bases de datos SQL (PostgreSQL, MySQL, MariaDB), disponible como opción de persistencia en backends generados.
Autenticación y seguridad
Actor Token (token de actor) Un token con tiempo limitado emitido a consumidores API externos para seguimiento de concurrencia. Incluido mediante la cabecera X-Actor-Token.
API Key (clave API) Una credencial emitida por proyecto para autenticar consumidores externos contra endpoints de API mock privados. Incluida mediante la cabecera Authorization: Bearer.
Concurrent Session (sesión concurrente) Una conexión de usuario autenticada simultáneamente activa. Cada nivel de plan tiene un límite máximo de sesiones concurrentes.
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, disponible a partir de los planes Business.
Public Endpoint (endpoint público) Un endpoint de API mock accesible sin autenticación, sujeto a limitación de tasa por IP.
Rate Limiting (limitación de tasa) El sistema que aplica límites de solicitudes por período de facturación. Devuelve HTTP 429 (Too Many Requests) con una cabecera Retry-After cuando se excede.
Session (sesión) Una conexión de navegador autenticada que cuenta hacia el límite de sesiones concurrentes del tenant.
SSO / SAML Single Sign-On y Security Assertion Markup Language — protocolos de gestión de identidad Enterprise (funcionalidad planificada).
Planes y acceso
Business (plan) Un nivel pago (19 $/mes) que ofrece endpoints privados, claves API, acceso basado en roles, 50 000 solicitudes/mes y hasta 25 proyectos.
Business Pro (plan) Un nivel pago (49 $/mes) que agrega equipos multi-usuario, analítica de endpoints, 250 000 solicitudes/mes y proyectos ilimitados.
Enterprise (plan) Un nivel con tarificación personalizada que ofrece solicitudes ilimitadas, datasets personalizados, SSO/SAML, SLAs, despliegue on-premise y límites de sesión configurables.
Free (plan) Un nivel gratuito que requiere registro de cuenta, ofreciendo hasta 5 proyectos, 1 000 solicitudes/día y endpoints públicos.
Quick (plan) El nivel instantáneo sin inicio de sesión que ofrece un proyecto temporal basado en sesión con un endpoint público. El trabajo se pierde cuando la sesión del navegador termina.
Equipo y gobernanza
Admin (administrador) Un rol de usuario con acceso completo a proyectos, gestión de equipo y configuración del tenant.
Domain Ownership (propiedad de dominio) Responsabilidad asignada para un área de dominio de negocio específica y sus definiciones de modelo dentro del equipo.
Governance (gobernanza) Políticas y controles que aseguran consistencia, calidad y cumplimiento a través de los esfuerzos de modelado del equipo — convenciones de nombrado, puntos de control de revisión y criterios de validación.
Guest (invitado) Un rol de usuario con acceso de solo lectura a proyectos compartidos y previsualización.
Multi-Tenancy (multi-tenencia) La arquitectura del sistema que aísla los datos, esquemas y configuración de cada organización a través de acceso con alcance por tenant.
Review Gate (punto de control de revisión) Un checkpoint obligatorio donde los cambios de modelo, API o exportación se validan antes de la promoción — ej. validación runtime pre-exportación.
Tenant (inquilino) Un límite organizacional aislado con colecciones de datos dedicadas, configuración independiente y limitación de tasa separada.
User (usuario) Un rol de usuario que puede crear, editar y exportar proyectos dentro del equipo.
User Admin (administrador de usuarios) Un rol de usuario que puede gestionar miembros del equipo y asignar roles sin acceso admin completo.
Infraestructura y despliegue
Data Sovereignty (soberanía de datos) El requisito de que todos los datos permanezcan dentro de la infraestructura propia del cliente, abordado por la opción de despliegue on-premise.
Docker Tecnología de conteneurización usada para empaquetar y desplegar instancias de Mockomat.
On-Premise Deployment (despliegue on-premise) Una instalación Mockomat autoalojada funcionando en la infraestructura del cliente para control completo de datos (1 000 $ de setup + 199 $/mes).
SLA (Service Level Agreement / acuerdo de nivel de servicio) Un compromiso formal de disponibilidad, tiempos de respuesta y niveles de soporte para clientes Enterprise.