feat: add classroom abandonment metrics and refresh prioritized roadmap

Author: jdsalasca

apps/backend/src/main/java/com/juegodefinitivo/autobook/api/dto/ClassroomDashboardResponse.java

@@ -8,6 +8,9 @@ public record ClassroomDashboardResponse(
         String teacherName,
         int students,
         int assignments,
+        int activeAttempts,
+        int completedAttempts,
+        int abandonmentRatePercent,
         List<StudentProgressView> studentProgress
 ) {
 }

apps/backend/src/main/java/com/juegodefinitivo/autobook/service/TeacherWorkspaceService.java

@@ -124,6 +124,8 @@ public ClassroomDashboardResponse getDashboard(String classroomId, LocalDate fro
         List<TeacherWorkspaceRepository.AttemptRow> attempts = loadAttempts(classroomId, from, to);
 
         List<StudentProgressView> progressViews = new ArrayList<>();
+        int totalAttempts = 0;
+        int totalCompletedAttempts = 0;
         for (TeacherWorkspaceRepository.StudentRow student : students) {
             List<TeacherWorkspaceRepository.AttemptRow> studentAttempts = attempts.stream()
                     .filter(attempt -> attempt.studentId().equals(student.id()))
@@ -139,6 +141,8 @@ public ClassroomDashboardResponse getDashboard(String classroomId, LocalDate fro
             int avgProgress = (int) states.stream().mapToInt(this::progressPercent).average().orElse(0);
             int completed = (int) states.stream().filter(GameStateResponse::completed).count();
             String difficulty = dominantDifficulty(states);
+            totalAttempts += studentAttempts.size();
+            totalCompletedAttempts += completed;
 
             progressViews.add(new StudentProgressView(
                     student.id(),
@@ -152,12 +156,20 @@ public ClassroomDashboardResponse getDashboard(String classroomId, LocalDate fro
             ));
         }
 
+        int activeAttempts = Math.max(0, totalAttempts - totalCompletedAttempts);
+        int abandonmentRatePercent = totalAttempts == 0
+                ? 0
+                : (int) ((activeAttempts / (double) totalAttempts) * 100);
+
         return new ClassroomDashboardResponse(
                 classroom.id(),
                 classroom.name(),
                 classroom.teacherName(),
                 students.size(),
                 assignments.size(),
+                activeAttempts,
+                totalCompletedAttempts,
+                abandonmentRatePercent,
                 progressViews
         );
     }

apps/backend/src/test/java/com/juegodefinitivo/autobook/TeacherControllerTest.java

@@ -100,6 +100,9 @@ void shouldCreateTeacherWorkspaceAndProduceDashboard() throws Exception {
         mockMvc.perform(get("/api/teacher/classrooms/" + classroomId + "/dashboard"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.classroomId").value(classroomId))
+                .andExpect(jsonPath("$.activeAttempts").isNumber())
+                .andExpect(jsonPath("$.completedAttempts").isNumber())
+                .andExpect(jsonPath("$.abandonmentRatePercent").isNumber())
                 .andExpect(jsonPath("$.studentProgress[0].studentId").value(studentId));
 
         mockMvc.perform(get("/api/teacher/classrooms/" + classroomId + "/dashboard")

apps/frontend/e2e/guided-flow.spec.ts

@@ -96,6 +96,9 @@ test("guided flow supports start, manual action and autoplay with telemetry", as
         teacherName: "Docente",
         students: 0,
         assignments: 0,
+        activeAttempts: 0,
+        completedAttempts: 0,
+        abandonmentRatePercent: 0,
         studentProgress: [],
       },
     });

apps/frontend/src/App.tsx

@@ -92,6 +92,9 @@ const EMPTY_DASHBOARD: ClassroomDashboard = {
   teacherName: "",
   students: 0,
   assignments: 0,
+  activeAttempts: 0,
+  completedAttempts: 0,
+  abandonmentRatePercent: 0,
   studentProgress: [],
 };
 
@@ -652,6 +655,12 @@ function App() {
                 <p>
                   Estudiantes: <strong>{dashboard.students}</strong> · Asignaciones: <strong>{dashboard.assignments}</strong>
                 </p>
+                <p>
+                  Intentos activos: <strong>{dashboard.activeAttempts}</strong> · Finalizados: <strong>{dashboard.completedAttempts}</strong>
+                </p>
+                <p>
+                  Abandono estimado: <strong>{dashboard.abandonmentRatePercent}%</strong>
+                </p>
                 <ul>
                   {dashboard.studentProgress.slice(0, 8).map((row) => (
                     <li key={row.studentId}>

apps/frontend/src/types.ts

@@ -92,6 +92,9 @@ export type ClassroomDashboard = {
   teacherName: string;
   students: number;
   assignments: number;
+  activeAttempts: number;
+  completedAttempts: number;
+  abandonmentRatePercent: number;
   studentProgress: StudentProgress[];
 };
 

docs/NEXT_STEPS.md

@@ -18,6 +18,7 @@
 - Auth API por roles con token (`student/teacher/admin`) para endpoints `/api/**`.
 - Rate limiting basico por IP para endpoints de escritura.
 - Filtros temporales (`from`, `to`) para dashboard y reporte docente.
+- Dashboard docente con intentos activos/finalizados y tasa estimada de abandono.
 
 1. Persistencia productiva
 - Agregar estrategia de backup/restore y retencion.

docs/PRIORITY_REQUIREMENTS.md

@@ -9,21 +9,21 @@ Definir que implementar primero para maximizar valor comunitario (estudiantes, d
 - Regla de salida: no pasa a implementacion si no tiene criterio de aceptacion medible.
 
 ## Current Priority Order
-1. Seguridad institucional minima (`R5`):
+1. Seguridad institucional minima (`R5`) [P0]:
    - Autenticacion/roles (`teacher`, `student`, `admin`).
    - Seguridad de importacion de archivos (MIME/firma, limites, saneamiento).
    - Endurecimiento de errores y controles anti-abuso (rate limiting).
-2. Evidence Pack docente avanzado (`R2`):
+2. Evidence Pack docente avanzado (`R2`) [P1]:
    - Tiempo efectivo de lectura.
    - Abandono por actividad.
    - Segmentacion por cohorte y periodo.
-3. Calidad pedagogica (`R3`):
+3. Calidad pedagogica (`R3`) [P1]:
    - Mejorar banco de preguntas por nivel lector/habilidad.
    - Mantener benchmark de calidad en CI como gate obligatorio.
-4. Accesibilidad estudiantil (`R1` + `R3`):
+4. Accesibilidad estudiantil (`R1` + `R3`) [P1]:
    - Alto contraste y modo lectura amigable.
    - Narracion asistida (TTS) y ayudas de lectura.
-5. Operacion de plataforma (`R5`):
+5. Operacion de plataforma (`R5`) [P2]:
    - Observabilidad (logs estructurados y metricas).
    - Backup/restore y retencion.
    - Contratos OpenAPI para integracion segura.
@@ -34,9 +34,10 @@ Definir que implementar primero para maximizar valor comunitario (estudiantes, d
 3. E2E base `npm run test:e2e` en verde.
 4. Criterios de mercado trazados en `docs/MARKET_VALUE_REQUIREMENTS.md`.
 
-## Active Delivery Slice (now)
+## Active Delivery Slice (status)
 1. Hardening de import de libros. (implementado base)
 2. Anti-duplicados y consistencia de evidencia docente. (implementado)
 3. UX infantil accesible (lectura amigable + alto contraste). (implementado)
 4. Auth por roles y rate limiting basico. (implementado base)
 5. Segmentacion temporal docente (`from`/`to`) en dashboard y CSV. (implementado base)
+6. Pendiente inmediato: metrica de tiempo efectivo y abandono por actividad real. (siguiente P1)

docs/ROADMAP.md

@@ -10,6 +10,6 @@
 7. `v3.5` (parcial): panel docente y analitica por estudiante con export CSV.
 
 ## Next Milestones
-1. `v3.5`: cerrar analitica docente avanzada (tiempo, abandono, cohortes).
-2. `v3.6`: instalador firmado + observabilidad de produccion.
+1. `v3.5`: cerrar analitica docente avanzada (tiempo, abandono, cohortes) y consolidar filtros por periodo.
+2. `v3.6`: seguridad institucional (auth/roles productivo), observabilidad de produccion y backup/restore.
 3. `v3.7`: mejora profunda de lectura de libros (OCR, tablas, encabezados complejos, chunking semantico).