[ajuda] dia a dia

Como atualizar o AFK sem perder meus dados

atualize pelo painel, em Atualização, no botão Atualizar agora. A atualização troca só as pastas do sistema. A pasta meu-negocio\ e o arquivo .env nunca são tocados, e ela faz uma cópia do sistema antes e desfaz sozinha se algo falhar.

O que fica e o que muda

Fica como está	Recebe a versão nova
`meu-negocio\`: clientes, agenda, loja, financeiro, conteúdo, memória e configurações do negócio	As pastas do sistema, como `motor\`, `ferramentas\`, `painel\` e `.claude\`
`.env`: as suas chaves de conexão	O arquivo `VERSION` com o número da versão
`meu-negocio\credenciais\`: a sua licença
Arquivo do sistema que você mudou	A versão nova desse arquivo vai para `meu-negocio\atualizacao\<versão>\` e você decide depois

Passo a passo

Confira a licença. A atualização só chega com a licença ativa. Veja E-mail da licença, licença perdida e troca de computador.
Faça um backup antes (recomendado). No painel, clique em Backup na barra de baixo e depois em Fazer backup agora.
Veja se tem versão nova. Na barra de baixo do painel aparece versão X disponível quando existe uma. Clique nela para abrir a aba Atualização. Lá aparecem a versão instalada, a mais nova e o que mudou.
Atualize. Clique em Atualizar agora e depois em Confirmar: atualizar agora. Pode levar alguns minutos.
Abra de novo. Quando aparecer Atualizado, feche o painel e abra de novo pelo iniciar.bat.

Na conversa, você pode pedir "tem versão nova do AFK?". O AFK confere e só aplica com o seu "sim".

Pelo PowerShell, dentro da pasta do AFK:

python ferramentas\setup\atualizar-afk.py
python ferramentas\setup\atualizar-afk.py --aplicar

O primeiro comando só confere. O segundo aplica.

Arquivos que você personalizou

Se você mudou algum arquivo do sistema, a atualização mantém o seu e avisa no fim. Para ver a lista:

python ferramentas\setup\atualizar-afk.py --pendentes

Para juntar as suas mudanças com a versão nova, peça na conversa: "junta minhas mudanças com a versão nova".

Erros e soluções

O que aparece	O que fazer
`sem licenca configurada`	Ative a licença. Veja E-mail da licença, licença perdida e troca de computador.
`ja esta na ultima versao.`	Nada a fazer.
`nao consegui checar (rede/servidor indisponivel)`	Confira a internet e clique em Checar de novo mais tarde.
`assinatura do AFK inativa`	O AFK segue funcionando como está. Para receber versões novas, renove pelo painel, em Licença.
`esta licenca ja esta em 2 computadores`	Libere a vaga de um deles. Veja E-mail da licença, licença perdida e troca de computador.
`ssh-keygen nao encontrado nesta maquina`	O AFK confere a assinatura do pacote com o OpenSSH do Windows. Nas Configurações do Windows, procure Recursos opcionais e adicione o Cliente OpenSSH.
`ASSINATURA INVALIDA`	O pacote recebido não é o oficial. Nada foi aplicado. Não atualize por outro caminho e siga Travou ou quero sugerir uma melhoria: o que mandar.
`smoke-test FALHOU — desfazendo a atualizacao`	A versão nova não passou no teste e o AFK voltou para a anterior sozinho. A cópia fica na pasta `afk-backup-sistema`, ao lado da pasta do AFK. Siga Travou ou quero sugerir uma melhoria: o que mandar.
`Não atualizou (nada foi trocado)`	O motivo vem depois dos dois pontos. Siga Travou ou quero sugerir uma melhoria: o que mandar com print dessa mensagem.

A palavra "atualiza" sozinha, na conversa, faz o AFK revisar a memória do negócio. Para trocar a versão, fale "atualiza o sistema" ou "tem versão nova?".

Se nada funcionar

Siga Travou ou quero sugerir uma melhoria: o que mandar e mande o número da versão (arquivo VERSION) e o print da aba Atualização.

Uso do dia a dia

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.