ACVE/resumen_cambios.md

Resumen de Cambios (25/02/26)

Marcelo

Fecha de trabajo: 2026-02-25
Proyecto: /opt/ACVE

1) Objetivo de la sesion

Implementar el backlog solicitado:

• Mas mini-games con calificacion ligada al perfil.
• Recomendaciones de estudio por perfil/progreso.
• Certificados al completar curso.
• Ver cursos inscritos (enrolled).
• Cambiar Start Course por Continue cuando ya esta inscrito.
• Actualizar Case Studies con contenido de Andres.

Tambien se resolvio operativa de entorno para Prisma/Node y baseline de migraciones sobre Supabase.

---

2) Features implementadas

2.1 Mini-games (3 interactivos) + persistencia + perfil

• Se expandieron los mini-games a 3 modulos interactivos:
  • translation
  • term-matching
  • contract-clauses
• Se paso de historial localStorage a acciones server-side con persistencia DB (si tablas ya migradas).
• Se agrego calculo de calificacion global de mini-games para perfil (promedio de ultimo intento por juego).

Archivos:

• lib/data/mockPractice.ts
• types/practice.ts
• app/(protected)/practice/[slug]/actions.ts
• app/(protected)/practice/[slug]/page.tsx
• lib/recommendations.ts
• app/(protected)/profile/page.tsx

2.2 Recomendaciones de estudio (deterministicas)

• Se implemento motor de recomendaciones por reglas:
  • basado en score de mini-games y progreso/cursos.
  • prioriza cursos ya inscritos e incompletos.
  • fallback por nivel objetivo (beginner/intermediate/advanced).
• Se muestra bloque “Recommended next” en perfil.

Archivos:

• lib/recommendations.ts
• app/(protected)/profile/page.tsx
• app/(protected)/courses/[slug]/learn/actions.ts (refresh de recomendaciones al completar leccion)

2.3 Certificados automáticos + descarga PDF

• Emision automatica al llegar a 100% de lecciones completadas (idempotente por curso/usuario).
• Endpoint de descarga PDF:
  • /api/certificates/[id]/pdf
• Integracion en:
  • Profile (listado de certificados)
  • My Courses (download cuando existe certificado)

Archivos:

• lib/certificates.ts
• app/api/certificates/[id]/pdf/route.ts
• app/(protected)/courses/[slug]/learn/actions.ts
• app/(protected)/profile/page.tsx
• app/(protected)/my-courses/page.tsx

2.4 UX: completion modal + confetti + CTA de certificado

• Al completar curso por primera vez (cuando se emite certificado nuevo):
  • aparece modal de “Course completed”
  • animacion de confetti
  • boton Download PDF
  • boton Open Profile

Archivo:

• components/courses/StudentClassroomClient.tsx

2.5 Vista de cursos inscritos

• Nueva ruta protegida:
  • /my-courses
• Muestra progreso por curso, CTA Continue/Review, y descarga de certificado si aplica.

Archivo:

• app/(protected)/my-courses/page.tsx

2.6 Cambio Start -> Continue

• En detalle de curso (/courses/[slug]):
  • si usuario inscrito: Continue
  • si no inscrito: Start Course
  • no autenticado: Login to start

Archivo:

• app/(public)/courses/[slug]/page.tsx

2.7 Profile del alumno

• Nueva ruta protegida:
  • /profile
• Incluye:
  • score mini-games
  • desglose latest/best por mini-game
  • recomendaciones
  • certificados + descarga

Archivo:

• app/(protected)/profile/page.tsx

2.8 Navbar

• Se agregaron enlaces para usuario autenticado:
  • My Courses
  • Profile

Archivo:

• components/Navbar.tsx

2.9 Case Studies actualizados con Andres

• Se reemplazo contenido mock por:
  • Marbury v. Madison
  • Miranda v. Arizona
  • Brown v. Board of Education
• Se modelaron campos nuevos:
  • summaryEs
  • legalOutcomeEs
  • category
  • difficulty
  • keyTerms estructurado (termino + definicion)
  • quizPrompt
• Se actualizaron lista y detalle para mostrar contenido legal en espanol.

