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:

Registrar
Crear ficha
en el sistema
Generar e
imprimir carnet
Imprimir QR
para cada salón
Pago
Representante
reporta pago
Solvencia
Admin confirma
y da acceso
MóduloURLQuién lo usaAcción principal
Gestión de Estudiantes/admin-estudiantesSecretaría / AdminCRUD completo de alumnos
Carnets/carnetsSecretaríaGenerar e imprimir carnets MPPE
QRs de Aula/gestion-salonesAdmin / CoordinaciónImprimir ficha QR por salón
Pagos/pagosRepresentanteReportar 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.

1

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.

Gestión de Estudiantes ← Dashboard
247
Total
142
Primaria
105
Bachillerato
128
Masculino
119
Femenino
FotoNombreCédulaC.E. MPPENivelGradoSecciónSexoRepresentanteSolvenciaAcciones
Álvarez, Pedro 28.441.203 V1150523456 Bachillerato 4to AñoB Masc. María Álvarez
m.alv@gmail.com
Briceño, Valentina 29.112.780 Primaria 3er GradoA Fem. Juan Briceño
j.bri@hotmail.com
La tabla se actualiza en tiempo real. Solvente = ✓ verde; Bloqueado = ✗ rojo.
ColumnaDescripción
FotoMiniatura circular. Si no tiene foto se muestra el ícono de usuario.
C.E. MPPECédula Escolar generada con el algoritmo MPPE (ver sección 5).
SolvenciaBotón interactivo. Verde = acceso permitido en portería. Rojo = bloqueado en portería.
Acciones✏️ Editar · 🪪 Ver carnet individual · 🗑️ Eliminar
2

Búsqueda y filtros

Los cuatro controles de la barra de herramientas filtran la tabla al instante, sin recargar datos:

ControlFiltra por
Campo de búsquedaNombre completo o número de cédula (parcial o completo)
NivelInicial / Preescolar · Primaria · Bachillerato
GradoSe actualiza automáticamente según el nivel seleccionado
SexoMasculino / Femenino / Ambos
Los filtros se combinan. Puedes buscar, por ejemplo, "todas las alumnas de 4to Año Bachillerato sección B".
3

Crear un nuevo estudiante

  1. Presiona el botón verde + Nuevo Estudiante en la barra de herramientas.
  2. Se abre el formulario modal. Completa los datos en el siguiente orden: foto → datos personales → datos académicos → representante → Cédula Escolar MPPE.
  3. Los campos marcados con * son obligatorios: Nombre, Cédula, Sexo, Nivel y Grado.
  4. Presiona Guardar. El sistema verifica que la cédula no esté duplicada antes de guardar.
  5. El nuevo alumno aparece en la tabla al instante gracias al listener en tiempo real.

Nuevo Estudiante

Abrir cámara
Subir foto
Foto circular recortada automáticamente.
Webcam o archivo JPG/PNG.
Nombre completo *
García Martínez, Ana Sofía
Cédula *
28441203
Sexo *
Femenino
Fecha de nacimiento
2009-03-15
Año escolar
2025-2026
Nivel *
Bachillerato
Grado *
3er Año
Sección *
B
Nombre del representante
García, Carmen
Email del representante
cgarcia@gmail.com
Cancelar
Guardar
Formulario completo. El grado se actualiza automáticamente al seleccionar el nivel.
El email del representante es fundamental: es la dirección donde llegarán los códigos OTP del portal del alumno y las notificaciones de entrada/salida de la portería.
4

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étodoPasosMejor 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.
La foto se comprime a JPEG con calidad 0.7. Fotos muy grandes (> 2MB) se reducirán automáticamente. Si el documento Firestore supera 1MB, considera subir la imagen a Firebase Storage y guardar solo la URL.
5

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

V o E  +  [Orden nacimiento]  +  [2 últimas cifras del año de nac.]  +  [CI de la madre, 8 dígitos con ceros iniciales]
CampoEjemploResultado en C.E.
NacionalidadVenezolanoV
Orden de nacimiento1er hijo1
Año de nacimiento (2 dígitos)201515
C.I. de la madre (8 dígitos)5.123.456 → 0512345605123456
Cédula Escolar resultanteV11505123456

