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.
Licença
MIT — use, altere e distribua à vontade, sem garantia nenhuma.
