Central de Ajuda Quaza Provedores

Como atualizar cliente(s) (PT)

Como atualizar cliente(s) — Quaza

Neste manual vamos demonstrar como atualizar os clientes.

Neste manual vamos demonstrar como atualizar os clientes.

 

COMO ATUALIZAR CLIENTE(S):

1. Acesse o lançador: Abra o lançador do sistema.

2. Acesse o sistema do cliente

  • Clique em Sistema
  • Digite o nome do cliente
  • Se solicitado, clique em Accept

3. Acesse o diretório do sistema:

cd  /var/www/html/quaza/

4. Verifique a última atualização do cliente:

svn info

Exibe informações sobre a última atualização.

5. Volte para o diretório anterior:

cd ..

6. Verifique se há tarefas em execução:

ps -aux | grep php

ps -aux | grep mysql

  • PHP: pode ter 1 processo rodando (caso sejam os padrões, exemplo na foto abaixo:)

  • MySQL: idealmente até 2 processos (os os padrões também, exemplo na foto abaixo:)

🔴 Caso seja necessário e esteja dando problema, você pode encerrar/matar uma tarefa com o comando abaixo:

kill -9 [ID da tarefa]

Substitua [ID da tarefa] pelo número exibido na lista.

⚠️ Importante: Antes de executar este comando, **confirme com um colega mais experiente se é seguro encerrar a tarefa.

7. Se estiver tudo certo, atualize o cliente:

🔄 Atualizando o Cliente

svn up quaza/ areadocliente/

⚠️ Se o cliente tem quaza/ e areadocliente/ separados, atualize os dois individualmente.
(Você percebe isso no TAB)

8. Será solicitada a senha:

Senha: pm@1351d
A atualização será iniciada após inserir a senha.

9. Volte para o diretório anterior novamente:

cd ..

⚠️ Apenas para o SISTEMA (não para a área do cliente)

10. Verifique o status do Flyway:

flyway/flyway info

  • Veja se há alguma migração pendente (pending) ou se está tudo sucesso (success)

11. Se houver pending, execute a migração:

flyway/flyway migrate

12. Verifique novamente:

flyway/flyway info

  • Se estiver tudo success, finalize com:

exit

13. Acesse o Backuper para gerar o monitor e os codificados:

http://172.24.0.10/backuper/

usuario: quaza

senha: #QZ232@ti

 

Vá em Monitor > Configuração > Pesquise pelo cliente

Abra os dois acessos que aparecerem: o do Sistema e o do Portal (área do cliente), conforme mostra a imagem abaixo:

Após isso:

Teste a conexão para verificar se está tudo certo.

Em seguida, clique em Gerar Monitor.

Depois clique em Gerar Codificados.

Faça isso tanto para o Sistema quanto para o Portal.

Glossário

Termo Significado
Quaza Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico.
Provedor Empresa que opera o sistema Quaza.
Cliente Assinante final do serviço de internet/telefonia/TV.
Contrato Vínculo formal entre cliente e provedor.
Operador Funcionário que opera o sistema.
Permissão Direito de acesso vinculado a papel.
Auditoria Registro de quem fez o quê e quando.
API REST Interface programática para integração externa.
Webhook Notificação automática para sistemas externos.
Cron / crontab Tarefa agendada que roda automaticamente.

Pegadinhas frequentes

1. Permissões mal configuradas. Operador sem acesso ao módulo não consegue executar a ação descrita.
2. Dados faltando em pré-requisito. Esta tela depende de cadastros anteriores estarem completos.
3. Cache do navegador. Após mudança, force refresh (Ctrl+F5) se a tela não atualizar.
4. Operação irreversível. Algumas ações não podem ser desfeitas — confira antes de salvar.
5. Filtros ativos. Listas filtradas escondem registros — limpe filtros se faltar dado.

FAQ

Quem pode acessar essa funcionalidade?

Depende da permissão do usuário. Confira com o administrador do Quaza se você não vê a opção.

O que fazer se aparecer um erro?

Anote a mensagem completa, screenshot, e abra um chamado no suporte do Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal do Cliente. Verifique no módulo Portal .

Posso integrar via API?

Sim — a maioria das funcionalidades do Quaza expõe endpoints REST. Consulte a documentação técnica.

Quaza tem treinamento oficial?

Sim — equipe de suporte oferece sessões de onboarding sob agendamento.

Ciclo completo da operação

