# Matriz de brechas PRD vs sistema CreaBotX

Fecha: 2026-06-09  
Sistema revisado: CreaBotX / CreaLiga Academy  
Producto publico: RoboLiga Academy  
Ruta local: `C:\sistema_creabotx`

## Proposito

Este documento compara el PRD tecnico del MVP de RoboLiga Academy con el estado real de CreaBotX. Sirve para decidir que se puede pilotear ahora, que requiere ejecucion operativa y que debe quedar para una segunda version.

## Estado real confirmado

El sistema ya cuenta con:

- Gestion de usuarios, alumnos, docentes y padres.
- Organizacion academica: cursos, paralelos, aulas y matriculas.
- Diagnostico con pretest, preguntas, respuestas y resultados.
- Robotica con prototipos, grupos, integrantes y roles.
- Aula virtual tipo LMS con modulos, clases, progresos, tareas, entregas y evidencias.
- Reportes y metricas pedagogicas.
- Seguridad por rol y cambio obligatorio de clave.
- Comunidad CreaLiga con retos, publicaciones, comentarios, evaluaciones, aplausos, foro, biblioteca, insignias y portafolio.
- Landing comercial RoboLiga Academy en `/roboliga-academy/`.
- Pagina web de materiales del piloto en `/roboliga-academy/materiales/`.
- Descarga controlada de documentos y PowerPoint desde rutas Django.
- Paneles admin, docente, alumno y padre con accesos directos al piloto.
- Respaldo, restauracion y preparacion para hosting.

Datos base confirmados por el plan de pendientes actualizado:

```text
Perfiles de usuario: 62
Estudiantes: 30
Docentes: 1
Representantes/padres: 30
Cursos: 2
Paralelos: 3
Aulas: 6
Matriculas: 30
Preguntas pretest: 20
Resultados pretest: 30
Respuestas pretest: 580
Prototipos: 20
Grupos: 8
Integrantes de grupo: 30
Modulos LMS: 20
Clases LMS: 60
Progresos LMS: 90
Tareas: 60
Categorias CreaLiga: 18
Retos CreaLiga: 5
Insignias: 5
Recursos biblioteca: 8
Rubricas CreaLiga: 2
Tema foro RoboPaso: 1
Publicaciones reales del piloto: pendiente operativo
```

## Criterios de estado

- Implementado: existe y puede usarse en el piloto.
- Implementado documental: existe como documento o material operativo.
- Parcial: existe una base funcional, pero requiere uso real, datos reales o refinamiento.
- Faltante operativo: no falta codigo base, pero falta ejecutar la actividad con usuarios reales.
- Segunda fase: no conviene incluirlo en el piloto inicial.

## Matriz principal

