Tour del dashboard

El dashboard web de SoftSys Edu Analytics (app.softsysanalytics.com) presenta los datos procesados del tenant en una serie de páginas organizadas por temática. Esta página recorre cada sección para que sepas dónde encontrar cada métrica.

Autenticación y acceso

Para entrar al dashboard puedes usar:

SSO desde Moodle: si tienes el plugin Moodle instalado y el viewer shared secret configurado, tus usuarios con las capabilities adecuadas (local/ssea:viewlearnerreport, local/ssea:viewinstructorreport) acceden desde sus perfiles Moodle sin introducir credenciales.
Login directo: flujo estándar con email y clave para administradores del tenant.

Una vez dentro, la navegación principal vive en el sidebar de la izquierda.

Overview — Página principal

La página / del dashboard es el punto de entrada y muestra los KPIs más relevantes del tenant.

KPIs destacados:

Total de eventos en el período seleccionado.
Usuarios activos (usuarios únicos que generaron al menos un evento).
Sesiones totales (número de sesiones detectadas).
Tiempo promedio por usuario (minutos).
Estudiantes en riesgo (conteo de usuarios por encima del umbral).

Controles:

Selector de período (7, 30, 90 días, o personalizado).
Gráfico de tendencia (eventos por día/hora).

Cuándo usarla: revisión rápida del estado general del tenant. Ideal para el primer vistazo de la mañana.

Users — Lista de usuarios

/users muestra una tabla paginada con todos los usuarios activos del tenant y su resumen de actividad.

Columnas principales:

Nombre completo y username.
Última actividad (last_seen_at).
Total de eventos.
Tiempo total (minutos).
Nivel de riesgo (low / medium / high / critical).
Score de riesgo (0–100).

Filtros disponibles:

Búsqueda por nombre o username.
Filtro por nivel de riesgo.
Filtro por rol (student, teacher, manager).
Ordenamiento por cualquier columna.

Click en una fila lleva al perfil del usuario (/users/:userId) con una timeline diaria de su actividad, histórico de intentos de quiz, tareas entregadas, cursos en los que está matriculado, y factores que contribuyen a su score de riesgo.

Courses — Cursos

/courses muestra la lista de cursos sincronizados desde Moodle con métricas de engagement.

Columnas principales:

Nombre completo y shortname del curso.
Usuarios activos en el período.
Total de eventos.
Tiempo promedio por usuario (minutos).
Tasa de completitud (%).

Drill-down: click en un curso lleva a su vista detallada con desglose por actividad, gráfico de submissions, y lista de estudiantes en riesgo específicos de ese curso.

Enrollment — Matrículas

/enrollment presenta análisis de matrícula:

Distribución por curso.
Tendencia de nuevas matrículas en el tiempo.
Distribución por rol.
Cohortes de matrícula (útil para retención).

Grades — Calificaciones

/grades muestra la distribución de calificaciones a nivel de tenant y de curso.

KPIs:

Promedio, mínimo y máximo por curso.
Top performers (Top-10 usuarios).
Low performers (para seguimiento proactivo).
Distribución histórica por rango de notas.

Completion — Completitud

/completion muestra tasas de completitud de actividades y cursos.

Vistas:

Barra por curso con % de usuarios que completaron.
Detalle por actividad dentro de un curso específico.
Funnel de completitud (útil para identificar actividades donde los usuarios abandonan).

At-Risk — Estudiantes en riesgo

/at-risk es una de las páginas más usadas por docentes y managers. Presenta los estudiantes que el worker de detección marcó como en riesgo.

Columnas:

Nombre, curso, nivel de riesgo.
Score de riesgo (0–100).
Factores de riesgo (inactividad, tasa de entrega baja, calificaciones bajas).
Días desde la última actividad.
Estado de acknowledgment (si un docente ya tomó acción).

Filtros:

Por umbral de score (slider 0.0–1.0).
Por curso.
Por acknowledged / pending.
Ordenamiento (score_desc es el más usado).

