Diferencias

Muestra las diferencias entre dos versiones de la página.

--- a:stats:users:students [2025/10/06 13:05]
[Distribución de secciones] , iavechuco
+++ a:stats:users:students [2026/09/14 08:00] (actual)
wiki: a:stats:users:students profundiza "Sesiones por estudiante" con los campos Inicio/Final y sus dos avisos de validación (fecha de inicio y final obligatorias; sin resultados en el rango) (+2 mejoras más de la corrida), algebraix
@@ Línea 1: / Línea 1: @@
-====== Estadísticas Estudiantes ======
+====== Estadísticas de estudiantes ======
-En esta opción podrás consultar el total de estudiantes registrados, así como su distribución por sección, grupo o grado. También podrás conocer el estatus de los estudiantes que han confirmado sus datos, identificar aquellos dados de baja y realizar consultas masivas sobre estudiantes con anotaciones.
+En esta opción podrás consultar el total de estudiantes activos registrados, así como su distribución por sección, grupo o grado. También podrás conocer el estatus de los estudiantes que han confirmado sus datos, identificar aquellos dados de baja y realizar consultas masivas sobre estudiantes con anotaciones.
+<notes>También se conoce como conocer cuantos alumnos/estudiantes existen en mi base de datos.</notes>
 ===== Sesiones por estudiante =====
 Esta sección muestra a los estudiantes que han registrado más sesiones dentro de la plataforma.
-  -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
+  -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios; esta es la estadística que se muestra al entrar.
-  -Se mostrará un formulario donde deberás ingresar el rango de fechas que deseas consultar.
+  -Si estás consultando otra, selecciona la opción Estudiantes y haz clic en **Sesiones por estudiante**.
+  -Se mostrará un formulario de **Búsqueda por fecha** donde deberás ingresar el rango: los campos **Inicio** y **Final**.
   -Haz clic en **Aceptar** para generar la estadística.
-  -Mostrará una tabla con:
+    * Si no capturaste ambas fechas, se muestra el aviso "Es necesario especificar una fecha de inicio y una fecha final".
-     *Los 100 estudiantes con más sesiones.
+    * Si no hay mensajes ni sesiones registradas en el rango consultado, se muestra el aviso "No se encontraron resultados".
-     *Total de sesiones de los 100 estudiantes con más sesiones
+  -Si hubo resultados, se muestran una o ambas tablas:
-     *Sesiones promedio e 100 estudiantes con más sesiones.
+     *Mostrando 100 estudiantes con más mensajes enviados: el **Estudiante** y sus **Mensajes**, seguida del **Total de mensajes de los 100 estudiantes con más mensajes enviados** y el **Promedio de mensajes de los 100 estudiantes con más mensajes enviados**.
-Para imprimir la estadística, haz clic en el botón **Imprimir** {{icon>fas fa-print text-dark}}, situado en la esquina superior derecha de la tabla.
+     *Mostrando 100 estudiantes con más sesiones: el **Estudiante** y sus **Sesiones**, seguida del **Total de sesiones de los 100 estudiantes con mas sesiones** y las **Sesiones promedio de 100 estudiantes con más sesiones**.
+Para imprimir la estadística, haz clic en el botón **Imprimir** {{icon>fas fa-print text-dark}}, situado en la esquina superior derecha de la tabla.\\
+La vista de impresión muestra, para el mismo rango de fechas consultado, una tabla de **Mensajes** (si hubo estudiantes con mensajes enviados) con el **Estudiante** y sus **Mensajes**, seguida del **Total de mensajes** y el **Promedio de mensajes** de los 100 estudiantes con más mensajes enviados; y una tabla de **Sesiones** (si hubo estudiantes con sesiones registradas) con el **Estudiante** y sus **Sesiones**, seguida del **Total de sesiones** y las **Sesiones promedio** de los 100 estudiantes con más sesiones.
 ===== Distribución de secciones =====
@@ Línea 18: / Línea 21: @@
   -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
-  -Selecciona la opción Estudiantes y haz clic en **Distribución de secciones**.
+  -Esta es la estadística que se muestra al entrar. Si estás consultando otra, selecciona la opción Estudiantes y haz clic en **Distribución de secciones**.
   -Se mostrará una tabla con los estudiantes registrados, agrupados por sección, indicando el total de estudiantes en cada una. A la derecha, podrás visualizar una gráfica de barras que representa visualmente la información de la tabla.
   -En la parte superior izquierda, encontrarás un filtro de búsqueda. Al hacer clic en la **Flecha desplegable** {{icon>fas fa-chevron-down text-black}}, verás que por defecto se muestra la información correspondiente a la fecha actual.
