Gestão de Instalação

Como os clientes escolhem um plano, implantam uma instalação, gerenciam equipes e operam cada site a partir do console da instalação.

Interface de usuário principal:

• Preços — planos de marketing públicos
• Painel → Instalações — lista
• Detalhe da instalação — gerenciamento por abas (/dashboard/installations/{id}?tab=…)

Seleção de plano e checkout

1. Ver preços (pacotes publicados + recursos de marketing).
2. Iniciar checkout para um pacote (e complementos opcionais / cupom, se oferecidos).
3. Pague via o gateway da plataforma ativa (Stripe Checkout, Paddle, Mollie, …) ou inicie um período de teste quando o pacote tiver trial_days.
4. Em caso de sucesso, a instalação passa de pagamento pendente → provisionamento → em execução (workers do Horizon + agente do host).

Espaço reservado do screenshot: Página de preços Espaço reservado do screenshot: Revisão da finalização (bundle + adicionais) Espaço reservado do screenshot: Página de pagamento do provedor Espaço reservado do screenshot: Sucesso no faturamento / progresso do provisionamento

Se o navegador retornar antes do webhook, a página de sucesso pode confirmar a sessão com a API do provedor para que o pagamento ainda seja concluído.

Implantar uma nova instalação

As falhas aparecem nas abas **Visão geral** e **Atividade** durante a instalação; os administradores da plataforma também veem **ops/logs**.

A organização max_installations bloqueia implantações adicionais quando estiver cheia.

Gerenciamento de instalação

Abra uma instalação para obter separadores horizontais. A capacidade de faturamento depende do papel do membro (can.billing).

Placeholder de captura de tela: cabeçalho de instalação com selo de status e barra de abas

Visão geral

• Status da instalação, domínio principal, resumo do pacote.
• Operações ativas de implantação com progresso por etapas (provisionar, atualizar, reinstalar).
• Módulos incluídos no pacote: instalar/atualizar quando as versões estiverem disponíveis.
• Atualizações do núcleo/módulo com um clique quando a plataforma informar que há atualizações disponíveis (coloca um job de atualização em fila; acompanhe o progresso nesta guia).
• Reinstalar: limpeza completa (wipe) ou restaurar a partir de um backup selecionado (mesma identidade de instalação).

Configurações (senha do administrador do tenant)

• As configurações de localidade/estilo de fuso horário para a instalação foram expostas.
• Redefinir as credenciais de administrador do NexoPOS (e-mail/senha) via o agente da plataforma.

Importante: a redefinição de senha/credenciais de administrador funciona apenas quando a aplicação está instalada e em execução. Ela não terá êxito nos estados pendente/provisionamento/falha. A nova senha normalmente é exibida uma vez na interface (flash) — ela não é enviada por e-mail como substituto do SMTP.

Faturamento (inclui renovação e cancelamento)

Não há uma aba separada “Renovação”. O ciclo de vida da assinatura fica em Faturamento:

• Status atual da assinatura, período, término do período de teste.
• Lista de faturas.
• Renovar / retomar o pagamento quando estiver em atraso ou quando for necessária alguma ação.
• Cancelar renovação (acesso até o fim do período, conforme as regras do produto).
• Histórico de solicitações de reembolso / enviar (ver

Domínio

• Mostra o subdomínio da plataforma gratuita ({slug}.{base_domain}).
• Domínio personalizado quando:
  • O modo de domínio é gratuito, ou
  • O modo de domínio é addon e a instalação tem uma assinatura ativa de domínio personalizado, ou
  • O cliente pode comprar o complemento de domínio personalizado publicado nesta aba.

Fluxo: inserir nome do host → criar registros DNS (A/AAAA para o IP público da plataforma, além do host do desafio de verificação conforme instruído) → verificar (nginx + SSL). Podem ser aplicados limites diários para alterações verificadas.

Backup

Visível/útil quando a instalação tiver o add-on de Backups (ou CTA de compra quando existir um add-on de backups publicado).

• Backup completo manual ou apenas do banco de dados.
• Histórico: restaurar, baixar, excluir (dentro da política).
• Os backups automáticos da plataforma são executados no cronograma do administrador quando ativados; os clientes não configuram o cron.
• Retenção: os últimos N backups bem-sucedidos (Admin → Backups → manter os últimos).

Requer configuração de Admin S3 em funcionamento.

Registros

Busca logs de aplicativos do tenant para troubleshooting (permissões, erros do app) sem SSH.

Atividade

Registro em estilo auditoria das operações realizadas nesta instalação por membros da organização (e ações do sistema quando registradas): implantação, alterações de domínio, backups, redefinições de credenciais, ações de faturamento etc.

Jornadas comuns do cliente

O pagamento falhou

Notificação por e-mail (se SMTP) → banner de renovação / guia de Cobrança → atualizar método de pagamento → retomar. Após o período de carência, a instalação pode ser suspensa (página offline conforme as configurações de suspensão do Admin).

Cancelar vs reembolso

• Cancelar renovação: continuar a usar até ao fim do período.
• Pedido de reembolso: a aprovação do administrador conclui a instalação mais rapidamente e agenda uma exclusão definitiva mais rápida.

Dicas do operador

• O Horizon deve estar em execução ou as instalações ficarão em “provisionamento”.
• HOST_AGENT_LOCAL_REAL_CLONE=false usa um stub rápido no Docker; defina como true (ou use script no VPS) para árvores reais do NexoPOS.
• As abas de domínio/backup estão vazias? Verifique as chaves do recurso de catálogo e as configurações do Admin Domain/S3.
• Falha ao redefinir a senha? Confirme se o status está em execução.