Portal de padres
Vista pública en /portal/:publicId para que las familias consulten una boleta publicada sin iniciar sesión en Droka OS.
El portal de padres es una página independiente donde la familia ve la boleta publicada de su hijo o hija. No necesita usuario ni contraseña de staff: el acceso se valida con el enlace seguro que usted comparte al publicar la boleta.
Solo muestra boletas en estado publicado. Borradores, notas de progreso del expediente y otros documentos administrativos no aparecen aquí.
Cómo funciona el enlace
Recibir el enlace
El coach o administración envía una URL con esta forma:
https://{su-dominio}/portal/{publicId}#{secreto}
El publicId identifica la boleta (prefijo rpc_). El secreto va en el fragmento después de # y no se envía al servidor en la barra de direcciones inicial de forma persistente tras la validación.
Validación automática
Al abrir el enlace, el navegador resuelve el secreto contra /api/parent-portal/resolve. Si es válido, se crea una sesión de portal temporal y el hash se limpia de la barra de direcciones.
Ver la boleta
La familia ve período, nombre del estudiante, fechas, secciones con calificaciones, notas por bloque y comentarios generales. Si es boleta de competencia, también el nombre del evento.
Descargar PDF
Botón Descargar PDF abre el documento en una nueva pestaña usando la sesión del portal (sin login de academia).
Qué ve la familia
| Bloque | Contenido |
|---|---|
| Encabezado | Marca Droka OS y nombre de la academia |
| Título | Etiqueta del período (ej. trimestre o evento) |
| Estudiante | Nombre completo |
| Fechas | Rango periodStart — periodEnd formateado |
| Competencia | Solo si reportType === competition y hay nombre |
| Disciplinas | Secciones de la plantilla en solo lectura, con escalas y notas |
| Notas generales | Comentarios del coach si se incluyeron al publicar |
| Descarga de la misma información en formato imprimible |
El portal detecta el idioma del navegador (español o inglés) para etiquetas de interfaz. El contenido de la boleta es el que cargó el staff al crearla.
Seguridad y vigencia
| Tema | Comportamiento |
|---|---|
| Sin auth de staff | No pide correo ni contraseña de Droka OS |
| Enlace revocable | Regenerar link en staff invalida enlaces anteriores |
| Expiración | 90 días desde publicación o última regeneración |
| Enlace incompleto | Sin publicId o sin secreto válido → mensaje de enlace inválido o expirado |
| Sesión | Tras resolver, la vista usa /api/parent-portal/session |
No reenvíe enlaces por canales públicos. Trátelos como credenciales de un solo uso prolongado: quien tenga la URL completa puede ver la boleta hasta que expire o se regenere.
Qué NO es el portal
Notas de progreso
Actualizaciones informales coach → padres en el expediente. Canal distinto, sin publicación formal.
Boleta en borrador
Solo visible para staff hasta que publique y genere el enlace.
Problemas frecuentes
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| «Enlace inválido» | URL truncada o sin #secreto | Vuelva a copiar el enlace completo desde la boleta publicada |
| «Expirado o revocado» | Pasaron 90 días o se regeneró el link | Pida al staff un enlace nuevo con Regenerar link |
| Página en blanco tras abrir | Secreto ya consumido y sesión caducada | Abra de nuevo el enlace original que recibió |
| No ve cambios recientes | Boleta no republicada | Los borradores no se reflejan; debe publicarse una boleta nueva o el flujo de edición previo a publicar |
Checklist (para staff al orientar padres)
- La boleta está publicada, no en borrador
- Compartí la URL completa con el fragmento
# - Confirmé que el enlace no expiró
- Expliqué que pueden descargar PDF desde el mismo portal
- Aclaré que este enlace es solo para la boleta formal, no para notas de progreso
Siguiente paso
Si aún no creó la evaluación, comience en Crear boleta. Si el enlace falla tras publicar, revise Publicar boleta y la sección de regeneración.