Jerarquía: Sites → Agents → Scan Tasks → Workers

Niveles de la jerarquía

Sites
└── Agents
    └── Scan Tasks
        └── Workers

Sites — Ubicaciones

Un Site es el nivel superior de la jerarquía. Es un objeto físico o lógico: una granja de minería, un centro de datos, un edificio separado o un rack. Todas las demás entidades —Agents, dispositivos, métricas— están vinculadas a un Site específico.

Qué se almacena a nivel de Site:

• Nombre y ubicación geográfica
• Tarifa de electricidad — utilizada para calcular el ingreso neto
• Potencia máxima (Capacity) — para mostrar la carga del Site
• Configuración de operaciones grupales (envío de comandos por lotes)

Escenario típico: una empresa gestiona varias granjas en diferentes ciudades — cada granja es un Site separado en Pulse.

Agents — Agentes

Un Agent es una aplicación local que se instala en un ordenador o servidor en la misma red que los mineros. El Agent es el enlace entre los dispositivos en el Site y la nube de HashCore.

Qué hace un Agent:

• Escanea la red local dentro de los rangos IP especificados
• Detecta dispositivos ASIC y obtiene métricas de ellos
• Transfiere datos a la nube de HashCore en tiempo real
• Ejecuta comandos del usuario (reinicio, cambio de Pools, instalación de Firmware, etc.)

Modos de operación del Agent:

• Full Control — recopilación de métricas y ejecución de comandos (por defecto)
• Monitoring Only — solo recopilación de métricas, los comandos no se ejecutan

Se pueden conectar varios Agents a un Site — por ejemplo, si los dispositivos están en diferentes subredes.

Scan Tasks — Tareas de escaneo

Una Scan Task define qué escanea exactamente el Agent: qué rangos IP verificar y cómo autenticarse en los dispositivos. Cada Agent puede tener varias Scan Tasks.

Qué se configura en una Scan Task:

• Network ranges — lista de rangos IP para escanear. Se admite la importación desde TXT, CSV, JSON y la agregación de rangos.
• Unlock Configs — credenciales para dispositivos con contraseñas no estándar (HashCore, Bitmain)
• Estado — la tarea puede activarse o desactivarse sin ser eliminada.

Escenario típico: una Scan Task escanea la subred 192.168.1.0/24, otra — 10.0.0.0/24. Cada Scan Task puede tener su propia configuración de autenticación.

Workers — Dispositivos

Los Workers son mineros ASIC detectados por el Agent durante el proceso de escaneo. Los dispositivos no se añaden manualmente — aparecen automáticamente una vez que el Agent los encuentra en la red.

Qué está disponible a nivel de dispositivo:

• Métricas en tiempo real: Hashrate, consumo, temperatura, RPM de los ventiladores
• Estado de conexión (Connectivity) y estado del minero (Miner Status)
• Información detallada: parámetros de red, números de serie, estado de las Hashboards, Pools
• Historial de eventos (Event Log) — un registro cronológico de todas las operaciones y cambios
• Operaciones: reinicio, cambio de Pools, instalación de Firmware, diagnóstico y otros.

Esquema final