Libretto

La aplicación anterior se apoyaba en una base de datos que había crecido tabla por tabla durante dos décadas: una tabla por carrera, booleanos guardados como −1 y 0, y texto en varias codificaciones a la vez. Los caracteres que no podía decodificar los sobrescribía, así que los acentos de nombres y materias se perdían para siempre.

La secretaría necesitaba un sistema confiable: notas en la escala italiana de 18 a 30, créditos (CFU) que cierren por plan de estudios, cohortes que avanzan año a año, y docentes y estudiantes viendo exactamente su parte.

Un monorepo con Turborepo: una API en NestJS 11 con Prisma sobre MySQL 8, una interfaz en Next.js 16 y React 19, y un paquete compartido de contratos TypeScript para que ambos lados coincidan en cada request y response. El navegador nunca llama a la API directamente: delante hay route handlers de Next.js.

La API responde con códigos de error estables en lugar de frases, y la interfaz los traduce. El acceso es un registro de permisos, cada uno con un alcance —propio, asignado o todo— que el servidor resuelve en cada request. Un administrador puede ver el sistema como otro usuario para reproducir exactamente lo que esa persona ve, y cada cambio queda en un log de auditoría, con los campos sensibles ocultos, en la misma transacción que el cambio.

Alrededor de ese núcleo: importación masiva desde Excel, generación de PDF, archivos en S3 con URLs prefirmadas y el tipo real del archivo verificado por sus bytes, recordatorios programados por email con Microsoft Graph, y tablas de historial que guardan cada versión anterior de los registros importantes.