Prisma ORM Profesional: Schemas, Migraciones y Queries Optimizadas para Producción

Este curso sigue el recorrido de una API de reservas para salas de estudio. El punto de partida no es un proyecto vacío, sino un servicio Node.js que ya recibe solicitudes HTTP y necesita una capa de persistencia mantenible. En el primer módulo conectarás Prisma con ese servicio, separarás la configuración de la aplicación de la configuración del cliente de base de datos y aprenderás a leer un schema como contrato. Después modelarás salas, usuarios, reservas y estados, prestando atención a claves, relaciones, restricciones e índices. La decisión importante no será escribir muchos modelos, sino justificar qué regla debe vivir en la base de datos y cuál pertenece a la lógica de aplicación.

El segundo módulo trata la evolución del esquema. Una base de datos de producción contiene información que no puede tratarse como un archivo temporal. Practicarás la diferencia entre modificar el schema, generar una migración revisable y aplicar migraciones pendientes en un entorno controlado. También analizarás qué hacer cuando una migración falla, cómo registrar el estado real y por qué una corrección nueva suele ser más segura que editar el pasado. El ejercicio de staging usará una copia local autorizada con registros representativos, no datos de usuarios reales.

El tercer módulo conecta el diseño con el rendimiento. Aprenderás a pedir solo los campos que necesita un endpoint, a limitar relaciones anidadas y a elegir entre una relación incluida y un recuento agregado. Luego compararás un bucle que dispara consultas repetidas con una consulta paginada que devuelve la misma información de forma controlada. Las decisiones se comprobarán con conjuntos pequeños y completos: número de consultas esperadas, filas devueltas, campos transferidos y orden estable. Así evitarás atribuir una mejora a una cifra que no puede reproducirse.

El proyecto integrador reúne esas decisiones en una API de reservas. Primero redactarás una tabla de entidades y relaciones, identificarás invariantes como una fecha de fin posterior al inicio y escogerás índices para las búsquedas previstas. Después crearás una migración inicial y un seed idempotente con salas y estados de referencia. En la capa HTTP implementarás endpoints para consultar disponibilidad, crear reservas y listar reservas de un usuario. Cada endpoint tendrá una selección explícita de campos, límites de página y una respuesta coherente ante entradas inválidas.

La comprobación final no se basa en memorizar comandos. Entregarás el schema, las migraciones, el seed, las consultas y pruebas que demuestren relaciones válidas, cambios reproducibles y ausencia de consultas innecesarias en los casos elegidos. También incluirás una breve bitácora con el estado inicial, el cambio aplicado, el resultado esperado y la evidencia obtenida en una base local o de staging autorizada. Para evaluar el trabajo se revisarán cuatro dimensiones: integridad del modelo, seguridad del cambio, eficiencia observable y claridad de las pruebas. Si una decisión depende del motor de base de datos o de una interfaz concreta, la documentarás como supuesto verificable, no como una promesa universal.

Los ejemplos de consulta se fijan a Prisma ORM7 para acompañar la API enseñada. La documentación oficial también describe la transición a Prisma8, que cambia configuración y cliente. En una actualización identifica primero la versión del proyecto y el propietario de las migraciones; no mezcles binarios o formatos de configuración por instalar latest. Verificarás un módulo de cliente con adaptador PostgreSQL y una ruta de lectura/escritura antes de avanzar. Esta ampliación no afirma que las consultas findMany de7 sean intercambiables con el cliente de8. El proyecto mantiene sus datos y contratos mediante pruebas por ruta, revisa SQL de migraciones y protege la exclusividad temporal de salas frente a peticiones concurrentes. Un índice por fecha acelera candidatos, mientras un control transaccional o una restricción protege disponibilidad; son comprobaciones diferentes.