====== Sesiones y actividad de los usuarios ======
Estas estadísticas te permiten dar seguimiento al uso que administradores/operadores, profesores, estudiantes y padres de familia hacen de la plataforma: cuántas sesiones han iniciado, cuántas acciones han realizado día con día y cuándo fue la última vez que entraron.

Al entrar encontrarás tres pestañas: **Sesiones**, **Acciones por día** y **Última actividad**; las dos últimas se despliegan en un menú donde eliges el tipo de usuario que quieres consultar (**Administradores / Operadores**, **Profesores**, **Estudiantes** o **Padres de familia**).

===== Consultar las sesiones de la plataforma =====
  - Ingresa al módulo **Estadísticas**; la pestaña **Sesiones** está seleccionada por defecto.
  - En el panel **Búsqueda por fecha** captura los campos **Fecha inicial** y **Fecha final** con el rango que quieres consultar y da clic en **Aceptar**.
    * Si la fecha que capturaste no es válida, la pantalla muestra el aviso "Fecha inicial inválida" o "Fecha final inválida", según el campo.
    * Si no hay sesiones registradas en el rango que buscaste, se muestra el aviso "No hay datos para este periodo de tiempo".
  - Los resultados se muestran en paneles con una gráfica cada uno:
    * **Sesiones por tipo de usuario en navegador**, **Sesiones por sistema operativo en navegador** y **Sesiones por tipo de usuario y sistema operativo en navegador:** las sesiones abiertas desde el navegador.
    * **Sesiones por tipo de usuario en app móvil**, **Sesiones por sistema operativo en app móvil** y **Sesiones por tipo de usuario y sistema operativo en app móvil:** las mismas gráficas para las sesiones abiertas desde la aplicación móvil.
    * **Sesiones por fecha:** el número de sesiones de cada día del rango que buscaste.
    * **Sesiones por hora del día y tipo de usuario** y **Sesiones por hora del día:** el número de sesiones acumulado en cada hora del día, sumando todos los días del rango.
    * **Páginas más visitadas por administradores**, **Páginas más visitadas por profesores**, el panel equivalente para estudiantes (su título en pantalla no incluye la palabra "estudiantes") y **Páginas más visitadas por padres:** las diez páginas con más usuarios distintos, para ese tipo de usuario, dentro del rango que buscaste.
    * **Sesiones por país:** da clic en una de las barras para desplegar, junto a ella, el desglose **Sesiones por estado** de ese país.
  - En las gráficas de tipo circular que combinan tipo de usuario y sistema operativo (navegador y app móvil), al pasar el puntero por el ícono {{icon>fas fa-circle-info}} con la etiqueta **Detalles** verás el desglose completo en una lista, con el color y el total de cada combinación.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Sesiones, con un rango de fechas ya buscado; mostrar: el panel de Búsqueda por fecha y, debajo, la primera fila de gráficas circulares (tipo de usuario y sistema operativo en navegador); archivo sugerido: :a:stats:users:sesiones_graficas.png</notes>

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Sesiones → gráfica "Sesiones por país", con un país ya seleccionado; mostrar: la barra del país con el desglose "Sesiones por estado" desplegado junto a ella; archivo sugerido: :a:stats:users:sesiones_por_pais.png</notes>

===== Imprimir el reporte de la pestaña Sesiones =====
Desde la pestaña **Sesiones**, después de consultar un rango de fechas, puedes generar una vista de impresión con las mismas gráficas que se muestran en pantalla.
  - Con los resultados de tu búsqueda ya en pantalla, da clic en el icono de impresora que aparece arriba de las gráficas.
  - Se abre una vista de impresión con el título **Sesiones** y, debajo, el rango de fechas de tu búsqueda.
  - La vista incluye las mismas gráficas que consultaste; las de tipo circular no se imprimen como gráfica, sino como una lista con cada elemento, su color y su total.
  - El diálogo de impresión del navegador se abre automáticamente después de unos segundos, el tiempo que tardan en dibujarse las gráficas; desde ahí puedes imprimir la vista o guardarla como PDF.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Sesiones → vista de impresión; mostrar: el encabezado con el título Sesiones, el subtítulo con el rango de fechas y las gráficas de la vista de impresión; archivo sugerido: :a:stats:users:sessions_impresion.png</notes>

