Ir para o conteúdo
For Sellers

Suporte, atualizações e versionamento para vendedores de código

Como aplicar o versionamento semântico e um changelog claro a um aplicativo web que os compradores instalam e personalizam, lançar atualizações que eles realmente conseguem aplicar e escrever uma política de suporte com limites justos. Inclui exemplos de entradas de changelog e um modelo de política.

• Nov 17, 2026 • 13 min de leitura
Suporte, atualizações e versionamento para vendedores de código

Quem compra código-fonte se preocupa com uma coisa acima de todas as outras: este produto continuará sendo mantido depois que eu pagar? Você responde a isso com três hábitos. Use o versionamento semântico para que o número da versão diga aos compradores o quanto uma atualização é arriscada. Mantenha um changelog que explique cada lançamento em linguagem simples. E publique uma política de suporte que diga qual ajuda está incluída, por quanto tempo e o que não está incluído.

Esses hábitos transformam uma venda única em um relacionamento e são uma parte importante do que faz os compradores confiarem em um anúncio, como descrito no nosso guia sobre como vender o código-fonte do seu aplicativo web ou SaaS. Este artigo trata da parte prática: numerar lançamentos, escrever entradas de changelog, empacotar atualizações para instalações personalizadas e definir limites de suporte que protejam o seu tempo.

Como o versionamento semântico se aplica a um aplicativo web?

O Versionamento Semântico usa três números, MAJOR.MINOR.PATCH. A especificação foi escrita para bibliotecas com uma API pública, então você precisa decidir qual é a sua “API pública” quando vende um aplicativo inteiro. Para um produto de código-fonte, é tudo aquilo de que o comprador depende ao instalar, configurar, personalizar e atualizar:

  • Requisitos do servidor (versões da linguagem, do banco de dados e das extensões).
  • Variáveis de ambiente e chaves de configuração.
  • O esquema do banco de dados que os compradores podem consultar ou estender.
  • Pontos de extensão: hooks, eventos, pastas de sobrescrita, arquivos de tema, classes documentadas.
  • A sua API REST, os webhooks e os formatos de importação ou exportação.

Uma mudança que obriga os compradores a alterar qualquer um desses itens é uma mudança incompatível, mesmo que o aplicativo pareça igual.

MudançaIncremento de versãoExemplo
Correção de bug sem alteração de requisitos, configuração ou pontos de extensãoPATCH (de 2.4.1 para 2.4.2)Corrigir totais errados no relatório mensal
Correção de segurança compatível com versões anterioresPATCHAdicionar a verificação de autorização que faltava na rota de exportação
Novo recurso; as instalações existentes continuam funcionando após as migraçõesMINOR (de 2.4.2 para 2.5.0)Adicionar lembretes por SMS como módulo opcional
Nova configuração ou variável de ambiente opcional com um padrão seguroMINORAdicionar REPORTS_CACHE_MINUTES, padrão 10
Aumento da versão mínima do PHP ou do banco de dadosMAJOR (de 2.5.0 para 3.0.0)Exigir PHP 8.4
Chave de configuração renomeada, hook removido, resposta da API alteradaMAJORRenomear o tratamento de MAIL_FROM; remover a API v1 obsoleta
Atualização de versão principal do framework que altera os caminhos de sobrescritaMAJORMigrar para uma nova versão principal do framework com uma nova estrutura de pastas

Duas regras práticas ajudam: marque como obsoleto antes de remover (avise em uma versão MINOR e remova na MAJOR seguinte) e mantenha as versões MAJOR raras e bem documentadas. Os compradores perdoam mudanças incompatíveis; o que eles não perdoam são surpresas.

Escreva um changelog em que os compradores possam confiar

Um changelog é escrito para pessoas, não gerado a partir de mensagens de commit. O formato amplamente usado Keep a Changelog agrupa as mudanças em Added, Changed, Deprecated, Removed, Fixed e Security, com o lançamento mais recente no topo e uma data para cada versão. Veja um exemplo de como são boas entradas:

[3.0.0] — 10/11/2026

Notas de atualização: requer PHP 8.4. Execute as migrações. A configuração MAIL_FROM foi movida para Configurações > E-mail; os valores existentes são migrados automaticamente. Se você sobrescreve resources/views/invoices, compare a sua cópia com o novo template.

Adicionado — Faturas recorrentes com lembretes automáticos. — Tradução para japonês.

Alterado — O layout do PDF da fatura agora suporta descrições longas de itens.

Removido — A API REST v1, marcada como obsoleta na 2.6.0. Use a v2.

Segurança — Os arquivos CSV exportados agora ficam disponíveis apenas para usuários com a permissão Relatórios.

[2.6.1] — 22/09/2026

Corrigido — O calendário exibia os agendamentos com uma hora de diferença após a mudança do horário de verão.

