Tema 12 · Relaciones & Prisma

12. Relaciones, Transacciones Atómicas y Alternativa Moderna con Prisma ORM

Implementa relaciones (@OneToMany, @ManyToOne), ejecuta transacciones seguras con QueryRunner y conoce el patrón PrismaService en NestJS.

Relaciones y Prevención del Problema N+1

En sistemas reales, las entidades están conectadas: un Curso tiene muchas Lecciones (@OneToMany) y cada Leccion pertenece a un Curso (@ManyToOne).

Al consultar listados con relaciones en TypeORM, especifica siempre la propiedad relations: ['lecciones'] (o usa leftJoinAndSelect en el QueryBuilder) para resolver los datos en un solo JOIN de SQL y evitar el problema de rendimiento N+1.

Prisma ORM: La Alternativa Schema-First en NestJS

Además de TypeORM, muchos equipos modernos en NestJS adoptan Prisma ORM por su autocompletado ultra estricto generado a partir del archivo declarativo prisma/schema.prisma. En NestJS, Prisma se integra creando un servicio ligero PrismaService que extiende PrismaClient e implementa el hook de ciclo de vida OnModuleInit.

Criterio TypeORM Prisma ORM
Enfoque de Modelado Code-First mediante clases TypeScript y decoradores @Entity(). Schema-First en un archivo único schema.prisma que genera el cliente tipado.
Patrón de Diseño Data Mapper (Repositorios inyectados) o Active Record. Cliente unificado tipado (this.prisma.curso.findMany()).
Transacciones dataSource.transaction(async (manager) => ...) prisma.$transaction(async (tx) => ...)

⚡ Implementación de PrismaService y Transacción Atómica en NestJS

Conexión limpia con OnModuleInit y ejecución de una matrícula con descuento de cupo en una sola transacción:

src/prisma/prisma.service.ts
Solo lectura
import { Injectable, OnModuleInit, OnModuleDestroy, BadRequestException } from '@nestjs/common';
import { PrismaClient } from '@prisma/client';

@Injectable()
export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
  async onModuleInit(): Promise<void> {
    await this.$connect();
  }

  async onModuleDestroy(): Promise<void> {
    await this.$disconnect();
  }
}

@Injectable()
export class MatriculasPrismaService {
  constructor(private readonly prisma: PrismaService) {}

  // Transacción ACID: verifica cupo, registra matrícula e incrementa inscritos atómicamente
  async inscribirEstudiante(usuarioId: number, sesionId: number) {
    return this.prisma.$transaction(async (tx) => {
      const sesion = await tx.courseSession.findUnique({ where: { id: sesionId } });
      if (!sesion || (sesion.capacity !== null && sesion.taken >= sesion.capacity)) {
        throw new BadRequestException('No hay cupos disponibles en esta cohorte.');
      }

      await tx.courseSession.update({
        where: { id: sesionId },
        data: { taken: { increment: 1 } },
      });

      return tx.enrollment.create({
        data: { userId: usuarioId, courseSessionId: sesionId },
      });
    });
  }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué interfaz del ciclo de vida de NestJS debe implementar PrismaService para abrir la conexión con la base de datos ($connect) automáticamente apenas se inicializa el módulo?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.