feat(ui): migrate to Tailwind UI and add result matrix tooling

2026-03-03 22:54:06 -05:00
parent 1592434192
commit 87f52777c4
21 changed files with 1575 additions and 263 deletions
@@ -0,0 +1,80 @@
+# Método de presentación de resultados (basado en Rankmi) y adaptación al sistema
+
+Este documento describe **cómo trabajar los resultados** de la encuesta de clima laboral en el sistema, **sin cambiar el contenido de la lista de preguntas actual**. Se toma como guía el enfoque de Rankmi de “7 pasos” y se adapta a nuestro flujo y módulos existentes. citeturn0search0
+
+## Principios base
+
+- La comunicación de resultados debe ir **de lo general a lo específico** y con lenguaje constructivo (enfoque “sándwich”). citeturn0search0
+- Siempre presentar **participación**, **resultados globales**, **ranking de mejores/peores**, y **prioridades de acción**. citeturn0search0
+- Los reportes deben ser **agregados** (sin identificación individual) y con **mínimos de respuestas** si aplica. citeturn0search2turn0search5
+
+## 7 pasos (Rankmi) — cómo se aplica en nuestro sistema
+
+1) **Agradecer**  
+   - Mensaje breve al cerrar la medición.
+   - En PDF: incluir un párrafo de agradecimiento.
+   citeturn0search0
+
+2) **Recordar objetivos de la encuesta**  
+   - Sección fija en el PDF y en el dashboard (texto corto).
+   citeturn0search0
+
+3) **Informar participación**  
+   - Usar cálculo automático ya implementado (tasa de participación).
+   - Mostrar en dashboard y PDF.
+   citeturn0search0
+
+4) **Resumen del proceso / histórico**  
+   - Mostrar comparativo con medición anterior (si existe).
+   - En PDF: bloque “Histórico y acciones previas”.
+   citeturn0search0
+
+5) **Resultados generales**  
+   - Índice global, promedio por dimensión, clasificación (Bajo/Medio/Alto).
+   - Se explica brevemente cómo se calculó (promedios).
+   citeturn0search0
+
+6) **Mejor y peor evaluado**  
+   - Ranking de dimensiones y/o subvariables.
+   - En PDF: “Top fortalezas” y “Principales oportunidades”.
+   citeturn0search0
+
+7) **Prioridades / plan de acción**  
+   - En PDF: listado de 3–5 prioridades sugeridas según resultados.
+   - Deben ser medibles y trazables.
+   citeturn0search0
+
+## Qué NO se cambia
+
+- **La lista de preguntas actual permanece igual**.
+- Solo cambia la forma de **presentar y modelar resultados**.
+
+## Cómo quedamos en el sistema (Fase 1)
+
+- Resultados automáticos:
+  - Promedios por pregunta, dimensión, global.
+  - Clasificación Bajo/Medio/Alto.
+  - Tasa de participación.
+- Reportes:
+  - PDF con logo, código de medición, resumen ejecutivo, resultados por dimensión, históricos.
+  - Excel con crudos + consolidados.
+
+## Estructura de “Matriz” (modelo base)
+
+Se usa la tabla `climate_result_model` como plantilla editable:
+- **dimension** / **variable** / **subvariable**
+- **max_score** (por defecto 100)
+- **score_value** se llena solo cuando hay resultados (no visible en matriz de configuración).
+
+## Recomendación de flujo operativo
+
+1) Crear medición y activar encuesta.
+2) Cerrar medición (se calculan resultados).
+3) Revisar dashboard (global, dimensión, histórico).
+4) Generar PDF y Excel.
+5) Presentar resultados siguiendo los 7 pasos.
+
+## Nota sobre resultados por área (futuro)
+
+Rankmi recomienda visualización por área/jerarquía y mínimos de respuestas.  
+Podemos integrar en Fase 2 (si se requiere). citeturn0search1turn0search5