Diferencias

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

--- a:users:users:student_profile_grades [2026/09/11 12:36]
wiki: a:users:users:student_profile_grades gana la Revalidación de calificaciones completa (sub-ciclo por grado, mínimo aprobatorio, avisos de validación y el aviso de guardado), algebraix
+++ a:users:users:student_profile_grades [2026/09/14 10:30] (actual)
editor externo, 127.0.0.1
@@ Línea 13: / Línea 13: @@
      *Al final de la fila encontrarás un botón que te permitirá acceder directamente a la configuración de la boleta {{icon>fas fa-external-link-alt}} , en caso de que necesites realizar cambios, así como la opción para imprimir {{icon>fas fa-print text-dark}} la boleta. <notes>También se conoce como imprimir la boleta digital.</notes>
     *Categorías y las clases que las integran
+     *Si la categoría no es promediable, un ícono junto a su nombre lo indica.
+     *Si la categoría tiene configurada una tabla de conversión de valores, un ícono {{icon>fas fa-right-left text-green}} junto a su nombre muestra, al pasar el cursor, la **Tabla de conversiones de la categoría** con las columnas **Valor**, **Rango** (si la categoría muestra rangos) y **Comentario**.
     *Nombre del sub-ciclo
     *Periodos publicados y sus respectivas calificaciones
@@ Línea 20: / Línea 22: @@
     *Retardos
     *Promedio general
+  -Si la boleta tiene configurada una tabla general de conversión de valores, al final se agrega el panel **Tabla de conversiones de la boleta** con las columnas **Valor**, **Rango** (si la boleta muestra rangos) y **Comentario**.
 {{:a:users:users:boleta_estudiante.png?direct&600|}}
@@ Línea 112: / Línea 115: @@
 ==== Consultar calificaciones del periodo del estudiante ====