CICLO COMPLETO DE OPERAÇÃO QUAZA ───────────────────────────────── ┌──────────────────────────────────────────┐ │ 1. PREPARAÇÃO │ │ ───────────── │ │ - usuário com permissão correta │ │ - cadastros pré-requisitos prontos │ │ - integrações configuradas │ │ - equipe treinada nas operações │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 2. EXECUÇÃO │ │ ──────────── │ │ - input do operador, API ou cron │ │ - validação automática de dados │ │ - persistência transacional │ │ - log de auditoria com timestamp/user │ │ - notificações por email/Slack/webhook │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 3. EFEITOS COLATERAIS │ │ ────────────────────── │ │ - dashboards atualizados em tempo real │ │ - relatórios refletem nova mudança │ │ - webhook dispara sistemas externos │ │ - histórico do registro atualizado │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 4. ACOMPANHAMENTO │ │ ───────────────── │ │ - revisão periódica (semanal/mensal) │ │ - identificação de desvios e exceções │ │ - ajustes finos de configuração │ │ - treinamento contínuo da equipe │ └──────────────────────────────────────────┘

Boas práticas operacionais

Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que provedores experientes adotam para evitar erros recorrentes e maximizar valor extraído do Quaza.

Antes de operar

  • Confirme permissão de acesso: nem todo operador tem permissão para todas as funcionalidades. Verifique com o administrador do Quaza se algo não aparece como esperado. Permissões são vinculadas a papéis (operador, supervisor, admin).
  • Cadastros pré-requisitos completos: muitas funcionalidades dependem de outros cadastros estarem completos antes. Por exemplo, antes de criar um contrato você precisa ter o cliente cadastrado, plano de vendas configurado, e regras de cobrança definidas.
  • Treine pelo menos 2 operadores: redundância previne paralisação por ausência. Funcionário pode sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
  • Documente procedimentos internos: crie checklist próprio para operações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operação

  • Documente decisões não óbvias: se você ajustou algo de forma diferente do default, anote o porquê. Próximo operador agradece e evita refazer análise.
  • Operações em massa pedem cuidado: antes de aplicar a 100+ registros, teste com 5 e revise resultado completo. Se possível, exporte CSV antes para ter como rollback.
  • Backup antes de mudanças grandes: cancelar/desfazer pode não ser possível em todas as ações. Em dúvida, faça export ou imprima tela antes.
  • Comunique alterações: mudanças que impactam outras equipes (atendimento, financeiro) devem ser anunciadas com antecedência. Surpresa gera retrabalho.

Acompanhamento e revisão

  • Revisão semanal de 30 minutos: dedique tempo regular para revisar o que rodou, falhou, ficou pendente neste módulo. Anomalia detectada cedo custa 10x menos que descoberta tarde.
  • Defina KPIs próprios: 2-3 indicadores que medem saúde da operação. Acompanhe tendências, não só valores absolutos. Variação maior que 20% merece investigação.
  • Auditoria mensal: revise sample de operações do mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
  • Compare com período anterior: "Vendi R$ 100k" — é bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

  • Anote a mensagem de erro completa: copie o texto exato. Captura de tela ajuda. Anote quais passos levaram ao problema — facilita diagnóstico.
  • Tente reproduzir em ambiente de teste: se possível, simule o erro com dado dummy antes de pedir suporte. Isso acelera resolução.
  • Procure no histórico: provavelmente alguém já viu erro similar. Veja log de auditoria para entender o que mudou recentemente.
  • Abra chamado bem documentado: equipe de suporte do Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada provedor define seus próprios indicadores, mas alguns são quase universais para qualquer operação no Quaza:

  • Volume mensal processado (registros/transações/eventos)
  • Taxa de erro (% de operações que falharam)
  • Tempo médio de processamento
  • Cobertura (% da carteira atendida pela funcionalidade)
  • Satisfação operacional (feedback da equipe que usa)

Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.

Recursos relacionados no Quaza

Este recurso se conecta com outros módulos do sistema. Conhecer essas conexões ajuda no troubleshooting e em decisões operacionais:

  • Cadastro de cliente — base de tudo no Quaza. Cliente bem cadastrado evita problemas downstream.
  • Plano de Contas — onde o impacto financeiro é classificado contabilmente.
  • Logs de auditoria — histórico de quem fez o quê e quando, essencial para diagnóstico.
  • Permissões e papéis — definem quem pode operar o quê.
  • Tarefas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para operação eficiente:

  • Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão pode esconder registros antigos.
  • Exportação: a maioria das listas exporta para CSV/Excel. Útil para análise externa ou backup pré-mudança.
  • Histórico: cada registro tem timeline de modificações. Acesse via botão "Histórico" ou aba lateral.
  • Atalhos de teclado: Ctrl+F (busca), Ctrl+S (salvar), Esc (cancelar) na maioria das telas.
  • Permissão restrita: se botão estiver cinza, é falta de permissão — não bug.