SINCRONIZAÇÃO COM GITHUB GIST

Configure seus computadores com segurança

Este guia explica todo o processo: criar a credencial no GitHub, conectar o primeiro navegador, adicionar outros computadores e entender como o sistema protege as alterações de cada pessoa.

Antes de começar

Escolha uma pessoa responsável pela conta do GitHub e pelo Gist. Use um Gist secreto e nunca envie o token por e-mail, WhatsApp ou captura de tela. Atenção: “secreto” significa apenas que o Gist não aparece em buscas; quem obtiver sua URL poderá visualizá-lo.

VISÃO GERAL

Como a sincronização funciona

O sistema mantém uma cópia dos dados neste navegador e usa um Gist secreto global do OfficeJur como ponto central para compartilhar as informações entre computadores. O Financeiro mantém arquivos próprios para clientes, casos, pacotes, equipe, lançamentos, cobranças, contas e documentos; outros módulos, como o Controle de Pagamentos, também possuem seus arquivos.

Computador ADados locais

Gist secretoCópia central

Computador BDados locais

Ao sincronizar, o sistema primeiro lê o conteúdo atual do Gist.
Inclusões, edições e exclusões são mescladas registro por registro.
Alterações feitas em computadores diferentes são preservadas.
Se o mesmo registro for alterado em dois lugares, prevalece a alteração mais recente.
Ao abrir um módulo sincronizável, o OfficeJur baixa, mescla e publica automaticamente o arquivo desse módulo.
O token fica somente no navegador em que foi configurado; ele não é gravado no Gist.

ETAPA 1

Crie um token de acesso no GitHub

O token funciona como uma senha exclusiva para o sistema acessar o Gist. Recomendamos um token refinado, com acesso apenas a Gists e com prazo de validade.

1
Entre na conta responsável
Acesse o GitHub com a conta que será proprietária do Gist.
Abrir login do GitHub
2
Abra a criação de token refinado
No GitHub, acesse Settings → Developer settings → Personal access tokens → Fine-grained tokens e escolha Generate new token.
Criar token refinado
3
Defina identificação e validade
Use um nome que identifique o equipamento, como “Financeiro — notebook recepção”. Escolha uma validade compatível com a política do escritório; 90 dias é uma opção conservadora.
4
Conceda somente a permissão necessária
Em Account permissions, localize Gists e selecione Read and write. O sistema não precisa de acesso de gravação aos repositórios.
5
Gere e copie o token
Clique em Generate token e copie imediatamente. O GitHub mostra o valor completo apenas uma vez.

Alternativa: token clássico

Se a conta não oferecer a permissão refinada para Gists, crie um token clássico e marque somente o escopo gist. Não marque repo nem outras permissões desnecessárias.

Criar token clássico com escopo gist

Documentação oficial

O GitHub exige permissão de usuário “Gists: write” para criar e atualizar Gists por meio de tokens refinados.

Consultar documentação do GitHub

ETAPA 2

Configure o primeiro computador

1
Abra a área central
No portal ou no seletor de apps, abra Configurações. Gist ID e token são administrados somente nessa área.
2
Cole o token
No campo “Token do GitHub”, cole a credencial criada na etapa anterior.
3
Conecte um Gist existente
Se já houver um Gist secreto, informe seu ID ou endereço e clique em Salvar e testar.
4
Ou crie um novo Gist
Com o token informado, clique em Criar novo Gist secreto. O sistema criará a estrutura global e preencherá o ID automaticamente.
5
Guarde o Gist ID
O ID é a sequência final do endereço do Gist. Exemplo: em gist.github.com/usuario/abc123, o ID é abc123. Ele será usado nos outros computadores.

Configuração concluída

Quando o topo mostrar “Gist configurado”, use o botão “Sincronizar” para confirmar que os dados já estão atualizados.

ETAPA 3

Adicione outro computador ou navegador

Repita esta etapa em cada navegador que terá acesso ao sistema. Perfis diferentes do mesmo navegador também possuem configurações separadas.

