🛠️ Criacción del Projeto del Aplicativo Este guia explica como utilizar o script automático responsável por criar toda a estrutura del aplicativo del cliente.

Este guia explica como utilizar o script automático responsável por criar toda a estrutura del aplicativo del cliente. O processo es simples e elimina diversas etapas manuais de configuración.

📍 Localizacción del Script

O script está localizado en la mesma pasta del app base.

No macOS, o caminho padrão é:

Para acceder a pasta utilizando o Terminal:

▶️ Executando o Script

Dentro de la pasta correta, execute:

O script solicitará três informações:

• Cliente: nome del proveedor

• URL Portal: endereço completo del portal del cliente

• Slug: identificador curto usado para gerar builds Android e iOS

  • Também es usado como identifier del app en las lojas

🧩 O Que o Script Faz

Después inserir os dados, o script executa automaticamente diversas ações:

• Cria a pasta del novo app dentro de Projects

• Copia o projeto base para la nova estrutura

• Realiza ajustes internos para permitir a build em Android e iOS

• Gera todas as imagens necessárias para publicacción (ícones, splashes etc.)

Um detalhamento completo de los processos executados pelo script está disponível aquí .

🖼️ Ajustando a Logo (se necessário)

Caso as imagens geradas en el fiquem adequadas — seja por baixa resolução ou qualidade insuficiente — basta:

1. Substituir o arquivo logo.png dentro de la pasta del projeto del cliente

2. Pelo terminal, navegue até a pasta del projeto del cliente:

1. Rode o comando node make.js images

O script vai regenerar automaticamente todas as imagens.

🔁 Atualizacción de Projetos Já Publicados

Se o cliente já tem um app publicado, o slug debe ser exatamente o mesmo que está sendo usado en las lojas.

Exemplo:
O app de la Atos Telecom tem identifier: br.com.pixelmidia.appatosnet

Portanto, o slug correto é: atosnet

Se o projeto for criado com slug incorreto, es possível ajustar manualmente posteriormente, porém isso puede impactar a atualizacción del app já publicado.

⚙️ Build del Projeto

O script também realiza as builds de Android e iOS, com um processo igualmente simples.

▶️ Gerando Builds

1. Pelo terminal, navegue até a pasta del projeto del cliente:

2. Execute:

O script fará automaticamente:

• Build del Android

• Build del iOS

Os arquivos gerados podem ser encontrados en la pasta builds del projeto.

Para atualizacción del sistema, o comando build aceita parâmetros para latualizar a versão de build del android ou ios, en el seguinte formato:

node make.js build android {versao} ios {versao}

📦 Dónde Encontrar os Arquivos Gerados

Después a conclusão, os arquivos serão criados en la raiz de la pasta del cliente:

• Android: release.aab

• iOS: {nomeDoCliente}.iap

Publicacción

• O arquivo Android (.aab) debe ser enviado para la Play Store através del Google Console

• O arquivo iOS (.iap) puede ser aberto diretamente para envio en el processo de la App Store

As instruções detalhadas de publicacción estão disponíveis en las páginas:

• Android

• iOS

Glosario

Trampas frecuentes

FAQ

Quem puede acceder essa funcionalidade?

Depende de la permiso del usuário. Confira com o administrador del Quaza se usted en el vê a opção.

O que hacer se aparecer um erro?

Anote a mensaje completa, screenshot, e abra um chamado en el soporte del Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal del Cliente. Verifique en el módulo Portal .

Posso integrar via API?

Sim — a maioria de las funcionalidades del Quaza expõe endpoints REST. Consulte a documentacción técnica.

Quaza tem treinamento oficial?

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

Ciclo completo de la operacción

Boas práticas operacionais

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

Antes de operar

• Confirme permiso de acesso: nem todo operador tem permiso para todas as funcionalidades. Verifique com o administrador del Quaza se algo en el aparece como esperado. Permissões son 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 usted necesita ter o cliente cadastrado, plano de ventas configurado, e regras de cobranza definidas.
• Treine pelo menos 2 operadores: redundância previne paralisacción por ausência. Funcionário puede sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
• Documente procedimentos internos: crie checklist próprio para elperações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operacción

• Documente decisões en el óbvias: se usted ajustou algo de forma diferente del default, anote o porquê. Próximo operador agradece e evita refazer análise.
• Operaciones 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 puede en el ser possível em todas as ações. Em dúvida, faça export ou imprima pantalla antes.
• Comunique alterações: mudanças que impactam outras equipes (atención, 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 de la operacción. Acompanhe tendências, en el só valores absolutos. Variacción maior que 20% merece investigacción.
• Auditoría mensal: revise sample de operações del mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
• Compare com período anterior: "Vendi R$ 100k" — es bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

• Anote a mensaje de erro completa: copie o texto exato. Captura de pantalla 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 soporte. Isso acelera resolução.
• Procure en el 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 soporte del Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada proveedor define seus próprios indicadores, mas alguns son quase universais para qualquer operacción en el Quaza:

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

Compare valores atuais com média de los últimos 3 meses. Variacción maior que 20% em qualquer direção merece investigacción — puede ser melhoria sustentável ou degradacción silenciosa.

Recursos relacionados en el Quaza

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

• Cadastro de cliente — base de tudo en el Quaza. Cliente bem cadastrado evita problemas downstream.
• Plano de Cuentas — donde o impacto financeiro es classificado cuentabilmente.
• Logs de auditoria — histórico de quem fez o quê e cuando, essencial para diagnóstico.
• Permissões e papéis — definem quem puede operar o quê.
• Tareas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para elperacción eficiente:

• Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão puede escdonder registros antigos.
• Exportacción: a maioria de las listas exporta para CSV/Excel. Útil para lanálise externa ou backup pré-mudança.
• Histórico: cada registro tem timeline de modificações. Acceda via botón "Histórico" ou aba lateral.
• Atalhos de teclado: Ctrl+F (busca), Ctrl+S (guardar), Esc (cancelar) en la maioria de las pantallas.
• Permiso restrita: se botón estiver cinza, es falta de permiso — en el bug.