feat: fase 2+3 — expansion masiva multi-perfil + bug fixes + hardening

Fase 2 (expansion):
- Francesca: +6 etapas matematicas (5-10), +7 etapas lectura (3-9), +2 ortografia
- Sebastian: +8 etapas matematicas (4-11), +6 lectura, +3 historia, +3 geografia, +1 banderas
- Nuevas paginas: ortografia, lectura, geografia, matematicas
- ~900 ejercicios nuevos, paridad ~500 por perfil

Fase 3 (bug fixes + hardening):
- Fix: SessionLog auto-create en grade route
- Fix: engine cache (no borrar antes de revisar)
- Fix: FSRS cards actualizadas en flujo curriculum
- Fix: responseMs real (no hardcodeado 3000)
- Fix: options dentro de content en sebastian etapa-1
- Fix: trazo-letra consonantes crash
- Security: execFileSync anti-command-injection en TTS
- DB: 18 cascade deletes + indices + unique constraints
- APIs debug: reset, state, seed
- Docker: espeak-ng + prisma + user/group
- E2E: 23 tests nuevos (curriculum-flow.spec.ts)
- Code review: tailwind colors, middleware dev mode, eslint config

Verificado: tsc exit 0, build exit 0, 61 E2E tests pass
This commit is contained in:
renato97
2026-07-25 22:07:28 -03:00
parent 25614704dc
commit a3360ec6e4
67 changed files with 5294 additions and 213 deletions
+47 -2
View File
@@ -1,5 +1,6 @@
import { NextRequest, NextResponse } from "next/server"
import { prisma } from "@/lib/db"
import { buildFsrsCard, gradeCard, skillCodeFromGrade } from "@/lib/fsrs"
export async function POST(request: NextRequest) {
try {
@@ -9,13 +10,16 @@ export async function POST(request: NextRequest) {
return NextResponse.json({ error: "Missing required fields" }, { status: 400 })
}
const sessionLog = await prisma.sessionLog.findFirst({
// Auto-create session log if none exists (so SkillAttempts are always stored)
let sessionLog = await prisma.sessionLog.findFirst({
where: { childId },
orderBy: { startedAt: "desc" },
})
if (!sessionLog) {
return NextResponse.json({ error: "No active session" }, { status: 400 })
sessionLog = await prisma.sessionLog.create({
data: { childId, startedAt: new Date() },
})
}
await prisma.skillAttempt.create({
@@ -31,6 +35,47 @@ export async function POST(request: NextRequest) {
},
})
// Update/create FSRS card so due-date sorting works in the engine
const existingCard = await prisma.fsrsCard.findFirst({
where: { childId, skillCode },
})
const grade = skillCodeFromGrade(correct, responseMs ?? 5000)
const baseCard = buildFsrsCard({
stability: existingCard?.stability,
difficulty: existingCard?.difficulty,
reps: existingCard?.reps,
lapses: existingCard?.lapses,
due: existingCard?.dueAt,
})
const { card: updatedCard } = gradeCard(baseCard, grade)
if (existingCard) {
await prisma.fsrsCard.update({
where: { id: existingCard.id },
data: {
dueAt: updatedCard.due,
stability: updatedCard.stability,
difficulty: updatedCard.difficulty,
reps: updatedCard.reps,
lapses: updatedCard.lapses,
},
})
} else {
await prisma.fsrsCard.create({
data: {
childId,
skillCode,
dueAt: updatedCard.due,
stability: updatedCard.stability,
difficulty: updatedCard.difficulty,
reps: updatedCard.reps,
lapses: updatedCard.lapses,
},
})
}
return NextResponse.json({ success: true })
} catch (error) {
console.error("Curriculum grade error:", error)
+70 -65
View File
@@ -4,74 +4,79 @@ import { initCurriculum, getLecturaStages, getNumerosStages } from "@/curriculum
import { getCurrentStage, getNextExercise } from "@/lib/curriculum/engine"
export async function GET(request: NextRequest) {
const childId = request.nextUrl.searchParams.get("childId")
const topic = (request.nextUrl.searchParams.get("topic") || "lectura") as "lectura" | "numeros"
if (!childId) {
return NextResponse.json({ error: "childId required" }, { status: 400 })
}
await initCurriculum()
const stages = topic === "lectura" ? getLecturaStages() : getNumerosStages()
const stageKeys = Object.keys(stages).map(Number).sort((a, b) => a - b)
const progress = prisma.curriculumProgress.findMany({
where: { childId, topic },
orderBy: { stage: "asc" },
})
const allAttempts = prisma.skillAttempt.findMany({
where: {
exerciseId: { not: null },
stage: { not: null },
sessionLog: { childId },
},
select: { exerciseId: true, correct: true },
})
const [progressRows, attempts] = await Promise.all([progress, allAttempts])
const mastered = new Set(
attempts.filter((a) => a.correct).map((a) => a.exerciseId),
)
const stagesInfo = stageKeys.map((sk) => {
const s = stages[sk]
const total = s?.exercises?.length || 0
const completed = s?.exercises?.filter((e) => mastered.has(e.id)).length || 0
const prog = progressRows.find((p) => p.stage === sk)
return {
stage: sk,
name: s?.name || `Etapa ${sk}`,
total,
completed,
unlocked: !!prog,
completedAt: prog?.completedAt || null,
percent: total > 0 ? Math.round((completed / total) * 100) : 0,
try {
const childId = request.nextUrl.searchParams.get("childId")
const topic = (request.nextUrl.searchParams.get("topic") || "lectura") as "lectura" | "numeros"
if (!childId) {
return NextResponse.json({ error: "childId required" }, { status: 400 })
}
})
const errorTypes = await prisma.skillAttempt.groupBy({
by: ["errorType"],
where: {
errorType: { not: null },
sessionLog: { childId },
},
_count: { errorType: true },
})
await initCurriculum()
const errorPatterns = errorTypes.map((e) => ({
errorType: e.errorType,
count: e._count.errorType,
}))
const stages = topic === "lectura" ? getLecturaStages() : getNumerosStages()
const stageKeys = Object.keys(stages).map(Number).sort((a, b) => a - b)
const activeProgress = progressRows.find((p) => !p.completedAt)
const currentStage = activeProgress?.stage || 1
const progress = prisma.curriculumProgress.findMany({
where: { childId, topic },
orderBy: { stage: "asc" },
})
return NextResponse.json({
currentStage,
stages: stagesInfo,
errorPatterns,
hasActiveSession: true,
})
const allAttempts = prisma.skillAttempt.findMany({
where: {
exerciseId: { not: null },
stage: { not: null },
sessionLog: { childId },
},
select: { exerciseId: true, correct: true },
})
const [progressRows, attempts] = await Promise.all([progress, allAttempts])
const mastered = new Set(
attempts.filter((a) => a.correct).map((a) => a.exerciseId),
)
const stagesInfo = stageKeys.map((sk) => {
const s = stages[sk]
const total = s?.exercises?.length || 0
const completed = s?.exercises?.filter((e) => mastered.has(e.id)).length || 0
const prog = progressRows.find((p) => p.stage === sk)
return {
stage: sk,
name: s?.name || `Etapa ${sk}`,
total,
completed,
unlocked: !!prog,
completedAt: prog?.completedAt || null,
percent: total > 0 ? Math.round((completed / total) * 100) : 0,
}
})
const errorTypes = await prisma.skillAttempt.groupBy({
by: ["errorType"],
where: {
errorType: { not: null },
sessionLog: { childId },
},
_count: { errorType: true },
})
const errorPatterns = errorTypes.map((e) => ({
errorType: e.errorType,
count: e._count.errorType,
}))
const activeProgress = progressRows.find((p) => !p.completedAt)
const currentStage = activeProgress?.stage || 1
return NextResponse.json({
currentStage,
stages: stagesInfo,
errorPatterns,
hasActiveSession: true,
})
} catch (error) {
console.error("Progress route error:", error)
return NextResponse.json({ error: "Internal error" }, { status: 500 })
}
}
+25
View File
@@ -0,0 +1,25 @@
import { NextRequest, NextResponse } from "next/server"
import { prisma } from "@/lib/db"
export async function POST(request: NextRequest) {
try {
const { childId } = await request.json()
if (!childId) {
return NextResponse.json({ error: "childId required" }, { status: 400 })
}
// Delete in dependency order
await prisma.skillAttempt.deleteMany({
where: { sessionLog: { childId } },
})
await prisma.sessionLog.deleteMany({ where: { childId } })
await prisma.fsrsCard.deleteMany({ where: { childId } })
await prisma.curriculumProgress.deleteMany({ where: { childId } })
await prisma.milestone.deleteMany({ where: { childId } })
return NextResponse.json({ success: true, message: `Reset state for child ${childId}` })
} catch (error) {
console.error("Debug reset error:", error)
return NextResponse.json({ error: "Internal error" }, { status: 500 })
}
}
+112
View File
@@ -0,0 +1,112 @@
import { NextRequest, NextResponse } from "next/server"
import { prisma } from "@/lib/db"
import { getStagesForProfile } from "@/lib/curriculum/engine"
export async function POST(request: NextRequest) {
try {
const { childId, profile = "ISABELLA", topic = "lectura", stages: stageIds, markAllCorrect = false } = await request.json()
if (!childId) {
return NextResponse.json({ error: "childId required" }, { status: 400 })
}
const child = await prisma.child.findUnique({
where: { id: childId },
select: { id: true, name: true, profile: true },
})
if (!child) {
return NextResponse.json({ error: "Child not found" }, { status: 404 })
}
const resolvedProfile = (profile || child.profile).toUpperCase()
// Get stages for this topic
const stages = await getStagesForProfile(resolvedProfile, topic)
// Filter to specific stages if requested
const stageEntries = stageIds
? Object.entries(stages).filter(([id]) => stageIds.includes(Number(id)))
: Object.entries(stages)
let seeded = 0
for (const [stageId, stage] of stageEntries) {
// Ensure curriculum progress exists
const exists = await prisma.curriculumProgress.findUnique({
where: { childId_topic_stage: { childId, topic, stage: Number(stageId) } },
})
if (!exists) {
await prisma.curriculumProgress.create({
data: { childId, topic, stage: Number(stageId) },
})
}
// Create a session log
const sessionLog = await prisma.sessionLog.create({
data: { childId, startedAt: new Date() },
})
// Create skill attempts for each exercise in the stage
for (const ex of stage.exercises) {
await prisma.skillAttempt.create({
data: {
sessionLogId: sessionLog.id,
skillCode: ex.skillCode,
promptLevel: 0,
correct: markAllCorrect,
responseMs: 2000,
errorType: markAllCorrect ? null : (ex.errorType || "discriminacion-auditiva"),
exerciseId: ex.id,
stage: ex.stage,
},
})
// Create FSRS card
await prisma.fsrsCard.create({
data: {
childId,
skillCode: ex.skillCode,
dueAt: new Date(Date.now() + 86400000),
stability: markAllCorrect ? 3.0 : 0.5,
difficulty: markAllCorrect ? 4.0 : 7.0,
reps: 1,
lapses: markAllCorrect ? 0 : 1,
},
})
seeded++
}
// Mark stage as completed if markAllCorrect
if (markAllCorrect) {
await prisma.curriculumProgress.updateMany({
where: { childId, topic, stage: Number(stageId) },
data: { completedAt: new Date() },
})
// Advance to next stage
const nextStage = Number(stageId) + 1
const nextExists = await prisma.curriculumProgress.findUnique({
where: { childId_topic_stage: { childId, topic, stage: nextStage } },
})
if (!nextExists) {
await prisma.curriculumProgress.create({
data: { childId, topic, stage: nextStage },
})
}
}
}
return NextResponse.json({
success: true,
child: { id: child.id, name: child.name, profile: resolvedProfile },
topic,
stagesSeeded: stageEntries.length,
exercisesSeeded: seeded,
})
} catch (error) {
console.error("Debug seed error:", error)
return NextResponse.json({ error: "Internal error" }, { status: 500 })
}
}
+70
View File
@@ -0,0 +1,70 @@
import { NextRequest, NextResponse } from "next/server"
import { prisma } from "@/lib/db"
import { getStagesForProfile } from "@/lib/curriculum/engine"
export async function GET(request: NextRequest) {
try {
const childId = request.nextUrl.searchParams.get("childId")
const profile = request.nextUrl.searchParams.get("profile") || "ISABELLA"
const topic = request.nextUrl.searchParams.get("topic") || "lectura"
if (!childId) {
return NextResponse.json({ error: "childId required" }, { status: 400 })
}
const child = await prisma.child.findUnique({
where: { id: childId },
select: { id: true, name: true, profile: true },
})
const progress = await prisma.curriculumProgress.findMany({
where: { childId },
orderBy: [{ topic: "asc" }, { stage: "asc" }],
})
const skillAttempts = await prisma.skillAttempt.findMany({
where: { sessionLog: { childId } },
orderBy: { createdAt: "desc" },
take: 20,
})
const fsrsCards = await prisma.fsrsCard.findMany({
where: { childId },
orderBy: { dueAt: "asc" },
})
const sessionLogs = await prisma.sessionLog.findMany({
where: { childId },
orderBy: { startedAt: "desc" },
take: 5,
})
// Count mastered exercises for this topic
const mastered = new Set(
skillAttempts
.filter((a) => a.exerciseId && a.exerciseId.startsWith(`${topic[0]}${topic[1]}`) && a.correct)
.map((a) => a.exerciseId),
)
const stages = await getStagesForProfile(profile, topic)
const totalExercises = Object.values(stages).reduce((sum, s) => sum + s.exercises.length, 0)
return NextResponse.json({
child,
progress,
skillAttempts: skillAttempts.slice(0, 10),
fsrsCards: fsrsCards.slice(0, 10),
sessionLogs,
stats: {
totalExercisesInTopic: totalExercises,
masteredInTopic: mastered.size,
progressPercent: totalExercises > 0 ? Math.round((mastered.size / totalExercises) * 100) : 0,
currentStage: progress.find((p) => !p.completedAt)?.stage || null,
currentTopic: progress.find((p) => !p.completedAt)?.topic || null,
},
})
} catch (error) {
console.error("Debug state error:", error)
return NextResponse.json({ error: "Internal error" }, { status: 500 })
}
}
+13 -5
View File
@@ -1,5 +1,5 @@
import { NextRequest, NextResponse } from "next/server"
import { execSync } from "child_process"
import { execFileSync } from "child_process"
import { existsSync, mkdirSync } from "fs"
import { createHash } from "crypto"
import { readFile, mkdir } from "fs/promises"
@@ -24,15 +24,23 @@ export async function GET(request: NextRequest) {
return NextResponse.json({ error: "text param required (max 200 chars)" }, { status: 400 })
}
// Sanitize: only allow alphanumeric, spaces, and common punctuation
if (!/^[\w\sáéíóúñüÁÉÍÓÚÑÜ.,;:!¿?¡()\-]+$/.test(text)) {
return NextResponse.json({ error: "Invalid text characters" }, { status: 400 })
}
await ensureCacheDir()
const cachePath = getCachePath(text)
if (!existsSync(cachePath)) {
try {
execSync(
`espeak-ng -v es-mx -s 140 -p 60 "${text.replace(/"/g, '\\"')}" -w "${cachePath}"`,
{ timeout: 10000 },
)
execFileSync("espeak-ng", [
"-v", "es-mx",
"-s", "140",
"-p", "60",
"-w", cachePath,
text,
], { timeout: 10000 })
} catch {
return NextResponse.json({ error: "TTS generation failed" }, { status: 500 })
}
+12
View File
@@ -0,0 +1,12 @@
import ExerciseSession from "@/components/child/exercise-session"
export default function FrancescaOrtografia() {
return (
<ExerciseSession
topic="ortografia"
profile="FRANCESCA"
loadingMessage="Preparando ortografía..."
completeMessage="¡Terminaste ortografía por ahora!"
/>
)
}
+14 -3
View File
@@ -8,8 +8,9 @@ import AudioUnlock from "@/components/child/audio-unlock"
const FRANCESCA_KEY = "edueasy_child_francesca"
const activities = [
{ id: "matematicas", label: "Matemáticas", icon: "🔢", description: "Sumas, restas y multiplicaciones" },
{ id: "lecturas", label: "Lecturas cortas", icon: "📖", description: "Leé textos chiquitos" },
{ id: "matematicas", label: "Matemáticas", icon: "🔢", description: "Sumas, restas, tablas y divisiones" },
{ id: "lecturas", label: "Lecturas cortas", icon: "📖", description: "Leé textos sobre distintos temas" },
{ id: "ortografia", label: "Ortografía", icon: "✏️", description: "Mayúsculas y reglas" },
{ id: "logros", label: "Mis logros", icon: "⭐", color: "bg-warning" },
{ id: "pairing", label: "iPad nuevo", icon: "🔗", color: "bg-secondary" },
]
@@ -23,6 +24,16 @@ export default function FrancescaHome() {
setPaired(!!localStorage.getItem(FRANCESCA_KEY))
}, [])
const handleActivity = (id: string) => {
if (id === "logros") {
router.push("/child/logros?profile=francesca")
} else if (id === "pairing") {
router.push("/child/pairing?profile=francesca")
} else {
router.push(`/francesca/${id}`)
}
}
if (!audioReady) {
return <AudioUnlock onUnlock={() => setAudioReady(true)} />
}
@@ -46,7 +57,7 @@ export default function FrancescaHome() {
{activities.map((a) => (
<button
key={a.id}
onClick={() => router.push(`/francesca/${a.id}`)}
onClick={() => handleActivity(a.id)}
className={`${a.color || "bg-accent"} text-primary-foreground touch-target-lg rounded-2xl flex items-center gap-4 px-6 py-5 text-xl font-display font-semibold shadow-md active:scale-95 transition-transform`}
>
<span className="text-2xl">{a.icon}</span>
+1 -1
View File
@@ -32,7 +32,7 @@ export default function RootLayout({
<link rel="icon" href="/icon.svg" type="image/svg+xml" />
<link rel="apple-touch-icon" href="/icon.svg" />
</head>
<body className="dvh-screen overflow-x-hidden">{children}</body>
<body className="min-h-dvh overflow-x-hidden">{children}</body>
</html>
)
}
+62 -16
View File
@@ -4,9 +4,30 @@ import { useEffect } from "react"
import { useRouter } from "next/navigation"
const PROFILES = [
{ id: "isabella", label: "Isabella", emoji: "👧", color: "bg-pink-500" },
{ id: "francesca", label: "Francesca", emoji: "👦", color: "bg-blue-500" },
{ id: "sebastian", label: "Sebastián", emoji: "🧒", color: "bg-green-500" },
{
id: "isabella",
label: "Isabella",
edad: "4 años",
emoji: "👧",
color: "from-pink-400 to-pink-500",
desc: "Letras, números y primeras palabras",
},
{
id: "francesca",
label: "Francesca",
edad: "6 años",
emoji: "👦",
color: "from-blue-400 to-blue-500",
desc: "Matemáticas, lectura y ortografía",
},
{
id: "sebastian",
label: "Sebastián",
edad: "8 años",
emoji: "🧒",
color: "from-green-400 to-green-500",
desc: "Matemáticas avanzadas, historia y geografía",
},
]
export default function RootPage() {
@@ -16,32 +37,57 @@ export default function RootPage() {
const host = window.location.hostname
if (host.includes("simulacro")) {
router.replace("/parent")
return
}
const params = new URLSearchParams(window.location.search)
const preselected = params.get("profile")
if (preselected && PROFILES.find(p => p.id === preselected)) {
router.replace(`/child/${preselected}`)
}
}, [router])
const handleSelect = (id: string) => {
if (id === "isabella") {
router.push("/child")
} else {
router.push(`/${id}`)
}
}
return (
<div className="min-h-dvh bg-background flex flex-col items-center justify-center p-6 gap-8">
<h1 className="text-4xl font-display font-bold text-center">¿Quién sos?</h1>
<div className="min-h-dvh bg-background flex flex-col items-center justify-center p-6 gap-6 relative overflow-hidden">
{/* Background decoration */}
<div className="absolute top-0 left-0 w-full h-1 bg-gradient-to-r from-primary via-accent to-secondary opacity-30" />
{/* Logo area */}
<div className="text-center space-y-1 mb-4">
<div className="text-5xl">📚</div>
<h1 className="text-3xl font-display font-bold text-foreground">
EduEasy
</h1>
<p className="text-muted-foreground text-sm">¿Quién va a aprender hoy?</p>
</div>
<div className="flex flex-col gap-4 w-full max-w-sm">
{PROFILES.map((p) => (
<button
key={p.id}
onClick={() => router.push(`/child/${p.id}`)}
className={`${p.color} text-white touch-target-lg rounded-2xl flex items-center gap-4 px-6 py-8 text-2xl font-display font-bold shadow-lg active:scale-95 transition-transform`}
onClick={() => handleSelect(p.id)}
className={`bg-gradient-to-r ${p.color} text-white touch-target-lg rounded-2xl flex items-center gap-4 px-6 py-6 text-left shadow-lg active:scale-95 transition-all hover:shadow-xl font-display`}
>
<span className="text-4xl">{p.emoji}</span>
<span>{p.label}</span>
<span className="text-5xl shrink-0">{p.emoji}</span>
<div className="flex-1 min-w-0">
<div className="text-xl font-bold">{p.label}</div>
<div className="text-sm opacity-80">{p.edad}</div>
<div className="text-xs opacity-70 mt-1">{p.desc}</div>
</div>
<span className="text-2xl opacity-60"></span>
</button>
))}
</div>
<div className="fixed bottom-4 text-center">
<button
onClick={() => router.push("/parent")}
className="text-sm text-muted-foreground underline underline-offset-2"
>
Mamá / Papá
</button>
</div>
</div>
)
}
+12
View File
@@ -0,0 +1,12 @@
import ExerciseSession from "@/components/child/exercise-session"
export default function SebastianGeografia() {
return (
<ExerciseSession
topic="geografia"
profile="SEBASTIAN"
loadingMessage="Preparando geografía..."
completeMessage="¡Terminaste geografía por ahora!"
/>
)
}
+12
View File
@@ -0,0 +1,12 @@
import ExerciseSession from "@/components/child/exercise-session"
export default function SebastianLectura() {
return (
<ExerciseSession
topic="lectura"
profile="SEBASTIAN"
loadingMessage="Preparando lectura..."
completeMessage="¡Terminaste las lecturas por ahora!"
/>
)
}
+12
View File
@@ -0,0 +1,12 @@
import ExerciseSession from "@/components/child/exercise-session"
export default function SebastianMatematicas() {
return (
<ExerciseSession
topic="matematicas"
profile="SEBASTIAN"
loadingMessage="Preparando matemáticas..."
completeMessage="¡Terminaste las matemáticas por ahora!"
/>
)
}
+15 -3
View File
@@ -8,8 +8,10 @@ import AudioUnlock from "@/components/child/audio-unlock"
const SEBASTIAN_KEY = "edueasy_child_sebastian"
const activities = [
{ id: "sumas", label: "Sumas avanzadas", icon: "", description: "Sumas de 2 y 3 dígitos" },
{ id: "historia", label: "Historia argentina", icon: "🇦🇷", description: "Personajes y eventos" },
{ id: "matematicas", label: "Matemáticas", icon: "", description: "Sumas, restas, multiplicación, división, fracciones" },
{ id: "lectura", label: "Lectura", icon: "📖", description: "Textos informativos y comprensión" },
{ id: "historia", label: "Historia argentina", icon: "🇦🇷", description: "Personajes, fechas y eventos" },
{ id: "geografia", label: "Geografía", icon: "🗺️", description: "Provincias, ríos y regiones" },
{ id: "banderas", label: "Banderas", icon: "🚩", description: "Provincias y símbolos" },
{ id: "logros", label: "Mis logros", icon: "⭐", color: "bg-warning" },
{ id: "pairing", label: "iPad nuevo", icon: "🔗", color: "bg-secondary" },
@@ -24,6 +26,16 @@ export default function SebastianHome() {
setPaired(!!localStorage.getItem(SEBASTIAN_KEY))
}, [])
const handleActivity = (id: string) => {
if (id === "logros") {
router.push("/child/logros?profile=sebastian")
} else if (id === "pairing") {
router.push("/child/pairing?profile=sebastian")
} else {
router.push(`/sebastian/${id}`)
}
}
if (!audioReady) {
return <AudioUnlock onUnlock={() => setAudioReady(true)} />
}
@@ -47,7 +59,7 @@ export default function SebastianHome() {
{activities.map((a) => (
<button
key={a.id}
onClick={() => router.push(`/sebastian/${a.id}`)}
onClick={() => handleActivity(a.id)}
className={`${a.color || "bg-accent"} text-primary-foreground touch-target-lg rounded-2xl flex items-center gap-4 px-6 py-5 text-xl font-display font-semibold shadow-md active:scale-95 transition-transform`}
>
<span className="text-2xl">{a.icon}</span>