Pular para o conteúdo principal

Guia do Suporte — Migrar um cliente para a v4

Este guia explica, passo a passo, como colocar um cliente no novo sistema de atualização automática (v4). Depois disso, o sistema do cliente passa a se atualizar sozinho.

Resumo rápido

  1. Migrar o banco do cliente manualmente até a v4 (como já é feito hoje).
  2. No painel: Atualizações → Migrar cliente para v4 → buscar o cliente → Confirmar migração.
  3. Aguardar ~30 min e conferir em Status da Migração (inclusive o Login do banco = restrito).
  4. Instalar o atualizador automático na máquina do cliente e, no 1º uso, informar CNPJ + usuário saikoo + senha admin (você copia a senha admin do próprio painel).

Antes de começar​

  • Acesso ao painel admin com permissão do menu Atualizações.
  • Acesso remoto à máquina do cliente (como nas atualizações de hoje).
  • Saber o nome do banco de dados do cliente no SQL Server (ex.: SAIKOO_NOMEDOCLIENTE).

Passo 1 — Migrar o banco até a v4 (manual)​

Esse é o único passo manual pesado, e é igual ao que já fazem hoje: atualizar o banco do cliente até a versão 4.0 (o "salto" das versões antigas para a v4).

Quando terminar, o banco do cliente estará na v4 — é esse ponto que vamos "marcar" no painel.

Passo 2 — Fazer a migração no painel​

A Migração é o que diz ao sistema: "este cliente entrou na v4". A partir daí ele passa a ser atualizado automaticamente.

  1. No painel, abra Atualizações → Migrar cliente para v4.
  2. No topo, em "Versão de baseline", selecione a versão 4.0.0.0.
  3. No campo "Buscar cliente", digite o nome, código ou CNPJ do cliente. A lista aparece conforme você digita.
  4. Localize o cliente. Ao lado dele vai aparecer uma destas situações:
    • Botão "Confirmar migração" → o cliente está disponível para migrar.
    • "Concluído" (verde) → o cliente já foi migrado. Não faça nada.
    • "Na fila" (azul) → o cutover já foi solicitado e está aguardando processamento. Não faça de novo.
  5. Se aparecer um campo "informe o nome do banco" ao lado do cliente, digite o nome do banco dele no SQL Server (ex.: SAIKOO_NOMEDOCLIENTE). Isso só aparece para clientes que ainda não têm a conexão cadastrada.
  6. Clique em "Confirmar migração" e confirme na janela.

Vai aparecer a mensagem "Migração na fila". Pronto — sua parte acabou.

O que o sistema faz sozinho depois disso: prepara o controle de versão no banco do cliente, marca o cliente como migrado, aplica automaticamente todas as atualizações de banco até a versão publicada atual (ele não precisa passar versão por versão) e cria o login exclusivo do cliente no SQL Server (btech_<código>, com acesso só ao banco dele e senha aleatória). Isso substitui o antigo login sa compartilhado.

Passo 3 — Conferir se deu certo​

O processamento acontece automaticamente em até 30 minutos.

  1. Abra Atualizações → Status da Migração.
  2. Procure o cliente na lista "Status por cliente". Ele deve aparecer com a versão de schema preenchida (ex.: v...) e sem erro.
  3. Confira a coluna "Login do banco": deve mostrar btech_<código> com a etiqueta verde restrito. Se ainda estiver compartilhado (vermelho) ou vazio, clique em "Gerar login" e aguarde alguns minutos. É esse usuário/senha que o cliente vai usar no 1º acesso (Passo 4).
  4. Se quiser acompanhar, veja o painel "Fila de jobs":
    • pendente → aguardando o processamento (aguarde).
    • processando → rodando agora.
    • concluído → deu tudo certo. ✅
    • erro → algo falhou (veja "Problemas comuns" abaixo).

Passo 4 — Instalar o atualizador automático na máquina do cliente​

Isso faz o sistema do cliente se atualizar sozinho toda vez que abrir.

Use o instalador SaikooBTech-Setup.exe na máquina do cliente — o mesmo procedimento serve tanto para instalação nova quanto para quem já tem o sistema. O passo a passo completo está em Como instalar ou atualizar.

O instalador não pergunta mais o nome do banco — não precisa digitar nada de conexão nele. Ele pergunta a pasta de instalação e o nome do atalho (veja o guia de instalação, útil para clientes com mais de uma unidade na mesma máquina).

No 1º acesso: informar o acesso ao banco​

Na primeira vez que abrir o sistema pelo atalho, aparece uma janela pedindo CNPJ, usuário e senha. Você (suporte) usa o usuário saikoo — que não depende de saber o login do salão:

  1. CNPJ do cliente.
  2. Usuário: digite saikoo.
  3. Senha: copie a "senha admin (suporte)" do painel, em Status da Migração → coluna "Senha admin (suporte)" (botão do olho para revelar, botão de copiar). Se ainda não houver uma senha admin, clique em "Gerar senha admin" ali mesmo.

Confirme. Deu certo? A janela some, o sistema abre e o launcher guarda essas credenciais — nas próximas vezes abre direto, sem perguntar. (Só volta a perguntar se a senha admin for trocada no painel.)

Por que saikoo? A senha do login real do banco (btech_<código>) o suporte normalmente não conhece. O usuário saikoo + a "senha admin" resolvem isso: a API valida essa senha e devolve as credenciais reais para o sistema, sem o suporte precisar sabê-las. Se o próprio cliente for configurar e souber o usuário/senha do banco dele, também pode usar esses no lugar de saikoo.

A partir daí, sempre que abrir, aparece uma janelinha rápida ("Verificando... / Atualizando...") e o sistema abre já atualizado.

O que os status significam (na tela de Migração)​

Aparece assimSignificaO que fazer
Botão Confirmar migraçãoCliente ainda não migradoPode migrar
Concluído (verde)Já migradoNada
Na fila (azul)Migração já solicitada, aguardandoAguardar (não repetir)

Problemas comuns​

  • "Selecione a versão de baseline..." → você esqueceu de escolher a versão no topo antes de clicar em Confirmar. Selecione a versão e tente de novo.
  • "Este cliente já foi migrado ou já está na fila" → não precisa fazer nada; ele já está no processo.
  • Passou de 30 min e não concluiu / status "erro" → não repita o cutover. Anote o nome do cliente e avise o time de desenvolvimento (o erro fica registrado no Status).
  • Cliente errado → confira sempre pelo nome + código/CNPJ na busca antes de confirmar. A migração mexe no banco daquele cliente.

Perguntas frequentes​

Preciso instalar o atualizador no mesmo momento da migração? Não obrigatoriamente, mas é o ideal fazer os dois na mesma visita: migração no painel + atualizador na máquina.

Fiz a migração duas vezes sem querer. Sem problema — o sistema bloqueia a duplicidade; o segundo pedido é recusado ("já foi migrado ou já está na fila").

O cliente pulou várias versões (estava numa v4 antiga). Tudo bem — ao fazer a migração, o sistema aplica todas as atualizações pendentes até a versão atual automaticamente.