# Clima Laboral SaaS - Fase 1

## Resumen
Sistema SaaS multi-tenant con MariaDB (una base por empresa). Incluye superadmin, admin por empresa, participantes, encuestas fijas, cálculos automáticos, histórico, reportes PDF/Excel e importación de usuarios.

## Conexión MariaDB
Actualmente el acceso correcto es con `user_ia` en `192.168.222.20` (puerto 3306).

## Estructura
- `backend/` API Node.js + Express
- `frontend/` UI React + Vite
- `backend/src/sql/` scripts de base de datos

## Base de datos central
Archivo: `backend/src/sql/central_schema.sql`

Tablas:
- `superadmins`
- `companies` (datos de conexión de cada empresa)
  - `start_date` / `end_date` controlan vigencia de acceso por empresa

## Base de datos por empresa
Archivos:
- `backend/src/sql/tenant_schema.sql`
- `backend/src/sql/seed_questions.sql`

Tablas principales:
- `admins`, `users`, `survey_periods`, `dimensions`, `questions`, `survey_questions`, `responses`, `survey_results`

Preparación Fase 2:
- `scales`, `question_versions`, `question_weights`, `metric_definitions`, `survey_rules`

## Flujo del sistema
1. Superadmin crea empresa.
2. Se genera DB de empresa, se ejecuta schema + seed, se crea admin principal.
3. Admin crea medición (survey_period) y se genera snapshot en `survey_questions`.
4. Admin activa la medición.
5. Participantes responden.
6. Admin cierra la medición y se calculan resultados automáticamente.
7. Dashboard, histórico, PDF y Excel disponibles.

## Cálculos automáticos
- Promedio por pregunta, por dimensión y global.
- Conversión a escala 0-100: `(avg - 1) / 4 * 100`.
- Clasificación: 0-59 Bajo, 60-79 Medio, 80-100 Alto.
- Participación: participantes únicos / total usuarios activos.

## Endpoints principales
- `POST /auth/login`
- `GET /superadmin/companies`
- `POST /superadmin/companies`
- `GET /admin/survey-periods`
- `POST /admin/survey-periods`
- `PATCH /admin/survey-periods/:id/activate`
- `PATCH /admin/survey-periods/:id/close`
- `GET /admin/dashboard`
- `POST /admin/users/import`
- `GET /reports/pdf/:surveyPeriodId`
- `GET /reports/excel/:surveyPeriodId`
- `GET /surveys/active`
- `POST /surveys/responses`

## Importación de usuarios
Se espera un Excel con columnas:
1) Nombre
2) Email
3) Departamento
4) Cargo

## Banco de preguntas (Excel)
Exportación e importación desde Admin:
- Archivo Excel con columnas: `question_code`, `dimension_code`, `dimension_name`, `text`, `is_active`.
- Si cambia el texto de una pregunta con mismo `question_code`, se crea una nueva versión con fecha.
- Para cambios, exporta, edita y vuelve a importar.

## Versiones de encuesta
Cada set de preguntas genera un `question_set_code` con versión. Las mediciones se crean usando el set activo.
## Importación de admins
No aplica en Fase 1. Solo se permite un admin principal por empresa, creado por Superadmin al provisionar la compañía.

## Puesta en marcha (local)
1) Instalar dependencias en `backend/` y `frontend/`.
2) Crear base central con `central_schema.sql`.
3) Crear superadmin con `npm run seed:superadmin -- "Nombre" correo@dominio.com clave`.
4) Iniciar backend y frontend.

## Puertos y acceso
- Backend: `4020`
- Frontend: `5373`
- La UI consume la API usando la IP del host (no usa `localhost`).

## Nota
No se ejecutaron instalaciones por restricciones del entorno.