Hierarquia: Sites → Agents → Scan Tasks → Workers

Níveis da Hierarquia

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

Sites — Locais

Um Site é o nível superior da hierarquia. É um objeto físico ou lógico: uma fazenda de mineração, um data center, um edifício separado ou um rack. Todas as outras entidades — Agents, dispositivos, métricas — estão vinculadas a um Site específico.

O que é armazenado no nível do Site:

• Nome e localização geográfica
• Tarifa de eletricidade — usada para calcular o lucro líquido
• Potência máxima (Capacity) — para exibir a carga do Site
• Configurações de operações em grupo (envio de comandos em lote)

Cenário típico: uma empresa gerencia várias fazendas em diferentes cidades — cada fazenda é um Site separado no Pulse.

Agents — Agentes

Um Agent é um aplicativo local que é instalado em um computador ou servidor na mesma rede que os mineradores. O Agent atua como um elo entre os dispositivos no Site e a nuvem HashCore.

O que um Agent faz:

• Verifica a rede local em intervalos de IP definidos
• Detecta dispositivos ASIC e obtém métricas deles
• Transmite dados para a nuvem HashCore em tempo real
• Executa comandos do usuário (reinicialização, mudança de Pools, instalação de Firmware, etc.)

Modos de operação do Agent:

• Full Control — coleta de métricas e execução de comandos (padrão)
• Monitoring Only — apenas coleta de métricas, comandos não são executados

Vários Agents podem ser conectados a um Site — por exemplo, se os dispositivos estiverem em sub-redes diferentes.

Scan Tasks — Tarefas de Verificação

Uma Scan Task define exatamente o que o Agent verifica: quais intervalos de IP verificar e como autenticar nos dispositivos. Cada Agent pode ter várias Scan Tasks.

O que é configurado em uma Scan Task:

• Network ranges — lista de intervalos de IP para verificação. Suporta importação de TXT, CSV, JSON e agregação de intervalos.
• Unlock Configs — credenciais para dispositivos com senhas não padrão (HashCore, Bitmain).
• Status — a tarefa pode ser ativada ou desativada sem ser excluída.

Cenário típico: uma tarefa verifica a sub-rede 192.168.1.0/24, outra — 10.0.0.0/24. Cada tarefa pode ter suas próprias configurações de autenticação.

Workers — Dispositivos

Workers são mineradores ASIC detectados pelo Agent durante o processo de verificação. Os dispositivos não são adicionados manualmente — eles aparecem automaticamente depois que o Agent os encontra na rede.

O que está disponível no nível do dispositivo:

• Métricas em tempo real: Hashrate, consumo, temperatura, RPM dos coolers
• Status de conexão (Connectivity) e status do minerador (Miner Status)
• Informações detalhadas: parâmetros de rede, números de série, estado das placas, Pools
• Histórico de eventos (Event Log) — um feed cronológico de todas as operações e alterações
• Operações: reinicialização, mudança de Pools, instalação de Firmware, diagnóstico, etc.

Esquema Final