DataLab · Bienestar

Vistas principales 2 Dashboard y carga operativa.

Filtros visibles 4 Semestre, facultad, programa y tipo de documento.

Visualizaciones 5 + tabla Gráficas con acciones de PNG, tabla, Excel, tema y fullscreen.

Formato de carga .xlsx /.xls Con validación, historial y certificado PDF.

Ruta de datos `bienestar` Lee ciclos desde `DataLab/ciclos_de_carga/bienestar`.

Alcance actual Participación En convocatorias y beneficios de Bienestar Universitario.

Propósito y alcance actual

El dashboard de Bienestar está construido para analizar la participación de estudiantes en convocatorias de Bienestar Universitario usando semestre, convocatoria, programa, facultad y tipo de documento como ejes de lectura. En la implementación actual, el relato del módulo se enfoca especialmente en el programa Bien-Estar Contigo y en los apoyos socioeconómicos relacionados con permanencia y bienestar integral.

El módulo no es solo una vitrina gráfica: también incluye una vista de carga con control de periodo, carga de Excel, validación de columnas, construcción de informe PDF, almacenamiento del archivo original y trazabilidad de entregas por fecha, autor y estado.

Rutas oficiales

/datalab/bienestar para el dashboard del módulo.
/datalab/bienestar/cargar para la carga operativa.
/documentacion/datalab/modulos/bienestar para esta ficha documental.

Si se comparte el módulo con usuarios de consulta, la ruta pública correcta es la del dashboard. La ruta de carga debe reservarse para responsables operativos o técnicos.

Fuente y modelo de datos

La fuente principal del dashboard se lee desde DataLab/ciclos_de_carga/bienestar en Realtime Database.
El dashboard consolida todos los ciclos disponibles y admite estructuras guardadas como registros, bienestarContigo o registrosBienestar.
Los campos operativos realmente usados para filtrar y visualizar son: semestre, convocatoria, tipo de documento, número de documento, programa y facultad.
La tabla de detalle y varias exportaciones se construyen directamente con el filtrado aplicado sobre esos campos.

KPIs y reglas de lectura

Beneficios entregados cuenta el total de registros filtrados; no deduplica estudiantes.
Programas cuenta programas distintos con participación en el conjunto filtrado.
Facultades cuenta facultades distintas con estudiantes beneficiarios.
El semestre visible se define con un slider de selección simple, inicializado por defecto en el semestre más reciente disponible.
La gráfica histórica por semestre se mantiene sin recorte por semestre para no romper la serie comparativa.

El código ya calcula estudiantes únicos a partir de Número documento, pero ese conteo no está expuesto como KPI visible en la versión actual del dashboard.

Filtros disponibles y efecto funcional

Filtro	Estado actual	Efecto principal	Observaciones
Semestre	Visible	Aplica a KPIs, programas, facultades, top programas y tabla de detalle.	La serie por semestre y la gráfica por convocatoria conservan comportamiento histórico.
Convocatoria	Campo activo, selector oculto	Se refleja en resumen y en la visualización específica por convocatoria.	Existe en los datos, pero hoy no se expone como select visible en el panel lateral.
Facultad	Visible	Acota todos los análisis de participación y la tabla filtrada.	Es clave para comparar distribución institucional.
Programa	Visible	Permite focalizar el módulo por programa académico.	Se usa en gráficas de distribución y top participación.
Tipo de documento	Visible	Filtra los registros según tipología documental cargada.	Hoy el selector incluye al menos `CC` y `TI`, pero puede ampliarse según datos reales.

Visualizaciones, tabla y acciones disponibles

