Uma boa demo ao vivo permite que um desconhecido entre com um clique, veja o app cheio de dados realistas, experimente o fluxo principal e saia sem conseguir quebrar nada para o próximo visitante. Para chegar lá, você precisa de quatro coisas: um ambiente de demo separado de todo o resto, um seeder que crie dados críveis, um reset automático programado e uma lista curta de recursos que ficam desativados ou simulados no modo demo.
Para quem compra código-fonte, a demo é o que há de mais próximo de um test drive. Ela é um dos principais sinais de confiança abordados no nosso guia sobre como vender o código-fonte do seu web app ou SaaS, e na AppTrovo uma URL de demo é exigida pela checklist de envio de produto, a menos que o seu produto realmente não tenha interface, como um backend só de API. Este artigo é a parte técnica: como construir a demo para que ela funcione no dia 300 tão bem quanto no primeiro dia.
Os exemplos usam Laravel porque muitos produtos do marketplace são construídos com ele, mas todas as ideias se aplicam a outras stacks.
Qual modelo de demo você deve escolher?
Existem quatro formas comuns de rodar uma demo pública. A maioria dos vendedores deve começar pela primeira e só passar para a segunda se os visitantes continuarem atrapalhando uns aos outros.
| Modelo | Como funciona | Pontos fortes | Pontos fracos |
|---|---|---|---|
| Demo compartilhada com reset programado | Uma instalação; todos usam as mesmas contas; os dados são restaurados mais ou menos a cada hora | Barata, simples, funciona para quase qualquer app | Os visitantes veem as alterações uns dos outros até o próximo reset |
| Sandbox por visitante | Cada visitante recebe um tenant ou banco de dados novo, apagado depois de algumas horas | Experiência limpa, sem interferência | Mais código e mais recursos de servidor; exige jobs de limpeza |
| Demo somente leitura | Os visitantes podem navegar, mas as gravações são bloqueadas | Nada pode ser quebrado ou usado de forma abusiva | Os compradores não conseguem testar o fluxo principal, o que enfraquece a demo |
| Vídeo passo a passo | Um tour gravado em vez de uma instalação ao vivo | Zero manutenção | Os compradores não conseguem explorar; funciona melhor como complemento, não como substituto |
Se o seu produto já é multi-tenant, um sandbox por visitante costuma ser fácil: crie um novo tenant a partir de um modelo na primeira visita e apague os tenants com mais de algumas horas. Para apps de uma única empresa, a demo compartilhada com resets é a escolha prática.
Passo 1: Crie um ambiente de demo separado
Nunca rode a demo no mesmo servidor, banco de dados ou bucket de armazenamento de qualquer coisa que importe para você. Uma demo pública com acesso de administrador é um convite para sondagens.
- Use um subdomínio próprio, como
demo.yourproduct.com, com o seu próprio certificado TLS. - Dê a ela um usuário de banco de dados próprio, com permissões apenas no banco da demo.
- Use um arquivo de ambiente dedicado com uma flag como
APP_DEMO=true, para que o seu código possa verificarconfig('app.demo')em um único lugar. - Desative o modo debug.
APP_DEBUG=falseem uma demo pública é obrigatório; um stack trace pode vazar caminhos e configurações. - Use credenciais falsas para todos os serviços de terceiros: chaves de pagamento em modo de teste, um mailer de log ou sandbox, nenhum gateway de SMS real.
- Publique o mesmo build que os compradores baixam. Uma demo que roda uma versão mais nova ou mais antiga que o ZIP gera confusão e chamados de suporte.
Passo 2: Popule a demo com dados realistas
Um dashboard vazio não vende nada. A demo deve parecer uma empresa que já usa o app há alguns meses. Escreva um seeder dedicado, por exemplo DemoSeeder, separado do seeder mínimo que os compradores executam na instalação. A documentação de seeding do Laravel explica a mecânica.
O que torna os dados de demo críveis
- Datas relativas a hoje. Gere registros com deslocamentos como
now()->subDays(rand(1, 90)). Datas fixas no código fazem a demo parecer abandonada em poucas semanas, e os gráficos mostram meses vazios. - Nomes e valores plausíveis. Use uma biblioteca como o Faker com uma seed fixa, para que os dados sejam os mesmos após cada reset, e depois escreva à mão os registros que aparecem nas capturas de tela.
- Todos os status representados. Mostre faturas pagas, vencidas e em rascunho; chamados abertos, pendentes e fechados. Os compradores querem ver como cada estado aparece.
- Volume suficiente para testar paginação e busca, mas não tanto a ponto de deixar os relatórios lentos. Algumas centenas de registros por tabela principal geralmente é o ideal.
- Arquivos e imagens enviados. Popule avatares, fotos de produtos ou documentos a partir de uma pasta no repositório, para que as páginas não mostrem imagens quebradas.
- Nenhuma pessoa real. Nunca use dados exportados de um projeto de cliente, mesmo “anonimizados”. Gere os dados.
Uma história por trás dos dados ajuda
Escolha uma empresa fictícia e crie dados que combinem com ela: “Greenleaf Paisagismo, 12 funcionários, 140 clientes, serviços agendados para esta semana.” Uma história coerente dá sentido aos relatórios e dashboards, e permite escrever um tour guiado curto na página de login (“Abra a agenda de hoje e arraste um serviço para outro técnico”).
Passo 3: Torne o login fácil
Cada passo extra entre clicar em “Demo ao vivo” e ver o app faz você perder visitantes. No modo demo, mostre as contas de demonstração diretamente na página de login:
- Um botão por perfil: “Entrar como Admin”, “Entrar como Gerente”, “Entrar como Funcionário”, “Entrar como Cliente”. Cada botão preenche o formulário ou envia para uma rota de login exclusiva da demo.
- Credenciais exibidas também em texto, para os visitantes que preferem digitá-las e para a seção de demo do seu anúncio.
- Um link para o frontend ou para a área do cliente, se o app tiver, como uma página de agendamento ou um portal do cliente.
- Um banner em todas as páginas: “Modo demo. Os dados são redefinidos a cada hora. Os e-mails não são enviados.” Isso evita relatos de bugs confusos.
Proteja a rota de um clique para que ela só exista quando config('app.demo') for verdadeiro. Incluir uma rota de login sem senha no download do comprador, mesmo desativada, é um risco de que você não precisa.
Passo 4: Redefina a demo automaticamente
Os visitantes vão apagar registros, mudar configurações e enviar arquivos estranhos. Um reset programado coloca tudo de volta no lugar. Escolha a estratégia que combina com o tamanho dos seus dados.
| Estratégia de reset | Como | Indicada para |
|---|---|---|
| Reconstruir com migrations e seeders | Execute php artisan migrate:fresh --seed --seeder=DemoSeeder --force | Conjuntos de dados pequenos a médios; sempre corresponde ao schema atual |
| Restaurar um snapshot do banco de dados | Popule uma vez, faça o dump do banco e restaure o dump a cada reset (por exemplo, com pg_restore ou mysql) | Conjuntos de dados grandes, em que o seeding leva minutos |
| Recriar um contêiner | Rode a demo a partir de uma imagem com os dados embutidos e substitua o contêiner conforme a programação | Produtos em contêineres; o isolamento mais limpo |
| Apagar tenants por visitante | Um job remove sandboxes com mais de uma idade definida | Produtos multi-tenant que usam sandboxes por visitante |
Um comando de reset que não quebra sessões
Envolva o reset em um único comando, como demo:reset, e agende-o com o scheduler do framework, por exemplo Schedule::command('demo:reset')->hourly(). Veja a documentação de agendamento de tarefas do Laravel. O comando deve:
- Colocar o app em modo de manutenção, com uma página amigável de “A demo está sendo redefinida, voltamos em um minuto”.
- Reconstruir ou restaurar o banco de dados.
- Limpar os arquivos enviados do armazenamento público e copiar de volta os arquivos de seed.
- Limpar caches, jobs na fila e sessões, para que os visitantes não fiquem logados como usuários que não existem mais.
- Colocar o app de volta no ar e acessar a página inicial uma vez para aquecer os caches.
A cada hora funciona para a maioria dos apps. Se o seu reset leva mais de um minuto, execute-o com menos frequência ou passe a usar snapshots. Se puder, mostre o horário do próximo reset no banner da demo.
Passo 5: Bloqueie o que os visitantes não podem alterar
Algumas ações são inofensivas na instalação de um comprador e prejudiciais em uma demo pública. Bloqueie-as no modo demo, de preferência em um único middleware ou policy, para que você veja a lista completa de relance.
- E-mail e SMS de saída. Use o mailer de log para que nada saia do servidor. Caso contrário, sua demo vira um relay de spam gratuito por meio do formulário “convidar usuário”.
- Senhas e e-mails das contas de demo. Se um visitante mudar a senha do administrador, todos os outros visitantes ficam bloqueados até o próximo reset.
- Uploads. Restrinja tipos e tamanhos de arquivo de forma mais rígida do que em produção, e nunca sirva arquivos enviados a partir de um caminho onde eles possam ser executados.
- Requisições de saída. Webhooks, botões de “testar conexão” e importadores por URL podem ser usados de forma abusiva para fazer o seu servidor chamar outros servidores. Desative-os ou simule-os.
- Instalador, backups, atualizações e configurações do sistema. Oculte telas que revelam caminhos, valores de ambiente ou que permitem executar comandos.
- Pagamentos. Use o modo de teste do provedor de pagamento e mostre o número do cartão de teste na página de checkout.
Quando uma ação for bloqueada, mostre uma mensagem clara (“Desativado na demo”) em vez de uma página 403, para que os visitantes saibam que o recurso existe. Adicione também limitação de taxa (rate limiting) no login e no envio de formulários; o OWASP Top Ten é um lembrete útil do que os atacantes tentam primeiro em web apps públicos.
Passo 6: Mantenha a demo fora dos resultados de busca e monitorada
- Adicione uma regra noindex. Você quer que o seu anúncio ranqueie, não as páginas administrativas da demo com dados falsos. O Google explica as opções no seu guia sobre bloquear a indexação com noindex.
- Monitore o uptime. Vale a pena configurar um verificador de uptime gratuito que avise quando a demo cair. Uma demo quebrada em um anúncio faz você perder vendas em silêncio.
- Confira o log de reset. Registre o início, o fim e o resultado de cada reset e gere alertas em caso de falha. Um reset que falha e deixa a demo em modo de manutenção é uma indisponibilidade comum e evitável.
- Fique de olho no espaço em disco. Uploads, logs e snapshots antigos crescem. Rotacione os logs e limpe o armazenamento durante o reset.
- Atualize a cada release. Publique a demo a partir da mesma tag que você empacota e adicione “Demo atualizada” à sua checklist de release. Nosso guia de suporte, atualizações e versionamento inclui essa checklist.
Checklist da demo ao vivo
- Subdomínio, usuário de banco de dados e armazenamento separados.
APP_DEBUG=falsee uma flag de demo no ambiente.- Chaves em modo de teste para todos os serviços de terceiros; mailer de log para e-mails.
- Seeder de demo dedicado com datas relativas, todos os status e arquivos populados.
- Login com um clique por perfil, credenciais exibidas em texto, banner de demo em todas as páginas.
- Reset programado que limpa banco de dados, arquivos, caches, filas e sessões.
- Bloqueio de troca de senha, requisições de saída e telas de configuração perigosas.
- Rate limiting no login e nos formulários.
- Noindex na demo, monitoramento de uptime e alertas de reset.
- A versão da demo corresponde à versão disponível para download.
Quando a demo estiver sólida, coloque o link para ela na primeira tela do seu anúncio (veja como escrever um anúncio de produto que vende código) e adicione a URL da demo no formulário do produto quando você anunciar o produto na AppTrovo.
Perguntas frequentes
Com que frequência uma demo pública deve ser redefinida?
A cada hora é um padrão sensato para uma demo compartilhada. Redefina com mais frequência se os visitantes costumam deixar a demo em um estado quebrado ou constrangedor, e com menos frequência se o reset demora ou se os seus dados raramente mudam. Sempre mostre aos visitantes quando acontecerá o próximo reset.
A demo deve dar acesso total de administrador?
Sim, na maioria dos casos. Os compradores querem ver o painel administrativo e as configurações, porque é lá que vão passar o tempo. Dê acesso total de administrador, mas bloqueie o pequeno conjunto de ações que quebrariam a demo para os outros ou exporiam o servidor, como alterar as senhas da demo ou executar backups.
Preciso de uma demo se já tenho um vídeo?
Um vídeo ajuda, mas não substitui uma demo ao vivo. Os compradores usam a demo para verificar a velocidade, o layout no próprio dispositivo e detalhes que um vídeo pula. Use o vídeo como uma visão geral rápida e a demo como a prova.
Como evito spam por meio da minha demo?
Direcione todos os e-mails para um driver de log, desative SMS e webhooks de saída, aplique rate limiting em formulários e logins e redefina a demo regularmente para que qualquer conteúdo injetado desapareça. Nunca deixe a demo enviar mensagens reais para endereços que os visitantes digitam.
Posso rodar a demo em uma hospedagem compartilhada barata?
Pode, se a hospedagem suportar cron e o seu reset terminar rápido, mas um VPS pequeno costuma ser mais confiável e permite isolar a demo adequadamente. Seja qual for a sua escolha, mantenha a demo longe de servidores que guardam dados reais.