-  -Ingresa al perfil del estudiante.
+  - Ingresa al perfil del estudiante.
-  -Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Calificaciones del periodo** del submenú.
+  - Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Calificaciones del periodo** del submenú. <notes>Esta opción del submenú solo aparece cuando el estudiante tiene una sola boleta configurada para mostrar directamente el último periodo publicado; con más de una boleta, o sin esa configuración, el submenú no la ofrece.</notes>
-  -Se mostrará un resumen del lado izquierdo con la siguiente información:
+  - La pantalla abre mostrando el periodo publicado más reciente de la boleta del estudiante.
-    *Ausencias
+  - Del lado izquierdo, el panel **Calificaciones** muestra, uno debajo de otro:
-    *Justificadas
+    * **Ausencias**, **Justificadas** y **Retardos**, cada uno con su ícono y un contador; estas tres filas solo aparecen si la boleta del estudiante las tiene habilitadas.
-    *Retardos
+    * **Ciclo**: el nombre del ciclo escolar.
-    *Nombre del ciclo
+    * **Periodo**: el nombre del periodo que se está consultando; pasa el cursor sobre el ícono de información junto a esta fila para ver, en una ventana emergente, las fechas de inicio y fin del periodo.
-    *Nombre del periodo
+    * **Promedio**: el promedio general del estudiante en el periodo, resaltado en una fila oscura. Solo aparece si la boleta tiene habilitado mostrar el promedio total.
-      * Al posicionar el cursor sobre el ícono de información, podrás ver las fechas que comprende el periodo.
+  - Arriba de la tabla de clases hay dos botones para alternar la vista:
-    *Promedio
+    * **Versión resumida** {{icon>fas fa-table-list}}: cada fila muestra solo la clase, el profesor y la calificación final; da clic en la fila para abrir una ventana con el detalle (criterios, temas, comentario del profesor).
-  -Se mostrará una tabla detallada por categoría con el listado de clases correspondientes. La información puede variar según la configuración de las clases, pero usualmente incluye:
+    * **Versión detallada** {{icon>fas fa-table}}: el detalle de cada clase (criterios, temas, comentario) se muestra siempre desplegado debajo de su fila, sin necesidad de dar clic; si la boleta muestra Ausencias, Justificadas o Retardos, esta versión agrega esas columnas a la tabla.
-    *Nombre de la clase
+  - Junto al selector de versión, un botón **Imprimir** {{icon>fas fa-print text-dark}} abre un menú con dos opciones (solo aparecen si la boleta tiene una plantilla de impresión configurada):
-    *Profesor que imparte la clase
+    * **Imprimir periodo**: genera la boleta impresa de este periodo y este sub-ciclo.
-    *Calificación
+    * **Imprimir boleta**: genera la boleta impresa completa, con todos los periodos del ciclo.
-    *Criterios y su porcentaje
+  - La tabla de clases está agrupada por categoría de evaluación, con una tarjeta por categoría:
-    *Calificación de criterios
+    * Si la categoría no es promediable, un ícono junto a su nombre lo indica ("No promediable").
-    *Ausencias
+    * Si la categoría tiene configurada una tabla de conversión de valores, un ícono junto a su nombre la muestra al pasar el cursor (**Tabla de conversiones de la categoría**), con las columnas **Valor**, **Rango** (si la categoría muestra rangos) y **Comentario**.
-    *Justificadas
+    * Cada fila es una clase, con el nombre del profesor que la imparte debajo (o la leyenda **Clase virtual** si es una clase virtual); si la clase no es promediable dentro de la categoría, un ícono junto a su nombre lo indica ("No promediable en la categoría").
-    *Retardos
+    * La columna **Calificación** muestra la calificación final de la clase en ese periodo. Si la clase tiene una calificación de recuperación o de extraordinario capturada, la calificación se muestra dentro de un botón (azul si aprueba, rojo si no) que abre el detalle de esa calificación.
-    *Promedio por categoría
+    * Al final de cada categoría se agregan, cuando la boleta o la categoría los tiene habilitados, un renglón de totales por **Ausencias**, **Justificadas**, **Retardos** y **Promedio** de la categoría.
-  -En la esquina inferior derecha de la pantalla encontrarás dos botones:
+  - El detalle de cada clase (desplegado o en ventana, según la versión elegida) puede incluir, según la configuración de la clase:
-     ***Imprimir** {{icon>fas fa-print text-dark}}: Para generar una versión impresa de la vista actual.
+    * Si se califica por **Criterios**: una fila por criterio con su nombre, su porcentaje y su calificación; un ícono de calificación en rojo indica que quedó por debajo de la calificación mínima posible o que el criterio es informativo o está condicionado a otros criterios, según el caso. Si el criterio tiene una rúbrica con un resultado ya capturado, un ícono de **Rúbrica** abre su visor de solo lectura con los **Niveles de desempeño** — ver "Modificar la calificación de una clase" más arriba.
-     ***Versión resumida** {{icon>fas fa-th-list}}:
+    * Si es una **Clase virtual**: el detalle de cada clase real que la compone, con su porcentaje de calificación virtual y su calificación.
-        *Al hacer clic, cambiarás a una vista simplificada que muestra solo las calificaciones finales por clase.
+    * Si la clase tiene **Temas** configurados: una fila por tema con su calificación o su opción capturada.
-        *Si haces clic nuevamente, volverás a la versión detallada, que desglosa calificaciones por criterios (si aplica) y muestra la calificación final por clase.
+    * La calificación final de la clase, y si el profesor capturó un comentario en el periodo, se muestra al final con su ícono.
+  - Si el periodo consultado todavía está abierto para captura de calificaciones, un aviso indica que la calificación final puede variar.
+  - Si la boleta tiene configurada una tabla general de conversión de valores, al final de la pantalla se agrega el panel **Tabla de conversiones de la boleta** con las columnas **Valor**, **Rango** (si la boleta muestra rangos) y **Comentario**.
+<notes>El nombre del ciclo, del periodo, de cada categoría y de cada clase se muestra como texto simple para el administrador de la escuela y el operador; solo se ve como enlace a su configuración cuando quien consulta es el administrador de la plataforma.</notes>
+<notes>FALTA_CAPTURA — pantalla: Perfil del estudiante → Calificaciones → Calificaciones del periodo; mostrar: el panel Calificaciones de la izquierda con Ausencias/Justificadas/Retardos, Ciclo, Periodo y Promedio, y la tabla de clases en versión detallada con al menos una clase con criterios desplegados; archivo sugerido: :a:users:users:calificaciones_del_periodo.png</notes>
+==== Consultar el historial de calificaciones de extraordinario o recuperación de un alumno ====
+Se abre al dar clic en la calificación de un periodo con extraordinario o recuperación registrados, tanto desde la **Boleta** como desde **Calificaciones del periodo**.
+  - Da clic en la calificación resaltada del periodo correspondiente.
+  - Se muestra un panel con los datos del extraordinario o recuperación:
+    * **Clase**: el nombre de la clase.
+    * **Extraordinario**: el nombre capturado para ese extraordinario o recuperación.
+    * **Periodo**: el periodo de exámenes al que pertenece.
+    * **Razón de inscripción**: solo aparece si la inscripción del alumno a ese periodo quedó con un comentario o razón capturada.
+  - Debajo, la sección **Historial de calificaciones** muestra:
+    * **Calificación original**: la calificación que tenía el alumno antes del extraordinario o recuperación.
+    * Una fila por cada toma presentada, con un ícono verde si esa toma está aprobada o rojo si no, un enlace a la información de la toma y su calificación; si el profesor capturó un **Comentario** en alguna toma, se muestra debajo de esa fila.
+  - Si el extraordinario es de recuperación por **Criterio**, se agrega debajo un panel por cada criterio en el que el alumno está inscrito, con su **Porcentaje**, su **Calificación original** y su **Calificación** (con un ícono de lápiz cuando ya tiene una calificación de recuperación capturada para ese criterio).
+**Nota:** Cualquier operador puede consultar esta pantalla sin necesidad de un permiso específico; el administrador de la escuela también puede consultarla libremente.
+<notes>FALTA_CAPTURA — pantalla: Perfil del estudiante → Calificaciones → Calificaciones del periodo (o Boleta) → clic en la calificación de un periodo con extraordinario o recuperación registrados; mostrar: el panel con Clase/Extraordinario/Periodo y el Historial de calificaciones con la Calificación original y al menos una toma con su calificación y comentario; archivo sugerido: :a:users:users:historial_extraordinario_recuperacion.png</notes>
 ==== Consultar estadísticas de calificaciones del estudiante ====
