Guía de usuario

Documento para administradores de la institución que usan la consola web. La ayuda sobre planes y retención está en FAQ; en Configuración del dashboard hay un enlace al sitio de documentación. No existe ruta /faq dentro de la app.

1. Acceso

Google (recomendado): inicio de sesión con la cuenta autorizada; el sistema asocia un tenant (1:1 con el correo del primer acceso, salvo configuración distinta).
API Key: desde el login, “Admin / API Key” con Tenant ID y clave ssea_… (útil para cuentas de servicio o pruebas).

Si no ves datos, revisa que el plugin Moodle local_ssea esté activo, con URLs y API key correctas (véase Configuración).

2. Navegación principal

Área	Uso
Resumen	KPIs, tendencias y actividad reciente.
Cursos / Usuarios	Listados y detalle de participación.
Matrículas / Calificaciones / Completitud	Vistas académicas agregadas.
En riesgo	Apoyos basados en reglas; reconocimiento de alertas.
Alertas	Historial y acuses.
Reportes	Trabajos asíncronos e informes generados.
Documentación	Enlace externo a este sitio (planes, retención, límites); detalle en FAQ.
Configuración	Tenant ID, URLs de API e ingest, copia de credenciales para Moodle.

3. Planes, límites y retención (resumen)

Los límites diarios de eventos dependen del plan (Free, Starter, Pro, etc.).
El plan Free aplica retención rodante de 30 días (UTC) sobre telemetría y derivados; no elimina por sí solo el catálogo sincronizado de Moodle (usuarios/cursos/…).

Detalle: FAQ y, para implementación interna, DATA_RETENTION.md (repositorio).

4. Conexión con Moodle

En Configuración encontrarás:

Tenant ID (UUID)
API URL → campo api_url del plugin
Ingest URL → campo server_url / ingest en el plugin
API Key → solo si la sesión la tiene (p. ej. login por clave); con solo Google puede que debas generar una clave desde el admin de la plataforma y pegarla en Moodle.

Instalación y resolución de problemas del plugin: MOODLE_PLUGIN.md (repositorio).

5. Reportes

Los informes pesados se encolan; en la consola verás estado (en cola, en ejecución, listo, error) y la última actualización. En plan Free, los trabajos y archivos antiguos pueden eliminarse al cumplir la ventana de retención.

6. Vista en Moodle (plugin)

Según permisos en Moodle:

Estudiante: informes propios (donde el plugin lo exponga).
Profesor: salud de cursos y riesgo de estudiantes a su cargo.
Administrador (capability): vista agregada / enlaces a la consola según configuración.

7. Soporte

Incidencias técnicas del producto: canal acordado con SoftSys Solutions.
Documentación técnica del repositorio: carpeta plan/.

Versión en inglés: User guide (English).