Skip to content

README.md

Latest commit

 

History

History
168 lines (128 loc) · 8.85 KB

README.md

File metadata and controls

168 lines (128 loc) · 8.85 KB
Raw

IP Monitor App

Aplicativo moderno, ultra-leve e portátil em Go para monitoramento de IPs e conectividade de rede em tempo real, construído com interface nativa em Wails v3 e persistência local com SQLite3.

Inspirado no design minimalista e moderno do Microsoft PC Manager, o IP Monitor App entrega uma experiência de alto padrão visual com temas Claro e Escuro, animações fluidas e zero dependências externas.

📸 Interface do Aplicativo

Tema Escuro (Dark Mode) Tema Claro (Light Mode)
IP Monitor - Tema Escuro IP Monitor - Tema Claro

✨ Funcionalidades Principais

  • Executável Único e Portátil: Frontend e backend 100% integrados em um binário autocontido (ipMonitorApp.exe de ~13 MB).
  • Zero DLLs ou Pastas Externas: Utiliza o WebView2 nativo do Windows, sem necessidade de arquivos .dll adicionais na pasta.
  • SQLite Dinâmico e Portátil: Detecta automaticamente a pasta de execução e cria/utiliza o banco ipmonitor.db localmente com migração transparente de schema.
  • Painel Expansível de Detalhes: Cada cartão possui uma seta (chevron) que expande uma gaveta com informações completas:
    • Nome / Identificação amigável (ex: Site do PTT)
    • Método de Teste (ICMP Ping / TCP)
    • Limite de Timeout configurado (ms)
    • ID do Sistema / UUID (gerado ou importado)
  • Filtro Inteligente de Prioridade: Hosts Offline aparecem automaticamente no topo da lista para atenção e diagnóstico imediatos.
  • Identificação Visual Suave: Indicadores de status refinados com animação de pulso e destaque visual em tom vermelho-alaranjado para hosts inacessíveis.
  • Cadastro e Edição com Formulário Completo: Diálogo modal centralizado e bloqueante com suporte a todos os metadados do host.
  • Barra Lateral com Ações Rápidas:
    • Cadastrar: Abertura rápida do modal para inclusão de novos hosts com campos de IP, Nome, Método e Timeout.
    • Importar: Leitura em lote de arquivos .json estruturados (ex: sites/hosts com name, url/ip, method, thresholdMs e id).
    • Varredura: Disparo manual de ICMP Ping imediato com animação rotativa no ícone e feedback visual no status.
    • Editar: Edição rápida do host selecionado via botão na barra lateral ou duplo clique diretamente na linha da tabela.
    • Remover: Exclusão de host selecionado com confirmação imediata.
  • Varredura Automática em Background: Verificação periódica a cada 1 minuto mantendo o painel de disponibilidade sempre atualizado.
  • Tipografia Confortável & Temas Claro e Escuro: Fontes escalonadas para leitura ergonômica e alternância instantânea com contraste polido.

🛠️ Requisitos de Desenvolvimento

  • Go 1.25 ou superior
  • Go 100% Puro no Windows: Não requer GCC, MinGW-w64, WinLibs ou CGo para compilar.
  • WebView2 Runtime (já incluído nativamente no Windows 10 e Windows 11)

🚀 Compilação e Execução

O projeto conta com um Makefile unificado multiplataforma que detecta automaticamente o sistema operacional (Windows, Linux ou macOS):

make build   # Compila o executável único e portátil (CGO_ENABLED=0 no Windows)
make test    # Executa todos os testes unitários do serviço
make run     # Compila e inicia o aplicativo imediatamente
make clean   # Remove executáveis e resíduos temporários de build
make info    # Exibe dados do ambiente, SO detectado e flags de compilação

💡 Dica no Windows: Você pode compilar diretamente com make build ou rodar nativamente go build -ldflags="-s -w -H=windowsgui" -o ipMonitorApp.exe . em qualquer terminal (PowerShell, CMD ou Git Bash) sem nenhuma ferramenta C instalada!

