Central de Ajuda Quaza Provedores

Software de criação de APP - make.js (PT)

Software de criação de APP - make.js — Quaza

📱 Gerador Automático de Projetos de Aplicativos Este script automatiza todo o processo de criação de um novo aplicativo baseado em um projeto modelo.

Este script automatiza todo o processo de criação de um novo aplicativo baseado em um projeto modelo. Ele realiza desde a coleta de informações do cliente até a geração de imagens, configuração das plataformas iOS/Android e captura de screenshots do portal do cliente.

Abaixo está uma explicação detalhada, em ordem cronológica, de tudo o que o programa faz.

🧩 1. Coleta de informações do usuário

Ao iniciar, o script pede alguns dados essenciais:

  • Nome do cliente (obrigatório)

  • URL do portal do cliente (opcional, possui padrão automático)

  • Slug do cliente (identificador usado nas pastas, também gerado automaticamente)

Com base nesses dados, o script calcula:

  • A pasta onde o novo projeto será criado

  • O nome correto do projeto

  • A URL completa usada para acessar o portal do cliente

📂 2. Criação e preparação do novo projeto

Se o projeto do cliente ainda não existir, o script realiza uma série de etapas importantes:

🔁 Copia o projeto base

Copia toda a pasta que contém o aplicativo modelo para uma nova pasta com o nome do cliente.
Isso inclui todos os arquivos e diretórios do app, como:

  • Código-fonte do React Native

  • Arquivos de configuração

  • Estrutura base de iOS e Android

  • Recursos como imagens, assets, scripts e dependências

📦 Instala os pacotes necessários

Dentro da nova pasta do projeto, o script executa o comando responsável pela instalação das dependências do Node.js, garantindo que tudo esteja pronto para uso.

📝 Ajusta configurações do arquivo principal do app

O script altera o arquivo de configuração do aplicativo, substituindo:

  • Nome do app

  • Slug do projeto

  • URL padrão utilizada pelo app

  • Identificador do pacote Android

  • Bundle Identifier do iOS

Essas mudanças personalizam o app para o cliente atual.

⚙️ Executa o prebuild do Expo

O script roda o comando responsável por gerar as pastas nativas do iOS e Android a partir da estrutura do Expo.

🍏 Ajustes específicos no iOS

No projeto iOS, o script:

  • Modifica parâmetros internos do arquivo de configuração do sistema

  • Abre o workspace do iOS automaticamente ao final da criação do projeto

🤖 Ajustes no Android

No projeto Android, o script:

  • Insere informações sobre a chave de assinatura do aplicativo

  • Adiciona configurações de release no arquivo Gradle

  • Copia a chave .jks para dentro da pasta do Android

Essas configurações permitem que o app seja compilado e assinado corretamente.

🖼️ 3. Download da logo do cliente

Após criar o projeto, o script tenta baixar automaticamente a logo do cliente a partir do portal dele.
Caso a logo já exista no projeto, este passo é ignorado.

📸 4. Geração de screenshots

O script abre o portal do cliente em um navegador automatizado e:

  • Acessa as páginas configuradas (como login e menu)

  • Emula dispositivos como:

    • iPad Pro

    • iPhone 11 Pro Max

  • Captura imagens das telas para uso em documentação ou publicação na App Store e Google Play

  • Salva todas as screenshots dentro da pasta do projeto

Se a página tiver menu, ele também abre o menu e captura uma imagem adicional.

🖼️ 5. Geração automática de imagens do app

Usando a logo baixada, o programa cria diversas imagens necessárias para o aplicativo, como:

  • Ícones principais

  • Splash icons

  • Logos para o projeto iOS

  • Imagens com tamanhos determinados (automáticas)

O script:

  • Ajusta a imagem de fundo

  • Trata transparência

  • Centraliza a logo

  • Cria várias versões da imagem em resoluções diferentes

  • Gera ícones e splashes dentro das pastas corretas do projeto

 

Todas as imagens são criadas ou sobrescritas automaticamente.

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.