Preguntas Frecuentes

Guía de uso del Sistema de Seguimiento de Entregas

📊 Dashboard 📈 Resumen ❓ FAQ

📌 General

❓ ¿Qué es este sistema?
Es una plataforma self-hosted para el seguimiento de entregas de estudiantes en cursos de tecnicatura superior. Permite a los docentes y ayudantes visualizar el estado de las entregas semanales y trabajos prácticos integradores.
❓ ¿Quién puede acceder al sistema?
Estudiantes: Acceden únicamente al formulario de entregas (público).
Docentes/Ayudantes: Acceden al panel de administración de NocoDB y al Dashboard de seguimiento.

👥 Gestión de Cohortes

❓ ¿Cómo inicializo las tablas de la base de datos?
La forma más rápida es usar el script python create_noco_tables.py incluido en el repositorio. Solicitará tu credencial de NocoDB y construirá todas las tablas, columnas y relaciones automáticamente por la API.
❓ ¿Cómo creo una nueva cohorte?
1. Accede a tu panel administrativo de NocoDB
2. Ve a la tabla Cohortes
3. Haz clic en + Nuevo
4. Completa el Nombre de la cohorte
5. Marca la casilla Activa para que aparezca en el dashboard
Usa nombres descriptivos como "pln-1c-2026" para identificar fácilmente cada cohorte.
❓ ¿Cómo desactivo una cohorte que ya terminó?
Edita la cohorte en NocoDB y desmarca el checkbox Activa. Esto la ocultará del dashboard pero conservará todos los datos para consultas futuras.

🎓 Gestión de Estudiantes

❓ ¿Cómo cargo estudiantes desde CSV?
1. Prepara un archivo CSV con columnas: Nombre,Apellido,Email,GitHub
2. En NocoDB, tabla Estudiantes, haz clic en los tres puntos (⋯)
3. Selecciona Importar CSV
4. Selecciona el archivo y mapea las columnas
5. Asigna la cohorte correspondiente a todos los importados
Asegúrate de que el campo GitHub incluya la URL completa (https://github.com/usuario)
❓ ¿Puedo agregar estudiantes individualmente?
Sí. En la tabla Estudiantes de NocoDB, haz clic en + Nuevo y completa los campos manualmente.

📚 Gestión de Actividades

❓ ¿Cómo creo una nueva semana/actividad?
1. En NocoDB, ve a la tabla Actividades
2. Haz clic en + Nuevo
3. Completa:
  • Nombre: "Semana 6", "TP Integrador 1", etc.
  • Orden: número secuencial (1, 2, 3...)
  • Tipo: "Semanal" o "Integrador"
  • Peso: 1 para semanales, 10 para integradores
  • Fecha Límite: deadline de la entrega
  • URL Guía: link al Colab o documento
4. Asigna a la cohorte correspondiente
❓ ¿Qué diferencia hay entre "Semanal" e "Integrador"?
Semanal: Actividades de práctica que miden participación activa. Pesan 20% en la calificación final.
Integrador: Trabajos prácticos evaluativos. Cada uno pesa 40% en la calificación final.

El sistema calcula automáticamente el índice final ponderado.

✅ Corrección de Entregas

❓ ¿Cómo corrijo una entrega?
1. Accede a la tabla Entregas en NocoDB
2. Busca la entrega por estudiante o actividad
3. Cambia el campo Estado:
  • Entregado → Recibido, pendiente de corrección
  • Corregido → Revisado y aprobado
  • Rehacer → Debe corregir y reenviar
  • No entregado → No se recibió
4. Agrega Observaciones si es necesario
❓ ¿Cómo sé si una entrega fue tarde?
El sistema compara automáticamente la Fecha Entrega (cuando el estudiante envió) con la Fecha Límite de la actividad. En el dashboard se muestran:
  • 🟢 Verde: Entregado a tiempo
  • 🟡 Amarillo: Entregado tarde
  • 🔴 Rojo: No entregado (vencido)

📊 Uso del Dashboard

❓ ¿Cómo veo el detalle de un estudiante?
Haz clic en el nombre del estudiante en la primera columna del dashboard. Se abrirá un panel lateral con:
  • Email y GitHub
  • Listado completo de entregas
  • Estado de cada entrega
❓ ¿Qué muestra la vista de Resumen?
La vista /resumen es exclusiva para docentes y muestra:
  • Ranking de estudiantes por índice de cumplimiento
  • Porcentaje de entregas semanales e integradores
  • Índice final ponderado (40% TP1 + 40% TP2 + 20% participación)
  • Clasificación: Excelente, Bueno, Regular, Deficiente
  • Exportación a Excel
❓ ¿Cómo exporto a Excel?
En la vista Resumen, haz clic en el botón 📊 Exportar Excel. Se descargará un archivo .xlsx con una hoja de resumen por cohorte, incluyendo métricas de cada estudiante (índice final, clasificación, porcentajes).

🔧 Troubleshooting

❓ El dashboard muestra "No hay datos para mostrar"
Verifica que:
1. Exista al menos una cohorte activa
2. La cohorte tenga alumnos y actividades cargadas
3. La variable de entorno NOCODB_DB_PATH apunte a la base correcta en el volumen Docker (/data/noco.db)
❓ Error "database is locked" (SQLite)
Esto ocurría en despliegues antiguos. El sistema actual accede a NocoDB en modo estricto de Solo Lectura (Read-Only) con un timeout de 20s, por ende ya no deberían ocurrir bloqueos de concurrencia en producción. Si persisten problemas, revisa que el contenedor Docker no esté saturando el disco.
❓ El Dashboard no computa los datos (Relaciones M2M corruptas)
Si al configurar NocoDB marcaste accidentalmente "Permitir enlazar múltiples registros" en las claves foráneas (ej: de Estudiante a Cohorte), NocoDB genera tablas intermedias "Many-to-Many". El Dashboard trae incorporada una función de Auto-Fix que intentará detectar y reparar el esquema SQLite en vivo cuando inicia. Si el error persiste, asegúrate de desmarcar manualmente el checkbox en la vista web de NocoDB.
❓ Las nuevas columnas no aparecen en el dashboard
El dashboard usa un descubrimiento dinámico de esquema (leyendo los metadatos internos nc_models_v2 y nc_columns_v2). Si cambias los nombres de tus columnas o tablas en producción:
1. Reinicia el contenedor del dashboard: docker compose restart dashboard
2. El sistema mapeará el nuevo SQL al iniciar.

📧 ¿Necesitas más ayuda?

Contacta a Matías Barreto
www.matiasbarreto.com