Initial commit

ADMIN.md

@@ -0,0 +1,58 @@
+# Manual Admin Empresa
+
+## Objetivo
+Gestionar mediciones de clima laboral, participantes y reportes de su empresa.
+
+## Acceso
+1) Ingresar con rol **admin** en la pantalla de Login.
+2) Indicar `company_code` asignado por superadmin.
+
+## Funciones principales
+- Crear periodos de medición.
+- Activar y cerrar mediciones.
+- Ver dashboard de resultados.
+- Importar participantes desde Excel.
+- Descargar reportes PDF y Excel.
+
+## Crear una medición
+1) Ir a **Mediciones**.
+2) Completar año, mes y fechas.
+3) Al crear la medición se genera el snapshot de preguntas.
+
+## Activar una medición
+- En el listado de mediciones, presionar **Activar**.
+
+## Cerrar una medición (cálculo automático)
+- En el listado de mediciones, presionar **Cerrar**.
+- El sistema calcula automáticamente:
+  - Promedio por pregunta.
+  - Promedio por dimensión.
+  - Índice global.
+  - Tasa de participación.
+  - Clasificación Bajo/Medio/Alto.
+
+## Importación de usuarios
+- Ir a **Importar**.
+- Usar plantilla con columnas:
+  1) Nombre
+  2) Email
+  3) Departamento
+  4) Cargo
+- El sistema valida y reporta errores por fila.
+ 
+## Importación de admins
+No aplica. En Fase 1 solo existe **un admin principal por empresa** y se crea automáticamente desde el Superadmin al provisionar la compañía, para evitar inconsistencias y garantizar el aislamiento por tenant.
+
+## Reportes
+- PDF: `GET /reports/pdf/:surveyPeriodId`
+- Excel: `GET /reports/excel/:surveyPeriodId`
+
+## Dashboard
+- Índice global actual
+- Resultado por dimensión
+- Histórico por periodo
+- Avance de encuestas (registrados, 100% completadas, <100%)
+
+## Consideraciones
+- Las preguntas no se editan en Fase 1.
+- Cada medición queda vinculada al snapshot de preguntas del periodo.