+La opción **Estadísticas** te permite consultar, en gráficas, el desempeño del estudiante por categoría de evaluación, por clase y, dentro de cada clase, por periodo.
-  -Ingresa al perfil del estudiante.
+  - Ingresa al perfil del estudiante.
-  -Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Estadísticas** del submenú.
+  - Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Estadísticas** del submenú.
-  -Selección de ciclo escolar
+  - Si el estudiante tiene más de un grupo y ciclo escolar, verás arriba un botón con el nombre del grupo y ciclo actuales; da clic en ese botón para elegir otro grupo y ciclo.
-    *Verás un botón con el nombre del grupo y ciclo escolar actual del estudiante.
+  - Si el estudiante no tiene calificaciones publicadas, la pantalla muestra el aviso "No se han publicado calificaciones para este estudiante." y no despliega ninguna boleta.
-     *Si deseas consultar la boleta de un ciclo escolar anterior, haz clic en ese botón y selecciona el ciclo correspondiente.
+  - Cuando sí hay calificaciones publicadas, se muestra un botón **Imprimir** {{icon>fas fa-print text-dark}} y, por cada boleta del estudiante en el grupo y ciclo seleccionados, un panel con el nombre de la boleta y su **Promedio de boleta**; da clic en la flecha hacia abajo {{icon>fas fa-angle-down}} del panel para contraerlo o expandirlo. Dentro de cada panel:
-  -Se mostrará una tabla con el nombre de la boleta y al final de la final, el promedio de boleta del estudiante. A continuación, se presentan las siguientes secciones:
+    * Si sus categorías tienen configurado mostrar promedio, una gráfica de **Promedio por categoría** con el promedio del estudiante en cada categoría de evaluación de esa boleta.
-     ***Gráfica de "Promedio por Categoría**: Representa visualmente el promedio del estudiante agrupado por cada categoría de evaluación.
+    * Una gráfica de **Promedio por clase** con el promedio obtenido en cada una de sus clases.
-     ***Gráfica de Promedio por Clase**: Muestra el promedio obtenido en cada clase de manera individual.
+    * Un listado con cada clase de la boleta, su **Promedio de clase**, y una flecha hacia abajo {{icon>fas fa-angle-down}} que despliega una gráfica de **Promedio por periodo** con el promedio de esa clase en cada uno de sus periodos.
-     ***Listado de Clases con Promedios**:
+  - Para imprimir las estadísticas, da clic en el botón **Imprimir** {{icon>fas fa-print text-dark}} de la esquina superior derecha; abre la misma información en una versión para impresión.
-       Se desplegará una lista con las clases del estudiante.
-         *Al final de cada fila verás el promedio de la clase.
+<notes>FALTA_CAPTURA — pantalla: Perfil del estudiante → Calificaciones → Estadísticas; mostrar: el panel de una boleta expandido con su Promedio de boleta, la gráfica de Promedio por categoría, la de Promedio por clase, y el listado de clases con al menos una fila desplegada mostrando la gráfica de Promedio por periodo; archivo sugerido: :a:users:users:estadisticas_calificaciones.png</notes>
-         *Al hacer clic en el botón de **Flecha** {{icon>fas fa-chevron-down text-black}} al final de la fila, se mostrará una gráfica detallada del "Promedio por Periodo" correspondiente a esa clase.
-Puedes imprimir las estadísticas de calificaciones del estudiante, haz clic en el botón **Imprimir** {{icon>fas fa-print text-dark}} ubicado en la esquina superior derecha de la pantalla.
 ==== Revalidación de calificaciones del estudiante ====
 La opción "Revalidación de calificaciones del estudiante" sirve para registrar materias que el estudiante ya cursó y aprobó en otra institución educativa o en otro plan de estudios, con el fin de validarlas dentro del sistema actual del colegio.