Archivos:

• types/caseStudy.ts
• lib/data/mockCaseStudies.ts
• app/(public)/case-studies/page.tsx
• app/(public)/case-studies/[slug]/page.tsx

---

3) Cambios de datos (Prisma schema)

Se actualizaron modelos en prisma/schema.prisma:

• Nuevos:

  • MiniGame
  • MiniGameQuestion
  • MiniGameAttempt
  • StudyRecommendation
  • enum MiniGameDifficulty

• Ajustes:

  • Certificate:
    • certificateNumber (unique)
    • pdfVersion
    • @@unique([userId, courseId])
  • Profile:
    • relaciones a mini-games/recomendaciones
  • Course:
    • relacion inversa recommendations StudyRecommendation[] (se corrigio tras error P1012)

Seed actualizado:

• prisma/seed.ts para sembrar 3 mini-games y preguntas.

---

4) Node 24+ / Prisma / Supabase (incidentes y fix)

4.1 Problema detectado

• En Node 18.19.1, Prisma CLI (v7.3.0) fallaba con:
  • ERR_REQUIRE_ESM (zeptomatch / @prisma/dev)
• Resultado:
  • no funcionaba correctamente prisma generate/migrate.

4.2 Fix aplicado

• Se trabajo con Node 24.14.0.
• Se agrego .nvmrc con 24.
• Se reinstalaron dependencias (npm ci).
• Se agregaron scripts Prisma en package.json:
  • prisma:generate
  • prisma:status
  • prisma:migrate:dev
  • prisma:migrate:deploy
  • prisma:seed
• Se corrigio prisma.config.ts seed command:
  • npx ts-node prisma/seed.ts

4.3 Baseline y drift en Supabase

• No existia prisma/migrations historico en repo.
• Se intento baseline inicial con comando viejo (--to-url) y genero SQL vacio.
• Se corrigio usando Prisma 7:
  • --to-config-datasource
• Se genero baseline real (~8148 bytes) y se marco aplicado.
• Estado final reportado:
  • Database schema is up to date!

Nota:

• Hubo dos carpetas baseline:
  • 20260225_baseline (invalida / vacia)
  • 20260225_baseline_v2 (valida)

---

5) Archivos nuevos creados

• task_implementation.md
• resumen_cambios.md
• app/(protected)/my-courses/page.tsx
• app/(protected)/profile/page.tsx
• app/(protected)/practice/[slug]/actions.ts
• app/api/certificates/[id]/pdf/route.ts
• lib/certificates.ts
• lib/recommendations.ts

---

6) Validaciones ejecutadas

Se ejecutaron en distintos momentos:

• npm run lint -> OK
• npx tsc --noEmit -> OK
• npm run build -> compilacion/lint/types OK en varios intentos; hubo un fallo intermitente de worker de Next durante static generation sin stack especifico en esta sesion.
• npm run prisma:generate -> OK (Node 24)
• npm run prisma:status -> OK tras baseline correcto

---

7) Estado funcional actual

• Certificado automatico: funcionando.
• Descarga PDF: funcionando.
• Modal de finalizacion + confetti: funcionando.
• Profile muestra certificados/recomendaciones: implementado.
• My Courses: implementado.
• Case Studies actualizados: implementado.

Observacion de UX:

• El diseno del certificado actual es basico/tecnico (no final de branding visual).

---

8) Implicaciones y pendientes recomendados

1. Limpiar migracion baseline invalida:

   • revisar si se debe eliminar prisma/migrations/20260225_baseline del historial.

2. Confirmar estrategia de migraciones por entorno:

   • migrate dev solo en DB de desarrollo.
   • migrate deploy en staging/prod.

3. Mejorar UI de certificado/modal:

   • plantilla de certificado con branding final.
   • polish de animacion/confetti.

4. QA end-to-end:

   • flujo completo desde completar curso hasta ver certificado en Profile y My Courses.

5. Verificar consistencia en Supabase:

   • mantener DATABASE_URL (pooler) para runtime app.
   • mantener DIRECT_URL (5432) para Prisma migrate.

---

9) Resumen ejecutivo