Repare nos detalhes: a data, as notas de atualização antes da lista, a configuração exata que mudou de lugar, a pasta que pode precisar de atenção e o motivo de algo ter sido removido. “Correções de bugs e melhorias” não diz nada ao comprador e sinaliza que talvez nem você saiba o que mudou.

Publique o changelog em três lugares: como arquivo no download, no seu anúncio e dentro da área administrativa do aplicativo, se você tiver um aviso de atualização. Uma entrada recente e datada no anúncio é um dos sinais mais fortes de que o produto está vivo.

Lance atualizações que os compradores realmente consigam aplicar

Quem compra código-fonte personaliza. Se o seu processo de atualização pressupõe uma instalação intocada, cada lançamento vira uma onda de tickets de suporte. Projete pensando na personalização desde o início.

Dê às personalizações um lugar seguro

  • Pastas de sobrescrita para views, traduções e temas, que o seu código verifica antes dos próprios padrões.
  • Eventos e hooks em pontos importantes (fatura criada, usuário cadastrado) para que os compradores possam adicionar comportamentos sem editar as classes principais.
  • Configurações e ajustes para tudo o que um comprador razoavelmente desejaria alterar.
  • Um service provider personalizado ou uma pasta de módulos que as atualizações nunca sobrescrevem.

Documente esses pontos de extensão; nosso guia sobre documentação que reduz os tickets de suporte mostra como escrever o guia de personalização.

Empacote cada lançamento corretamente

  1. Pacote completo: o código inteiro para novas instalações e para compradores que nunca personalizaram nada.
  2. Notas de atualização: mudanças de requisitos, migrações, novas configurações, arquivos alterados que os compradores podem ter sobrescrito.
  3. Uma lista dos arquivos alterados desde o lançamento anterior, para que os compradores que editaram arquivos principais saibam o que comparar.
  4. Migrações de banco de dados que rodam com segurança sobre os dados existentes e são testadas em uma cópia de um banco de dados realista.
  5. Um fluxo de atualização recomendado: fazer backup dos arquivos e do banco de dados, colocar o aplicativo em modo de manutenção, substituir os arquivos, executar as migrações, limpar os caches, testar e colocá-lo de volta no ar.

Para compradores que usam Git, sugira manter o seu lançamento original em uma branch separada e fazer o merge de cada novo lançamento na branch personalizada deles. Os conflitos mostram então exatamente onde as alterações deles encontram as suas. Se o seu produto é construído com Laravel, inclua nas suas notas o link para o próprio guia de atualização do framework sempre que um lançamento passar para uma nova versão principal do framework.

Avise os compradores de que existe uma atualização

Na AppTrovo, você publica uma nova versão do seu produto, e os compradores podem baixar as novas versões enquanto o período de suporte e atualizações deles estiver ativo. Você também pode exibir um aviso de atualização dentro do aplicativo: a API pública de produtos retorna a versão atual, então a sua área administrativa pode compará-la com a versão instalada e criar um link para o changelog. Verifique no máximo uma vez por dia e nunca bloqueie o aplicativo se a verificação falhar. O guia de integração de licenças inclui um exemplo.

Checklist de lançamento

  1. Escolha o número da versão usando a tabela acima.
  2. Escreva a entrada do changelog e as notas de atualização.
  3. Execute os testes e depois instale o lançamento em um servidor limpo.
  4. Atualize uma cópia da versão anterior com dados realistas e algumas sobrescritas aplicadas.
  5. Atualize a documentação e as capturas de tela que mudaram.
  6. Gere o pacote a partir de um commit com tag, sem arquivos de desenvolvimento, logs ou segredos.
  7. Implante a mesma build na sua demonstração ao vivo.
  8. Envie a nova versão e atualize o changelog do anúncio.
  9. Acompanhe os tickets de perto por 48 horas e esteja pronto com uma versão PATCH.

Escreva uma política de suporte com limites justos

Sem uma política escrita, o “suporte” passa a incluir desenvolvimento sob medida, administração de servidores e aulas. Uma política curta no seu anúncio e na sua documentação evita isso, e os compradores gostam de saber o que esperar. Na AppTrovo, cada produto tem um período de suporte incluído que você configura (6 meses por padrão), e você pode permitir que os compradores comprem um suporte mais longo no checkout ou o estendam depois.

Aqui está um modelo que você pode adaptar:

Política de suporte

Incluído: ajuda para instalar o produto em um servidor compatível; respostas a perguntas sobre recursos e configurações; correções de bugs no código original; atualizações de segurança; orientação sobre onde fazer personalizações comuns.

Não incluído: desenvolvimento sob medida ou novos recursos para um único comprador; correção de problemas causados por modificações no código; configuração de servidor, hospedagem ou provedor de e-mail além dos requisitos documentados; plugins ou serviços de terceiros.