Vista	Qué muestra	Consideraciones	Acciones
Estudiantes registrados por semestre	Evolución histórica de participación por semestre.	Se calcula sin recorte por semestre para mantener la serie completa.	PNG, ver datos, pantalla completa, Excel y cambio de tema.
Registros por convocatoria	Distribución de registros por convocatoria de bienestar.	Respeta facultad, programa y tipo de documento; sirve para comparar convocatorias entre sí.	PNG, ver datos, pantalla completa, Excel y cambio de tema.
Estudiantes por programa	Participación agregada por programa académico.	Se apoya en el subconjunto filtrado por semestre y demás filtros visibles.	PNG, ver datos, pantalla completa, Excel y cambio de tema.
Estudiantes por facultad	Distribución agregada por facultad.	Útil para lectura institucional y contraste entre unidades académicas.	PNG, ver datos, pantalla completa, Excel y cambio de tema.
Programas con mayor participación por convocatoria	Ranking de programas más activos dentro del filtro vigente.	Funciona como lectura comparativa rápida de participación relativa.	PNG, ver datos, pantalla completa, Excel y cambio de tema.
Detalle de registros filtrados	Tabla con semestre, convocatoria, programa, facultad y tipo de documento.	Incluye paginación y selector de filas; el Excel solo se habilita si hay resultados.	Exportación a `detalle_convocatorias_bienestar.xlsx`.

Vista de carga: qué hace realmente

Controla si existe un periodo de carga activo y muestra fecha de cierre y estado del periodo.
Permite seleccionar o arrastrar un archivo Excel para el semestre vigente.
Valida formato, nombre de hoja, columnas mínimas y presencia de registros.
Genera un informe PDF de respaldo con resumen por semestre, facultad y programa.
Sube a Storage tanto el archivo original como el certificado PDF.
Registra autor, fecha, aprobación y código de verificación en el historial del módulo.

Especificación mínima del Excel

Elemento	Valor esperado	Uso funcional
Nombre de hoja	`bienestarContigo`	Si la hoja no existe, la carga se rechaza.
Formato de archivo	`.xlsx` o `.xls`	Otros formatos se consideran inválidos.
Columnas exactas	`Semestre`, `Convocatoria`, `Tipo documento`, `Número documento`, `Programa`, `Facultad`	Los nombres deben coincidir exactamente con la primera fila del archivo.

Flujo operativo de carga y trazabilidad

El usuario autenticado selecciona un archivo válido para el ciclo activo.
El sistema verifica extensión, hoja bienestarContigo, encabezados y registros disponibles.
Si la validación pasa, los registros se guardan en el ciclo activo de DataLab/ciclos_de_carga/bienestar/{ciclo}.
La entrega se marca como entregado y se registra la fecha de entrega del ciclo.
Se genera un informe PDF, se construye un código de verificación y se envían archivo y certificado a Storage.
El historial de carga se actualiza en DataLab/ciclos_de_carga/bienestar/historial_carga/{fecha} con autor, aprobación, URLs y código de verificación.
La vista muestra historial descargable con fecha, semestre, autor, estado, archivo y certificado.

La entrega puede anularse: el sistema limpia el registro del historial, elimina los archivos asociados en Storage y devuelve el ciclo al estado pendiente.

Qué validar antes de publicar un ciclo

Que el semestre y la convocatoria del archivo correspondan al periodo que realmente se quiere reportar.
Que no existan columnas mal nombradas ni variaciones en acentos, espacios o mayúsculas del encabezado.
Que programa y facultad sigan una nomenclatura consistente para no fragmentar conteos.
Que el archivo no mezcle periodos distintos salvo que ese sea el objetivo explícito del ciclo.
Que el resumen por semestre, programa y facultad del PDF sea razonable frente a la fuente original.

Consideraciones funcionales importantes

El KPI principal visible expresa registros o beneficios, no personas únicas.
El módulo depende de buena calidad en programa, facultad y documento para filtrar y deduplicar correctamente.
La gráfica por convocatoria y la serie histórica no deben interpretarse como cortes estrictos del semestre activo.
La documentación del módulo debe mantenerse alineada con cualquier cambio en carga, campos o semántica del dashboard.
Si cambia la fuente o se amplía el alcance más allá de Bien-Estar Contigo, esta ficha debe actualizar alcance, filtros y definiciones.

Checklist para mantener esta ficha al día

Actualizar la descripción funcional si cambian el objetivo del tablero o el programa principal analizado.
Registrar nuevas columnas si el Excel de carga evoluciona.
Documentar cualquier KPI nuevo o cualquier cambio en su regla de cálculo.
Refrescar la tabla de visualizaciones cuando aparezcan nuevas gráficas o acciones de exportación.
Revisar que rutas, botones y ayuda contextual sigan apuntando al módulo correcto.