@@ Línea 25: / Línea 28: @@
      *En el campo que aparecerá en la parte inferior, haz clic y elige la fecha deseada en el calendario.
   -Haz clic en **Aceptar** para generar la estadística.
+    * Si elegiste **Fecha específica** sin capturar una fecha, se muestra el aviso "Es necesario especificar una fecha".
+  -Si la consulta incluye más de un campus, a la derecha de la tabla se muestra además una gráfica de barras con la misma información.\\ {{:a:stats:users:distribucion_de_secciones.png?direct&600|}}
-La estadística de distribución de estudiantes por sección puede **Descargarse en formato Excel** {{icon>far fa-file-excel text-grren}}  o **Imprimirse** {{icon>fas fa-print text-dark}} haciendo clic en los botones correspondientes ubicados en la esquina superior derecha de la tabla.
+Si no hay estudiantes registrados para la fecha consultada, se muestra el aviso "No se han agregado estudiantes" en lugar de la tabla.
+La estadística de distribución de estudiantes por sección puede **Descargarse en formato Excel** {{icon>far fa-file-excel text-grren}}  o **Imprimirse** {{icon>fas fa-print text-dark}} haciendo clic en los botones correspondientes ubicados en la esquina superior derecha de la tabla.\\
+La vista de impresión muestra la tabla de secciones agrupadas por campus, con el **Total** de cada sección y el **Total** general al final, seguida de la gráfica de barras si la consulta incluye más de un campus.
 ===== Distribución de grupos =====
-Permite conocer el total de estudiantes por cada uno de los grupos.
+Permite conocer el total de estudiantes de cada uno de los grupos de una sección, desglosado por género y por edad. No incluye a los estudiantes solicitantes.
   -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
   -Selecciona la opción Estudiantes y haz clic en **Distribución de grupos**.
-  -Se mostrará un formulario para especificar:
+  -En el formulario, selecciona la **Sección** que deseas consultar; las secciones inactivas se listan con la leyenda "(Inactivo)".
-      ***Sección**: Sección que deseas consultar la distribución de estudiantes por grupo.
+  -Debajo, en **Búsqueda por**, elige si quieres la distribución de la **Fecha actual** o de una **Fecha específica**; si eliges esta última, captura la fecha en el campo que aparece a continuación.
-      ***Fecha actual**: La distribución actual de estudiantes por grupo.
-      ***Fecha especifica**: La distribución de una fecha deseada de estudiantes por grupo.
   -Haz clic en **Aceptar** para generar la estadística.
-  -Se presentará una tabla acompañada de gráficas que muestran a los estudiantes registrados, agrupados por grupo. En cada grupo se indicará el total de estudiantes, así como la distribución por género y rangos de edad
+    * Si no seleccionaste una sección, se muestra el aviso "Debe seleccionar una sección".
+    * Si elegiste **Fecha específica** sin capturar una fecha, se muestra el aviso "Es necesario especificar una fecha".
+  -Se mostrará un panel por cada grupo activo de la sección, titulado con el grado y el nombre del grupo. Cada panel trae dos tablas con su gráfica debajo:
+    * **Distribución de género**: el total de estudiantes del grupo y su desglose en **Masculino**, **Femenino** y **Sin asignar**, cada uno con su **Total**, acompañado de una gráfica de pastel.
+    * **Distribución de edad**: una fila por cada edad registrada (o "Edad desconocida" si no se tiene el dato), con el total de **Femenino**, **Masculino** y el **Total** de esa edad, acompañada de una gráfica de barras.
-La estadística de distribución de estudiantes por grupo se pueden obtener en formato Excel haciendo clic en el botón **Descargar Excel**{{icon>far fa-file-excel text-grren}}  ubicados en la esquina superior derecha de la tabla.
+La estadística de distribución de estudiantes por grupo se puede obtener en formato Excel haciendo clic en el botón **Descargar Excel** {{icon>far fa-file-excel text-grren}} ubicado en la parte superior derecha, arriba de los paneles de grupo. Esta pantalla no tiene opción de impresión.
 ===== Distribución de grados =====
-Permite conocer el total de estudiantes por cada uno de los grados.
+Permite conocer el total de estudiantes de cada uno de los grados de una sección, desglosado por género y por edad.
   -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
   -Selecciona la opción Estudiantes y haz clic en **Distribución de grados**.