| Requisito PRD | Estado | Evidencia en sistema | Riesgo | Prioridad piloto |
| --- | --- | --- | --- | --- |
| Inicio de sesion | Implementado | `/ingresar/` | Bajo | Alta |
| Cambio obligatorio de clave | Implementado | `/cambiar-clave/` y middleware | Medio si no se comunica a usuarios | Alta |
| Roles estudiante/docente/admin | Implementado | `PerfilUsuario.rol` y vistas protegidas | Bajo | Alta |
| Rol padre | Implementado adicional | `/panel/padre/` | Bajo, aunque no es MVP minimo | Media |
| Alta controlada de usuarios | Implementado | `/usuarios/alumnos/`, `/usuarios/docentes/`, `/usuarios/padres/` | Bajo | Alta |
| Gestion academica de clases/aulas | Implementado | `/academico/` | Bajo | Alta |
| Codigo de invitacion a clase | Segunda fase | No hay modelo especifico de invitacion por codigo | Medio | Baja para piloto local |
| Matricula o vinculacion a aula | Implementado | `Matricula`, `Aula` | Bajo | Alta |
| Crear retos | Implementado | `/comunidad/retos/nuevo/` | Bajo | Alta |
| Reto piloto RoboPaso | Implementado | Comando `sembrar_piloto_robopaso` y reto semilla | Bajo | Alta |
| Ver retos activos | Implementado | `/comunidad/retos/` | Bajo | Alta |
| Detalle de reto con reglas | Implementado | Modelo `RetoRobotica` con reglas, descripcion, objetivo y fechas | Bajo | Alta |
| Subir proyecto o avance | Implementado | `/comunidad/publicaciones/nueva/` | Medio por calidad de evidencias reales | Alta |
| Campos pedagogicos de proyecto | Implementado | problema, solucion, mejoras, reflexion, materiales, codigo | Bajo | Alta |
| Evidencia con imagen, video o enlace | Implementado | `imagen`, `video_url`, `repositorio_url` | Medio si no se define permiso de imagen | Alta |
| Likes educativos | Implementado | `AplausoProyecto` | Bajo | Media |
| Calificacion con estrellas/rubrica | Implementado | `EvaluacionProyecto` y rubricas CreaLiga | Bajo | Alta |
| Rubrica RoboPaso | Implementado | Rubrica semilla del piloto | Bajo | Alta |
| Comentarios moderados | Implementado | `ComentarioProyecto.visible` y `verificado_docente` | Medio si docente no revisa diario | Alta |
| Ranking por reto | Parcial | Servicios de ranking por publicaciones y evaluaciones | Medio: necesita publicaciones reales | Alta |
| Insignias basicas | Implementado | `Insignia`, `LogroEstudiante` | Bajo | Media |
| Portafolio del estudiante | Implementado | `/comunidad/portafolio/<id>/` | Medio: requiere publicaciones aprobadas | Alta |
| Panel docente | Implementado | `/panel/docente/` con accesos del piloto | Bajo | Alta |
| Panel administrador | Implementado | `/panel/admin/` con accesos del piloto | Bajo | Alta |
| Panel estudiante | Implementado | `/panel/alumno/` con flujo RoboPaso | Bajo | Alta |
| Panel padre | Implementado adicional | `/panel/padre/` con consentimiento y privacidad | Bajo | Media |
| Biblioteca de recursos | Implementado | `/comunidad/biblioteca/`, recursos RoboPaso sembrados | Bajo | Media |
| Foro tecnico | Implementado | `/comunidad/foro/`, tema inicial RoboPaso | Bajo | Media |
| Analitica avanzada | Parcial | `/reportes/metricas/` cubre pretest, preguntas, aulas y grupos | Bajo para piloto | Media |
| Exportacion CSV | Implementado | `/reportes/metricas/exportar-pretest.csv` | Bajo | Media |
| Materiales web del piloto | Implementado | `/roboliga-academy/materiales/` | Bajo | Alta |
| Pitch PowerPoint | Implementado documental | `outputs/pitch_roboliga_academy.pptx` | Bajo | Media comercial |
| Consentimiento de representantes | Implementado documental | `docs/formato_consentimiento_representante.md` | Medio si no se imprime o guarda | Alta |
| Privacidad especifica para menores | Implementado documental | `docs/privacidad_menores_y_consentimiento.md` | Alto si no se aplica en moderacion | Alta |
| Checklist del dia del piloto | Implementado documental | `docs/checklist_dia_piloto_robopaso.md` | Bajo | Alta |
| Manual docente | Implementado documental | `docs/manual_docente_creabotx.md` | Bajo | Alta |
| Manual estudiante | Implementado documental | `docs/manual_estudiante_creabotx.md` | Bajo | Media |
| Manual padre | Implementado documental | `docs/manual_padre_familia_creabotx.md` | Bajo | Media |
| Publicaciones reales del piloto | Faltante operativo | Depende de estudiantes/docente durante el piloto | Alto para demo si no se crea | Alta |
| Evidencias reales | Faltante operativo | Depende de estudiantes/docente | Alto para validar impacto | Alta |
| Moderacion real | Faltante operativo | Debe ejecutarla el docente durante el piloto | Alto si hay imagenes de menores | Alta |
| Evaluacion real con rubrica | Faltante operativo | Debe realizarse sobre publicaciones reales | Alto para medir resultados | Alta |
| Respaldo antes/despues del piloto | Faltante operativo | `5_RESPALDAR_DATOS.bat` existe | Alto si se omite | Alta |
| Decision de hosting | Faltante operativo | `6_PREPARAR_HOSTING.bat` existe | Medio | Despues del piloto |
| Red social abierta | Excluida | No implementada | Bajo | No incluir |
| Chat privado | Excluida | No implementado | Bajo, decision correcta | No incluir |
| Pagos y suscripciones | Segunda fase | No implementado | Bajo | Segunda fase |
| Certificados digitales | Segunda fase | No implementado | Bajo | Segunda fase |
| Jueces externos | Segunda fase | Modelo evalua tipo juez, pero sin rol/panel dedicado | Medio | Segunda fase |
| Multiinstitucion avanzada | Segunda fase | Modelo `InstitucionEducativa` existe como base | Medio | Segunda fase |
| App movil nativa | Segunda fase | Sistema web responsive | Bajo | Segunda fase |
| IA educativa | Segunda fase | No implementada | Medio si se promete comercialmente | Segunda fase |

## Brechas criticas para piloto

1. Publicaciones y evidencias reales.

Sin publicaciones reales, el ranking, portafolio, comentarios y evaluaciones no muestran el valor completo. Se recomienda crear al menos una publicacion por grupo piloto o por estudiante, segun carga del docente.

2. Moderacion docente real.

El sistema ya permite moderar, observar y aprobar. El riesgo no es tecnico sino operativo: el docente debe revisar contenidos antes de que se usen como evidencia de piloto.

3. Evaluacion con rubrica real.

La rubrica existe, pero el impacto se valida cuando el docente evalua evidencias reales y los estudiantes ven retroalimentacion.

4. Consentimientos aplicados.

El formato ya existe. Falta distribuirlo, recogerlo y verificarlo antes de aprobar fotos o videos donde el estudiante sea identificable.

5. Respaldo.

Los scripts existen, pero el respaldo debe ejecutarse antes y despues del piloto.

## Brechas que no bloquean el piloto

- Invitaciones por codigo.
- Certificados digitales.
- Rol juez externo.
- Pagos o suscripciones.
- Moderacion automatizada.
- App movil nativa.
- IA educativa.
- Torneos interinstitucionales.

## Recomendacion de alcance MVP real

Para el piloto RoboPaso, usar solo:

- Login.
- Cambio de clave.
- Aula virtual.
- Reto RoboPaso.
- Publicacion de evidencia.
- Comentario moderado.
- Evaluacion docente con rubrica.
- Ranking por reto.
- Portafolio.
- Reporte docente.
- Consentimiento de representante si hay imagen/video.
- Materiales web en `/roboliga-academy/materiales/`.

Evitar por ahora:

- Chat privado.
- Red social abierta.
- Pagos.
- Certificados.
- IA.
- Jueces externos.
- Competencias entre instituciones.

## Decision tecnica

El sistema esta listo para piloto local controlado si se ejecutan estas acciones operativas:

1. Ejecutar respaldo antes del piloto.
2. Confirmar accesos y cambio de clave.
3. Distribuir y guardar consentimientos.
4. Cargar publicaciones y evidencias reales.
5. Moderar publicaciones.
6. Evaluar con rubrica.
7. Revisar ranking y portafolio.
8. Ejecutar respaldo final.
9. Decidir si se prepara hosting.