Acciones:

Click en un estudiante → su perfil detallado.
Botón “Acknowledge” → marcar la alerta como gestionada (queda registrada para auditoría).

Ver API — Dashboard REST para el endpoint equivalente.

Alerts — Alertas

/alerts centraliza las notificaciones activas: inactividad, caídas de rendimiento, hitos de completitud, baja de notas, etc.

Columnas:

Tipo de alerta (alert_type).
Severidad (low, medium, high, critical).
Usuario afectado.
Timestamp.
Mensaje descriptivo.
Estado (pending / acknowledged).

Acciones:

Acknowledge individual.
Acknowledge all (útil al revisar alertas del día).

Las alertas las genera el worker de alertas en segundo plano cada hora, basándose en reglas configurables por el tenant.

Reports — Reportes asíncronos

/reports muestra el histórico de jobs de exportación y permite crear nuevos.

Vista:

Tabla de jobs con report_type, formato (CSV/JSON), estado, fecha de solicitud y fecha de completitud.
Botón de descarga para jobs completados (los artefactos se mantienen 7 días en R2).

Tipos de reporte disponibles:

retention_cohort — retención por cohorte de matrícula.
activity_funnel — embudo de completitud por actividad.
teacher_course_health — salud del curso desde la óptica del profesor.
student_learning_profile — perfil agregado del estudiante.
assessment_performance — rendimiento en evaluaciones.
early_warning_summary — resumen de alertas tempranas.

Ver API — Dashboard REST para el flujo equivalente via API.

Settings — Configuración

/settings incluye las opciones del tenant:

Branding (solo Enterprise): logo, color primario, nombre de producto.
Dominios personalizados (Enterprise): configuración del white-label.
Opciones de privacidad: toggle para ocultar datos sensibles, GDPR prefs.
Umbrales de At-Risk: configurar el score crítico por defecto.
Zona horaria: afecta cómo se muestran los timestamps en las vistas.

Monitors — Watchlists guardadas

En varias páginas (Users, Courses, At-Risk) puedes guardar un conjunto de filtros como monitor. Un monitor es una watchlist nombrada que puedes volver a abrir con un click en el sidebar.

Casos de uso típicos:

“Estudiantes de CS101 con score > 0.7”
“Cursos con completitud < 30%”
“Alertas de la semana acknowledgeadas por Juan”

Los monitores se gestionan via /v1/tenants/:id/monitors en la API (ver API — Dashboard REST).

Admin (solo super-admin)

Si tu cuenta tiene rol de super-admin en SoftSys Solutions (normalmente solo el equipo interno de soporte y managers Enterprise), verás una sección /admin/tenants adicional:

Listar tenants.
Crear sub-tenants (en planes reseller).
Gestionar API keys.

Estos endpoints no se documentan en la API pública — son para gestión interna.

Vista embebida desde Moodle

Los estudiantes y profesores con las capabilities local/ssea:viewlearnerreport o local/ssea:viewinstructorreport acceden a una vista reducida del dashboard embebida dentro de Moodle (en una iframe). Esta vista:

Solo muestra los datos del propio usuario (estudiante) o sus cursos asignados (profesor).
Usa los endpoints /v1/tenants/:id/viewer/** firmados con los viewer shared secret.
No requiere que el usuario tenga cuenta en el dashboard — la autenticación viene del plugin Moodle.

Ver API — Dashboard REST para los endpoints disponibles.

Resumen — dónde encontrar cada cosa

Vista rápida

Overview (/) — KPIs globales + gráfico de tendencia. Punto de entrada diario.

Buscar un usuario

Users (/users) — tabla paginada con búsqueda y filtros. Click para ver perfil detallado.

Detectar problemas

At-Risk (/at-risk) + Alerts (/alerts) — lista priorizada de estudiantes y notificaciones accionables.

Exportar datos

Reports (/reports) — jobs asíncronos con descarga de CSV/JSON (persistencia 7 días).