Instalação e Atualização do Sistema One (Release do PDV)

Resumo do que será ensinado
Neste documento você aprenderá, passo a passo, como instalar e atualizar o sistema Maqplan One (PDV) utilizando a Release oficial após já ter o PostgreSQL instalado, tanto em clientes novos (instalação do zero) quanto em clientes que já possuem o One (atualização de versão).

Segue um Vídeo explicativo do processo

Detalhamento do uso correto
Com este guia, você deve ser capaz de rodar a Release do One corretamente, executar como administrador, acompanhar o processo de instalação/atualização e finalizar a configuração inicial do PDV.

Segue o detalhamento de como instalar e atualizar o Maqplan One utilizando a Release

1. Primeiro passo: Garantir que o PostgreSQL já está instalado no computador.

   • Antes de instalar o One, confirme que o PostgreSQL já foi instalado:
     
     • Verifique se o serviço do PostgreSQL está ativo no sistema.
     • Confirme se a pasta de instalação do PostgreSQL foi criada (caminho padrão definido no instalador).
   • O One utiliza o PostgreSQL como banco de dados; portanto, esta etapa é pré‑requisito obrigatório.
   • Se ainda não estiver instalado, siga primeiro o guia de instalação do PostgreSQL para o One e só depois retorne a este procedimento.

2. Segundo passo: Obter o instalador (Release) mais atual do One (PDV).

   • Acesse o local onde são disponibilizadas as versões do One (por exemplo, pasta de instaladores internos da empresa).
   • Localize o arquivo da Release mais recente do PDV One, identificada por um número de versão (exemplo: 15.8.0, 15.8.6 etc.).
   • Esta numeração pode variar conforme o que foi liberado pelo programador, mas sempre será exibida na tela inicial do instalador.
   • Salve o instalador em uma pasta acessível, como Área de Trabalho ou uma pasta própria de Instalação do One.

3. Terceiro passo: Executar o instalador do One como administrador.

   • Localize o arquivo da Release do One (PDV).
   • Clique com o botão direito do mouse sobre o arquivo.
   • Selecione a opção “Executar como administrador”.
   • Esta execução com privilégios elevados é importante para permitir que o instalador:
     
     • Crie pastas em diretórios protegidos.
     • Registre componentes necessários no sistema operacional.

4. Quarto passo: Identificar a versão exibida na tela inicial do instalador.

   • Ao abrir, o instalador mostrará uma tela inicial com:
     
     • Nome do sistema (One / PDV).
     • Número da versão que está sendo instalada (por exemplo, 15.8.x).
   • Esta informação permite confirmar se você está instalando a versão correta conforme orientações técnicas.

5. Quinto passo: Iniciar o processo de instalação/atualização.

   • Na tela inicial do instalador, clique em Avançar.
   • Em seguida, clique em Instalar para iniciar o processo.
   • O instalador começará a copiar arquivos e configurar o sistema no computador.
   • Este mesmo processo serve tanto para:
     
     • Instalação do zero em clientes novos.
     • Atualização de versão em clientes que já possuem o One instalado.

6. Sexto passo: Entender o comportamento em cliente novo (instalação do zero).

   • Se o cliente ainda não possui o One instalado:
     
     • A Release irá instalar o pacote completo do sistema One no computador.
     • Serão criadas pastas de instalação, atalhos e componentes necessários.
   • Ao final, o computador passará a ter o One pronto para ser configurado (conexão com banco, ERP, etc., conforme outros guias).

7. Sétimo passo: Entender o comportamento em cliente já existente (atualização).

   • Se o One já está instalado no computador:
     
     • A Release irá remover a versão anterior do sistema.
     • Em seguida, instalará a nova versão.
   • Importante:
     
     • Este processo atualiza arquivos do sistema, não devendo apagar dados do cliente no banco PostgreSQL.
     • Ainda assim, recomenda‑se que sempre exista backup do banco antes de grandes atualizações, por segurança.

8. Oitavo passo: Aguardar a conclusão da instalação.

   • Durante o processo, será exibida uma barra de progresso com a cópia e configuração de arquivos.
   • Aguarde até que o instalador finalize todas as etapas.
   • Evite:
     
     • Fechar o instalador manualmente.
     • Desligar o computador durante o processo.

9. Nono passo: Finalizar a instalação.

   • Quando o instalador terminar, será exibida uma tela de conclusão.
   • Clique em Concluir para encerrar o processo de instalação/atualização.
   • Neste momento, o One já estará instalado/atualizado no computador.

10. Décimo passo: Verificar se o One abre corretamente após a instalação.

    • Localize o atalho do One (PDV) criado no desktop ou no menu Iniciar.
    • Abra o sistema normalmente.
    • Observe se:
      
      • O sistema inicia sem erros.
      • A tela principal é exibida corretamente.
    • Em clientes novos, ainda será necessário configurar banco e integração com ERP, conforme outros materiais da base de conhecimento.

11. Décimo primeiro passo: Confirmar atualização em clientes existentes.

    • Em clientes que já utilizavam o One:
      
      • Após abrir o sistema, confira se a versão exibida (geralmente em algum canto da tela) corresponde à nova Release instalada.
      • Teste algumas funções básicas (abrir telas, consultar cadastros) para verificar se tudo está funcionando normalmente.
    • Caso seja necessário, realize uma sincronização ou outros ajustes de acordo com os guias complementares.

12. Décimo segundo passo: Procedimentos recomendados antes de grandes atualizações.

    • Antes de atualizar muitos clientes para uma nova Release, recomenda‑se:
      
      • Validar a instalação em um ambiente de teste.
      • Garantir que haja backup recente do banco de dados em cada cliente.
      • Planejar a atualização em horários de menor movimento, para reduzir impactos operacionais.

Informações Importantes

• Resumo das principais orientações.

  • Sempre instale primeiro o PostgreSQL antes de rodar a Release do One.
  • Utilize a Release mais atual liberada pelo programador.
  • Execute o instalador do One como administrador.
  • Clique em Avançar → Instalar e aguarde a conclusão.
  • Em clientes novos, a Release instala o sistema do zero.
  • Em clientes existentes, a Release remove a versão antiga e instala a nova, mantendo o banco de dados.

• Dicas de uso.

  • Organize os instaladores em pastas com nomes que indiquem claramente a versão do One (ex.: “One_15.8.6”).
  • Mantenha um controle interno dos clientes com suas respectivas versões, para saber quem já foi atualizado.
  • Após grandes atualizações, faça testes rápidos com o cliente (abrir vendas, consultar produtos) para garantir que tudo esteja estável.

• Recomendações gerais sobre o processo.

  • Antes de atualizar, tenha sempre backup do banco PostgreSQL do cliente.
  • Não interrompa a instalação após iniciada; deixe o processo finalizar.
  • Em caso de erro durante a instalação ou ao abrir o sistema:
  • Anote a mensagem exibida.
  • Informe ao suporte técnico que o problema ocorreu na instalação/atualização via Release do One (PDV).

• Benefícios de seguir corretamente o procedimento.

  • Garantir que o Maqplan One esteja sempre na versão correta e atualizada, com as últimas melhorias e correções.
  • Padronizar a forma de instalação/atualização em todos os clientes, facilitando suporte e manutenção.
  • Reduzir riscos de falhas de sistema, mantendo um processo simples e confiável de instalação e atualização via Release.