Todo lo de la central vive en el área Ecosistema, que solo existe en nyxerp.com: al entrar se abre su tablero (ver El área Ecosistema) y la barra lleva el rótulo Central · NIL.
Para qué sirve: en nyxerp.com, Ecosistema › Instalaciones reúne a todos los clientes de Nyxerp: qué versión corre cada uno, si está vivo, cuántos usuarios tiene, cuánta IA gastó en el mes y cuándo se respaldó por última vez. Desde la ficha de cada instalación, el equipo entra como soporte sin conocer ninguna clave.
Qué se ve
- La lista: nombre, identificador (el subdominio), estado, versión, salud («Bien», «Sin base», «No contesta» o «Sin datos»), último reporte, usuarios, usuarios activos en los últimos 30 días, la IA del mes contra su tope, el último respaldo y el partner.
- La ficha: los mismos datos más el cliente, el servidor y los módulos activos. La pestaña Reportes tiene las últimas 48 fotos (dos días, una por hora); la historia se guarda 90 días y la limpieza de la noche borra lo más viejo (la última foto de cada instalación se queda en su ficha) y la pestaña Soporte, quién entró y cuándo.
Cada instalación manda solo lo operativo. Ningún dato de negocio (ventas, clientes, montos) viaja a la central: si alguna vez una instalación intentara mandar un campo que no está en la lista, la central rechaza el reporte entero.
Entrar como soporte
- Abre la instalación y ve a la pestaña Soporte.
- Pulsa Entrar como super (soporte de Nyxerp) o Entrar como usuario de soporte de Nyxerp (equipo), o Entrar como soporte del partner (persona de un partner).
- Confirma con Entrar ahora. La instalación se abre en otra pestaña y ahí empieza la sesión; la central sigue abierta en la tuya.
- Como super, el equipo de Nyxerp entra con todos los permisos, para lo que solo Nyxerp puede hacer. Esto no se puede apagar.
- Como usuario de soporte de Nyxerp, la persona del equipo entra con su propio usuario («Ana Pérez (soporte de Nyxerp)»), con lo mismo que el soporte de un partner: configura todo menos crear usuarios, la inteligencia artificial y los límites, y no ocupa un usuario del plan. Si el cliente apagó «Permitir que el equipo de Nyxerp entre a dar soporte con usuario propio», la instalación lo rechaza; como super se puede entrar igual.
- La persona de un partner entra con su propio usuario de soporte (se crea solo la primera vez), que puede configurar todo menos crear usuarios, la inteligencia artificial y los límites. No ocupa un usuario del plan del cliente. Si el cliente apagó «Permitir que mi partner entre a dar soporte», la instalación lo rechaza.
- El enlace vale dos minutos y una sola vez. Queda anotado aquí y en el registro de accesos de la instalación («Entró como soporte»).
- Todo lo que haces en esa sesión queda a tu nombre, aunque entres como super: el historial y la pestaña Actividad de la instalación dicen «Super (soporte: tu nombre (tu número))». Con usuario propio, el autor ya es tu usuario. El cliente lo ve en Ajustes › Usuarios y roles › Entradas de soporte: quién entró, cuándo y desde qué IP.
Registrar una instalación
Una sola vez, el par de claves de firma (en la central):
nyxerp central claves -c /home/admin/nyxerp-produccion/nyxerpcom/nyxerpcom.toml
La clave privada queda en un archivo aparte, con permisos 600 (por omisión ~/.config/nyxerp/central/firma.pem, o la ruta de [central] clave_privada si el .toml ya la dice; --archivo RUTA elige otra), y no se muestra. No pisa una clave que ya exista. En el .toml de la central solo va la ruta (clave_privada = "…"); la clave pública (clave_publica), en el de cada instalación. Si el archivo tiene permisos más abiertos que 600, la central no firma y «Entrar como soporte» dice por qué: se corrige con chmod 600. Respalda ese archivo aparte, cifrado.
Si la central tenía la clave en el .toml (clave_firma): sigue funcionando mientras no se diga clave_privada, pero conviene migrarla: pegar la clave en un archivo, chmod 600, poner clave_privada = "ruta" y borrar la línea clave_firma.
Después, cada instalación se registra desde la pantalla: Ecosistema › Credenciales y tareas › Registrar una instalación (también es un botón del tablero). Se escriben el identificador (el subdominio), el nombre, la dirección y el servidor, y la página muestra la sección [central] que se pega en el .toml de esa instalación (con permisos 600). En Ecosistema › Instalaciones no hay botón «Nuevo»: las instalaciones nuevas nacen solas con «Nueva alta de instalación», y esta página es para una que ya existe y todavía no reporta.
El token se muestra una sola vez, en esa página: no sale en ningún correo, en el historial ni en la dirección, y volver a abrir la página no lo trae. La central guarda solo su resumen, y la Actividad de la instalación dice «Token: cambió», sin valor. Si se pierde o se filtra, en la ficha de la instalación, pestaña «Alta y demo», Rotar el token da otro y anula el anterior en el acto; pide escribir el identificador para confirmar. Hasta que se pegue el nuevo, esa instalación no puede reportar.
Registrar y rotar piden el permiso Administrar credenciales de la central (lo trae el perfil «Plataforma / Equipo de Nyxerp»; nunca el de un partner).
En la terminal sigue igual, para quien la prefiera: nyxerp central registrar --instalacion sumain2 --nombre "Grupo Sumain 2" --direccion https://sumain2.nyxerp.com -c …/nyxerpcom.toml (con --rotar, un token nuevo).
Los servidores y su credencial
Un servidor donde corre un aprovisionador se da de alta en Ecosistema › Credenciales y tareas › Dar de alta un servidor: la página muestra una vez la sección [aprovisionador] que va en su aprovisionador.toml. En la ficha del servidor, la pestaña Aprovisionador dice cuándo habló por última vez y cuántas altas tiene en la cola o con error (cada número abre su lista), y Rotar la credencial da otra (pide escribir el nombre del servidor). En la terminal sigue nyxerp central servidor --nombre N [--rotar].
Revisar las instalaciones y el ciclo de las demos ahora
La central revisa sola sus instalaciones cada hora y corre el ciclo de las demos una vez al día. Para no esperar al temporizador, Ecosistema › Credenciales y tareas tiene Revisar las instalaciones ahora y Correr el ciclo de las demos ahora (también en el tablero). Hacen exactamente lo mismo que el temporizador, a nombre de quien pulsa el botón, y muestran el resultado. Si la tarea ya está corriendo (el temporizador u otra persona), no se corre dos veces: la página lo dice. Cada corrida queda anotada en Corridas de las tareas: cuándo, quién o qué la corrió («temporizador», «terminal» o el nombre de la persona), cuántos avisos dio y qué hizo. Piden el permiso Correr las tareas de la central ahora.
El reporte de cada hora
En la instalación, el temporizador nyxerp-central@<instalación>.timer corre nyxerp central reportar cada hora; lo instala instalar-temporizadores.sh cuando el .toml tiene [central] con su token. Si la central no contesta, no pasa nada: la hora siguiente se manda la foto completa otra vez. Para probarlo a mano:
nyxerp central reportar -c /home/admin/nyxerp-produccion/sumain/sumain.toml
La IA de las demos
En los ajustes de la plataforma (Ajustes › Plataforma (nyxerp central)), dos ajustes fijan lo que puede gastar cada demo en inteligencia artificial: IA de las demos: el tope se mide en (tokens o centavos de dólar) y IA de las demos: tope del mes (por omisión, 500 000 tokens, la décima parte del plan base). La demo lo recibe con su plan en menos de una hora. En 0, las demos quedan sin IA. Ver Demos de partners.
Avisos al equipo
Central le avisa al equipo de lo que necesita atención, sin que nadie tenga que entrar a mirar:
- llega una solicitud de demo (del portal de partners o del formulario del sitio);
- un partner hace una solicitud (más usuarios, un módulo u otra cosa);
- un alta falla (con el paso en que quedó);
- una instalación deja de reportar por más de 2 horas, reporta mala salud o tiene el último respaldo de más de 26 horas; y otro aviso cuando vuelve a la normalidad. Cada incidente avisa una sola vez.
Cada incidente guarda su historia: en la ficha del incidente, la pestaña «Historia» dice cuándo se abrió, cuándo se normalizó y cuándo se reabrió, sin pisar lo anterior.
Quién hizo qué. Toda acción deja su autor. Lo que hace una persona queda a su nombre (por ejemplo, quien pulsa «Reintentar» en un alta). Lo que corre solo queda con un nombre que dice cuál fue, como «sistema: vigilar», «sistema: aprovisionador», «terminal: aplicaciones» o «temporizador: tasa BCV» (la tasa que carga sola el temporizador; la que se pide a mano en la terminal queda como «terminal: cotización (tasa BCV)»), y la pantalla Actividad lo muestra así. Cada entrada de soporte guarda además la dirección IP de quien pulsó el botón. Nada de esto se borra.
Cada aviso llega a la campana de quienes tienen el permiso «Atender las solicitudes de los partners», con el enlace a la ficha, y por correo a la dirección que diga el .toml de la central:
[central] avisos = "avisos@nyxerp.com" equipo = "https://equipo.nyxerp.com"
avisos es a dónde va el correo (sin esa línea solo suena la campana) y equipo es la dirección del ERP del equipo, de donde sale el enlace de cada aviso. Los correos salen con la cuenta de correo de la instalación (Ajustes › Correo) cada 5 minutos. La revisión de las instalaciones la hace el temporizador nyxerp-vigilar@<instalación>.timer, cada hora; se puede correr a mano con nyxerp central vigilar -c …/nyxerp-com.toml.
Acceso para partners
El sitio público (nyxerp.com) tiene en el encabezado y en el pie un enlace Acceso partners que lleva a la central (la dirección es el ajuste del sitio «Enlace Acceso partners», en Sitio web › Ajustes). La persona de un partner entra con su usuario y ve en CRM › Instalaciones solo las instalaciones de su partner, con su estado, versión y uso. El panel completo del partner llega más adelante.
Si la central no contesta: la salida de emergencia
En la terminal del servidor de la instalación:
nyxerp soporte enlace --usuario super -c …/sumain.toml
Escribe un enlace de un solo uso que vence en cinco minutos. El código va después de #, así que no queda en ningún registro del servidor. Lo que se hace con ese enlace queda como «soporte: emergencia (terminal)».
Preguntas frecuentes
¿Y la clave de super? Se cambia por una aleatoria que nadie conoce con nyxerp usuario --acceso super --clave-aleatoria. Desde ahí, a super se entra solo como soporte.
¿Por qué una instalación dice «Sin datos»? Nunca reportó: revisa su [central] y su temporizador.
La instalación de central no se limita
La instalación donde corre Nyxerp central es el ERP principal de Nyxerp: tiene todas las aplicaciones y nunca queda en demo, en solo lectura, suspendida ni con cupo de usuarios o tope de inteligencia artificial. Su propia ficha en Plataforma no admite esos estados ni un plan con cupo (el sistema lo rechaza y dice por qué), el ciclo de las demos no la toca y, si a esa instalación llegara un plan que la limite, se ignora y queda anotado en la historia del plan (Ajustes › Plan y límites).
Quién es la central lo dice su configuración: la instalación cuyo .toml tiene [central] clave_privada (o clave_firma). La aplicación Plataforma solo se enciende en esa instalación: en cualquier otra, Ajustes › Aplicaciones no la ofrece, nyxerp aplicaciones --todas la deja fuera y lo dice, y el sistema rechaza encenderla por cualquier camino. Encenderla nunca saca a una instalación de su plan.
Si una instalación que no es la central tiene Plataforma encendida (de antes de la versión 0.75.0), su plan rige igual y cada plan que llega deja un aviso en la historia del plan (Ajustes › Plan y límites). Se apaga en Ajustes › Aplicaciones › Plataforma › Desactivar.
Para encender de una vez todas las aplicaciones de la central, quien administra el servidor corre nyxerp aplicaciones --todas --empresa N -c ARCHIVO. Es idempotente; con --solo-faltan respeta las que alguien apagó a propósito. «Número de control» no se enciende solo hasta que la empresa tenga hojas cargadas.
Lo que solo existe en la central
Los partners son del ecosistema de Nyxerp: fuera de la central no hay partners, ni en el menú ni dentro de otras pantallas. En una instalación común, las oportunidades del CRM no muestran la columna ni el campo «Partner», y la tabla de permisos de un rol no ofrece los de partners ni «Reasignar oportunidades a otro partner». En la central todo sigue como estaba.
Cuando una instalación se da de baja, sus incidentes abiertos se cierran solos y en la historia del incidente queda «cerró: instalación dada de baja»; la revisión no los vuelve a abrir.
Última revisión: