Ir al contenido

Tipos de eventos

El plugin Moodle local_ssea observa 15 eventos estándar de Moodle y los traduce al formato de SSEA antes de enviarlos al endpoint de ingesta. Esta página lista el catálogo completo.

Catálogo de eventos

Sesión

`event_type` SSEA	Evento Moodle	Cuándo se emite
`user_login`	`\core\event\user_loggedin`	Usuario inicia sesión en Moodle.
`user_logout`	`\core\event\user_loggedout`	Usuario cierra sesión (logout explícito).

Matrícula y navegación de cursos

`event_type` SSEA	Evento Moodle	Cuándo se emite
`user_enrolled`	`\core\event\user_enrolment_created`	Usuario matriculado en un curso.
`course_viewed`	`\core\event\course_viewed`	Usuario abre la página principal de un curso.

Visualización de recursos

`event_type` SSEA	Evento Moodle	Cuándo se emite
`resource_viewed`	`\mod_resource\event\course_module_viewed`	Usuario visualiza un recurso (archivo, carpeta).
`resource_viewed`	`\mod_url\event\course_module_viewed`	Usuario visualiza un recurso de tipo URL.
`page_viewed`	`\mod_page\event\course_module_viewed`	Usuario visualiza un recurso de tipo Página.

Cuestionarios (quiz)

`event_type` SSEA	Evento Moodle	Cuándo se emite	Metadata enriquecida
`quiz_attempted`	`\mod_quiz\event\attempt_started`	Usuario inicia un intento de quiz.	`attempt_number`, `time_limit_seconds`, `quiz_name`
`quiz_submitted`	`\mod_quiz\event\attempt_submitted`	Usuario envía un intento de quiz.	`attempt_number`, `score_percent`, `raw_score`, `time_taken_seconds`, `state`

Tareas

`event_type` SSEA	Evento Moodle	Cuándo se emite	Metadata enriquecida
`assignment_submitted`	`\mod_assign\event\assessable_submitted`	Usuario entrega una tarea (submission).	`submission_status`, `is_late`, `due_date`, `submission_draft`

Foros

`event_type` SSEA	Evento Moodle	Cuándo se emite	Metadata enriquecida
`forum_post_created`	`\mod_forum\event\post_created`	Usuario crea un post (inicial o respuesta).	`is_reply`, `parent_id`, `word_count`, `subject`, `forum_type`, `discussion_id`

Calificaciones

`event_type` SSEA	Evento Moodle	Cuándo se emite	Metadata enriquecida
`grade_updated`	`\core\event\user_graded`	Profesor o sistema asigna/actualiza una calificación a un usuario.	`finalgrade`, `item_type`, `grademax`, `grademin`, `gradepass`, `percent`, `passed`
`grade_item_updated`	`\core\event\grade_item_updated`	Se modifica la definición de un item de calificación (p. ej. peso, nombre).	`item_name`, `item_type`, `item_module`, `grademax`, `gradepass`, `hidden`, `locked`

Completitud

`event_type` SSEA	Evento Moodle	Cuándo se emite	Metadata enriquecida
`module_completed`	`\core\event\course_module_completion_updated`	Se actualiza el estado de completitud de un módulo.	`completion_state`, `completion_type`, `course_module_id`
`course_completed`	`\core\event\course_completion_updated`	Se actualiza el estado de completitud del curso para un usuario.	`status`, `is_complete`, `time_completed`, `time_enrolled`

Estructura general del payload

Todos los eventos comparten un núcleo común:

{
  "event_type": "quiz_submitted",
  "user_id": "<moodle_user_id>",
  "course_id": "<moodle_course_id>",
  "module_id": "<moodle_course_module_id>",
  "timestamp": "2026-04-13T14:30:00Z",
  "context": {
    "object_id": "<event_object_id>",
    "context_level": 70
  },
  "metadata": {
    "attempt_number": 2,
    "score_percent": 84.5,
    "time_taken_seconds": 1200,
    "state": "finished"
  }
}

Campos comunes:

Campo	Tipo	Obligatorio	Descripción
`event_type`	string	Sí	Uno de los 15 tipos listados arriba.
`user_id`	string	Sí	ID del usuario Moodle.
`course_id`	string	Según evento	ID del curso Moodle (opcional para `user_login` / `user_logout`).
`module_id`	string	Según evento	ID del módulo del curso (solo eventos de actividad).
`timestamp`	string (ISO 8601 UTC)	Sí	Cuándo ocurrió el evento en el origen.
`context`	object	Opcional	Contexto de Moodle (object_id, context_level).
`metadata`	object	Opcional	Campos específicos del evento (ver columna “Metadata enriquecida” arriba).

Qué se usa cada evento en el dashboard

Evento SSEA	Usado para…
`user_login`, `user_logout`	Métrica de sesiones, detección de inactividad (factor clave de At-Risk).
`user_enrolled`	Crecimiento de matrícula por curso y por período.
`course_viewed`, `resource_viewed`, `page_viewed`	Métrica de engagement; mapa de calor de actividad; tiempo estimado en el curso.
`quiz_attempted`, `quiz_submitted`	Rendimiento académico, correlación con at-risk, scoring académico.
`assignment_submitted`	Tasa de entrega (submission rate), flag de entregas tardías.
`forum_post_created`	Profundidad de engagement (palabras por post, conversaciones activas).
`grade_updated`, `grade_item_updated`	Distribución de notas, alertas por bajas calificaciones.
`module_completed`, `course_completed`	Tasa de completitud por curso/programa, cohort analytics.

Deduplicación

Cada evento generado por el plugin incluye un ID único (event_id). El worker de procesamiento deduplica eventos repetidos basándose en el hash de los campos clave, así que si tu Moodle reintenta un envío por un timeout de red, el evento no se cuenta dos veces.

Versionado

El catálogo de eventos es estable entre versiones menores del plugin. Si en el futuro se añade un nuevo tipo, se añade sin romper los existentes. Los tenants no necesitan hacer ningún cambio cuando se añaden tipos nuevos — simplemente dejan de ser ignorados cuando actualizan el plugin.

Relacionado