Guia de Atualização Manual para o Z-PRO v4 (Frontend)

---

Bora pra ação! Este é um guia detalhado de como atualizar manualmente o seu Z-PRO para a versão 4. Este processo é recomendado para quem usa a versão 3 (em Vue) e possui uma infraestrutura personalizada ou uma instalação antiga, onde o autoinstalador pode encontrar dificuldades.

Vamos seguir o passo a passo para garantir uma migração tranquila para o novo frontend em Next.js e todas as suas vantagens, como as integrações nativas com a API Oficial do WhatsApp, Instagram e Messenger.

Passo 1: Preparação do Ambiente

A preparação correta é 90% do sucesso. Siga estes passos com máxima atenção:

1. Conecte-se como `deployzdg`: Acesse seu servidor via SSH ou SFTP usando o usuário deployzdg. Este passo é primordial para evitar problemas de permissão nas pastas do projeto.
2. Suba o Pacote de Atualização: Usando um cliente SFTP (como o Bitvise), envie o arquivo update.zip para a pasta /home/deployzdg/. O arquivo deve ficar no mesmo nível da sua pasta Zpro.io.
3. Renomeie o Frontend Antigo: Dentro da pasta Zpro.io, renomeie a pasta frontend para frontend-old. Isso irá "desativar" a versão antiga.
4. Identifique a Porta Antiga (MUITO IMPORTANTE): Navegue até a pasta frontend-old que você acabou de renomear e abra o arquivo server.js. Procure pela linha que define a porta (port). Anote este número (geralmente é 4444). Vamos precisar dele para que o novo frontend funcione com seu domínio atual sem precisar mexer no Nginx.

Passo 2: Atualizando os Arquivos e Instalando o Novo Frontend

Agora, com o ambiente preparado, vamos aos comandos no terminal.

1. Descompacte a Atualização: No terminal, na pasta /home/deployzdg/, execute:

   unzip update.zip

   O sistema perguntará se você deseja sobrescrever os arquivos. Pressione a tecla A e depois Enter para confirmar e sobrescrever tudo.

2. Instale as Dependências do Novo Frontend:

   cd Zpro.io/frontend
   npm install -f

3. Configure o Arquivo de Ambiente:

   Na pasta frontend, crie um novo arquivo chamado .env.local. Dentro dele, cole o seguinte conteúdo, substituindo a PORTA pela que você anotou no Passo 1:

   NEXT_PUBLIC_BACKEND_URL=https://sua-api.com.br
   NEXT_PUBLIC_ENCRYPTION_KEY=zdg-default-key
   NEXT_PUBLIC_INTERATIVE_BAILEY=false
   PORT=4444

   Certifique-se de que a NEXT_PUBLIC_BACKEND_URL esteja correta e que a PORT seja exatamente a mesma usada pelo seu frontend antigo.

4. Compile a Nova Versão:

   npm run build

   Aguarde a conclusão do build. Se sua máquina tiver pouca memória RAM, este processo pode falhar. Nesse caso, pare alguns processos do PM2 temporariamente ou crie um arquivo de swap.

Passo 3: Gerenciando os Processos com PM2

Com o novo frontend pronto, precisamos parar o processo antigo e iniciar o novo.

1. Liste os Processos Atuais:

   pm2 list

2. Identifique e Delete o Frontend Antigo: Encontre na lista o processo correspondente ao seu frontend antigo (geralmente terá "frontend" ou "server" no nome). Anote o ID dele e execute o comando para deletá-lo:

   pm2 delete [ID_DO_PROCESSO]

3. Salve a Nova Lista do PM2:

   pm2 save

4. Inicie o Novo Frontend com PM2: Certifique-se de que você ainda está no diretório Zpro.io/frontend e execute:

   pm2 start npm --name "zpro-frontend" -- run start

Passo 4: Atualizando o Backend

Para garantir a compatibilidade com a nova versão, é crucial atualizar o backend também.

1. Navegue até a Pasta do Backend:

   cd ../backend

2. Instale Novas Dependências:

   npm install -f

3. Execute as Migrações do Banco de Dados:

   npx sequelize db:migrate

4. Execute os Seeders (para popular novas tabelas):

   npx sequelize db:seed:all

5. Reinicie Todos os Processos:

   pm2 restart all

Pronto! Após esses passos, sua instância do Z-PRO estará 100% atualizada para a versão 4. Acesse seu domínio e aproveite as novidades. Depois de confirmar que tudo está funcionando, você pode deletar a pasta frontend-old para liberar espaço.

Qualquer dúvida, é só chamar. Tamo junto!