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

This commit is contained in:
2026-03-03 22:54:06 -05:00
parent 1592434192
commit 87f52777c4
21 changed files with 1575 additions and 263 deletions
+80
View File
@@ -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
+12
View File
@@ -51,6 +51,11 @@ Proyecto en `/var/www/react/clima_laboral` con backend Node/Express y frontend R
- User: `usuario.prueba@demo.com` / `Usuario2026!`
- Question sets en DB `P123456`: `QSET-DEFAULT`, `QSET-20260303-03`, `QSET-20260303-04`, `QSET-20260303-05` (algunos activos/inactivos).
## Credenciales (recordatorio)
- Superadmin: `superadmin@demo.com` / `SuperAdmin2026`
- Admin: `admin.prueba@demo.com` / `Admin2026!` (company_code: `123456`)
- User: `usuario.prueba@demo.com` / `Usuario2026!` (company_code: `123456`)
## Problemas frecuentes
- Si “Versiones de Encuesta” sale vacío, es porque no se entró con `company_code` (usar Superadmin > Empresas > Acceder).
- Si `/admin/dimensions` da 404, reiniciar backend para cargar rutas nuevas.
@@ -60,6 +65,13 @@ Proyecto en `/var/www/react/clima_laboral` con backend Node/Express y frontend R
- Sugerencia de nombre de set corregida para usar máximo existente + 1.
- Vista Editar Set agregada con lista de preguntas y edición.
- Popup 404 silenciado para `/admin/dimensions`.
- Repo Git creado y primer commit limpio (sin node_modules ni token).
## Git / Repo
- Gitea: `https://gitea.linkedcorp.net/`
- Repo: `mgonzalez/claboral.linkedcorp.net`
- Rama: `main`
- Remote: `origin`
## Pendientes
- A gusto del usuario, agregar etiqueta “Escala 1–5” visible en encuestas/preguntas.