Publicar boleta
Publique un borrador de boleta, genere el enlace al portal de padres y descargue el PDF oficial.
Publicar congela el contenido de la boleta y entrega a la familia un enlace seguro al portal. Desde el detalle de la boleta (/report-cards/:id) puede publicar, copiar el link, regenerarlo si hace falta y descargar el PDF.
La publicación es un paso de un solo sentido para el contenido: una vez publicada, la boleta ya no se edita como borrador. Revise calificaciones y notas antes de confirmar.
Ruta rápida
Abrir el borrador
En Boletas (/report-cards) o en la pestaña Boletas del expediente, abra la boleta en estado Borrador (/report-cards/:id).
Publicar
Pulse Publicar y confirme en el diálogo. El sistema cambia el estado a Publicada, genera un token público con secreto en el hash de la URL y fija la expiración del enlace en 90 días.
Compartir con la familia
Copie el enlace al portal que aparece tras publicar. El formato es /portal/{publicId}#{secreto}.
El secreto viaja en el fragmento (#) de la URL; comparta el enlace completo tal como lo copia Droka.
Descargar PDF
Use Descargar PDF en el detalle de la boleta. El archivo se sirve en /api/report-cards/:id/pdf (requiere sesión de staff autenticada).
Enlace al portal
| Aspecto | Detalle |
|---|---|
| Ruta pública | /portal/:publicId con identificador prefijado rpc_ |
| Secreto | Hash en la URL (#...); sin él el portal no resuelve la sesión |
| Vigencia | 90 días desde la publicación o regeneración |
| Regenerar | Botón Regenerar link invalida el enlace anterior y emite uno nuevo con nuevo secreto |
| Vista familiar | Portal standalone sin login de staff; ver Portal de padres |
Si perdió el enlace recién generado, use Regenerar link en la boleta publicada. El enlace anterior deja de funcionar de inmediato.
PDF: staff vs portal
PDF para staff
En /report-cards/:id → Descargar PDF → /api/report-cards/:id/pdf con su sesión de academia.
PDF para padres
Dentro del portal publicado, la familia descarga el PDF con su propia sesión pública (sin cuenta Droka).
Flujo resumido
Borrador → Publicar → Enlace /portal/{id}#{secreto}
→ PDF staff (/api/report-cards/:id/pdf)
→ PDF portal (desde la vista pública)
Detalles
| Tema | Comportamiento |
|---|---|
| Solo borradores | El endpoint de publicación aplica únicamente si status === draft |
| Copiar enlace | Tras publicar, use Copiar link; el portapapeles recibe la URL completa con hash |
| Competencia | Si aplica, el nombre de competencia viaja al portal y al PDF |
| Notas de progreso | No se publican por este flujo; son un canal informal aparte en el expediente |
Checklist
- Releí toda la boleta en borrador antes de publicar
- Confirmé estudiante, plantilla y fechas del período
- Copié el enlace completo (incluido el
#y el secreto) - Probé el enlace en una ventana privada o dispositivo de la familia
- Descargué el PDF de respaldo para archivo interno si lo requiere su proceso
Siguiente paso
Explique a los padres qué verán al abrir el enlace en Portal de padres.