Initial commit

SUPERADMIN.md

@@ -0,0 +1,45 @@
+# 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.