ACVE/task_implementation.md

ACVE Task Implementation

Scope

• Add 3 mini-games with persisted scoring and profile grading.
• Add deterministic study recommendations from user profile/progress.
• Auto-issue completion certificates and support PDF download.
• Add enrolled-courses view (/my-courses).
• Show Continue instead of Start Course when user is enrolled.
• Update case studies with Andres source content (case_studies.txt).

Implemented Items

1. Mini-games + profile grade

• Expanded interactive modules to 3 in lib/data/mockPractice.ts.
• Added DB persistence for attempts via:
  • app/(protected)/practice/[slug]/actions.ts
  • submitPracticeAttempt
  • getPracticeAttempts
• Replaced localStorage attempt history in app/(protected)/practice/[slug]/page.tsx.
• Added profile grade computation in lib/recommendations.ts#getMiniGameGrade.

2. Recommendations

• Added deterministic recommendation engine in lib/recommendations.ts:
  • refreshStudyRecommendations
  • getActiveRecommendations
• Recommendations refresh after:
  • mini-game submission
  • lesson completion toggle
• Recommendations are displayed on /profile.

3. Certificates + PDF

• Added certificate issuance utility in lib/certificates.ts:
  • issueCertificateIfEligible
  • buildCertificatePdf
• Hooked issuance after lesson completion in:
  • app/(protected)/courses/[slug]/learn/actions.ts
• Added PDF endpoint:
  • app/api/certificates/[id]/pdf/route.ts

4. Enrolled courses view

• Added protected page:
  • app/(protected)/my-courses/page.tsx
• Displays enrolled courses, progress, continue/review CTA, and certificate download CTA.

5. Start vs Continue

• Updated course detail CTA in:
  • app/(public)/courses/[slug]/page.tsx
• Logic:
  • enrolled user => Continue
  • not enrolled => Start Course
  • unauthenticated => Login to start

6. Case studies update

• Expanded case-study type model:
  • types/caseStudy.ts
• Replaced mock cases with:
  • Marbury v. Madison
  • Miranda v. Arizona
  • Brown v. Board of Education
• Updated pages to render:
  • resumen
  • terminos juridicos con definiciones
  • resultado juridico
  • "Ponte a prueba"
• Files:
  • lib/data/mockCaseStudies.ts
  • app/(public)/case-studies/page.tsx
  • app/(public)/case-studies/[slug]/page.tsx

Navigation updates

• Added authenticated links in navbar:
  • /my-courses
  • /profile
• File:
  • components/Navbar.tsx

Prisma changes (schema)

• Updated prisma/schema.prisma with:
  • MiniGame, MiniGameQuestion, MiniGameAttempt, StudyRecommendation
  • Certificate.certificateNumber, Certificate.pdfVersion
  • @@unique([userId, courseId]) on Certificate
• Updated prisma/seed.ts to seed 3 mini-games + questions.

Validation

• Ran: npm run lint (passes; one pre-existing warning remains in lib/auth/requireTeacher.ts).

Required follow-up (environment)

• Prisma client generation failed in this environment due Node runtime mismatch (Node v18, project expects >=24).
• Before production use of new DB-backed features, run:
  1. Node 24+ runtime
  2. npx prisma generate
  3. apply migration for schema updates