Exportación
La exportación hace de puente entre la intención del modelo y la implementación backend que tú posees. Toma tu proyecto Mockomat validado y genera un backend NestJS listo para producción que te pertenece completamente — sin dependencia runtime de Mockomat, sin bloqueo de proveedor.
El código generado es tuyo. Puedes modificarlo, extenderlo, desplegarlo y comercializarlo sin restricciones.
Objetivos de la exportación
La exportación debe producir un backend de inicio que sea:
- Legible — código limpio y bien estructurado siguiendo las convenciones y buenas prácticas de NestJS.
- Estructurado — organizado por módulos de dominio con una separación clara de responsabilidades.
- Trazable — cada módulo, entidad y resolver generado corresponde a tu modelo Mockomat.
- Listo para la propiedad del equipo — calidad de código sobre la que un equipo de desarrollo puede construir inmediatamente.
El objetivo no es reemplazar el desarrollo backend — es eliminar la fase de scaffolding repetitiva y permitir que tu equipo se enfoque en la lógica de negocio desde el primer día.
Panel de configuración de exportación con opciones de destino.
Fuentes de entrada
La exportación puede generar un backend a partir de dos fuentes:
Proyecto nativo Mockomat
Usa los metadatos de tu proyecto existente — todas las entidades, atributos, relaciones, asociaciones y configuraciones API se usan como entrada de generación. Este es el camino recomendado para la mayoría de los usuarios.
Importación OpenAPI
Sube una especificación OpenAPI (JSON o YAML) y genera un backend directamente desde la especificación. Útil cuando ya tienes un contrato API definido fuera de Mockomat y deseas generar la implementación.
Selección de fuente de exportación: proyecto Mockomat o importación OpenAPI.
Opciones de exportación
Al iniciar una exportación, configura varias opciones que determinan la forma del backend generado:
Estilo de API
| Opción | Descripción |
|---|---|
| GraphQL (code-first) | Genera resolvers, tipos de objetos y tipos de entrada con decoradores GraphQL de NestJS. |
| REST (basado en OpenAPI) | Genera controllers con decoradores de rutas y anotaciones Swagger. |
| Ambos | Genera tanto resolvers GraphQL como controllers REST para los mismos modelos de dominio. |
Capa de persistencia
| Opción | Descripción |
|---|---|
| TypeORM (SQL) | Genera entidades con decoradores TypeORM apuntando a bases de datos relacionales (PostgreSQL, MySQL, MariaDB). |
| Mongoose (MongoDB) | Genera esquemas y modelos para MongoDB via Mongoose. |
| En memoria | Genera almacenes en memoria simples para prototipado rápido sin configuración de base de datos. |
Scaffolding de autenticación
El proyecto generado incluye un scaffolding de autenticación JWT opcional:
- Un stub de entidad
Userbásico - Configuración del guard JWT
- Decoradores de endpoints protegidos
- Stubs de endpoints de login y registro
Este scaffolding proporciona un punto de partida — tú reemplazas los stubs por tu lógica de autenticación real.
Lo que se genera
La exportación produce un proyecto NestJS completo y ejecutable:
/nestjs-backend
/src
/modules
/customer
customer.module.ts
customer.controller.ts (REST) or customer.resolver.ts (GraphQL)
customer.service.ts
customer.entity.ts
/dto
create-customer.dto.ts
update-customer.dto.ts
/order
order.module.ts
order.controller.ts
order.service.ts
order.entity.ts
/dto
create-order.dto.ts
update-order.dto.ts
/common
/filters
/interceptors
/pipes
app.module.ts
main.ts
package.json
tsconfig.json
README.mdContenido de cada archivo
| Archivo | Propósito |
|---|---|
| Entity | Definición del esquema de base de datos con decoradores (TypeORM o Mongoose) |
| Service | Capa de lógica de negocio con operaciones CRUD y gestión de relaciones |
| Controller/Resolver | Capa API exponiendo endpoints con validación de entradas |
| DTOs | Objetos de transferencia de datos con decoradores class-validator para validación de entradas |
| Module | Módulo NestJS vinculando el servicio, controller y entidad |
| Common | Filtros, interceptors y pipes compartidos entre módulos |
Flujo típico de exportación
1. Validar el modelo y la disponibilidad runtime
Antes de exportar, recorre la lista de verificación de validación runtime. Confirma que:
- Todas las entidades tienen asociaciones de atributos completas.
- Las relaciones se resuelven correctamente en previsualización.
- Las operaciones de filtrado y ordenamiento funcionan como se espera.
- No quedan indicaciones sin resolver.
Un pase de validación runtime limpio aumenta significativamente la calidad del código generado.
2. Elegir las opciones de exportación
Selecciona tu estilo de API, capa de persistencia y preferencias de autenticación. Si tienes dudas, comienza con GraphQL + TypeORM — es la configuración más común para backends NestJS.
3. Generar el paquete
Haz clic en generar y espera a que el proyecto backend se construya. El proceso de generación lee tu configuración de modelo completa y produce todos los archivos en un solo pase.
4. Descargar y ejecutar localmente
El proyecto generado se entrega como un archivo .zip. Extráelo y ejecuta:
npm install
npm run start:devEl backend se inicia en un puerto local con hot reload activado. Puedes probar la API inmediatamente con tu cliente GraphQL o herramienta REST preferida.
5. Traspasar al equipo de implementación
El proyecto generado es un punto de partida, no un producto terminado. Traspásalo a tu equipo de desarrollo con un contexto claro sobre:
- Lo que fue generado y por qué
- Qué partes están listas para producción
- Qué partes necesitan implementación personalizada
Vista general de la estructura del proyecto backend generado.
Qué verificar después de la exportación
Después de generar tu backend, verifica estas áreas antes de construir sobre él:
Límites de módulos y nombrado
- ¿Cada módulo corresponde a una entidad de dominio de tu modelo Mockomat?
- ¿Los nombres de módulos, servicios y controllers son consistentes y significativos?
- ¿La organización de archivos corresponde a las convenciones de tu equipo?
Cobertura de DTOs y validación
- ¿Los DTOs incluyen todos los campos obligatorios?
- ¿Los decoradores class-validator están correctamente aplicados (ej.
@IsString(),@IsNumber(),@IsOptional())? - ¿Los DTOs de creación y actualización difieren apropiadamente?
Estructura de resolver/controller
- ¿Todos los endpoints previstos están generados?
- ¿Los caminos de rutas o nombres de consultas coinciden con tu diseño API?
- ¿Los guards y decoradores están correctamente aplicados?
Gestión de relaciones
- ¿Las relaciones de entidades están definidas con los decoradores correctos (
@OneToMany,@ManyToOne,@ManyToMany)? - ¿La capa de servicio gestiona la carga de relaciones (eager vs lazy)?
- ¿Las opciones de cascada están configuradas apropiadamente?
Vista de lista de verificación de revisión de código post-exportación.
Lista de verificación de traspaso post-exportación
Usa esta lista al traspasar el proyecto generado a tu equipo de implementación:
- Asignar responsabilidad por módulo/dominio — cada módulo debe tener un responsable claro encargado de extenderlo.
- Definir qué permanece generado vs personalizado — marcar qué archivos son scaffolding generado y cuáles necesitan lógica de negocio personalizada.
- Capturar las brechas conocidas — documentar las funcionalidades que Mockomat no genera (reglas de negocio complejas, integraciones externas, trabajos en segundo plano).
- Configurar control de versiones — hacer commit del código generado como tu baseline inicial y crear ramas a partir de ahí.
- Configurar los entornos — establecer las conexiones de base de datos, variables de entorno y pipelines de despliegue.
- Ejecutar la suite de pruebas completa — incluso si el código generado compila, verifica el comportamiento tempranamente con pruebas de integración.
Primer inicio local y lista de verificación.
Propiedad del código
El código generado te pertenece al 100%. No hay dependencia runtime de Mockomat, no hay tarifas de licencia sobre la salida generada y no hay restricciones de uso comercial. Puedes:
- Modificar cada línea del código generado
- Desplegar en cualquier infraestructura (AWS, GCP, Azure, on-premise)
- Usar en productos comerciales sin atribución
- Compartir con clientes, socios o comunidades open-source
El proyecto generado es una aplicación NestJS estándar. Cualquier desarrollador NestJS puede extenderlo inmediatamente.