HUB SNK

Hub local de cadastro de clientes, das bases e dos repositórios Git de cada um, com o SankhyaOm e a Experience abertos em guias do próprio aplicativo. Roda na sua máquina, sem Docker, sem banco de dados e sem conta para criar.

O cadastro fica na sua máquina. Ele só sai dela se você ligar a cópia no seu próprio Google Drive — veja Backup. O único envio de dados ao mantenedor é o relato de problema, que leva seu nome, empresa, time e e-mail (de Configurações), e só quando você clica em Enviar — veja Relato de problema.

É um aplicativo desktop (Electron) para Windows, Ubuntu (.deb) e Mac com chip Apple (.dmg).

Funcionalidades e download também em carlossimao.github.io/hub-snk.

---

Instalação

Windows

Baixe o HUB-SNK-Setup-<versão>.exe na página de releases e rode.

• Instala só para o seu usuário, em %LOCALAPPDATA%\Programs\HUB SNK, sem pedir administrador.
• Não exige Node.js: o backend roda no Node que vem dentro do aplicativo.
• Cria os atalhos "HUB SNK" no menu Iniciar e na área de trabalho.
• O Git AutoSync (commit e push automáticos dos repositórios) não vem no instalador: tem licença própria. A aba Git AutoSync do painel o instala baixando da release do repositório dele, e exige o Git na máquina.

O instalador não é assinado digitalmente. Na primeira execução, o SmartScreen pode mostrar "O Windows protegeu o computador": clique em Mais informações › Executar assim mesmo.

Ubuntu

Testado no Ubuntu 24.04. Baixe o hub-snk-<versão>-amd64.deb na página de releases e instale:

sudo apt install ./hub-snk-<versão>-amd64.deb

Depois abra o HUB SNK pelo menu de aplicativos. O pacote instala em /opt/HUB SNK e traz o que o cofre de senhas precisa (o chaveiro do GNOME). Diferenças em relação ao Windows:

• O Git AutoSync não aparece: ele só publica executáveis para Windows.
• No Ubuntu 24.04 o atalho global Ctrl+Shift+Espaço não funciona (o GNOME 46 não libera tecla global no Wayland). Cadastre em Configurações › Teclado › Atalhos personalizados o comando hub-snk-desktop --busca-rapida com a combinação que preferir.
• Para desinstalar: sudo apt remove hub-snk-desktop. O cadastro não é apagado.

Mac

Só Mac com chip Apple (M1 em diante). Baixe o HUB-SNK-<versão>-arm64.dmg na página de releases, abra e arraste o HUB SNK para Aplicativos.

O app não é assinado nem notarizado pela Apple (exige conta paga):

• A primeira abertura é bloqueada. Libere em Ajustes do Sistema › Privacidade e Segurança › Abrir Mesmo Assim, ou no Terminal: xattr -dr com.apple.quarantine "/Applications/HUB SNK.app".
• Não há atualização automática: o Painel avisa da versão nova, e o .dmg novo é instalado por cima.
• A cada versão nova o macOS pergunta se o HUB SNK pode usar a chave HUB SNK Safe Storage, onde ficam as senhas: responda Sempre Permitir.
• O cadastro fica em ~/Library/Application Support/HUB SNK/dados. O Git AutoSync não aparece.

Primeiro uso

Na primeira abertura, um assistente de boas-vindas pergunta, em quatro passos rápidos:

• nome, empresa, time e e-mail, todos opcionais;
• o seu perfil profissional — Consultor, Analista, Gerente de Projetos ou Desenvolvedor —, que define as abas visíveis;
• se você tem login no SankhyaOm e na Experience. Quem não tem é Terceiro: some o que depende deles (Sankhya ID, Agenda, OS e as guias dos dois sistemas).

Tudo pode ser mudado depois em Configurações › Geral e Configurações › Acessos. Com o cadastro vazio, o painel abre na aba Clientes e, para quem não é Terceiro, com a aba Sankhya ID das Configurações já aberta.

Atualizar e desinstalar

O HUB SNK se atualiza sozinho: procura versão nova ao abrir e a cada 6 horas, baixa em segundo plano e avisa quando ela está pronta — clique no aviso, ou em Ajuda › Reiniciar para atualizar. Quem desligar Ajuda › Atualizar automaticamente atualiza rodando o instalador da versão nova por cima. Para desinstalar, use Configurações › Aplicativos › HUB SNK. Nos dois casos o cadastro não é apagado; na desinstalação, se o Git AutoSync foi instalado pelo HUB SNK, o instalador pergunta se ele sai junto.

---

Como é o aplicativo

A janela tem guias no topo:

