Gestión de la instalación

Cómo los clientes eligen un plan, implementan una instalación, gestionan equipos y operan cada sitio desde la consola de la instalación.

Interfaz de usuario principal:

• Precios: planes de marketing públicos
• Panel de control → Instalaciones — lista
• Detalle de instalación: administración con pestañas (/dashboard/installations/{id}?tab=…)

Selección de plan y pago

1. Explorar precios (paquetes publicados + funciones de marketing).
2. Inicia el pago de un paquete (y complementos opcionales / cupón si se ofrece).
3. Paga a través de la pasarela de la plataforma activa (Stripe Checkout, Paddle, Mollie, …) o introduce un período de prueba cuando el paquete tenga trial_days.
4. En caso de éxito, la instalación pasa de pago pendiente → aprovisionamiento → en ejecución (trabajadores de Horizon + agente del host).

Marcador de captura de pantalla: Página de precios Marcador de captura de pantalla: Revisión de la compra (paquete + complementos) Marcador de captura de pantalla: Página de pago del proveedor Marcador de captura de pantalla: Éxito de facturación / progreso de aprovisionamiento

Si el navegador devuelve la respuesta antes que el webhook, la página de éxito puede confirmar la sesión con la API del proveedor para que el pago aún se complete.

Implementar una nueva instalación

Los fallos aparecen en las pestañas **Resumen** y **Actividad** de la instalación; los administradores de la plataforma también ven **ops/logs**.

El límite máximo de instalaciones bloquea despliegues adicionales cuando está completo.

Gestión de la instalación

Abra una instalación para obtener pestañas horizontales. La capacidad de facturación depende del rol del miembro (can.billing).

Marcador de posición de captura de pantalla: encabezado de instalación con insignia de estado y barra de pestañas

Resumen

• Estado de la instalación, dominio principal, resumen del paquete.
• Operaciones de implementación activa con progreso por pasos (aprovisionar, actualizar, reinstalar).
• Módulos titulados por el paquete: instalar/actualizar cuando haya versiones disponibles.
• Actualizaciones del núcleo/módulo con un clic cuando la plataforma informa que hay actualizaciones disponibles (pone en cola un trabajo de actualización; supervisa el progreso en esta pestaña).
• Reinstalar: restablecimiento completo o restauración desde una copia de seguridad seleccionada (misma identidad de instalación).

Configuración (contraseña de administrador del tenant)

• Configuración de estilo de la localidad / zona horaria para la instalación que se expuso.
• Restablecer las credenciales de administrador de NexoPOS (correo electrónico/contraseña) a través del agente de la plataforma.

Importante: el restablecimiento de la contraseña/credenciales de administrador solo funciona cuando la aplicación está instalada y en ejecución. No tendrá éxito en estados pendientes/de aprovisionamiento/fallidos. La nueva contraseña normalmente se muestra una vez en la interfaz de usuario (flash); no se envía por correo como sustituto de SMTP.

Facturación (incluye renovación y cancelación)

No hay una pestaña independiente de “Renovación”. El ciclo de vida de la suscripción vive en Facturación:

• Estado actual de la suscripción, período, finalización de la prueba.
• Lista de facturas.
• Renovar / reanudar el pago cuando esté vencido o se requiera una acción.
• Cancelar renovación (acceso hasta el final del período según las reglas del producto).
• Historial de solicitudes de reembolso / enviar (ver

Dominio

• Muestra el subdominio de la plataforma gratuita ({slug}.{base_domain}).
• Dominio personalizado cuando:
  • El modo de dominio es gratuito, o bien
  • El modo de dominio es complemento y la instalación tiene una suscripción activa de dominio personalizado, o bien
  • El cliente puede comprar el complemento de dominio personalizado publicado desde esta pestaña.

Flujo: ingresa el nombre de host → crea registros DNS (A/AAAA a la IP pública de la plataforma, además del host de desafío de verificación según las instrucciones) → Verifica (nginx + SSL). Pueden aplicarse límites diarios de cambios verificados.

Copia de seguridad

Visible/utilizable cuando la instalación tiene el complemento de Backups (o el CTA de compra cuando exista un complemento de backups publicado).

• Copia de seguridad completa o solo de la base de datos.
• Historial: restaurar, descargar, eliminar (dentro de la política).
• Las copias de seguridad automáticas de la plataforma se ejecutan según el calendario de administración cuando están habilitadas; los clientes no configuran cron.
• Retención: los últimos N respaldos correctos (Administrador → Respaldos → conservar los últimos).

Requiere configuración de Admin S3 funcional.

Registros

Recupera los archivos de registro de la solicitud del inquilino para la solución de problemas (permisos, errores de la aplicación) sin SSH.

Actividad

Registro tipo auditoría de las operaciones realizadas en esta instalación por miembros de la organización (y acciones del sistema cuando se registran): despliegues, cambios de dominio, copias de seguridad, restablecimientos de credenciales, acciones de facturación, etc.

Viajes comunes de los clientes

El pago falló

Notificación por correo electrónico (si SMTP) → banner de renovación / pestaña de Facturación → actualizar método de pago → reanudar. Después del período de gracia, la instalación puede suspenderse (página sin conexión según la configuración de suspensión del administrador).

Cancelar vs reembolso

• Cancelar renovación: seguir usando hasta el final del período.
• Solicitud de reembolso: la aprobación del administrador finaliza la instalación rápidamente y programa una eliminación definitiva más rápida.

Consejos para el operador

• Horizon debe estar en ejecución o las instalaciones se quedarán en “aprovisionamiento”.
• HOST_AGENT_LOCAL_REAL_CLONE=false usa un stub rápido en Docker; configúralo en true (o usa script en VPS) para árboles reales de NexoPOS.
• ¿Las pestañas de dominio/copia de seguridad están vacías? Comprueba las claves de la función del catálogo y la configuración del dominio S3 en Admin.
• ¿El restablecimiento de la contraseña falla? Confirma que el estado está en ejecución.