-  -Se mostrará un formulario para especificar:
+  -En el formulario, selecciona la **Sección** que deseas consultar; las secciones inactivas se listan con la leyenda "(Inactivo)".
-      ***Sección**: Sección que deseas consultar la distribución de estudiantes por grupo.
+  -Debajo, en **Búsqueda por**, elige si quieres la distribución de la **Fecha actual** o de una **Fecha específica**; si eliges esta última, captura la fecha en el campo que aparece a continuación.
-      ***Fecha actual**: La distribución actual de estudiantes por grupo.
-      ***Fecha especifica**: La distribución de una fecha deseada de estudiantes por grupo.
   -Haz clic en **Aceptar** para generar la estadística.
-  -Se presentará una tabla acompañada de gráficas que muestran a los estudiantes registrados, agrupados por grados. En cada grado se indicará el total de estudiantes, así como la distribución por género y rangos de edad
+    * Si elegiste **Fecha específica** sin capturar una fecha, se muestra el aviso "Es necesario especificar una fecha".
+    * Si la sección no tiene estudiantes registrados en esa fecha, se muestra el aviso "No se han encontrado estudiantes en la sección especificada".
+  -Se mostrará un panel por cada grado de la sección, titulado con el nombre del grado. Cada panel trae dos tablas con su gráfica debajo:
+    * **Distribución de género**: el total de estudiantes del grado y su desglose en **Masculino**, **Femenino** y **Sin asignar**, cada uno con su **Total**, acompañado de una gráfica de pastel.
+    * **Distribución de edad**: una fila por cada edad registrada (o "Edad desconocida" si no se tiene el dato), con el total de **Femenino**, **Masculino** y el **Total** de esa edad, acompañada de una gráfica de barras.
+  -Si la sección tiene solicitantes en proceso de admisión para un ciclo y grado determinado, se agrega un panel adicional por cada combinación de ciclo y grado, titulado con el nombre del ciclo seguido del nombre del grado, con las mismas dos tablas y gráficas que los paneles de grado.
-La estadística de distribución de estudiantes por grados se pueden obtener en formato Excel haciendo clic en el botón **Descargar Excel**{{icon>far fa-file-excel text-grren}}  ubicados en la esquina superior derecha de la tabla.
+<notes>FALTA_CAPTURA — pantalla: Estadísticas → Estudiantes → Distribución de grados; mostrar: el listado de paneles de grado con sus dos tablas (distribución de género y de edad) y sus gráficas; archivo sugerido: :a:stats:users:distribucion_de_grados.png</notes>
+La estadística de distribución de estudiantes por grado se puede obtener en formato Excel haciendo clic en el botón **Descargar Excel** {{icon>far fa-file-excel text-grren}} ubicado en la parte superior derecha, arriba de los paneles de grado. Esta pantalla no tiene opción de impresión.
 ===== Confirmación de datos =====
@@ Línea 63: / Línea 78: @@
   -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
   -Selecciona la opción Estudiantes y haz clic en **Confirmación de datos**.
-  -Selecciona las secciones, grados o grupos que deseas consultar.
+  -Selecciona las secciones, grados o grupos que deseas consultar; el árbol solo lista los grupos activos.
   -Haz clic en **Aceptar**.
-  -Se mostrarán 2 tablas, indicando grupo y nombre de:
+  -Se mostrará una tabla por cada caso que tenga al menos un estudiante:
       *Estudiantes con los datos confirmados.
       *Estudiantes sin confirmar datos.
+     En cada fila se indica el **Grupo** (con la ruta Campus » Sección » Grado » Grupo del estudiante) y el **Estudiante**, cuyo nombre es un enlace a su perfil. Ambas tablas se pueden filtrar y ordenar desde el buscador de la parte superior, y traen paginador si hay más de 10 resultados.
-La estadística de que estudiantes han confirmado sus datos se pueden obtener en formato Excel haciendo clic en el botón **Descargar Excel**{{icon>far fa-file-excel text-grren}}  ubicados en la esquina superior derecha de la tabla.
+La estadística de que estudiantes han confirmado sus datos se puede **Descargar en formato Excel** {{icon>far fa-file-excel text-grren}}  o **Imprimirse** {{icon>fas fa-print text-dark}} haciendo clic en los botones correspondientes ubicados en la esquina superior derecha de la tabla.\\
+La vista de impresión muestra el listado de grupos consultados y, debajo, las mismas dos tablas de **Estudiantes con los datos confirmados** y **Estudiantes sin confirmar datos**, con grupo y nombre de cada estudiante.
 ===== Bajas =====
-Permite conocer el listado de estudiantes que se han dado de baja en un rango de fechas.
+Permite conocer el listado/reporte de estudiantes que se han dado de baja en un rango de fechas.
   -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
@@ Línea 82: / Línea 99: @@
       ***Razones de baja**: Se especifica el motivo por el cual el estudiante causó baja, así como el número total de estudiantes asociados a cada razón.
       ***Gráfica por bajas**: Representación gráfica en formato de pastel que muestra la proporción de estudiantes dados de baja según cada razón, indicando tanto el número como el porcentaje correspondiente
