Flujo general de administración de estudiantes
Todo comienza con el registro del alumno. A partir de ese registro se generan los carnets físicos, los QR de las aulas y el control de solvencia. El diagrama muestra el ciclo completo:
en el sistema
imprimir carnet
para cada salón
reporta pago
y da acceso
| Módulo | URL | Quién lo usa | Acción principal |
|---|---|---|---|
| Gestión de Estudiantes | /admin-estudiantes | Secretaría / Admin | CRUD completo de alumnos |
| Carnets | /carnets | Secretaría | Generar e imprimir carnets MPPE |
| QRs de Aula | /gestion-salones | Admin / Coordinación | Imprimir ficha QR por salón |
| Pagos | /pagos | Representante | Reportar comprobante de pago |
Módulo de Gestión de Estudiantes
Panel completo para registrar, editar y gestionar todos los alumnos del plantel. Accesible desde el Dashboard → sección Admin → Estudiantes.
Tabla principal y KPIs
Al abrir /admin-estudiantes la página carga todos los alumnos activos en tiempo real (listener onSnapshot). Los KPIs se actualizan automáticamente con cada cambio.
| Foto | Nombre | Cédula | C.E. MPPE | Nivel | Grado | Sección | Sexo | Representante | Solvencia | Acciones |
|---|---|---|---|---|---|---|---|---|---|---|
| Álvarez, Pedro | 28.441.203 | V1150523456 | Bachillerato | 4to Año | B | Masc. | María Álvarez m.alv@gmail.com |
|||
| Briceño, Valentina | 29.112.780 | — | Primaria | 3er Grado | A | Fem. | Juan Briceño j.bri@hotmail.com |
| Columna | Descripción |
|---|---|
| Foto | Miniatura circular. Si no tiene foto se muestra el ícono de usuario. |
| C.E. MPPE | Cédula Escolar generada con el algoritmo MPPE (ver sección 5). |
| Solvencia | Botón interactivo. Verde = acceso permitido en portería. Rojo = bloqueado en portería. |
| Acciones | ✏️ Editar · 🪪 Ver carnet individual · 🗑️ Eliminar |
Búsqueda y filtros
Los cuatro controles de la barra de herramientas filtran la tabla al instante, sin recargar datos:
| Control | Filtra por |
|---|---|
| Campo de búsqueda | Nombre completo o número de cédula (parcial o completo) |
| Nivel | Inicial / Preescolar · Primaria · Bachillerato |
| Grado | Se actualiza automáticamente según el nivel seleccionado |
| Sexo | Masculino / Femenino / Ambos |
Crear un nuevo estudiante
- Presiona el botón verde + Nuevo Estudiante en la barra de herramientas.
- Se abre el formulario modal. Completa los datos en el siguiente orden: foto → datos personales → datos académicos → representante → Cédula Escolar MPPE.
- Los campos marcados con * son obligatorios: Nombre, Cédula, Sexo, Nivel y Grado.
- Presiona Guardar. El sistema verifica que la cédula no esté duplicada antes de guardar.
- El nuevo alumno aparece en la tabla al instante gracias al listener en tiempo real.
Nuevo Estudiante
✕Webcam o archivo JPG/PNG.
Foto del alumno
La foto se almacena como cadena Base64 directamente en Firestore (foto). Aparece en la tabla de estudiantes, en el carnet y en la pantalla de la portería al registrar entrada/salida.
| Método | Pasos | Mejor para |
|---|---|---|
| 📷 Webcam / Cámara | Clic en "Abrir cámara" → el video se activa sobre el ícono circular → clic en "Capturar" → la foto se recorta al círculo automáticamente. | Matrícula presencial: el alumno está físicamente en la oficina. |
| 📁 Subir archivo | Clic en "Subir foto" → seleccionar JPG o PNG desde el disco → la imagen se redimensiona y recorta a 200×200 px vía canvas. | Foto previa del alumno en formato digital. |
Cédula Escolar MPPE
La Cédula Escolar (C.E.) es el identificador oficial del alumno ante el MPPE. EnClase la genera automáticamente a partir de los datos del alumno.
Fórmula de generación
| Campo | Ejemplo | Resultado en C.E. |
|---|---|---|
| Nacionalidad | Venezolano | V |
| Orden de nacimiento | 1er hijo | 1 |
| Año de nacimiento (2 dígitos) | 2015 | 15 |
| C.I. de la madre (8 dígitos) | 5.123.456 → 05123456 | 05123456 |
| Cédula Escolar resultante | V11505123456 | |
Cómo generarla en el formulario
- En el formulario de nuevo/editar estudiante, baja hasta la sección Cédula Escolar MPPE.
- Selecciona la Nacionalidad (V o E).
- Ingresa el Orden de nacimiento (1 si es el primer hijo, 2 si es el segundo, etc.).
- La Fecha de nacimiento ya debe estar completada — el sistema la toma de ese campo.
- Ingresa la C.I. de la madre sin puntos ni guiones (máximo 8 dígitos).
- Presiona el botón azul Generar. El campo "Cédula Escolar generada" se llena automáticamente.
- Guarda el formulario — la C.E. queda almacenada en el campo
cedulaEscolarde Firestore.
Editar y eliminar estudiantes
Editar
Presiona el ícono de lápiz ✏️ en la fila del alumno. El formulario modal se abre con todos los datos precargados, incluyendo la foto actual. Modifica los campos necesarios y presiona Guardar. La actualización llega a todos los dispositivos en tiempo real.
Eliminar
Presiona el ícono de papelera 🗑️. El sistema pide confirmación con el nombre del alumno antes de proceder. La eliminación es permanente — el documento se borra de Firestore.
activo a false editando el documento directamente en la consola de Firebase.Ver carnet individual
Presiona el ícono verde 🪪 de la fila. Abre la página /carnets?id={id} mostrando solo el carnet de ese alumno, listo para imprimir.
Control de solvencia
La solvencia determina si el alumno tiene acceso permitido en la portería del colegio. Un alumno no solvente es bloqueado automáticamente al intentar pasar.
Acceso permitido en portería.
Semáforo verde al escanear carnet.
Campo solvente: true en Firestore.
Acceso denegado en portería.
Semáforo rojo con "ALUMNO BLOQUEADO".
Campo solvente: false en Firestore.
Cambiar el estado de solvencia
- En la columna "Solvencia" de la tabla, el botón muestra el estado actual del alumno.
- Presiona el botón. Aparece una ventana de confirmación con el nombre del alumno y la acción (BLOQUEAR o SOLVENTAR).
- Confirma. El campo
solventese actualiza en Firestore al instante. - El cambio es efectivo de inmediato en la portería — no hay que reiniciar el kiosco.
solvente definido. El sistema interpreta undefined como solvente (solvente !== false). Para bloquearlo explícitamente, debes presionar el botón una vez.Importación Masiva de Estudiantes
Carga cientos de alumnos desde una planilla Excel en menos de un minuto. El sistema genera la Cédula Escolar MPPE automáticamente cuando los datos están disponibles.
Plantilla oficial de importación
EnClase incluye una plantilla Excel estandarizada que garantiza que el archivo siempre tenga el formato correcto. El colegio la recibe, la llena y la devuelve — sin adaptaciones ni formatos personalizados.
Cómo descargarla
- Ve a Admin → Gestión de Estudiantes.
- En la barra de herramientas, haz clic en el botón verde oscuro Descargar Plantilla.
- Se descarga el archivo
EnClase_Plantilla_Estudiantes.xlsx. - Envíalo al colegio por correo o WhatsApp para que lo complete.
Columnas de la plantilla
| Columna | Tipo | Descripción |
|---|---|---|
nombre | OBLIGATORIO | Primer y segundo nombre del alumno |
apellido | OBLIGATORIO | Apellidos del alumno |
cedula | RECOMENDADO | Cédula nacional. Si el menor aún no tiene, déjala vacía — el sistema generará la C.E. MPPE como identificador provisional |
sexo | OBLIGATORIO | M o F — usar el menú desplegable |
nivel | OBLIGATORIO | preescolar, primaria o bachillerato |
grado | OBLIGATORIO | Ej: Maternal, Preescolar I, 1er Grado, 4to Año — usar el menú desplegable |
seccion | OBLIGATORIO | A, B, C, D o E |
fecha_nacimiento | PARA C.E. MPPE | Formato AAAA-MM-DD. Necesaria para generar la cédula provisional |
orden_nacimiento | PARA C.E. MPPE | ¿Es el 1er, 2do, 3er hijo de la madre? |
ci_madre | PARA C.E. MPPE | Cédula de la madre, solo dígitos, máximo 8 |
nombre_representante | OPCIONAL | Nombre completo del representante |
email_representante | OPCIONAL | Correo del representante — necesario para OTP y pagos |
telefono_representante | OPCIONAL | Teléfono con código de área |
Importar el archivo
Una vez que el colegio devolvió la plantilla completada, el proceso de carga toma menos de un minuto y no requiere conexión especial — todo el procesamiento ocurre en el navegador.
Pasos para importar
- En Gestión de Estudiantes, haz clic en el botón índigo Importar.
- Arrastra el archivo
.xlsxa la zona de carga, o haz clic para buscarlo en tu computadora. - El sistema lee el archivo y muestra la vista previa con todos los alumnos detectados.
- Revisa los estados: ✅ listo, ⚠️ con aviso, ❌ con error.
- Haz clic en Importar (N) para confirmar. Solo se importan los registros sin error ❌.
- Al terminar, aparece el total importado. Cierra el modal — la tabla se actualiza automáticamente.
Significado de cada estado
| Estado | Significado | ¿Se importa? |
|---|---|---|
| ✅ Listo | Todos los campos obligatorios están completos y válidos. Cédula nacional presente. | Sí |
| ⚠️ Con aviso | Datos válidos pero falta la cédula nacional y/o el email del representante. El sistema genera una cédula provisional si tiene los datos de la C.E. MPPE. | Sí, con marca |
| ❌ Con error | Falta nombre, apellido, o hay un valor inválido en Sexo / Nivel / Grado / Sección. También si la cédula ya existe en el sistema. | No |
Cédula provisional automática (C.E. MPPE)
En Venezuela, muchos niños pequeños aún no tienen cédula de identidad nacional. Para que el sistema funcione de forma completa desde el primer día — portal del alumno, pagos, carnets — EnClase genera automáticamente la Cédula Escolar MPPE y la usa como identificador provisional.
Cuándo se genera automáticamente
Durante la importación, si un alumno no tiene cédula pero la plantilla incluye los tres datos necesarios, el sistema calcula la C.E. MPPE al instante:
| Condición | Resultado |
|---|---|
| ✅ Tiene cédula nacional | Se usa la cédula. La C.E. MPPE se guarda como campo adicional. |
⚡ Sin cédula + tiene fecha_nac + orden_nac + ci_madre |
Se genera la C.E. MPPE y se usa como identificador provisional. Campo cedulaProvisional: true. |
| ⚠️ Sin cédula + faltan datos para C.E. | Se importa sin identificador. El admin debe completarlo manualmente desde el formulario de edición. |
Qué funciona con la cédula provisional
Una vez asignada la cédula provisional, todo el flujo opera normalmente:
- 🪪 Generación de carnet con QR
- 🏫 Login en portal del alumno
- 💰 Búsqueda en módulo de pagos
- 📋 Registro de asistencia
- 🧪 Módulo Lab y progreso
- 🪪 Campo C.I. en el carnet muestra la C.E.
- 🔄 Actualizar con CI nacional cuando el SAIME la emita
Cómo actualizar cuando llega la cédula nacional
- En la tabla de estudiantes, busca el alumno por nombre.
- Haz clic en el botón de edición .
- En el campo Cédula, ingresa la cédula nacional definitiva.
- Guarda. El campo
cedulaProvisionalse borra y el alumno queda con su CI definitiva.
cedulaEscolar, independientemente de si la cédula es provisional o definitiva. No se pierde al actualizar.Carnets Estudiantiles
Generador de carnets con estándar MPPE: anverso con datos del alumno y reverso con QR de cédula, firma y sello.
Generar carnets
Accede desde el Dashboard → Admin → Carnets, o directo desde /carnets. También puedes llegar desde el botón azul Carnets en la barra de herramientas de estudiantes.
Filtros disponibles
| Filtro | Opciones | Uso típico |
|---|---|---|
| Nivel | Todos / Inicial / Primaria / Bachillerato | Separar sección por nivel educativo |
| Grado / Año | Se llena según el nivel | Imprimir todos los carnets de un año específico |
| Sección | Texto libre (A, B, C…) | Imprimir solo una sección a la vez |
Tras ajustar los filtros, presiona Actualizar para recargar la vista.
Anatomía del carnet
ANA SOFÍA
Si usted encuentra este documento, comuníquese con la institución.
| Elemento | Origen de datos |
|---|---|
| Logo y nombre de la institución | Colección config/institucion (Configuración Institucional) |
| Código Plantel (PD) y RIF | config/institucion.codPlantel y .rif |
| Nombre, C.I., grado, foto del alumno | Colección estudiantes |
| QR del reverso | Encode de la cédula del alumno (lo que lee el kiosco de portería) |
| Nombre y cargo del director, contacto | config/institucion.director, .cargo, .telefono, .email |
Imprimir y laminar
Opciones de impresión
| Botón | Qué imprime | Cómo usarlo |
|---|---|---|
| Imprimir todos verde | Todos los carnets visibles según los filtros activos | Filtra primero el grado/sección, luego presiona. La impresión usa 2 columnas en hoja A4. |
| Imprimir este (bajo cada carnet) | Solo ese carnet específico | Útil para reposición de carnet perdido. La hoja se imprime centrada. |
| Ícono 🪪 en la tabla de estudiantes | El carnet individual en página aparte | Abre /carnets?id=XYZ en nueva pestaña con solo ese carnet. |
Proceso de producción del carnet
- Filtra por grado y sección.
- Presiona Imprimir todos. El diálogo de impresión del navegador se abre.
- Selecciona tamaño A4, orientación vertical, sin márgenes.
- Imprime en cartulina o papel fotográfico si es posible.
- Corta cada carnet (el anverso y reverso están lado a lado).
- Lamina para protección. Dimensiones del carnet: aprox. 5.5 cm × 8.7 cm (tamaño CR80 estándar).
QR de Señalización de Aula
Genera e imprime la ficha QR que se coloca en la pared de cada salón. Docentes y alumnos la escanean para registrar asistencia en el aula.
QR de señalización de aula — desde Gestión de Salones
La ficha QR de cada aula se genera directamente desde Gestión de Salones (/gestion-salones), accesible desde Dashboard → Salones. Ya no existe la ruta separada /generador-qr.
Generar e imprimir la ficha QR
- Ir a
/gestion-salones. Si el salón aún no existe, crearlo con el nombre exacto que usarás en el constructor de horarios (ej.1-1,LAB-A,BIBLIOTECA). - En la fila del salón, presionar el botón QR / Imprimir. Se abre la ficha de señalización con el QR ya generado para ese salón.
- Verificar que el nombre del aula en la ficha coincide exactamente con el del horario.
- Presionar Imprimir Ficha. El diálogo de impresión mostrará solo la ficha.
¿Qué contiene el QR?
El QR apunta a: https://edu.celinsubero.com/aula?id=2-3&colegio=ID_DEL_COLEGIO
El parámetro colegio se incluye automáticamente para aislar los datos del plantel (arquitectura multi-tenant). Cuando alguien escanea el QR con la cámara del teléfono, el navegador abre esa página, muestra la clase activa en ese salón y el formulario de registro de cédula. El mismo QR sirve para alumnos y docentes.
aula en la colección horarios. Si hay discrepancia, el sistema no encontrará la clase activa y mostrará "Sin clase activa".Dónde y cómo colocar el QR
- Imprime la ficha en papel tamaño carta o A4. Para mayor durabilidad, usa papel de 90 g/m² o superior.
- Lamina la ficha o cúbrela con contact transparente para protegerla de la humedad y el desgaste.
- Fíjala en la puerta o pared exterior del aula, a una altura de 1.2–1.5 metros desde el suelo, en posición vertical.
- Verifica que el QR se puede escanear desde al menos 30 cm de distancia con la cámara del teléfono.
- Si el aula tiene mala iluminación, considera usar papel brillante para mejor contraste.
| Espacio | ID sugerido | Ejemplo de URL |
|---|---|---|
| Aula numerada | 1-1, 2-3, 3-5 | /aula?id=2-3 |
| Laboratorio | LAB-A, LAB-BIO | /aula?id=LAB-A |
| Biblioteca | BIBLIOTECA | /aula?id=BIBLIOTECA |
| Sala de informática | INFORMATICA | /aula?id=INFORMATICA |
Pagos y Solvencia
El módulo de pagos recibe reportes de comprobantes de los representantes. El admin verifica y actualiza la solvencia manualmente.
Reporte de pago — vista del representante
El representante accede a /pagos (desde el menú del colegio o un enlace compartido) y llena el formulario de comprobante. No hay login — el acceso es abierto.
Reporte de Pago
Módulo de Tesorería y Solvencia
| Campo | Descripción |
|---|---|
| Cédula del Responsable | CI del padre, madre o representante |
| Correo | Donde llegará el comprobante de recepción |
| Mes a Pagar | Mes de la mensualidad (enero–diciembre) |
| Monto | Cantidad pagada en la divisa acordada |
| Método de Pago | Pago Móvil / Transferencia / Efectivo / Zelle |
| Referencia | Últimos 4–6 dígitos del comprobante bancario |
/admin-estudiantes.Verificar y actualizar solvencia — vista del admin
Flujo de conciliación
- El representante reporta el pago en
/pagos. El registro llega al Google Sheet de tesorería. - El admin o tesorero abre el Google Sheet y verifica el pago contra los extractos bancarios.
- Si el pago es válido, abre
/admin-estudiantes, busca al alumno por nombre o cédula del representante. - En la columna Solvencia, presiona el botón del alumno para cambiar de Bloqueado a Solvente.
- El cambio es inmediato. El alumno puede pasar por la portería desde ese instante.
Corte mensual — bloquear alumnos morosos
- Al inicio del mes, el tesorero identifica en el Google Sheet qué representantes no pagaron el mes anterior.
- En
/admin-estudiantes, filtra los alumnos de ese mes (o busca por nombre) y cambia su solvencia a Bloqueado. - Al pasar por la portería, el kiosco mostrará "ACCESO BLOQUEADO" y el semáforo rojo.
- El operador dirige al alumno a secretaría para regularizar su situación.
asistencias_estudiantes como tipo BLOQUEADO. Esta información es visible en el reporte de portería del dashboard administrativo.Resumen del ciclo pago → acceso
/pagos/admin-estudiantesChecklist de inicio de año escolar
- ☐ Opción A — Importar: descargar plantilla → enviar al colegio → importar .xlsx
- ☐ Opción B — Manual: registrar uno a uno con Nuevo Estudiante
- ☐ Verificar nombre completo sin errores tipográficos
- ☐ Cargar foto de cada alumno (webcam o archivo)
- ☐ Registrar email del representante para OTP y notificaciones
- ☐ Verificar que alumnos sin CI tienen C.E. MPPE asignada (provisional o definitiva)
- ☐ Marcar todos como activo: true y solvente
- ☐ Verificar datos institucionales en Configuración antes de imprimir
- ☐ Imprimir carnets por grado y sección
- ☐ Verificar que el QR de cada carnet lee correctamente
- ☐ Laminar los carnets
- ☐ Generar ficha QR para cada aula/laboratorio
- ☐ Colocar QR en la pared de cada salón y probar escaneo