1. Abra su navegador e ingrese a la dirección del sistema (por ejemplo, http://localhost:5000).
2. Si no ha iniciado sesión, el sistema lo llevará automáticamente a la pantalla de Iniciar Sesión.
3. Escriba su Usuario institucional y su Contraseña.
4. Pulse el botón azul "Iniciar Sesión". Según su rol (Administrador o Docente), entrará a su panel de trabajo.

Verifique que esté escribiendo correctamente el nombre de usuario y que no tenga activadas las mayúsculas por error. Si el problema persiste:
• Si es Docente: Comuníquese con el Administrador General del colegio para que verifique si su cuenta está activa o le asigne una nueva contraseña desde el menú 👥 Docentes.
• Si es Administrador: Puede recuperar o restablecer su clave administrativa ejecutando en la consola del servidor el comando institucional seguro python crear_admin.py (Opción 1).

El sistema cuenta con control de acceso por roles para proteger los datos institucionales:
• Los Docentes tienen acceso a sus horarios, sus cursos a cargo, el registro de asistencia de sus grupos y reportes.
• Las opciones directivas como crear cursos, matricular estudiantes, gestionar cuentas de docentes, configurar horarios generales y la bitácora de auditoría son exclusivas del Administrador.

1. Haga clic en 📝 Asistencia en el menú superior (o pulse "📝 Tomar Asistencia" directamente desde su horario o en 📚 Mis Cursos).
2. Seleccione el Curso y la Materia / Asignatura que va a impartir.
3. Confirme la Fecha (por defecto se carga la fecha actual).
4. Pulse "📋 Cargar Lista".
5. Para cada estudiante, marque su estado (Presente, Ausente o Tardanza).
6. Pulse el botón verde "💾 Guardar Asistencia en MySQL" al final de la lista.

En la planilla digital, cada estudiante tiene botones circulares interactivos:
• Botón P (Verde): Presente en clase.
• Botón A (Rojo): Ausente (inasistencia).
• Botón T (Amarillo): Tardanza (llegó con retraso).
Consejo: Puede usar el botón rápido "✅ Presentes Todos" en la cabecera de la planilla para marcar a todo el grupo como Presente con un solo clic y luego cambiar únicamente a los que faltaron.

Puede consultar las ausencias en dos módulos:
1. En 🔍 Consultar: filtra por curso, materia o estado "Ausente" para ver la lista detallada de inasistencias registradas.
2. En 📊 Reportes: se visualizan tarjetas con el total de ausencias acumuladas, alertas tempranas de estudiantes con alto ausentismo y gráficos estadísticos.

Ingrese al menú 🔍 Consultar. En el campo de búsqueda escriba el nombre o apellido del estudiante (o seleccione su curso) y pulse "🔍 Filtrar Asistencias". La tabla listará cada fecha con el estado de asistencia y observaciones.

Vaya a 🔍 Consultar, defina en el campo Fecha Desde y Fecha Hasta el rango deseado y pulse "🔍 Filtrar Asistencias". También puede generar un reporte impreso usando el botón "🖨️ Imprimir / Guardar PDF".

Vaya al módulo 📝 Asistencia, seleccione el mismo curso, materia y la fecha del día que desea corregir. Al pulsar "📋 Cargar Lista", el sistema cargará los estados guardados previamente. Cambie los estados correspondientes y vuelva a presionar "💾 Guardar Asistencia en MySQL" para actualizar los registros.

Al ingresar con su cuenta de docente, pulse en el menú 📅 Mi Horario. Se desplegará la cuadrícula semanal de lunes a viernes con los periodos de clase y sus horarios exactos de inicio y fin (ej. 6:30 a. m. a 7:30 a. m. en la mañana o 1:30 p. m. a 2:30 p. m. en la tarde).

En cada casilla de su horario semanal encontrará el nombre destacado de la Materia y el número del Grupo (ej. Matemáticas • Grupo 10-1). También puede consultar el menú 📚 Mis Cursos para ver el catálogo de todos los cursos y materias que tiene asignados.

Si en su pantalla aparece el aviso "Todavía no tiene un horario registrado" o falta alguna clase, informe al Administrador General. El docente no puede modificar horarios directamente; el administrador es quien programa los bloques en el módulo directivo de 📅 Horarios.

1. Ingrese con perfil de Administrador y haga clic en 📅 Horarios.
2. Pulse el botón azul "➕ Programar Horario" (o "🔗 Asignar Docente").
3. Seleccione el Curso, el Docente, la Materia, el Día de la semana y el Período/Hora de clase.
4. Pulse "💾 Guardar Bloque en MySQL". El sistema verificará que no existan choques de horario y la clase aparecerá de inmediato en el horario del profesor.

Música cuenta con una Regla Institucional Obligatoria:
• Solo se imparte a los grados 6°, 7°, 8° y 9°. No se permite en 10° ni 11°.
• La clase debe programarse en la jornada de la tarde (entre la 1:30 p. m. y las 5:30 p. m.).
• Cada curso tiene exactamente 1 hora semanal de 60 minutos. El sistema bloquea automáticamente asignaciones duplicadas.
Para programarla, abra "➕ Programar Horario", elija un curso de 6° a 9°, seleccione la materia Música, el docente y un período de la tarde.

• Desde el panel de Administrador: Vaya a 🏫 Cursos y en la fila del curso deseado haga clic en el botón "👥 Ver Alumnos". Se abrirá la ventana con el listado de matriculados obtenidos desde MySQL.
• Desde el panel de Docente: Vaya a 📚 Mis Cursos y pulse el botón "📋 Ver Alumnos" en la tarjeta del curso asignado.

1. Con rol Administrador, ingrese a 👨‍🎓 Estudiantes.
2. Pulse el botón azul "➕ Matricular Nuevo Estudiante".
3. Diligencie los Nombres, Apellidos, Documento de Identidad, Edad, Correo Institucional y seleccione el Curso al que pertenecerá.
4. Pulse "💾 Guardar Estudiante en MySQL".

En el momento de matricular al alumno se elige su curso. Si necesita cambiarlo de grupo, vaya a 👨‍🎓 Estudiantes, busque al alumno, pulse el botón "✏️ Editar", elija el nuevo Curso en el menú desplegable y presione "🔄 Actualizar en MySQL".

1. Ingrese a 📅 Horarios como Administrador.
2. Pulse el botón "📚 Nueva Materia" en la cabecera.
3. Escriba el nombre oficial de la asignatura y su área académica.
4. Pulse "💾 Guardar Materia". La nueva materia estará disponible de inmediato en todos los selectores de horarios y planillas.

Vaya a 📅 Horarios, pulse "🔗 Asignar Docente", seleccione el Docente, el Curso y la Materia. Puede especificar de una vez el día y hora para programarla en su horario semanal, y pulse "💾 Guardar en MySQL".

El sistema cuenta con un motor inteligente que impide choques de agenda:
• Si el docente ya tiene otra clase a esa hora, el sistema indicará con qué grupo tiene clase.
• Si el curso ya tiene otra materia programada en esa hora, el sistema indicará qué docente la está impartiendo.
Para resolver el conflicto, elija otro período libre o reasigne previamente la clase conflictiva.

Ingrese a 📊 Reportes en el menú superior. En la parte superior filtre por el Curso de su interés. El sistema calculará el porcentaje global de asistencia, el porcentaje de puntualidad y mostrará los gráficos comparativos de presentes, ausencias y tardanzas.

En 🔍 Consultar, indique la misma fecha en Fecha Desde y Fecha Hasta. La tabla mostrará todos los estudiantes a los que se les pasó lista en esa jornada escolar con su estado y la materia correspondiente.

1. Con rol Administrador, haga clic en 👥 Docentes.
2. Pulse el botón azul "➕ Crear Nuevo Docente".
3. Diligencie el Nombre Completo, Usuario institucional, Correo Electrónico y Contraseña inicial.
4. Pulse "💾 Crear Cuenta en MySQL".

En 🏫 Cursos puede crear nuevos cursos (botón "➕ Crear Nuevo Curso") indicando el nombre (ej. 10-1) y la jornada (Mañana o Tarde). También puede editar sus datos o verificar cuántos estudiantes matriculados tiene cada grupo.

El administrador puede consultar el consolidado general en 📅 Horarios (filtrando por curso, docente o día), o bien ingresar a 📅 Mi Horario y usar el selector superior "Consultar Docente" para visualizar la matriz semanal de cualquier profesor.

Haga clic en la pastilla de su usuario en la esquina superior derecha (👤 Perfil). Desde allí puede actualizar su nombre completo, correo electrónico y cambiar su contraseña de forma segura. El Administrador también puede restablecer la contraseña de cualquier docente desde el módulo 👥 Docentes.