Guia	O que é
Painel	O HUB SNK: Resumo do dia, clientes, bases, repositórios, ambiente local e agenda
SankhyaOm	O ERP, que loga sozinho com o Sankhya ID salvo
Experience	A Experience, com o mesmo login automático
Uma por base aberta	Cada base de cliente abre na sua própria guia, isolada das outras, com o login já preenchido

Onde os links do cadastro abrem — bases, repositórios, links gerais e links de projeto — é uma escolha só, na aba Geral das configurações: numa guia do HUB SNK ou no navegador padrão do sistema. O padrão é a guia do HUB SNK, onde a base já abre com o login preenchido. Detalhes em Onde os links abrem.

O menu Guias esconde e mostra cada guia. Ctrl+F busca um texto na guia que está na tela, como no Chrome.

À esquerda fica a barra de comunicação, com o WhatsApp Web, o Gmail, o Google Chat, o Google Agenda e o Google Meet abertos num painel por cima das guias, cada um com o próprio login salvo. Entrar numa reunião abre a chamada numa janela própria, uma por reunião.

Fechar a janela não encerra o aplicativo: ele fica na bandeja do Windows, perto do relógio, ou no ícone do canto superior direito, no Linux. Para sair, use Hub › Sair ou o menu do ícone (botão direito, no Windows).

---

Configuração

O aplicativo não precisa de configuração: porta, endereço e pasta de dados são fixos. Para quem desenvolve ou precisa mudar alguma coisa, estas variáveis de ambiente valem antes de abrir o aplicativo:

Variável	Padrão	O que faz
HUB_DADOS_DIR	%LOCALAPPDATA%\HubSnk\dados	Onde o cadastro é gravado
SANKHYA_HUB_URL	http://127.0.0.1:4100	Endereço do backend. A porta daqui é a porta em que o aplicativo o sobe
SANKHYA_DESKTOP_BRIDGE_PORT	4103	Porta da ponte que o backend chama no aplicativo (cofre, agenda)
SANKHYA_HUB_BACKEND	gerenciado	externo faz o aplicativo usar um backend que já esteja no ar (npm run dev)
SANKHYA_ERP_URL	https://skw.sankhya.com.br/mge/	Endereço da guia SankhyaOm
SANKHYA_EXPERIENCE_URL	https://experience.sankhya.com.br/	Endereço da guia Experience

Rodando só o backend (npm run dev, veja Manutenção), valem HUB_PORTA (padrão 4100), HUB_HOST (padrão 127.0.0.1, e só aceita loopback), HUB_DADOS_DIR (padrão ./dados-hub-snk) e HUB_SEM_TOKEN (1 desliga a exigência do token na API, para usar o painel no navegador sem o aplicativo aberto — só em desenvolvimento).

O backup é embutido: cópia no Google Drive e backup periódico numa pasta — veja Backup.

---

Segurança

O backend escuta só em 127.0.0.1, e a razão é o que ele faz: devolve o cadastro inteiro — senhas em texto puro incluídas — e abre programas do seu computador (a IDE configurada, terminal, gerenciador de arquivos) a pedido de quem chama a API. Um HUB_HOST fora do loopback é recusado na largada.

Toda a API exige o token que o aplicativo grava num arquivo da sua conta do Windows, então outro programa da máquina — inclusive o de outro usuário do mesmo computador — não lê o cadastro. O painel recebe o token do aplicativo sem nunca vê-lo, e por isso só funciona dentro dele. O backend confere ainda se cada requisição veio mesmo da própria máquina e recusa o resto — inclusive um site aberto no seu navegador tentando falar com o programa. As rotas que só o aplicativo chama (sessão da Experience, senha para o login automático, encerramento) exigem o token no cabeçalho, que a tela não tem. Como as conferências funcionam está em docs/api.md.

O Sankhya ID (um usuário e uma senha, que valem para o SankhyaOm e para a Experience) fica no cofre do sistema operacional, cifradas pelo aplicativo — nunca em texto puro.

---

Onde ficam os dados

Tudo o que você cadastra fica em %LOCALAPPDATA%\HubSnk\dados — ou onde o HUB_DADOS_DIR apontar. São o cadastro de clientes, a configuração global, as bases e bancos da própria máquina, os lembretes, as notificações e o sankhya.db com a Agenda de Recursos.

Os logs do aplicativo ficam em %APPDATA%\HUB SNK\log (desktop.log e backend.log). O formato dos arquivos de dados está em docs/formato-dos-dados.md.

---

Funcionalidades