Cómo generarla en el formulario

  1. En el formulario de nuevo/editar estudiante, baja hasta la sección Cédula Escolar MPPE.
  2. Selecciona la Nacionalidad (V o E).
  3. Ingresa el Orden de nacimiento (1 si es el primer hijo, 2 si es el segundo, etc.).
  4. La Fecha de nacimiento ya debe estar completada — el sistema la toma de ese campo.
  5. Ingresa la C.I. de la madre sin puntos ni guiones (máximo 8 dígitos).
  6. Presiona el botón azul Generar. El campo "Cédula Escolar generada" se llena automáticamente.
  7. Guarda el formulario — la C.E. queda almacenada en el campo cedulaEscolar de Firestore.
Cédula Escolar MPPE Formato: V/E + Orden nac. + Año nac.(2d) + CI Madre(8d)
Nacionalidad
V — Venezolano/a
Orden de nacimiento
1
CI de la madre
5123456
C.E. generada
V11505123456
Generar
La C.E. generada aparece en la tabla principal y en el carnet del alumno.
Si la madre no tiene C.I. venezolana (extranjera), usa sus 8 dígitos de pasaporte o documento extranjero con ceros a la izquierda. Consulta al MPPE en caso de duda sobre el formato oficial.
6

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.

Al editar, puedes cambiar la foto tomando una nueva con webcam o subiendo un archivo. La foto anterior se reemplaza.

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.

Eliminar un alumno no borra sus registros de asistencia ni sus notas en colecciones independientes. Si solo quieres que deje de aparecer en el sistema sin perder el historial, cambia el campo 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.

7

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.

Estado: SOLVENTE

Acceso permitido en portería.
Semáforo verde al escanear carnet.
Campo solvente: true en Firestore.

Estado: BLOQUEADO

Acceso denegado en portería.
Semáforo rojo con "ALUMNO BLOQUEADO".
Campo solvente: false en Firestore.

Cambiar el estado de solvencia

  1. En la columna "Solvencia" de la tabla, el botón muestra el estado actual del alumno.
  2. Presiona el botón. Aparece una ventana de confirmación con el nombre del alumno y la acción (BLOQUEAR o SOLVENTAR).
  3. Confirma. El campo solvente se actualiza en Firestore al instante.
  4. El cambio es efectivo de inmediato en la portería — no hay que reiniciar el kiosco.
Un alumno recién creado no tiene el campo 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.

A

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

  1. Ve a Admin → Gestión de Estudiantes.
  2. En la barra de herramientas, haz clic en el botón verde oscuro Descargar Plantilla.
  3. Se descarga el archivo EnClase_Plantilla_Estudiantes.xlsx.
  4. Envíalo al colegio por correo o WhatsApp para que lo complete.
Descargar Plantilla
Importar
Carnets
Nuevo
Barra de herramientas con los botones de importación.

Columnas de la plantilla

Columna Tipo Descripción
nombreOBLIGATORIOPrimer y segundo nombre del alumno
apellidoOBLIGATORIOApellidos del alumno
cedulaRECOMENDADOCédula nacional. Si el menor aún no tiene, déjala vacía — el sistema generará la C.E. MPPE como identificador provisional
sexoOBLIGATORIOM o F — usar el menú desplegable
nivelOBLIGATORIOpreescolar, primaria o bachillerato
gradoOBLIGATORIOEj: Maternal, Preescolar I, 1er Grado, 4to Año — usar el menú desplegable
seccionOBLIGATORIOA, B, C, D o E
fecha_nacimientoPARA C.E. MPPEFormato AAAA-MM-DD. Necesaria para generar la cédula provisional
orden_nacimientoPARA C.E. MPPE¿Es el 1er, 2do, 3er hijo de la madre?
ci_madrePARA C.E. MPPECédula de la madre, solo dígitos, máximo 8
nombre_representanteOPCIONALNombre completo del representante
email_representanteOPCIONALCorreo del representante — necesario para OTP y pagos
telefono_representanteOPCIONALTeléfono con código de área
La plantilla tiene menús desplegables en las columnas de Sexo, Nivel, Grado y Sección. Pide al colegio que los use — evitan errores de tipeo que bloquean la importación.
No modificar los encabezados ni el nombre de las hojas del archivo. El importador los busca exactamente como están.
B

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

  1. En Gestión de Estudiantes, haz clic en el botón índigo Importar.
  2. Arrastra el archivo .xlsx a la zona de carga, o haz clic para buscarlo en tu computadora.
  3. El sistema lee el archivo y muestra la vista previa con todos los alumnos detectados.
  4. Revisa los estados: ✅ listo, ⚠️ con aviso, ❌ con error.
  5. Haz clic en Importar (N) para confirmar. Solo se importan los registros sin error ❌.
  6. Al terminar, aparece el total importado. Cierra el modal — la tabla se actualiza automáticamente.

