claboral.linkedcorp.net/SUPERADMIN.md

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.