@@ Línea 183: / Línea 204: @@
 <notes>FALTA_CAPTURA — pantalla: Perfil del estudiante → Calificaciones → Revalidación de calificaciones; mostrar: un panel de grado desplegado con la lista Sub-ciclo del encabezado, las columnas Equivalencia, Calificación con su Mínimo aprobatorio y Comentario, y al menos una fila bloqueada con "Clase en curso o cursada."; archivo sugerido: :a:users:users:revalidacion_calificaciones.png</notes>
 ==== Desglose de calificaciones del estudiante ====
-La opción "Desglose de calificaciones del estudiante" permite consultar en detalle cómo se calculó la calificación final de cada clase durante un periodo específico. Es una herramienta muy útil ya que ofrece transparencia y claridad en el proceso de evaluación.
+La opción **Desglose de calificaciones** permite consultar en detalle cómo se calculó la calificación final de cada clase durante un periodo específico. Es una herramienta muy útil ya que ofrece transparencia y claridad en el proceso de evaluación.
+  - Ingresa al perfil del estudiante.
-  -Ingresa al perfil del estudiante.
+  - Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Desglose de calificaciones** del submenú.
-  -Selecciona la pestaña **Calificaciones** y haz clic nuevamente en la opción **Desglose de calificaciones** del submenú.
+  - Arriba de la lista de clases verás un botón con el nombre del periodo (y, si el sub-ciclo tiene más de un periodo activo, también el nombre del sub-ciclo) que el estudiante cursa actualmente. Da clic en ese botón para abrir el listado de periodos y elegir otro; los periodos de sub-ciclos ya cerrados quedan agrupados debajo, ocultos hasta que actives el interruptor **Mostrar sub-ciclos inactivos**.
-  -Selección del periodo
+  - Si el estudiante no tiene ningún periodo disponible, la pantalla no muestra el listado de clases.
-    *Verás un botón con el nombre del periodo actual del estudiante.
+  - Junto al selector de periodo, dos botones: **Descargar Excel** {{icon>far fa-file-excel text-green}} para exportar el desglose del periodo, e **Imprimir** {{icon>fas fa-print text-dark}} para abrir la versión de impresión.
-    *Si deseas consultar el desglose de otro periodo, haz clic en ese botón y selecciona el periodo correspondiente.
+  - Se mostrará, por cada clase que el estudiante cursa (agrupadas y contraídas de una en una), el nombre de la clase —con enlace directo a su configuración—, el nombre del profesor —con enlace a su perfil— y la calificación final del periodo en esa clase; da clic sobre la fila para desplegar el detalle.
-  -Se mostrará el listado de todas las clases cursadas por el estudiante, cada una con:
+    * Si la clase tiene tabla de conversión de valores configurada, junto a la calificación aparece un ícono {{icon>fas fa-right-left text-green}} que muestra la **Tabla de conversiones** de esa clase al pasar el cursor.
-    *Nombre de la clase
+  - Si la clase se califica por criterios, el detalle desplegado muestra una fila por criterio con:
-    *Profesor que imparte la clase
+    * El nombre del criterio y su porcentaje.
-    *Calificación final del estudiante en esa clase
+    * La calificación del criterio; si quedó por debajo de la calificación mínima posible, o si el sistema la convirtió a otro valor según la configuración del criterio, aparece un ícono de aviso junto al valor con el detalle al pasar el cursor.
-    *Un botón de **Flecha** {{icon>fas fa-chevron-down text-black}} al final de la fila para desplegar el detalle de cómo se obtuvo dicha calificación.
+    * Si el criterio es informativo (no cuenta para el promedio) o está condicionado a que existan calificaciones de otros criterios, un ícono adicional lo indica.
-  -Cuando se despliega el detalle de una clase, se muestra:
+    * Si el criterio tiene una rúbrica asignada y ya tiene un resultado capturado, un ícono de rúbrica abre, al dar clic, el visor de solo lectura con sus **Niveles de desempeño**.
-    ***Criterios de evaluación** (si aplica)
+    * Si el criterio lo configuró el profesor (no el administrador), el nombre del criterio no es un enlace.
-    ***Porcentaje asignado a cada criterio**
+    * Cuando el criterio tiene actividades, un botón de flecha despliega la lista de actividades de ese criterio: cada una con su nombre, su porcentaje y su calificación; da clic en el ícono de información junto al nombre para ver su **Fecha** y **Descripción**, y en la calificación misma para ir al detalle de la actividad. Si un criterio no tiene actividades capturadas se indica con **Sin actividades**.
-    ***Calificación obtenida en cada criterio**
+  - Si la clase NO se califica por criterios, el detalle no muestra la tabla de criterios.
-    ***Actividades** (si aplica) Calificación de la actividad y al hacer clic se muestra el detalle de la actividad.
+  - Al final del detalle de cada clase se muestran los **Totales**: **Ausencias**, **Retardos**, el **Promedio sin redondeo** y, cuando la clase tiene puntos extra, los **Puntos extra** y, según si el redondeo coincide o no con la calificación con puntos extra, el **Redondeo** o el **Promedio + puntos extras sin redondeo**.
-    ***Totales**
-    ***Ausencias**
-    ***Retardos**
-    ***Promedio sin redondeo**
-    ***Promedio final**
 ==== Desglose de proyección del estudiante ====
