rckrdmrd
a249c99be2
Some checks failed
CI Pipeline / changes (push) Has been cancelled
CI Pipeline / core (push) Has been cancelled
CI Pipeline / trading-backend (push) Has been cancelled
CI Pipeline / trading-data-service (push) Has been cancelled
CI Pipeline / trading-frontend (push) Has been cancelled
CI Pipeline / erp-core (push) Has been cancelled
CI Pipeline / erp-mecanicas (push) Has been cancelled
CI Pipeline / gamilit-backend (push) Has been cancelled
CI Pipeline / gamilit-frontend (push) Has been cancelled
## Backend - fix(ranks): Reordenar rutas en RanksController para evitar conflictos 404 - feat(gamification): Agregar MayaRankEntity al modulo - feat(ml-coins): Expandir funcionalidad del servicio - feat(teacher): Mejoras en dashboard, mensajes y reportes - feat(entities): Nuevas entidades admin, educational, progress, social ## Frontend - feat(gamificationAPI): API completa para ranks con endpoints - feat(RubricEvaluator): Nuevo componente para evaluacion docente - refactor(admin): Mejoras en hooks y paginas - refactor(teacher): Mejoras en paginas del portal ## Database - fix(initialize_user_stats): Agregar is_current y achieved_at a user_ranks - fix(notifications-policies): Corregir RLS con JOIN correcto - feat(friendships): Agregar columna status con estados - sync(seeds): Homologacion completa DEV <-> PROD ## Docs & Orchestration - docs(api): Actualizar API-TEACHER-MODULE.md - docs(frontend): COMPONENTES-INVENTARIO.md - docs(database): VIEWS-INVENTARIO.md, VALIDACION-DDL-SEEDS - Reportes de analisis y validacion 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
166 lines
5.3 KiB
Markdown
166 lines
5.3 KiB
Markdown
# ÉPICA: EAI-007 - Módulos 4 y 5: Lectura Digital y Producción
|
|
|
|
### Metadata
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **ID** | EAI-007 |
|
|
| **Nombre** | Módulos Lectura Digital y Producción |
|
|
| **Módulo** | educational_content |
|
|
| **Fase** | Fase 2 - Robustecimiento |
|
|
| **Prioridad** | P0 |
|
|
| **Estado** | Done ✅ |
|
|
| **Story Points** | 35 |
|
|
| **Sprint(s)** | Sprint 7-8 |
|
|
|
|
### Descripción
|
|
|
|
Completar la implementación de los módulos educativos 4 (Lectura Digital y Multimodal) y 5 (Producción y Expresión Lectora), que comprenden 8 tipos de ejercicios que requieren revisión manual por docentes. Estos módulos son críticos para completar el journey completo del estudiante hasta el rango K'uk'ulkan.
|
|
|
|
### Objetivo de Negocio
|
|
|
|
- Permitir que estudiantes alcancen el rango máximo (K'uk'ulkan) completando todos los módulos
|
|
- Habilitar evaluación de competencias de producción creativa
|
|
- Cerrar el ciclo educativo completo sobre Marie Curie
|
|
|
|
### Stakeholders
|
|
|
|
| Rol | Nombre/Equipo | Responsabilidad |
|
|
|-----|---------------|-----------------|
|
|
| Product Owner | Isem | Aprobación de criterios |
|
|
| Tech Lead | Backend-Agent | Validación técnica |
|
|
| Usuarios | Estudiantes 10-14 años | Completar ejercicios |
|
|
| Usuarios | Docentes | Calificar ejercicios |
|
|
|
|
---
|
|
|
|
### Historias de Usuario
|
|
|
|
| ID | Historia | Prioridad | SP | Estado |
|
|
|----|----------|-----------|-----|--------|
|
|
| US-M4-001 | Como desarrollador, quiero crear DTOs para M4 para validar respuestas | P0 | 5 | Done ✅ |
|
|
| US-M4-002 | Como estudiante, quiero recibir XP/ML al completar M4 | P0 | 3 | Done ✅ |
|
|
| US-M5-001 | Como desarrollador, quiero crear DTOs para M5 para soportar multimedia | P0 | 5 | Done ✅ |
|
|
| US-M5-002 | Como docente, quiero calificar ejercicios M4-M5 con rúbricas | P0 | 8 | Done ✅ |
|
|
| US-M4M5-001 | Como QA, quiero seeds de prueba para validar flujos | P1 | 5 | Done ✅ |
|
|
| US-M4M5-002 | Como estudiante, quiero ver mi progreso hacia K'uk'ulkan | P1 | 3 | Done ✅ |
|
|
| US-M4M5-003 | Como docente, quiero notificaciones de nuevos envíos | P1 | 5 | Done ✅ |
|
|
|
|
**Total Story Points:** 34
|
|
|
|
---
|
|
|
|
### Criterios de Aceptación de la Épica
|
|
|
|
**Funcionales:**
|
|
- [x] Los 5 ejercicios de M4 permiten envío de respuestas
|
|
- [x] Las 3 opciones de M5 soportan contenido multimedia
|
|
- [x] El sistema identifica ejercicios pendientes de revisión
|
|
- [x] Docentes pueden calificar con puntuación 0-100
|
|
- [x] Estudiantes reciben XP/ML tras calificación
|
|
|
|
**No Funcionales:**
|
|
- [x] Performance: Carga de multimedia < 30s para archivos de 50MB
|
|
- [x] Seguridad: Validación de tipos de archivo permitidos
|
|
- [x] Usabilidad: Interfaz de calificación clara y eficiente
|
|
|
|
**Técnicos:**
|
|
- [x] Cobertura de tests > 60%
|
|
- [x] Documentación de endpoints completa
|
|
- [x] Seeds de prueba en ambiente dev
|
|
|
|
---
|
|
|
|
### Dependencias
|
|
|
|
**Esta épica depende de:**
|
|
| Épica/Módulo | Estado | Bloqueante |
|
|
|--------------|--------|------------|
|
|
| EAI-003 Gamificación | Done | Sí |
|
|
| EAI-002 Actividades | Done | Sí |
|
|
| MediaStorageService | Done | Sí |
|
|
| ManualReviewService | Done | Sí |
|
|
|
|
**Esta épica bloquea:**
|
|
| Épica/Módulo | Razón |
|
|
|--------------|-------|
|
|
| Certificación K'uk'ulkan | Requiere completar M5 |
|
|
| EAI-003-EXT Gamificación Social | Mejor con módulos completos |
|
|
|
|
---
|
|
|
|
### Desglose Técnico
|
|
|
|
**Database:**
|
|
- [ ] Schema: educational_content
|
|
- [ ] Tablas: media_attachments (existente), ejercicios M4-M5 (seeds)
|
|
- [ ] Funciones: validate_module4_module5_answer (existente)
|
|
- [ ] RLS Policies: Existentes
|
|
|
|
**Backend:**
|
|
- [ ] Módulo: educational, teacher
|
|
- [ ] DTOs: 8 nuevos (1 por tipo de ejercicio)
|
|
- [ ] Endpoints: 4 nuevos
|
|
- [ ] Tests: 12 esperados
|
|
|
|
**Frontend:**
|
|
- [ ] Páginas: TeacherManualReviewsPage (nueva)
|
|
- [ ] Componentes: MediaViewer mejorado
|
|
- [ ] Stores: Integración con existentes
|
|
|
|
---
|
|
|
|
### Riesgos
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigación |
|
|
|--------|--------------|---------|------------|
|
|
| Complejidad de multimedia | Media | Alto | Límites de tamaño, formatos |
|
|
| Carga de trabajo docente | Alta | Medio | Notificaciones, priorización |
|
|
| Storage costs | Baja | Bajo | Compresión, cleanup policies |
|
|
|
|
---
|
|
|
|
### Definition of Ready (DoR)
|
|
|
|
- [x] Historias de usuario definidas
|
|
- [x] Criterios de aceptación claros
|
|
- [x] Dependencias identificadas
|
|
- [x] Estimación completada
|
|
- [x] Diseño técnico aprobado
|
|
- [x] Sin bloqueadores activos
|
|
|
|
### Definition of Done (DoD)
|
|
|
|
- [x] Código implementado y revisado
|
|
- [x] Tests pasando (unit, integration)
|
|
- [x] Documentación actualizada
|
|
- [x] Inventarios actualizados
|
|
- [x] Trazas registradas
|
|
- [x] Demo realizada
|
|
- [x] Product Owner aprobó
|
|
|
|
---
|
|
|
|
### Documentación Relacionada
|
|
|
|
- Diseño: `docs/00-vision-general/DocumentoDeDiseño_Mecanicas_GAMILIT_v6_1.md` (líneas 782-1119)
|
|
- Validador: `apps/database/ddl/schemas/educational_content/functions/23-validate_module4_module5.sql`
|
|
- Frontend M4: `apps/frontend/src/features/mechanics/module4/`
|
|
- Frontend M5: `apps/frontend/src/features/mechanics/module5/`
|
|
|
|
---
|
|
|
|
### Historial
|
|
|
|
| Fecha | Cambio | Autor |
|
|
|-------|--------|-------|
|
|
| 2025-12-05 | Creación de épica | Requirements-Analyst |
|
|
| 2025-12-23 | Módulos M4-M5 completamente implementados | Requirements-Analyst |
|
|
| 2025-12-26 | Estado actualizado a Done | Requirements-Analyst |
|
|
|
|
---
|
|
|
|
**Creada por:** Requirements-Analyst
|
|
**Fecha:** 2025-12-05
|
|
**Última actualización:** 2025-12-26
|