• Se implementaron todos los ejes funcionales del backlog.
• Se desbloqueo el problema estructural de Prisma (Node 18 -> Node 24).
• Se normalizo flujo de migraciones con baseline real en Supabase.
• Ya existe flujo real de completion + certificado + descarga + visibilidad en perfil/cursos.

Daniel

Resumen de cambios (sesión 25/02/26)

1) Catálogo y publicación de cursos

• Problema: Los cursos publicados no aparecían de inmediato en el catálogo y hacía falta refrescar la página a mano.
• Causa: No se revalidaba la ruta pública /courses al guardar un curso.
• Solución: En la acción updateCourse se agregó revalidatePath("/courses") y revalidación con "page" y "layout" para la página de edición del curso, para que el catálogo y el formulario de edición muestren datos actualizados sin refrescar.

2) Estado y nivel del curso que volvían a valores anteriores al guardar

• Problema: Al cambiar Estado (Borrador → Publicado) o Nivel (p. ej. Intermedio → Principiante) y dar "Guardar Cambios", el formulario seguía mostrando el valor anterior hasta hacer un refresco manual.
• Causas: (1) Los inputs de nivel y estado son no controlados (defaultValue); React no actualiza el valor en re-renders. (2) router.refresh() a veces seguía sirviendo una versión en caché del RSC.
• Soluciones:
  • En la página de edición del curso se puso export const dynamic = "force-dynamic" para no cachear la ruta.
  • Al componente TeacherEditCourseForm se le pasó un key que incluye course.updatedAt para forzar un nuevo montaje cuando cambian los datos del curso y así aplicar los nuevos defaultValue.
  • Tras guardar con éxito se reemplazó router.refresh() por router.push(\/teacher/courses/${course.slug}/edit`)` para forzar una navegación y cargar datos frescos.
• Archivos: app/(protected)/teacher/actions.ts, app/(protected)/teacher/courses/[slug]/edit/page.tsx, components/teacher/TeacherEditCourseForm.tsx.

3) Vista previa gratuita para usuarios sin sesión

• Objetivo: Que los usuarios no autenticados puedan ver lecciones marcadas como "free preview" y que en la ficha del curso se indique cuáles son y se ofrezca un CTA para verlas.
• Cambios:
  • Se movió la ruta de aprendizaje de app/(protected)/courses/[slug]/learn a app/(public)/courses/[slug]/learn (page + actions) para que no quede detrás de un layout que exija autenticación.
  • Se actualizó el import en StudentClassroomClient para usar las acciones en la nueva ruta pública.
  • En la página de detalle del curso (landing):
    • Se incluyó isFreePreview en la consulta de lecciones.
    • En "Course structure preview" se muestra un indicador "Free preview" (pill amarillo) en las lecciones que lo son.
    • Para invitados: si hay al menos una lección en free preview, se muestra el botón principal "Watch free preview" con enlace a /courses/[slug]/learn?lesson=[id], y como secundario "Login to unlock all lessons" con redirectTo=/courses/[slug] para que tras iniciar sesión vuelvan a la ficha y puedan inscribirse/comprar.
• Archivos: app/(public)/courses/[slug]/learn/page.tsx, app/(public)/courses/[slug]/learn/actions.ts, app/(public)/courses/[slug]/page.tsx, components/courses/StudentClassroomClient.tsx. Eliminados los archivos bajo app/(protected)/courses/[slug]/learn/.

4) Botón "Editar Título" en módulos

• Problema: El botón "Editar Título" en cada módulo del plan de estudios no hacía nada.
• Solución:
  • Nueva acción de servidor updateModuleTitle(moduleId, title) en teacher actions: valida que el módulo sea del profesor, actualiza el título en BD y revalida las rutas correspondientes.
  • En el formulario de edición del curso: al hacer clic en "Editar Título" se muestra un campo de texto inline con el título actual y botones "Guardar" y "Cancelar"; Enter guarda, Escape cancela. Tras guardar se navega a la misma página de edición para ver el título actualizado.
• Archivos: app/(protected)/teacher/actions.ts, components/teacher/TeacherEditCourseForm.tsx.