Hierarquia: Sites → Agents → Scan Tasks → Workers

Níveis da hierarquia

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

Organização v1.0.0-alpha4

O nível superior da hierarquia. Reúne os Sites e os membros de uma conta Business. As funções dos membros e o acesso deles aos Sites são definidos no nível da organização (consulte «Funções e permissões de acesso»). Na conta Personal, a organização fica oculta: ela tem um único Site e um único usuário.

Sites — Locais

Um Site é um objeto físico ou lógico dentro da organização. É 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 — agentes, 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 agente é um aplicativo local instalado em um computador ou servidor na mesma rede que os mineradores. O agente é o elo entre os dispositivos do Site e a nuvem HashCore.

O que o agente faz:

• Verifica a rede local nos 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, alteração de Pools, instalação de Firmware etc.)

Modos de operação do agente:

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

É possível conectar vários agentes 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 agente verifica: quais intervalos de IP verificar e como se autenticar nos dispositivos. Cada agente pode ter várias tarefas de verificação.

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 agente durante a verificação. Os dispositivos não são adicionados manualmente — eles aparecem automaticamente depois que o agente 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) — feed cronológico de todas as operações e alterações
• Operações: reinicialização, alteração de Pools, instalação de Firmware, diagnóstico etc.

Esquema final