📖 Como Usar

  1. Cadastrar Dispositivo:
    • Clique em Cadastrar na barra lateral. O modal central bloqueante será aberto.
    • Preencha o Endereço IP / Hostname (obrigatório), Nome / Identificação (opcional), escolha o Método de Teste (PING ou TCP) e o Timeout Limite (ms).
    • Pressione Enter ou clique em Cadastrar.
  2. Visualizar Detalhes Expandidos:
    • Clique na seta (chevron) ao lado do endereço IP para abrir ou recolher a gaveta de detalhes do host (Nome, Método, Timeout e UUID).
  3. Editar Host:
    • Selecione a linha do host desejado e clique no botão Editar na barra lateral (ou dê um duplo clique rápido diretamente no cartão).
    • O modal abrirá pré-preenchido com todos os dados atuais do dispositivo para alteração.
  4. Realizar Varredura Manual:
    • Clique no botão Varredura na barra lateral. O ícone girará enquanto os pings ICMP são emitidos e a lista e os cards de disponibilidade serão atualizados.
  5. Importar Lista em Lote (JSON):
    • Clique em Importar na barra lateral e selecione o arquivo .json.
    • O aplicativo aceita tanto listas simples quanto formatos estruturados com objetos ricos (name, url, method, thresholdMs, id): 
      {
  "sites": [
    {
      "name": "ROTEADOR NA TORRE do KM3 - Saida para Fazendo PAMITAL",
      "url": "192.168.100.100",
      "method": "PING",
      "thresholdMs": 2000,
      "id": "01"
    }
  ]
}
  6. Remover Host:
    • Selecione a linha do host desejado na lista e clique no botão Remover na barra lateral.
  7. Alternar Tema:
    • Clique no botão Tema no canto superior direito para alternar dinamicamente entre os modos Escuro e Claro.

🍏 Instalação no macOS & Aviso do Gatekeeper

Ao baixar o aplicativo compactado ou a imagem de disco (.dmg) diretamente da internet (GitHub Releases), o macOS aplica o atributo de quarentena (com.apple.quarantine) por questões de segurança, exibindo um diálogo de alerta:

"O Item ipMonitorApp-AppleSilicon-arm64.dmg Não Foi Aberto. A Apple não pôde verificar se o item está livre de algum malware capaz de danificar o Mac ou comprometer sua privacidade."

Por que isso acontece?

O IP Monitor é um projeto de código aberto e independente. Como ele não possui a assinatura paga anual da Apple Developer ($99/ano) com notarização automática nos servidores da Apple, o Gatekeeper bloqueia a abertura direta com 2 cliques.

Como abrir e instalar (Escolha uma das 3 opções):

Opção 1: Via Terminal (Mais Rápido e Definitivo)

Abra o Terminal no Mac e execute o comando para remover a quarentena do arquivo baixado:

xattr -d com.apple.quarantine ~/Downloads/ipMonitorApp-AppleSilicon-arm64*.dmg

(ou para a versão Intel: xattr -d com.apple.quarantine ~/Downloads/ipMonitorApp-Intel-x86_64*.dmg)

Pronto! Agora basta dar duplo clique no .dmg, arrastar o IP Monitor.app para a pasta Applications e abri-lo normalmente.

Opção 2: Pelo Finder com a tecla Control (Sem usar Terminal)

  1. Feche o aviso clicando em OK (não clique em "Mover para o Lixo").
  2. No Finder (na sua pasta Downloads), clique com o botão direito (ou segure a tecla Control ⌃ e clique) em cima do arquivo .dmg.
  3. Selecione a opção Abrir.
  4. O macOS exibirá um diálogo com um botão explícito "Abrir" além do botão de cancelar. Basta clicar em Abrir.

Opção 3: Pelos Ajustes do Sistema (Preferências)

  1. Clique em OK no aviso de bloqueio.
  2. Abra os Ajustes do Sistema (System Settings) ➔ Privacidade e Segurança (Privacy & Security).
  3. Role a página até a seção Segurança.
  4. Você verá a mensagem informando que o arquivo foi bloqueado porque não é de um desenvolvedor identificado.
  5. Clique no botão "Abrir Mesmo Assim" (Open Anyway) e confirme com sua senha ou Touch ID.

💡 Dica após arrastar para /Applications: Caso o macOS exiba o mesmo aviso de desenvolvedor não verificado ao abrir o aplicativo instalado pela primeira vez, faça o mesmo: clique com Control + Botão Direito ➔ Abrir no IP Monitor.app ou execute no Terminal:

xattr -cr "/Applications/IP Monitor.app"

💾 Banco de Dados Local

O banco de dados SQLite (ipmonitor.db) é resolvido dinamicamente de acordo com o sistema operacional:

  • macOS: Armazenado de forma segura e nativa em ~/Library/Application Support/IPMonitor/ipmonitor.db.
  • Windows / Linux: Salvo no mesmo diretório do executável, garantindo portabilidade para cópia em pendrives ou pastas compartilhadas.

Novas colunas de metadados (name, method, threshold_ms, uuid) são migradas automaticamente na inicialização.

Desenvolvido com Go, Wails v3 e SQLite3.