Como obter ajuda: abra um ticket de suporte a partir da sua compra. Informe a versão do produto, o ambiente do servidor (versão do PHP e do banco de dados), a mensagem de erro exata e os passos para reproduzi-lo.

Meta de resposta: procuramos responder em até dois dias úteis, de segunda a sexta-feira, em inglês. Problemas complexos podem levar mais tempo para serem resolvidos.

Período de suporte: o suporte e as atualizações estão incluídos pelo período indicado na página do produto e podem ser estendidos a partir do seu painel.

Defina uma meta de resposta que você consiga cumprir de verdade, inclusive nos feriados. Uma resposta confiável em dois dias é melhor do que uma resposta prometida em uma hora que você não cumpre. Se você oferece personalização paga, mencione isso separadamente para que os compradores saibam a quem recorrer.

O tempo de suporte é um custo real de cada venda. Como exemplo ilustrativo, se um comprador médio abre três tickets que levam vinte minutos cada, cada venda custa a você uma hora de trabalho durante o período de suporte. Estime esse número a partir dos tickets dos primeiros meses e leve-o em conta no seu preço; nosso guia sobre como precificar código-fonte mostra como. Garanta também que a política não contradiga os termos de licença do marketplace, que definem o que os compradores podem fazer com o código.

Torne os tickets eficientes

  • Peça a versão, o ambiente, o erro exato e os passos no próprio formulário do ticket.
  • Adicione à área administrativa uma página de informações do sistema que os compradores possam copiar para um ticket.
  • Responda com um link para a documentação e um breve resumo, e melhore a página se o link não tiver ajudado.
  • Responda publicamente a avaliações e perguntas quando a resposta também ajudar futuros compradores.

Trate os problemas de segurança de forma diferente

As correções de segurança merecem um processo próprio, porque os compradores executam o seu código nos servidores deles, com os dados dos clientes deles.

  • Publique uma forma de relatar vulnerabilidades, como um endereço de e-mail dedicado na sua documentação. Um arquivo security.txt, definido na RFC 9116, é um lugar padrão para colocá-lo no seu site.
  • Corrija primeiro, divulgue depois. Lance o PATCH e então descreva o problema na seção Segurança do changelog, com detalhes suficientes para que os compradores avaliem a urgência, mas sem um passo a passo de exploração.
  • Corrija as versões anteriores ainda suportadas quando for viável ou diga claramente aos compradores para qual versão eles precisam migrar.
  • Peça aos compradores que atualizem por todos os canais que você tiver: o anúncio, o aviso dentro do aplicativo e as suas respostas de suporte.

Planeje o fim da vida útil

Nenhum produto é mantido para sempre. Decida com antecedência como você vai encerrar o suporte a uma versão principal antiga ou ao produto inteiro. Anuncie isso no changelog, dê aos compradores um prazo de aviso razoável e publique uma versão final com todas as correções de segurança conhecidas. Na AppTrovo, um produto que já emitiu licenças pode ser aposentado em vez de excluído: ele deixa de ser listado, mas todas as licenças existentes continuam sendo verificadas, então as instalações dos compradores não são afetadas.

Perguntas frequentes

O que é versionamento semântico, em termos simples?

É um esquema de numeração, MAJOR.MINOR.PATCH, em que cada número diz aos usuários que tipo de mudança um lançamento contém. PATCH significa apenas correções de bugs, MINOR significa novos recursos que mantêm as configurações existentes funcionando, e MAJOR significa que algo mudou e pode exigir trabalho do usuário na atualização.

O que um changelog deve incluir?

Cada lançamento precisa de um número de versão, uma data e entradas agrupadas para o que foi adicionado, alterado, marcado como obsoleto, removido, corrigido e protegido. Para aplicativos que os próprios compradores instalam, acrescente notas de atualização no topo de cada lançamento: novos requisitos, migrações, configurações que mudaram de lugar e arquivos que as instalações personalizadas devem comparar.

Com que frequência devo lançar atualizações?

Lance as correções PATCH assim que estiverem prontas, especialmente para problemas de segurança. Muitos vendedores agrupam recursos em versões MINOR a cada um a três meses, o que dá aos compradores um ritmo previsível. Lançamentos regulares e datados importam mais do que lançamentos frequentes.

Os compradores precisam pagar pelas atualizações?

Na AppTrovo, os compradores podem baixar novas versões enquanto o período de suporte e atualizações estiver ativo e podem estender esse período. Quando ele termina, eles mantêm a versão que têm e podem continuar a usá-la nos termos da licença.

O suporte deve incluir ajuda com personalizações?

A maioria dos vendedores inclui orientação sobre onde fazer alterações comuns, mas exclui a escrita de código sob medida para compradores individuais. Diga isso claramente na sua política de suporte. Se quiser oferecer serviços de personalização, apresente-os como um serviço pago separado.