# Manual Superadmin

## Objetivo
Administrar la plataforma SaaS y crear empresas con su base de datos independiente.

## Acceso
1) Ingresar con rol **superadmin** en la pantalla de Login.
2) No requiere `company_code`.

## Funciones principales
- Crear empresas (provisionamiento automático de base de datos y admin principal).
- Crear múltiples administradores por empresa.
- Activar o suspender empresas.
- Definir fecha de inicio y fecha de fin de vigencia por empresa.
- Las fechas son obligatorias. Si no están en rango, la empresa queda sin acceso.
- Ver avance de encuestas por empresa (registrados, 100% completadas, <100%).
- Ver listado de empresas.

## Flujo de creación de empresa
1) Completar el formulario **Nueva Empresa**.
2) Al guardar, el sistema:
   - Crea la base de datos de la empresa.
   - Ejecuta el schema + seed de preguntas.
   - Crea el admin principal.

## Campos requeridos al crear empresa
- Nombre
- Código (ej: EMPRESA-001)
- Fecha inicio (opcional)
- Fecha fin (opcional)
- DB Name (ej: clima_empresa_001)
- Admin Nombre
- Admin Email
- Admin Password

> Nota: Los datos de conexión por defecto están precargados en UI, se pueden ajustar si aplica.

## Endpoints relevantes
- `POST /auth/login`
- `GET /superadmin/companies`
- `POST /superadmin/companies`
- `PATCH /superadmin/companies/:id/status`

## Consideraciones
- Si el acceso a MariaDB falla (Error 1045), revisar permisos del usuario en el host cliente.