Saltar a contenido

Guía del administrador de MRG

Para el personal del fabricante: administra todos los clientes, da de alta los equipos de planta y emite sus credenciales.

Es el único rol que cruza la frontera entre empresas, y conviene entender por qué y hasta dónde.

Sin capturas de pantalla, a propósito

La interfaz está en refactor. Esta guía describe qué se puede hacer y qué esperar.

Qué podés hacer

Todo lo del administrador del cliente, en cualquier empresa, más:
Clientes Crear, editar y configurar empresas
Dispositivos de planta Alta, modificación, habilitar y deshabilitar
Credenciales de dispositivo Emitir, listar y revocar
Usuarios de cualquier empresa Invitar, listar y gestionar membresías
Roles globales Según tu rol: ver la nota de abajo

Los tres roles de MRG no son equivalentes

Rol Qué agrega
admin dentro del tenant de plataforma Permisos de administración más la gestión de empresas
tenant_manager Rol global: opera sobre varias empresas
Administración de la plataforma Ve y administra las internas de la plataforma: los roles globales, quiénes los tienen y las invitaciones a esos roles. Es el alcance más amplio del sistema y no se otorga para operar clientes

El acceso entre empresas es una excepción explícita y acotada: existe solo para membresías del tenant de la plataforma. Un usuario de una empresa cliente no tiene ningún camino hacia ella, ni manipulando la petición. Está documentado en un ADR del repositorio del Cloud.

Dar de alta un equipo de planta

Es la tarea más delicada del rol, y la que más cuesta si sale mal.

El procedimiento completo está en alta de un dispositivo Edge. Lo esencial:

  1. Crear el dispositivo, con su identificador de máquina.
  2. Emitir la credencial. Se muestra una sola vez y no se puede recuperar.
  3. Entregarla a quien instale el equipo, sin pegarla en un chat ni en un ticket.

El identificador de máquina tiene que coincidir exactamente con el del equipo

Es el error más costoso del sistema y el más difícil de detectar, porque todo parece funcionar: el equipo reporta sano, alcanza la nube, y el dashboard nunca muestra un dato. Los datos de ese período se pierden definitivamente.

La única señal es que el dispositivo nunca registra actividad. Si diste de alta un equipo y la actividad no aparece, revisá eso primero.

Copiar y pegar, nunca transcribir.

Rotar una credencial

El orden importa: emitir la nueva primero, revocar la vieja al final.

  1. Emitir la nueva. Las dos quedan válidas a la vez.
  2. Actualizar la configuración del equipo de planta y reiniciarlo.
  3. Verificar que el dispositivo vuelve a registrar actividad.
  4. Recién ahí, revocar la vieja.

Al revés corta la entrega de datos. No los pierde —el equipo acumula y reintenta— pero el backlog crece mientras dure el corte.

Para una revocación de emergencia, lo más contundente es deshabilitar el dispositivo: invalida todas sus credenciales de una vez.

Lo que el sistema no te va a avisar

Es lo más importante de esta guía. El rol administra el sistema, así que conviene saber qué problemas no van a aparecer en ninguna pantalla.

No te avisa de… Cómo te enterás hoy
Una planta que dejó de entregar datos Mirando la actividad del dispositivo, a mano
Datos descartados y perdidos Entrando por SSH al equipo de planta
Una variable que cruzó un umbral peligroso No te enterás: el motor de alarmas no existe, y el módulo ni siquiera se muestra
Un equipo que se quedó sin espacio No hay retención configurada en la base local

Nadie recolecta las métricas del sistema

Los dos componentes que llevan los datos de la planta a la nube exponen métricas y nadie las consulta. Con dos alertas sobre métricas que ya existen se detectaría el peor fallo del sistema.

Mientras eso no exista, la supervisión del sistema es manual, y conviene instalar la costumbre de revisar periódicamente la actividad de cada dispositivo. Ver monitoreo.

Lo que tenés que saber antes de mostrar el sistema

Si vas a mostrarle el producto a un cliente, tres cosas conviene tenerlas claras de antemano:

  1. 11 de los 32 widgets muestran datos reales. Los demás muestran datos simulados y nada los distingue en pantalla. Ver widgets.
  2. La sección de reportes es una maqueta: no hay backend detrás. Lo que se genera no contiene datos de ninguna máquina.
  3. Las alertas no se disparan solas. El sistema deja definirlas y no las evalúa.

No son defectos ocultos: están documentados y tienen su explicación en la bitácora de alcance. Lo que no conviene es que aparezcan durante una demostración.

Relacionado