Guía de Gestión (Administración y Configuración)¶

El panel de Gestión permite a los administradores autorizados realizar el aprovisionamiento de recursos, la configuración de la seguridad y el registro de actividades operativas en Nexus Energy.

🏢 1. Aprovisionamiento de Organizaciones (Plataforma)¶

La creación de nuevas empresas cliente está restringida exclusivamente a los Administradores de Plataforma (platform_admin).

Flujo de Creación de Empresa:¶

Ingresa a la sección Gestión ➔ Admin Plataforma (/app/admin/platform).
Haz clic en "Crear Organización" para desplegar el modal de registro.
Ingresa los datos requeridos:
- Nombre de la Empresa (Ej: "Banco Solidario").
- Razón Social y Identificación Tributaria (Tax ID).
- Correo y Teléfono de Contacto Principal.
Haz clic en Guardar. La empresa se crea instantáneamente en la base de datos distribuida D1 y queda lista para recibir sucursales y usuarios.

📍 2. Alta de Sitios (Sucursales)¶

Una vez creada la Organización, el Administrador de la Organización (org_admin) puede comenzar a estructurar su infraestructura física agregando sucursales o Sitios.

Pasos para dar de alta un Sitio:¶

Ve a Gestión ➔ Admin Org (/app/admin/organization/[id]).
Presiona el botón "Agregar Sitio" para abrir el formulario de registro.
Completa los campos técnicos obligatorios:
- Código de Sitio: Un identificador único (Ej: S-041-SUR). El formulario sanitiza automáticamente este campo y convierte a NULL los valores vacíos para evitar colisiones de índices SQLite de campo único (UNIQUE).
- Nombre de Sucursal: Identificación descriptiva (Ej: "Sucursal Kennedy").
- Zona Horaria (Timezone): Configura la zona exacta de operación (Ej: America/Bogota o America/Miami). Esto es crítico para el procesamiento correcto de horas de generación y sol pico.
- Geolocalización (Latitud / Longitud): Habilita el posicionamiento preciso en mapas satelitales.
Al enviar el formulario, el Sitio se añade bajo la empresa activa de forma inmediata.

✉️ 3. Invitación y Control de Usuarios (Clerk Sync)¶

Para garantizar la seguridad, Nexus Energy delega la autenticación a Clerk, pero mantiene una sincronización total en la base de datos SQLite local para la gestión de permisos y roles de negocio.

Flujo de Invitación:¶

En el panel de administración, haz clic en "Invitar Usuario".
Define el Correo Electrónico del destinatario y su Rol asignado (org_admin, site_admin, o site_viewer).
Si seleccionas un rol de sitio (site_admin/site_viewer), el sistema te permitirá elegir las sucursales específicas a las que tendrá visibilidad.
Al hacer clic en "Enviar Invitación":
- Se efectúa una llamada al API SDK de Clerk para generar un token seguro y disparar un correo electrónico de invitación oficial.
- Se crea un registro espejo en la tabla invitations de D1 en estado pending.
Aceptación: Cuando el destinatario recibe el correo e inicia sesión por primera vez, el endpoint de webhook /api/webhooks/clerk recibe el evento user.created, activa la relación de base de datos local y le concede los privilegios exactos configurados.

🔧 4. Bitácora de Mantenimiento (`maintenance_logs`)¶

Para asegurar el rendimiento óptimo del hardware de campo, los Administradores de Sitio (site_admin) pueden registrar cada procedimiento o inspección técnica sobre inversores o baterías:

Tipos de Actividad: Inspección rutinaria, reparación por avería, reemplazo de partes, calibración de sensores.
Costo y Presupuesto: Registro monetario directo para auditorías financieras y análisis del costo total de propiedad (TCO).
Notas y Reportes: Almacenamiento de reportes detallados y adjuntos técnicos guardados de forma segura.