O quê	Resumo
Cadastro de clientes	Bases do ERP com usuário, senha e banco vinculado, repositórios Git, links avulsos, projetos e anotações livres
Guias do Sankhya	SankhyaOm e Experience dentro do aplicativo; cada base de cliente numa guia isolada, com usuário e senha preenchidos
Agenda de Recursos	Lida por uma janela oculta que loga no SankhyaOm sozinha; lança a OS do dia na Experience e ocorrências (férias, folga) no ERP
Resumo do dia	A tela inicial do Painel: agenda de hoje, lembretes do dia, repositórios com pendência e OS não concluídas, cada item com seu atalho
Notificações	Sino do topo e aviso do Windows, com som e e-mail opcional: evento da agenda sem tarefa na Experience e lembretes
Lembretes	Aba própria no menu: numa data ou recorrentes (cron), ligados a um cliente ou projeto, com aviso e e-mail opcional
Kanban	Quadro por projeto e por cliente, mais um Kanban geral; colunas e tipos cadastráveis; a IA gera as tarefas do escopo. JSON e MCP
Importação de favoritos	Transforma favoritos do Chrome, Edge, Opera, Firefox ou Safari em bases, deduzindo Produção ou Teste do nome
Botões do repositório	Abrem a pasta, o terminal, a IDE configurada e o assistente de IA (num terminal novo); e editam o .sankhya-mcp.env do MCP Claude
Busca rápida	Ctrl+K no aplicativo ou Ctrl+Shift+Espaço em qualquer programa: acha cliente, base, repositório, link, contato ou atalho e abre
Buscar na página	Ctrl+F em qualquer guia, inclusive na Experience e no SankhyaOm: destaca as ocorrências e anda entre elas, como no Chrome
Comunicação	WhatsApp Web, Gmail, Google Chat, Google Agenda e Meet na barra lateral; o contato abre a conversa ou um e-mail do HUB SNK
Atalhos	Lista de programas da sua máquina, iniciados com um clique pelo botão de raio, com busca a partir de seis cadastrados
Bases locais (Local)	Ligam, param e reiniciam o WildFly da sua máquina, com a situação do serviço, o log ao vivo e o da instalação

As bases e os bancos locais ficam no botão Local, no topo do painel, ao lado de Clientes: é o ambiente de desenvolvimento da sua própria máquina, separado do cadastro dos clientes. Ligar o banco sobe o Docker antes, se ele estiver parado, e parar o WildFly usa o desligamento limpo do próprio servidor, não um encerramento forçado.

Cada uma em detalhe, com as regras, em docs/funcionalidades.md.

O backup leva os dados como estão no disco, e o cadastro guarda as senhas das bases e dos bancos em texto puro. Confira se a pasta do backup e a pasta "HUB SNK" do Drive não estão compartilhadas com ninguém.

---

Solução de problemas

Sintoma	O que fazer
"HUB SNK — o backend não subiu" ao abrir	Com "A porta 4100 já está em uso por outro programa, que não é o backend do HUB SNK", feche esse programa e abra o HUB SNK de novo: o aplicativo não usa um backend que não é dele. Sem essa frase, o backend falhou, e as últimas linhas estão na mensagem e em backend.log
"HUB SNK — a ponte com o backend não abriu" ao abrir	A porta 4103 está ocupada por outro programa. Sankhya ID, Agenda e login automático ficam indisponíveis até você fechar esse programa e abrir o HUB SNK de novo
O painel não carrega nada e o log do backend mostra "Requisição sem token válido recusada"	O painel foi aberto fora do aplicativo, num navegador comum. Ele só funciona dentro do HUB SNK, que entrega o token da API à guia Painel
A agenda diz que o login automático falhou ou que não há usuário e senha salvos	Confira o usuário e a senha no Sankhya ID e tente de novo
A agenda diz "login automático suspenso: ...", ou as guias pararam de logar sozinhas	O Sankhya recusou a senha salva duas vezes seguidas, e o login automático parou para não bloquear a conta. Salve usuário e senha de novo no Sankhya ID (ou reabra o aplicativo)
Os botões de Git não fazem nada	O git precisa estar no PATH. Confira com git --version num terminal novo
Mensagem sobre esquema mais novo ao iniciar	O cadastro foi gravado por uma versão mais nova do HUB SNK. Instale a versão mais recente

Se não estiver na lista, abra uma issue citando a versão que aparece no rodapé da tela, e sem colar senha, host, usuário ou nome de cliente: o repositório é público.

---

Documentação técnica

Nada disto é necessário para usar o HUB SNK.

• Funcionalidades em detalhe — cada recurso, com as regras
• API HTTP — as rotas, os corpos aceitos e a conferência de origem
• Formato dos arquivos de dados — o envelope, o esquema e a migração
• Distribuição — como o aplicativo desktop e o instalador são montados
• Estrutura do código — mapa dos arquivos
• Manutenção — modo de desenvolvimento, padrões do código, regra de versão, roteiro de teste e publicação
• CHANGELOG — o que mudou em cada versão

---

Licença

MIT — use, altere e distribua à vontade, sem garantia nenhuma.