Significado de cada estado

EstadoSignificado¿Se importa?
Listo Todos los campos obligatorios están completos y válidos. Cédula nacional presente.
⚠️ 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
✅ 48 listos ⚠️ 32 con aviso ❌ 3 con error · Se importarán 80 de 83
Estado Nombre Cédula Nivel · Grado · Secc. Aviso
María V. Aguilar 30512345 Primaria · 1er Grado · A
⚠️ Owen G. González ⚡ V11505123456 Primaria · 1er Grado · A · Usará C.E. MPPE provisional
Liam J. Otaiza Sin cédula ✗ Grado inválido
Vista previa antes de confirmar la importación.
Los registros ❌ con error no se importan, pero los ✅ y ⚠️ sí. Después de importar puedes corregir los erróneos directamente en el Excel y volver a importar — los duplicados se detectan automáticamente.
C

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ónResultado
✅ 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:

FUNCIONA
  • 🪪 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
PENDIENTE
  • 🪪 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

  1. En la tabla de estudiantes, busca el alumno por nombre.
  2. Haz clic en el botón de edición .
  3. En el campo Cédula, ingresa la cédula nacional definitiva.
  4. Guarda. El campo cedulaProvisional se borra y el alumno queda con su CI definitiva.
La Cédula Escolar MPPE queda siempre guardada en el campo 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.

8

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

FiltroOpcionesUso típico
NivelTodos / Inicial / Primaria / BachilleratoSeparar sección por nivel educativo
Grado / AñoSe llena según el nivelImprimir todos los carnets de un año específico
SecciónTexto 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

Anverso
GARCÍA MARTÍNEZ,
ANA SOFÍA
C.I.V- 28.441.203
F.N.15/03/2009
Grado3er Año · Sección B
Educación Media
Año Escolar: 2025-2026
Reverso
logo
UNIDAD EDUCATIVA
Inscrito en el M.P.P.E · PD 123456
SELLO
Lic. Nombre Director
Director(a)
ElementoOrigen de datos
Logo y nombre de la instituciónColección config/institucion (Configuración Institucional)
Código Plantel (PD) y RIFconfig/institucion.codPlantel y .rif
Nombre, C.I., grado, foto del alumnoColección estudiantes
QR del reversoEncode de la cédula del alumno (lo que lee el kiosco de portería)
Nombre y cargo del director, contactoconfig/institucion.director, .cargo, .telefono, .email
Si los datos institucionales (director, teléfono, dirección) están vacíos, el reverso mostrará guiones. Completa la Configuración Institucional antes de imprimir carnets en producción.
9

Imprimir y laminar

Opciones de impresión

BotónQué imprimeCó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

  1. Filtra por grado y sección.
  2. Presiona Imprimir todos. El diálogo de impresión del navegador se abre.
  3. Selecciona tamaño A4, orientación vertical, sin márgenes.
  4. Imprime en cartulina o papel fotográfico si es posible.
  5. Corta cada carnet (el anverso y reverso están lado a lado).
  6. Lamina para protección. Dimensiones del carnet: aprox. 5.5 cm × 8.7 cm (tamaño CR80 estándar).
Imprime siempre una hoja de prueba antes del lote completo para verificar que el QR se escanea correctamente. El QR contiene la cédula del alumno y es lo que usa el kiosco de portería.

📋

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.

10

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.

El QR está integrado al salón El QR se genera a partir del nombre exacto del salón registrado en Firestore. Esto garantiza que el QR siempre coincide con el identificador usado en los horarios.

Generar e imprimir la ficha QR

  1. 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).
  2. 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.
  3. Verificar que el nombre del aula en la ficha coincide exactamente con el del horario.
  4. Presionar Imprimir Ficha. El diálogo de impresión mostrará solo la ficha.
