Gerenciamento da Frota

A página Fleet é a visualização principal da frota. Ela exibe todas as máquinas registradas e seus status atuais.

Lista de máquinas

Cada linha exibe:

Campo	Descrição
Hostname	Hostname Windows da máquina
OS	String de versão do Windows
Agent	Versão em execução do PatchPilotAgent.exe
Status	Badge Online / Offline
Last seen	Timestamp do heartbeat mais recente (relativo)
Updates	Número de atualizações winget disponíveis (badge vermelho)

Pesquisa e filtros

A barra de pesquisa filtra máquinas por hostname em tempo real. Filtros adicionais disponíveis:

• Status — exibir apenas máquinas Online ou Offline
• Tag — filtrar por tag atribuída (ex.: accounting, servers)
• Has updates — exibir apenas máquinas com atualizações pendentes

Adicionar máquinas

O botão Add machines no canto superior direito abre um wizard de 3 etapas:

1. Download config — gera um config.ini pré-configurado com a URL deste servidor
2. Download installer — link direto para PatchPilotAgent.exe hospedado no servidor
3. Instructions — snippet PowerShell para instalação manual + orientações para GPO e SCCM/MECM

As máquinas aparecem na lista automaticamente após o primeiro heartbeat do agente.

Detalhes da máquina

Clique em qualquer máquina para abrir sua página de detalhes. A página possui três abas:

Aba Overview

Exibe informações gerais: data de registro, último heartbeat, IP e versão do agente.

Tags são editadas inline — clique em + tag para adicionar, × para remover. As alterações são salvas imediatamente.

Notes suporta edição inline — clique no campo para abrir um editor de texto livre. Útil para registrar número de patrimônio, localização física ou responsável.

Aba Software

Lista completa do software instalado detectado via registro do Windows, atualizada a cada heartbeat.

Colunas: Name, Version, Update (versão disponível), além de ações por linha:

• Deploy update — navega para a página Deploy com máquina e pacote pré-selecionados (aparece apenas se houver atualização disponível e o item estiver no catálogo)
• Remove — enfileira um job de desinstalação via winget uninstall (aparece para itens do catálogo)

O botão Deploy all updates (N) no topo da aba enfileira jobs para todas as atualizações pendentes de uma só vez com comportamento de reboot imediato.

Aba History

Timeline de alterações de software nesta máquina. Cada evento exibe:

Campo	Descrição
Tipo	installed, updated ou removed
Software	Nome do pacote
Versão	Versão anterior → versão nova (ou apenas uma delas)
Hora	Horário do evento (UTC)

Os eventos são agrupados por data e ordenados do mais recente para o mais antigo.

Exclusão suave

Excluir uma máquina a marca como inativa (status = deleted) em vez de remover o registro. A máquina é ocultada da frota padrão, mas permanece no log de auditoria. Se a mesma máquina física fizer check-in novamente, ela é restaurada automaticamente.

Registro de máquinas

As máquinas são identificadas pelo seu UUID SMBIOS (lido do registro do Windows). Esse UUID persiste após renomeações e reinstalações do SO no mesmo hardware. Quando um agente envia seu primeiro heartbeat, o servidor cria automaticamente um registro de máquina.

Alerta de offline

Quando uma máquina deixa de enviar heartbeats por mais tempo que HEARTBEAT_TIMEOUT_MINUTES (padrão: 30 minutos), uma notificação é gerada e o badge muda para Offline. Consulte Notificações.