Exportación
La exportación convierte tu modelo de Mockomat en archivos que te pertenecen. Hay dos formatos:
| Formato | Qué obtienes | Disponible en |
|---|---|---|
| Especificación OpenAPI | Un archivo YAML OpenAPI 3.0.3 con un esquema por tabla | Todos los planes con cuenta |
| Paquete de código | Un ZIP con un backend NestJS generado para tus tablas | Professional y superiores |
Los paquetes de código requieren al menos el rol Editor y acceso de edición al proyecto. La exportación nunca modifica tu proyecto, y el código generado no tiene dependencia de ejecución de Mockomat.
Asistente de exportación con los pasos de formato y opciones.
Iniciar una exportación
Abre Export en la aplicación. El asistente de exportación te guía en cuatro pasos:
- Proyecto — elige el proyecto que quieres exportar.
- Formato de exportación — especificación OpenAPI o paquete de código.
- Configurar exportación — para un paquete de código, este paso muestra el paquete que incluye tu plan.
- Revisar y exportar — confirma. Un archivo OpenAPI se descarga de inmediato; un paquete de código se genera en segundo plano y aparece con un enlace de descarga cuando está listo.
Si tu aplicación todavía no ofrece paquetes de código, exporta mientras tanto la especificación OpenAPI.
Selección del formato de exportación: especificación OpenAPI o paquete de código.
Especificación OpenAPI
La exportación OpenAPI escribe tu modelo como components.schemas: un esquema por tabla, con sus atributos como propiedades, los atributos obligatorios, los valores de enum y las relaciones. No contiene rutas (paths). Úsala para compartir el modelo de datos con otras herramientas, o como punto de partida de un contrato que implemente tu equipo de backend.
Paquete de código
El paquete de código es un proyecto generado que puedes ejecutar, modificar y desplegar tú mismo.
| Paquete | Planes | Contenido |
|---|---|---|
| Pro | Professional, Business | Backend NestJS |
| Enterprise | Enterprise | Backend NestJS + frontend Angular |
Qué contiene el backend
- Una aplicación NestJS con una API GraphQL (code-first), un módulo por tabla: entidad, resolver, servicio y tipos de entrada y salida.
- Por tabla: una consulta de lista paginada con búsqueda, una consulta por ID y mutaciones para crear, actualizar, eliminar y restaurar registros.
- Entidades TypeORM para MySQL / MariaDB.
- Autenticación: inicio de sesión con JWT y un módulo de usuarios. En el primer arranque, el backend crea un usuario administrador y muestra su contraseña una sola vez en la consola.
- Un archivo Docker Compose que inicia MySQL y Redis, y un README con los pasos de configuración.
El generador actual tiene límites que conviene conocer antes de planificar con el código:
- Apunta a MySQL / MariaDB e incluye siempre la autenticación y el archivo Docker Compose. Las opciones de base de datos y demás interruptores del asistente todavía no cambian el paquete.
- Las relaciones entre tus tablas no se generan. Añádelas tú mismo a las entidades y servicios generados.
- Las columnas generadas aceptan valores vacíos: el flag Obligatorio de un atributo todavía no se aplica.
Ejecutarlo en local
El README del paquete enumera los pasos. En resumen, en la carpeta del backend:
npm install
cp .env.example .env # luego introduce las credenciales de tu base de datos
npm run migration:run
npm run start:devEl backend espera una base de datos MySQL o MariaDB y Redis.
Resumen de la estructura del proyecto backend generado.
Antes de exportar
Recorre primero la lista de validación del runtime. Un modelo limpio produce un código más limpio:
- Los nombres siguen tus convenciones — los nombres de tablas y atributos se convierten en nombres de clases, tipos y campos.
- Los tipos de los atributos son correctos — se convierten en tipos de columnas y de campos GraphQL.
- Los atributos buscables pasan a ser los campos de búsqueda de la consulta de lista generada, y los atributos ordenables se marcan como columnas de lista ordenables.
Las operaciones y los parámetros que diseñaste en API Design (en inglés) dan forma a tu mock API; el backend generado trae sus propias consultas y mutaciones estándar por tabla.
Qué revisar después de exportar
Límites de módulos y nombrado
- ¿Cada módulo corresponde a una tabla de tu modelo?
- ¿Los nombres de módulos, servicios y resolvers son coherentes y significativos?
Entradas y validación
- ¿Las entradas de creación y actualización contienen los campos que esperas?
- Añade validación para los campos que tu aplicación exige — los campos generados son opcionales.
Relaciones
- Añade las relaciones de tu modelo a las entidades generadas, con la dirección y la cardinalidad que diseñaste.
- Carga los registros relacionados en los servicios como tu aplicación lo necesite.
Lista de revisión de código tras la exportación.
Lista de traspaso tras la exportación
- Asigna responsables por módulo — cada módulo necesita alguien responsable de ampliarlo.
- Marca lo que está generado — indica qué archivos son andamiaje generado y cuáles necesitan lógica de negocio propia.
- Recoge las carencias conocidas — las reglas de negocio, las integraciones externas y las tareas en segundo plano no se generan.
- Haz commit de una base — guarda el código generado como versión inicial y crea ramas a partir de ahí.
- Configura los entornos — conexiones a bases de datos, variables de entorno y pipelines de despliegue.
- Prueba pronto — el código generado compila, pero verifica el comportamiento pronto con pruebas de integración.
Primera ejecución local y lista de verificación.
Propiedad del código
El código generado es tuyo: sin dependencia de ejecución de Mockomat, sin tarifas de licencia sobre el resultado y sin restricciones de uso comercial. Modifícalo, ejecútalo en tus propios servidores o con cualquier proveedor de hosting, y compártelo con clientes o socios.