🛠️ Configurar Etiqueta
Ingrese el nombre exacto del aula tal como aparece en el horario.
Identificador del Aula
2-3
Generar Etiqueta
Imprimir Ficha
Panel izquierdo: configuración del generador
Punto de Control
Registro de Asistencia
AULA 2-3
Docentes y estudiantes: escanea para registrar tu asistencia.
Vista previa de la ficha impresa

¿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.

El nombre del salón en el QR debe coincidir exactamente (incluyendo mayúsculas) con el campo aula en la colección horarios. Si hay discrepancia, el sistema no encontrará la clase activa y mostrará "Sin clase activa".
11

Dónde y cómo colocar el QR

  1. Imprime la ficha en papel tamaño carta o A4. Para mayor durabilidad, usa papel de 90 g/m² o superior.
  2. Lamina la ficha o cúbrela con contact transparente para protegerla de la humedad y el desgaste.
  3. 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.
  4. Verifica que el QR se puede escanear desde al menos 30 cm de distancia con la cámara del teléfono.
  5. Si el aula tiene mala iluminación, considera usar papel brillante para mejor contraste.
EspacioID sugeridoEjemplo de URL
Aula numerada1-1, 2-3, 3-5/aula?id=2-3
LaboratorioLAB-A, LAB-BIO/aula?id=LAB-A
BibliotecaBIBLIOTECA/aula?id=BIBLIOTECA
Sala de informáticaINFORMATICA/aula?id=INFORMATICA
Genera una ficha de prueba y escanéala con el teléfono antes de pegarla en la pared. Confirma que lleva al aula correcta y que la clase del horario aparece bien.

💰

Pagos y Solvencia

El módulo de pagos recibe reportes de comprobantes de los representantes. El admin verifica y actualiza la solvencia manualmente.

12

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

Cédula del Responsable
12.345.678
Nombre Completo
García, Carmen Luisa
Correo (para recibir comprobante)
cgarcia@gmail.com
Mes a Pagar
Junio
Monto
$45.00
Método de Pago
Pago Móvil
Referencia / Comprobante
1234
Registrar Pago
El formulario envía los datos a Google Sheets vía Apps Script para su registro y conciliación.
CampoDescripción
Cédula del ResponsableCI del padre, madre o representante
CorreoDonde llegará el comprobante de recepción
Mes a PagarMes de la mensualidad (enero–diciembre)
MontoCantidad pagada en la divisa acordada
Método de PagoPago Móvil / Transferencia / Efectivo / Zelle
ReferenciaÚltimos 4–6 dígitos del comprobante bancario
El registro se envía a un Google Sheet vía Apps Script. La solvencia no se actualiza automáticamente — el administrador debe verificar el pago en el Google Sheet y luego cambiar el estado manualmente en /admin-estudiantes.
13

Verificar y actualizar solvencia — vista del admin

Flujo de conciliación

  1. El representante reporta el pago en /pagos. El registro llega al Google Sheet de tesorería.
  2. El admin o tesorero abre el Google Sheet y verifica el pago contra los extractos bancarios.
  3. Si el pago es válido, abre /admin-estudiantes, busca al alumno por nombre o cédula del representante.
  4. En la columna Solvencia, presiona el botón del alumno para cambiar de Bloqueado a Solvente.
  5. El cambio es inmediato. El alumno puede pasar por la portería desde ese instante.

Corte mensual — bloquear alumnos morosos

  1. Al inicio del mes, el tesorero identifica en el Google Sheet qué representantes no pagaron el mes anterior.
  2. En /admin-estudiantes, filtra los alumnos de ese mes (o busca por nombre) y cambia su solvencia a Bloqueado.
  3. Al pasar por la portería, el kiosco mostrará "ACCESO BLOQUEADO" y el semáforo rojo.
  4. El operador dirige al alumno a secretaría para regularizar su situación.
Un alumno bloqueado queda registrado en asistencias_estudiantes como tipo BLOQUEADO. Esta información es visible en el reporte de portería del dashboard administrativo.

Resumen del ciclo pago → acceso

📱
Representante
Reporta pago en /pagos
📊
Tesorero
Verifica en Google Sheet
Admin
Marca solvente en /admin-estudiantes
🏫
Alumno
Accede sin problemas en portería

Checklist de inicio de año escolar

Registro de alumnos
  • 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
Carnets y QR
  • ☐ 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