feat: fase 5 — botones volver, seguridad APIs, infraestructura

- Botón 'Volver' en todas las sesiones de ejercicios (ExerciseSession)
- Botón 'Cambiar perfil' en las 3 home pages (Isabella/Francesca/Sebastián)
- Páginas inline de Isabella migradas a ExerciseSession (elimina código duplicado)
- APIs con try/catch: curriculum/next, dashboard/summary, fsrs/next, children
- Validación childId en curriculum/next (404 si no existe)
- /api/health endpoint para Docker healthcheck
- .env.example, .dockerignore, README.md creados
- docker-compose.yml con healthcheck en app service
- Test E2E: health endpoint + childId validation
- 62/62 tests pasan, TS exit 0
This commit is contained in:
renato97
2026-07-26 02:00:27 -03:00
parent ce7cb27290
commit 411f235f75
18 changed files with 470 additions and 457 deletions
+7 -162
View File
@@ -1,167 +1,12 @@
"use client"
import { useState, useCallback, useEffect, useRef } from "react"
import { motion, AnimatePresence } from "framer-motion"
import { GatoMascota } from "@/components/child/gato-mascota"
import NoChildError from "@/components/child/no-child-error"
import TemporizadorVisual from "@/components/child/temporizador-visual"
import ExerciseDispatcher from "@/components/exercises/exercise-dispatcher"
import { speak, stopSpeaking } from "@/lib/speech"
import type { Exercise } from "@/curriculum/types"
const CHILD_ID_KEY = "edueasy_child_id"
type PageState = "loading" | "ready" | "complete" | "error"
import ExerciseSession from "@/components/child/exercise-session"
export default function LecturaSesion() {
const [pageState, setPageState] = useState<PageState>("loading")
const [exercise, setExercise] = useState<Exercise | null>(null)
const [running, setRunning] = useState(true)
const [score, setScore] = useState(0)
const [totalAttempts, setTotalAttempts] = useState(0)
const childIdRef = useRef<string>("")
const startedAtRef = useRef(new Date().toISOString())
const getChildId = useCallback(() => {
const id = localStorage.getItem(CHILD_ID_KEY) || ""
childIdRef.current = id
return id
}, [])
const fetchNext = useCallback(async () => {
const childId = getChildId()
if (!childId) {
setPageState("error")
return null
}
try {
const res = await fetch(`/api/curriculum/next?childId=${childId}&topic=lectura`)
const data = await res.json()
if (data.done || !data.id) {
setPageState("complete")
return null
}
setExercise(data)
setPageState("ready")
return data
} catch {
setPageState("error")
return null
}
}, [getChildId])
useEffect(() => {
fetchNext()
}, [fetchNext])
const gradeAttempt = useCallback(async (ex: Exercise, correct: boolean) => {
const childId = childIdRef.current
if (!childId || !ex) return
setTotalAttempts((t) => t + 1)
if (correct) setScore((s) => s + 1)
const errorType = !correct
? ex.errorType || "discriminacion-auditiva"
: null
try {
await fetch("/api/curriculum/grade", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
childId,
exerciseId: ex.id,
skillCode: ex.skillCode,
correct,
promptLevel: 0,
responseMs: 3000,
errorType,
stage: ex.stage,
}),
})
} catch {
// silent
}
}, [])
const handleComplete = useCallback(
async (correct: boolean) => {
if (!exercise) return
await gradeAttempt(exercise, correct)
stopSpeaking()
if (correct) {
await speak("¡Muy bien!")
await new Promise((r) => setTimeout(r, 800))
}
fetchNext()
},
[exercise, gradeAttempt, fetchNext],
)
const resetSession = useCallback(() => {
setScore(0)
setTotalAttempts(0)
setRunning(true)
startedAtRef.current = new Date().toISOString()
fetchNext()
}, [fetchNext])
if (pageState === "loading") {
return (
<div className="flex-1 flex items-center justify-center">
<GatoMascota mood="coach" message="Preparando ejercicios..." size="sm" />
</div>
)
}
if (pageState === "error") {
return <NoChildError onRetry={resetSession} />
}
if (pageState === "complete") {
return (
<div className="flex-1 flex flex-col items-center justify-center p-8 gap-6">
<GatoMascota mood="celebrate" message="¡Terminaste todos los ejercicios por ahora!" size="lg" />
<p className="text-lg font-display">
Aciertos: {score}/{totalAttempts}
</p>
<button
onClick={resetSession}
className="bg-primary text-primary-foreground touch-target-lg rounded-2xl px-8 py-4 text-xl font-display font-bold"
>
Jugar de nuevo
</button>
</div>
)
}
return (
<div className="flex-1 flex flex-col items-center justify-center p-6 gap-6">
<TemporizadorVisual
durationMinutes={10}
onComplete={() => {
setRunning(false)
setPageState("complete")
}}
running={running}
/>
<AnimatePresence mode="wait">
<motion.div
key={exercise?.id || "empty"}
initial={{ opacity: 0, x: 50 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -50 }}
transition={{ duration: 0.25 }}
className="w-full max-w-md"
>
{exercise && (
<ExerciseDispatcher exercise={exercise} onComplete={handleComplete} />
)}
</motion.div>
</AnimatePresence>
</div>
<ExerciseSession
topic="lectura"
profile="ISABELLA"
loadingMessage="Preparando ejercicios..."
completeMessage="¡Terminaste todos los ejercicios por ahora!"
/>
)
}
+7 -162
View File
@@ -1,167 +1,12 @@
"use client"
import { useState, useCallback, useEffect, useRef } from "react"
import { motion, AnimatePresence } from "framer-motion"
import { GatoMascota } from "@/components/child/gato-mascota"
import NoChildError from "@/components/child/no-child-error"
import TemporizadorVisual from "@/components/child/temporizador-visual"
import ExerciseDispatcher from "@/components/exercises/exercise-dispatcher"
import { speak, stopSpeaking } from "@/lib/speech"
const CHILD_ID_KEY = "edueasy_child_id"
const META_KEY = "edueasy_child_meta"
type PageState = "loading" | "ready" | "complete" | "error"
import ExerciseSession from "@/components/child/exercise-session"
export default function NumerosSesion() {
const [pageState, setPageState] = useState<PageState>("loading")
const [exercise, setExercise] = useState<any | null>(null)
const [running, setRunning] = useState(true)
const [score, setScore] = useState(0)
const [totalAttempts, setTotalAttempts] = useState(0)
const childIdRef = useRef<string>("")
const startedAtRef = useRef(new Date().toISOString())
const getChildId = useCallback(() => {
const id = localStorage.getItem(CHILD_ID_KEY) || ""
childIdRef.current = id
return id
}, [])
const fetchNext = useCallback(async () => {
const childId = getChildId()
if (!childId) {
setPageState("error")
return null
}
try {
const res = await fetch(`/api/curriculum/next?childId=${childId}&topic=numeros`)
const data = await res.json()
if (data.done || !data.id) {
setPageState("complete")
return null
}
setExercise(data)
setPageState("ready")
return data
} catch {
setPageState("error")
return null
}
}, [getChildId])
useEffect(() => {
fetchNext()
}, [fetchNext])
const gradeAttempt = useCallback(async (ex: any, correct: boolean) => {
const childId = childIdRef.current
if (!childId || !ex) return
setTotalAttempts((t) => t + 1)
if (correct) setScore((s) => s + 1)
const errorType = !correct
? ex.errorType || "discriminacion-auditiva"
: null
try {
await fetch("/api/curriculum/grade", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
childId,
exerciseId: ex.id,
skillCode: ex.skillCode,
correct,
promptLevel: 0,
responseMs: 3000,
errorType,
stage: ex.stage,
}),
})
} catch {
// silent
}
}, [])
const handleComplete = useCallback(
async (correct: boolean) => {
if (!exercise) return
await gradeAttempt(exercise, correct)
stopSpeaking()
if (correct) {
await speak("¡Muy bien!")
await new Promise((r) => setTimeout(r, 800))
}
fetchNext()
},
[exercise, gradeAttempt, fetchNext],
)
const resetSession = useCallback(() => {
setScore(0)
setTotalAttempts(0)
setRunning(true)
startedAtRef.current = new Date().toISOString()
fetchNext()
}, [fetchNext])
if (pageState === "loading") {
return (
<div className="flex-1 flex items-center justify-center">
<GatoMascota mood="coach" message="Preparando ejercicios de números..." size="sm" />
</div>
)
}
if (pageState === "error") {
return <NoChildError onRetry={resetSession} />
}
if (pageState === "complete") {
return (
<div className="flex-1 flex flex-col items-center justify-center p-8 gap-6">
<GatoMascota mood="celebrate" message="¡Terminaste todos los ejercicios de números por ahora!" size="lg" />
<p className="text-lg font-display">
Aciertos: {score}/{totalAttempts}
</p>
<button
onClick={resetSession}
className="bg-primary text-primary-foreground touch-target-lg rounded-2xl px-8 py-4 text-xl font-display font-bold"
>
Jugar de nuevo
</button>
</div>
)
}
return (
<div className="flex-1 flex flex-col items-center justify-center p-6 gap-6">
<TemporizadorVisual
durationMinutes={10}
onComplete={() => {
setRunning(false)
setPageState("complete")
}}
running={running}
/>
<AnimatePresence mode="wait">
<motion.div
key={exercise?.id || "empty"}
initial={{ opacity: 0, x: 50 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -50 }}
transition={{ duration: 0.25 }}
className="w-full max-w-md"
>
{exercise && (
<ExerciseDispatcher exercise={exercise} onComplete={handleComplete} />
)}
</motion.div>
</AnimatePresence>
</div>
<ExerciseSession
topic="numeros"
profile="ISABELLA"
loadingMessage="Preparando números..."
completeMessage="¡Terminaste los números por ahora!"
/>
)
}
+12 -2
View File
@@ -14,8 +14,17 @@ export default function ChildHome() {
const router = useRouter()
return (
<div className="flex-1 flex flex-col items-center justify-center p-6 gap-8">
<GatoMascota mood="happy" message="¡Hola! ¿Qué querés aprender hoy?" />
<div className="flex-1 flex flex-col p-4">
<button
onClick={() => router.push("/")}
className="self-start flex items-center gap-2 bg-surface text-foreground border border-border rounded-xl px-4 py-2 text-base font-display font-semibold shadow-sm active:scale-95 transition-transform mb-4"
>
<span className="text-xl"></span>
<span>Cambiar perfil</span>
</button>
<div className="flex-1 flex flex-col items-center justify-center gap-8">
<GatoMascota mood="happy" message="¡Hola! ¿Qué querés aprender hoy?" />
<div className="flex flex-col gap-4 w-full max-w-md">
{activities.map((a) => (
@@ -29,6 +38,7 @@ export default function ChildHome() {
</button>
))}
</div>
</div>
</div>
)
}