1
Crie uma credencial para o equipamento
Por segurança, prefira um token diferente para cada computador. Assim, um equipamento perdido pode ter seu token revogado sem interromper os demais.
2
Informe o mesmo Gist ID
Abra a área central Configurações e cole o ID ou endereço criado no primeiro computador.
3
Informe e teste o token
Cole o token autorizado e clique em Salvar e testar. Os módulos deste navegador passarão a usar essa conexão.
4
Abra o módulo
Ao abrir, o Financeiro baixa e mescla os dados existentes do Gist sem apagar eventuais registros locais.
5
Salve e sincronize
Ative a sincronização automática na área central se desejar e clique em “Sincronizar” no Financeiro para confirmar a conexão.

USO DIÁRIO

Boas práticas entre computadores

Ao iniciar

Aguarde a sincronização automática de abertura concluir antes de começar, especialmente se outra pessoa utilizou o sistema em outro computador.

Durante o trabalho

Com a opção automática ativada, alterações salvas são enviadas após um pequeno intervalo.

Ao terminar

Clique novamente em “Sincronizar” e aguarde a mensagem de confirmação antes de fechar a página.

Edição simultânea

Evite duas pessoas editarem o mesmo cliente, lançamento ou processo ao mesmo tempo. Para o mesmo registro, prevalece a versão mais recente.

O que cada botão faz

SincronizarLê o Gist, mescla com este navegador e atualiza a cópia central.

Configurações globaisCria, testa, substitui ou remove a conexão usada por todos os módulos.

Sincronização automáticaÉ ativada na área central e agenda uma sincronização depois de cada alteração salva em qualquer módulo.

SEGURANÇA

Proteja os dados e as credenciais

Use um Gist secreto e proteja sua URL. Nunca o transforme em Gist público.
Crie tokens com somente a permissão de Gists e, sempre que possível, um token por equipamento.
Defina validade e renove o token quando o GitHub indicar expiração.
Não compartilhe tokens em mensagens, documentos, capturas de tela ou gerenciadores não autorizados.
O token fica no armazenamento local do navegador. Limpar os dados do navegador remove a configuração daquele equipamento.
Um Gist secreto não é privado nem usa criptografia ponta a ponta: qualquer pessoa com a URL pode visualizar seu conteúdo. Não armazene documentos sigilosos nele. A conta do GitHub deve usar senha forte e autenticação em dois fatores.

SOLUÇÃO DE PROBLEMAS

Mensagens e correções mais comuns

“Bad credentials” ou status 401

O token está incorreto, expirou ou foi revogado. Gere um novo token, substitua-o na área central Configurações e teste novamente.

Status 403 ou “Resource not accessible”

O token não possui permissão de gravação em Gists. Em um token refinado, confirme Account permissions → Gists → Read and write. Em um token clássico, confirme o escopo gist.

Status 404 ou Gist não encontrado

Confira se o Gist ID ou endereço foi copiado integralmente e se o token pertence à conta proprietária do Gist secreto.

Arquivo JSON não encontrado

Cada domínio usa um nome fixo dentro do Gist. O Financeiro cria automaticamente os arquivos ausentes de clientes, casos, pacotes, equipe, lançamentos, cobranças, contas e documentos na próxima sincronização. Evite renomeá-los ou excluí-los diretamente no GitHub.

As alterações não apareceram no outro computador

No computador que fez a alteração, clique em “Sincronizar” e aguarde a confirmação. Depois, sincronize o segundo computador. Verifique também se ambos usam a mesma configuração global.

O token sumiu após limpar o navegador

Isso é esperado: a credencial fica somente no armazenamento local. Reconfigure o equipamento na área central com o Gist ID e um token autorizado; ao abrir o Financeiro, ele fará a mesclagem automaticamente.

Preciso recuperar uma versão anterior

Não edite o JSON manualmente. Abra o Gist no GitHub e consulte o histórico de revisões. Antes de restaurar qualquer versão, preserve uma cópia do estado atual e confirme a operação com a pessoa responsável pelo sistema.