# Manual docente CreaBotX / RoboLiga Academy

Fecha: 2026-06-09  
Audiencia: docentes, entrenadores y responsables de aula

## 1. Ingreso

1. Abrir el sistema:

```text
http://127.0.0.1:8080/
```

2. Entrar en:

```text
/ingresar/
```

3. Escribir usuario y clave entregados por el administrador.

4. Si el sistema pide cambio de clave, crear una clave personal y no compartirla.

## 2. Panel docente

Despues de ingresar, usar:

```text
/panel/docente/
```

Desde este panel se accede a:

- Alumnos.
- Aula virtual.
- Grupos y prototipos.
- Comunidad CreaLiga.
- Reportes.

## 3. Gestion de alumnos

Ruta:

```text
/usuarios/alumnos/
```

Acciones principales:

- Revisar lista de estudiantes.
- Crear estudiante si falta.
- Editar datos basicos.
- Confirmar que el estudiante tenga usuario vinculado.
- Verificar que este matriculado en aula/curso correcto.

Recomendacion: no duplicar estudiantes. Antes de crear uno nuevo, buscar por apellido o cedula.

## 4. Aula virtual

Rutas:

```text
/seguimiento/aula-virtual/
/seguimiento/clases/
/seguimiento/progresos/
```

Usar el aula virtual para:

- Revisar clases por prototipo.
- Ver objetivos, materiales y actividades.
- Registrar avances de estudiantes.
- Controlar evidencias y tareas.

## 5. Crear o revisar retos

Ruta:

```text
/comunidad/retos/
```

Para crear:

```text
/comunidad/retos/nuevo/
```

Un reto debe tener:

- Titulo claro.
- Objetivo pedagogico.
- Reglas.
- Materiales sugeridos.
- Fechas de inicio/cierre si aplica.
- Nivel.
- Aula o prototipo si corresponde.

Para piloto, usar el reto RoboPaso sembrado por el comando:

```bat
python manage.py sembrar_piloto_robopaso
```

## 6. Revisar publicaciones

Ruta:

```text
/comunidad/publicaciones/
```

Una publicacion de estudiante debe incluir:

- Que construyo o intento.
- Que problema encontro.
- Como lo soluciono.
- Que mejora realizo.
- Que aprendio.
- Evidencia del proceso.

Estados habituales:

- Pendiente: requiere revision docente.
- Aprobado: visible y valido para portafolio/ranking.
- Observado: necesita correccion.
- Rechazado: no cumple normas o evidencia.

## 7. Moderacion

Antes de aprobar una publicacion, verificar:

- No expone datos sensibles.
- No muestra rostros de menores sin autorizacion.
- No contiene lenguaje ofensivo.
- La evidencia corresponde al reto.
- La explicacion es educativa.

Si falta algo, marcar como observado y escribir retroalimentacion clara.

## 8. Evaluacion con rubrica

Cada publicacion puede evaluarse con criterios de 1 a 5:

- Funcionamiento.
- Creatividad.
- Explicacion.
- Materiales.
- Codigo o logica.
- Mejora.
- Trabajo en equipo.
- Presentacion.
- Seguridad.
- Impacto educativo.

Para el piloto RoboPaso, concentrarse especialmente en:

- Funcionamiento verificable.
- Explicacion.
- Mejora.
- Seguridad.
- Presentacion.

## 9. Foro tecnico

Ruta:

```text
/comunidad/foro/
```

Uso recomendado:

- Abrir una pregunta tecnica del reto.
- Responder dudas comunes.
- Marcar una respuesta como solucion cuando ayude al grupo.
- Evitar conversaciones personales o privadas.

## 10. Biblioteca

Ruta:

```text
/comunidad/biblioteca/
```

Usar para compartir:

- Guias.
- Tutoriales.
- Rubricas.
- Reglas de seguridad.
- Plantillas de bitacora.

## 11. Reportes

Rutas:

```text
/reportes/
/reportes/metricas/
/reportes/metricas/preguntas/
/reportes/metricas/alumnos/
/reportes/metricas/aulas/
/reportes/metricas/grupos/
```

Los reportes permiten:

- Ver desempeno del pretest.
- Detectar preguntas dificiles.
- Revisar avance por aula.
- Revisar avance por grupo.
- Exportar datos CSV cuando se necesite analisis externo.

## 12. Reglas de seguridad docente

- No compartir claves.
- No publicar capturas con cedulas, telefonos o datos sensibles.
- No aprobar fotos o videos de menores sin autorizacion.
- No usar el foro como chat personal.
- Hacer respaldo antes de cargas grandes o pilotos.

## 13. Checklist rapido del piloto

- Estudiantes ingresaron.
- Claves cambiadas.
- Reto RoboPaso visible.
- Recursos de biblioteca visibles.
- Foro inicial creado.
- Publicaciones pendientes revisadas.
- Evidencias aprobadas con permiso.
- Evaluaciones registradas.
- Ranking revisado.
- Portafolios revisados.
- Respaldo final ejecutado.