===== Consultar las acciones por día de los administradores y operadores =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Acciones por día** y, en el menú que se despliega, selecciona **Administradores / Operadores**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los administradores y operadores que sí realizaron alguna acción en el rango de fechas.
    * **Usuarios sin actividad:** lista a los administradores y operadores que no realizaron ninguna acción en el rango de fechas.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún administrador u operador que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha**, **Usuario** (nombre del administrador u operador, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de la consulta por estudiantes o por padres de familia, esta pantalla no trae un panel de búsqueda por grupo: la consulta siempre considera a todos los administradores y operadores del rango de fechas.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Acciones por día → Administradores / Operadores; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:acciones_por_dia_admin_operadores.png</notes>

===== Consultar las acciones por día de los padres de familia =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Acciones por día** y, en el menú que se despliega, selecciona **Padres de familia**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los padres de familia que sí realizaron alguna acción en el rango de fechas.
    * **Usuarios sin actividad:** lista a los padres de familia que no realizaron ninguna acción en el rango de fechas.
  - En el panel **Búsqueda por grupo** puedes acotar la consulta a los grupos de tus estudiantes que te interesan; si no seleccionas ninguno, se consideran todos.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún padre de familia que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha**, **Usuario** (nombre del padre de familia, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Acciones por día → Padres de familia; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:acciones_por_dia_padres.png</notes>

===== Consultar las acciones por día de los estudiantes =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Acciones por día** y, en el menú que se despliega, selecciona **Estudiantes**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los estudiantes que sí realizaron alguna acción en el rango de fechas.
    * **Usuarios sin actividad:** lista a los estudiantes que no realizaron ninguna acción en el rango de fechas.
  - En el panel **Búsqueda por grupo** puedes acotar la consulta a los grupos que te interesan; si no seleccionas ninguno, se consideran todos.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún estudiante que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha**, **Usuario** (nombre del estudiante, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Acciones por día → Estudiantes; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:acciones_por_dia_estudiantes.png</notes>

===== Consultar las acciones por día de los profesores =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Acciones por día** y, en el menú que se despliega, selecciona **Profesores**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los profesores que sí realizaron alguna acción en el rango de fechas.
    * **Usuarios sin actividad:** lista a los profesores que no realizaron ninguna acción en el rango de fechas.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún profesor que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha**, **Usuario** (nombre del profesor, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de la consulta por estudiantes o por padres de familia, esta pantalla no trae un panel de búsqueda por grupo: la consulta siempre considera a todos los profesores del rango de fechas.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Acciones por día → Profesores; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:acciones_por_dia_profesores.png</notes>

===== Consultar la última actividad de los administradores y operadores =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Última actividad** (está seleccionada por defecto) y, en el menú que se despliega, selecciona **Administradores / Operadores**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los administradores y operadores que sí iniciaron sesión en el rango de fechas.
    * **Usuarios sin actividad:** lista a los administradores y operadores que no iniciaron sesión en el rango de fechas.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún administrador u operador que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha** (el día de su actividad más reciente dentro del rango que buscaste), **Usuario** (nombre del administrador u operador, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de la consulta por estudiantes o por padres de familia, esta pantalla no trae un panel de búsqueda por grupo: la consulta siempre considera a todos los administradores y operadores del rango de fechas. A diferencia de **Acciones por día**, donde un mismo administrador u operador puede aparecer varias veces (una fila por cada día con actividad dentro del rango), en **Última actividad** cada uno aparece una sola vez, con la fecha de su actividad más reciente dentro del rango de fechas que capturaste.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Última actividad → Administradores / Operadores; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:ultima_actividad_admin_operadores.png</notes>

===== Consultar la última actividad de los padres de familia =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Última actividad** y, en el menú que se despliega, selecciona **Padres de familia**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los padres de familia que sí iniciaron sesión en el rango de fechas.
    * **Usuarios sin actividad:** lista a los padres de familia que no iniciaron sesión en el rango de fechas.
  - En el panel **Búsqueda por grupo** puedes acotar la consulta a los grupos de tus estudiantes que te interesan; si no seleccionas ninguno, se consideran todos.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún padre de familia que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha** (el día de su actividad más reciente dentro del rango que buscaste), **Usuario** (nombre del padre de familia, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de **Acciones por día**, donde un mismo padre de familia puede aparecer varias veces (una fila por cada día con actividad dentro del rango), en **Última actividad** cada padre de familia aparece una sola vez, con la fecha de su actividad más reciente dentro del rango de fechas que capturaste.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Última actividad → Padres de familia; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:ultima_actividad_padres.png</notes>

===== Consultar la última actividad de los estudiantes =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Última actividad** y, en el menú que se despliega, selecciona **Estudiantes**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los estudiantes que sí iniciaron sesión en el rango de fechas.
    * **Usuarios sin actividad:** lista a los estudiantes que no iniciaron sesión en el rango de fechas.
  - En el panel **Búsqueda por grupo** puedes acotar la consulta a los grupos que te interesan; si no seleccionas ninguno, se consideran todos.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún estudiante que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha** (el día de su actividad más reciente dentro del rango que buscaste), **Usuario** (nombre del estudiante, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de **Acciones por día**, donde un mismo estudiante puede aparecer varias veces (una fila por cada día con actividad dentro del rango), en **Última actividad** cada estudiante aparece una sola vez, con la fecha de su actividad más reciente dentro del rango de fechas que capturaste.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Última actividad → Estudiantes; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:ultima_actividad_estudiantes.png</notes>

===== Consultar la última actividad de los profesores =====
  - Ingresa al módulo **Estadísticas**.
  - Da clic en la pestaña **Última actividad** y, en el menú que se despliega, selecciona **Profesores**.
  - En el panel **Búsqueda por fecha** captura los campos **Inicio** y **Final** con el rango de fechas que quieres consultar.
    * Si das clic en **Aceptar** sin capturar ambas fechas, la pantalla muestra el aviso "Rango de fechas requerido".
  - Elige una de las dos opciones:
    * **Usuarios con actividad:** lista a los profesores que sí iniciaron sesión en el rango de fechas.
    * **Usuarios sin actividad:** lista a los profesores que no iniciaron sesión en el rango de fechas.
  - Da clic en **Aceptar** para generar la tabla.
    * Si no se encuentra ningún profesor que cumpla la búsqueda, se muestra el aviso "No hay resultados".
  - El resultado se muestra en un panel titulado **Usuarios con actividad** o **Usuarios sin actividad**, según la opción que elegiste:
    * Si elegiste **Usuarios con actividad**, la tabla trae **Fecha** (el día de su actividad más reciente dentro del rango que buscaste), **Usuario** (nombre del profesor, con enlace a su perfil) y **Acciones** (el total de acciones que realizó ese día).
    * Si elegiste **Usuarios sin actividad**, la tabla solo trae **Usuario**, con enlace a su perfil.
  - **IMPORTANTE:** la tabla muestra hasta 200 registros a la vez; si hay más, aparecen las flechas **Siguiente** y **Anterior** arriba del panel para moverte entre páginas.
  - Para obtener el mismo listado en un archivo, da clic en el icono **Descargar Excel** {{icon>far fa-file-excel text-green}}, en la esquina superior derecha del panel de resultados.

A diferencia de la consulta por estudiantes o por padres de familia, esta pantalla no trae un panel de búsqueda por grupo: la consulta siempre considera a todos los profesores del rango de fechas. A diferencia de **Acciones por día**, donde un mismo profesor puede aparecer varias veces (una fila por cada día con actividad dentro del rango), en **Última actividad** cada profesor aparece una sola vez, con la fecha de su actividad más reciente dentro del rango de fechas que capturaste.

<notes>FALTA_CAPTURA — pantalla: Estadísticas → Última actividad → Profesores; mostrar: el panel de resultados "Usuarios con actividad" con la tabla de Fecha, Usuario y Acciones ya generada; archivo sugerido: :a:stats:users:ultima_actividad_profesores.png</notes>

===== Permisos para el operador =====
Para que el operador pueda consultar esta pantalla, es necesario asignarle el siguiente permiso al momento de agregarlo o modificar su perfil:
    * Desde "Permisos globales" > **Estadísticas.**
      * **Sesiones:** Permite consultar las sesiones, las acciones por día y la última actividad de administradores/operadores, profesores, estudiantes y padres de familia.
El administrador de la escuela consulta esta pantalla sin necesidad de asignarle ningún permiso.

<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:stats:users:activity_log" make -C pipeline revisar</notes>