-      ***Listado de estudiantes dados de baja**: Relación detallada de los estudiantes que causaron baja, incluyendo matrícula, nombre completo, fecha de baja, motivo de baja, última sección cursada y grupo al que pertenecían.
+      ***Listado de estudiantes dados de baja**: Relación detallada de los estudiantes que causaron baja, incluyendo matrícula, nombre completo, fecha de baja, motivo de baja, última sección cursada y grupo al que pertenecían.\\ {{:a:stats:users:bajas.png?direct&600|}}
+La estadística de bajas se puede **Descargar en formato Excel** {{icon>far fa-file-excel text-grren}}  o **Imprimirse** {{icon>fas fa-print text-dark}} haciendo clic en los botones correspondientes ubicados en la esquina superior derecha de la tabla.\\
+La vista de impresión encabeza con **Razones de baja** y el rango de fechas consultado, y muestra una tabla con cada **Razón de baja** y su **Total** de estudiantes, seguida del **Total** general y de la gráfica de pastel por razón; debajo se lista cada estudiante dado de baja con su **Matrícula**, **Estudiante**, **Fecha**, **Razón de baja**, **Última sección** y **Último grupo**.
 ===== Anotaciones =====
+Permite conocer el listado de estudiantes que se les ha generado por lo menos una anotación en un rango de fechas.
+  -Ingresa al módulo **Estadísticas** y selecciona la opción **Estudiantes** en la sección de Usuarios.
+  -Selecciona la opción Estudiantes y haz clic en **Anotaciones**.
+  -Captura el rango de fechas de la consulta en los campos **Inicio** y **Final**.
+  -De manera opcional, en **Búsqueda por anotación**, elige una razón de anotación específica; si no seleccionas ninguna se muestra "Todas las razones de anotaciones" y se consultan todas.
+  -Selecciona el árbol de grupos que deseas consultar: en **Búsqueda por grupo** puedes escribir parte del nombre de un grupo y dar clic en el icono **Filtrar** para acotar el árbol, o en **Limpiar** para quitar el filtro; el menú **Perfiles** marca de una vez los grupos de un perfil de grupos, y la casilla **Seleccionar todo** marca o limpia el árbol completo.
+  -Haz clic en **Aceptar**.
+    * Si no capturaste ambas fechas, se muestra el aviso "Es necesario especificar una fecha de inicio y una fecha final".
+    * Si no seleccionaste ningún grupo, se muestra el aviso "Es necesario seleccionar al menos un grupo".
+    * Si no hay anotaciones registradas para los estudiantes de los grupos seleccionados en el rango consultado, se muestra el aviso "No se han encontrado anotaciones en los estudiantes seleccionados".
+  -Si hubo resultados, se muestra un panel colapsable por cada razón de anotación encontrada entre los estudiantes consultados —titulado con el nombre de la razón, o "SIN RAZÓN DE ANOTACIÓN" si la anotación no tiene una asignada—; al dar clic en el panel para expandirlo, se detalla una tabla con las columnas **Fecha**, **Título**, **Elaboró**, **Estudiante** y **Nota** de cada anotación.
+La estadística de anotaciones se puede **Descargarse en formato Excel** {{icon>far fa-file-excel text-grren}}  o **Imprimirse** {{icon>fas fa-print text-dark}} haciendo clic en los botones correspondientes ubicados en la esquina superior derecha de la tabla.\\
+La vista de impresión permite elegir, con una casilla por columna (**Todos**, **Fecha**, **Título**, **Elaboró** y **Nota**), cuáles se incluyen en la hoja impresa; encabeza con el rango consultado (**Fecha inicio** y **Fecha final**), la **Razón** si se filtró por una en particular, y el listado de **Grupos** consultados (Campus » Sección » Grado » Grupo). Debajo, muestra una tabla por cada razón de anotación encontrada —titulada con el nombre de la razón, o "SIN RAZÓN DE ANOTACIÓN" si la anotación no tiene una asignada— con las columnas **Fecha**, **Título**, **Elaboró**, **Estudiante** y **Nota** de cada anotación.
+===== Permisos para el operador =====
+Para que el operador pueda realizar estas consultas, es necesario asignarle los siguientes permisos al momento de agregarlo o modificar su perfil:
+    * Desde "Permisos por grupo" > **Estadísticas**
+      * **Estudiantes:** Permite consultar las estadísticas referentes al estudiante como su distribución, confirmación de datos, bajas y anotaciones.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:stats:users:students" make -C pipeline revisar</notes>