📋 Asistencia
El módulo de Asistencia permite registrar y dar seguimiento a la presencia de los estudiantes en cada clase programada. Está diseñado para operar directamente desde el calendario del horario, permitiendo un flujo rápido: ver bloque → registrar asistencia de toda la sección.
📍 Ruta de acceso: Menú lateral → Aula Virtual → Asistencia
1. Sistema de Estados de Asistencia
Los estados de asistencia son configurables por el administrador y soportan colores personalizados. Cada estado tiene un color de fondo y un color de texto para su visualización en la interfaz.
| Campo | Tipo | Descripción |
|---|---|---|
| Nombre | Texto (20 car.) | Identificador del estado (ej: Presente, Ausente, Justificado, Tardanza) |
| Activo | Sí/No | Controla si el estado aparece como opción disponible |
| Sistema | Sí/No | Indica si es un estado base del sistema (no eliminable) |
| Color | Hexadecimal | Color de fondo del chip de estado |
| Color Texto | Hexadecimal | Color del texto dentro del chip |
⚙️ Configuración: Menú lateral → Ajustes → Categorías → pestaña Estados de Asistencia
2. Flujo de Registro — Desde el Calendario
La forma principal de registrar asistencia es directamente desde un bloque del horario en el calendario. Al hacer clic en el botón 📋 Asistencia de un bloque, el sistema transfiere automáticamente el contexto (sección, materia, fecha, horario) a la pantalla de registro masivo.
Datos transferidos automáticamente al formulario de registro:
| Dato | Origen |
|---|---|
| Año Lectivo | Filtro activo del calendario |
| Sección | Filtro activo del calendario |
| Materia | Título del bloque seleccionado |
| Fecha | Fecha del bloque en el calendario |
| Hora inicio / fin | Horario del bloque seleccionado |
3. Pantalla de Registro Masivo
La pantalla de registro muestra el contexto de la clase en chips informativos y una tabla con todos los estudiantes matriculados en la sección. Para cada estudiante se puede seleccionar:
| Columna | Descripción |
|---|---|
| Nombre Completo | Nombre del estudiante (solo lectura) |
| Motivo | Selector del estado de asistencia (Presente, Ausente, Justificado, Tardanza, etc.) |
| Descripción | Campo opcional para notas adicionales (ej: "Llegó 15 min tarde", "Permiso médico") |
💡 Nota
Solo se guardan los estudiantes que tengan un estado seleccionado. Si un estudiante no tiene estado asignado, se omite del registro. Esto permite registrar asistencia selectiva (solo ausencias/tardanzas).
🔔 Notificaciones Automáticas
Cuando un estudiante es marcado con un estado diferente a "Presente" (ID ≠ 1), el sistema envía automáticamente una notificación push a los tutores del estudiante, informándoles del estado de asistencia.
4. Lista de Registros de Asistencia
La vista principal muestra todos los registros de asistencia en formato de tabla con filtros avanzados:
Filtros disponibles (selectores en cascada):
🎓 Año Lectivo → 🏫 Sección → 📚 Curso → 📅 Rango de Fechas
Además incluye un campo de búsqueda por nombre de estudiante.
Columnas de la tabla:
| Columna | Descripción |
|---|---|
| Año Lectivo | Ciclo escolar del registro |
| Sección | Grado y grupo |
| Curso | Materia asociada |
| Estudiante | Nombre completo |
| Fecha | Fecha del registro |
| Estado | Chip de color con el estado de asistencia |
Acciones disponibles por registro (menú de tres puntos):
| Acción | Icono | Descripción |
|---|---|---|
| Editar | ✏️ | Cambiar el estado o la descripción del registro individual |
| Estudiante | 🎓 | Navegar al expediente completo del estudiante |
| Eliminar | 🗑️ | Borrar el registro de asistencia (con confirmación) |
5. Dashboard Analítico de Asistencia
El módulo incluye un panel de análisis visual con gráficos interactivos. Es accesible desde el menú lateral → Aula Virtual → Panel de Asistencia.
📍 Ruta de acceso: Menú lateral → Aula Virtual → Panel de Asistencia
Tarjetas de Estadísticas (Premium Cards):
| Tarjeta | Icono | Color | Descripción |
|---|---|---|---|
| Asistencias | ✅ | Verde | Total de registros con estado "Presente" |
| Ausencias Injustificadas | ❌ | Rojo | Total de ausencias sin justificación |
| Ausencias Justificadas | ⚠️ | Naranja | Total de ausencias con justificación |
| Tardanzas | 🕐 | Azul | Total de llegadas tardías |
Gráficos disponibles:
| Gráfico | Tipo | Descripción |
|---|---|---|
| Asistencia por Estado | Barras | Distribución de registros agrupados por cada estado |
| Tendencia (30 días) | Línea | Evolución diaria de registros de asistencia |
| Distribución por Grado | Pastel (Donut) | Proporción de registros por grado académico |
| Distribución por Nivel | Pastel | Proporción de registros por nivel educativo |
El dashboard también incluye una tabla de ausencias recientes (últimos 10 registros) con avatar del estudiante, sección, curso, fecha y estado con chip de color.
🔍 Filtros del Dashboard
El panel soporta los mismos filtros en cascada que la lista principal (Año Lectivo → Sección → Curso). Los gráficos se actualizan automáticamente al cambiar cualquier filtro.
6. Resumen de Navegación — Asistencia
| Elemento | Ubicación | Función |
|---|---|---|
| 📋 Asistencia (Botón) | Bloque del calendario | Iniciar registro masivo desde el horario |
| 🔍 Buscar | Barra superior de lista | Ejecutar búsqueda con los filtros actuales |
| Año Lectivo | Barra de filtros | Filtro principal del selector en cascada |
| Sección | Barra de filtros | Depende del Año Lectivo seleccionado |
| Curso | Barra de filtros | Depende de la Sección seleccionada |
| Rango de Fechas | Barra de filtros | Filtrar por período (fecha inicio/fin) |
| Estudiante | Barra de filtros | Búsqueda por nombre del estudiante |
| ✏️ Editar | Menú de acciones por fila | Modificar estado y descripción del registro |
| 🎓 Estudiante | Menú de acciones por fila | Navegar al expediente del estudiante |
| 🗑️ Eliminar | Menú de acciones por fila | Borrar registro con confirmación |
| 💾 Guardar | Formulario de registro masivo | Confirmar y almacenar la asistencia de todos los estudiantes |
| 📊 Dashboard | Menú lateral | Acceder al panel analítico con gráficos interactivos |