+La opción **Desglose de proyección** te permite calcular, a partir de un mínimo aprobatorio que tú defines, si el estudiante alcanzará ese mínimo en cada una de sus clases considerando las calificaciones ya registradas y el periodo del ciclo que todavía falta por evaluar.
-  -Ingresa al perfil del estudiante.
+  - Ingresa al perfil del estudiante.
-  -Selecciona la pestaña **Calificaciones** y haz clic en la opción **Desglose de proyección** del submenú.
+  - Selecciona la pestaña **Calificaciones** y haz clic en la opción **Desglose de proyección** del submenú.
-  -Se mostrará el nombre del estudiante y el ciclo, deberás capturar el mínimo aprobatorio y hacer clic en **Aceptar**.
+  - En el panel **Desglose de proyecciones** verás el **Nombre** y el **Ciclo** del estudiante. Captura el **Mínimo aprobatorio** que quieres usar para la proyección y da clic en **Aceptar**.
-  -En la parte inferior de la pantalla, se desplegará la boleta del estudiante, la cual incluye las "clases cursadas", las "calificaciones registradas" hasta el momento y la "proyección" académica.
+    * Si el valor que capturaste no es numérico o queda fuera del rango de calificaciones válido para las boletas del estudiante, la consulta no se envía y se muestra "Una o más calificaciones se encuentran fuera del rango permitido, por favor revise y vuelva a intentar."
-  -En la columna de "Proyección", el ícono cambiará a color verde {{icon>fa fa-check-circle text-green-algebraix}} si, con las calificaciones actuales y considerando los periodos aún pendientes de evaluación, el estudiante cumple con el mínimo aprobatorio previamente capturado. Por el contrario, el ícono se mantendrá en color rojo {{icon>fa fa-times-circle text-red-algebraix}}  si no alcanza el mínimo requerido.
+  - Debajo del panel se despliega un bloque por cada boleta del estudiante en el ciclo, con su nombre y una tabla de sus clases agrupadas por categoría. Por cada clase, la tabla muestra una columna por sub-ciclo y periodo (incluido el periodo todavía pendiente de evaluar, sobre el que se calcula la proyección), y en cada una:
-{{:a:users:users:proyeccion_estudiante.png?direct&600|}}
+    * Un ícono verde {{icon>fa fa-circle-check text-green}} si el periodo ya está aprobado.
+    * Un ícono rojo {{icon>fa fa-circle-xmark text-red}} si el periodo ya está reprobado.
+    * Si el periodo aún no se resuelve, la calificación del estudiante hasta el momento, en rojo cuando queda por debajo del **Mínimo aprobatorio** que capturaste.
+  - Si alguna boleta tiene uno o más periodos todavía abiertos para captura, aparece un aviso con el nombre de esos periodos y el texto "aún se encuentra abierto para captura, por lo que la calificación final puede variar", porque mientras el periodo siga abierto la proyección puede cambiar.
+  - Si el estudiante no tiene ninguna boleta disponible en el ciclo, no se muestra ninguna tabla.
+<notes>FALTA_CAPTURA — pantalla: Perfil del estudiante → Calificaciones → Desglose de proyección; mostrar: el panel Desglose de proyecciones con el campo Mínimo aprobatorio capturado y, debajo, la tabla de una boleta con sus columnas de periodo mostrando al menos un ícono de aprobado, uno de reprobado y una calificación en rojo por debajo del mínimo; archivo sugerido: :a:users:users:desglose_proyeccion.png</notes>
 ===== Permisos para el operador =====
@@ Línea 220: / Línea 243: @@
 **Permisos por grupo**
   ***Calificaciones**
-    ***Estudiante**
+    ***Estudiante**: Permite consultar la boleta del estudiante y sus calificaciones del periodo.
     ***Desglose de calificaciones**: Permite visualizar el detalle de las calificaciones obtenidas por clase y periodo.
     ***Desglose de proyección**: Permite acceder a la proyección académica basada en las calificaciones actuales y los periodos pendientes.
@@ Línea 230: / Línea 253: @@
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:users:users:student_profile_grades" make -C pipeline revisar</notes>