Caderno de operação

Um projeto, um deploy, um domínio: a regra que evita versões concorrentes

Como organizar repositório, produção, aliases e rollback para que cada projeto tenha uma única origem verificável.

Solicitar triagem clínica →

Versões concorrentes parecem inofensivas até o primeiro incidente

Dois repositórios com nomes parecidos, uma configuração na raiz e outra dentro do aplicativo, um domínio apontando para um projeto antigo: cada item isolado parece administrável. Juntos, eles tornam impossível responder com rapidez a uma pergunta básica — qual código está no ar agora?

A confusão costuma aparecer como sintoma: uma correção chega ao preview e não à produção, um domínio exibe metadados antigos, o time reverte o lugar errado ou um deploy automático continua publicando uma branch abandonada.

O mapa canônico de cada projeto

Cada produto ativo deve caber em uma linha de inventário. Essa linha conecta identidade, código e publicação sem alternativas implícitas.

  • Produto: nome público e finalidade.
  • Código: organização, repositório e branch de produção.
  • Deploy: equipe, projeto e diretório de raiz.
  • Domínio: endereço principal e redirecionamentos aceitos.
  • Responsável: quem aprova, publica e recupera.

Uma configuração de build, no lugar em que a plataforma lê

Monorepos pedem disciplina adicional. A configuração efetiva deve ficar no nível ligado ao projeto de deploy. Um segundo arquivo dentro do aplicativo, com comandos diferentes, cria uma promessa que talvez nunca seja executada.

O mesmo vale para scripts paralelos de publicação. Se a produção sai pela integração entre Git e Vercel, qualquer fluxo legado precisa ser arquivado, documentado como histórico ou removido da rota ativa. Caminho alternativo não é redundância quando ninguém testa os dois; é ambiguidade.

A verificação termina no domínio público

Build aprovado e preview acessível são etapas, não conclusão. A conferência final precisa usar o domínio que clientes e mecanismos de busca encontram. Verifique resposta HTTP, redirecionamento entre www e endereço principal, canonical, título, robots, sitemap e os fluxos que gravam dados.

Também confira os erros de execução depois de gerar tráfego real de teste. Uma página estática pode responder 200 enquanto uma função usada no formulário falha em silêncio.

Rollback é parte do caminho único

Ter uma origem canônica não elimina recuperação; melhora a recuperação. O rollback deve apontar para um deploy anterior do mesmo projeto, associado a um commit conhecido. Não deve depender de ressuscitar outro repositório ou trocar o domínio para uma aplicação parecida.

Com esse desenho, incidentes deixam rastros legíveis: commit, build, domínio, horário e responsável. A equipe discute a falha concreta, não qual versão “parece ser” a correta.

Por que isso também é SEO e conversão

Mecanismos de busca precisam encontrar um endereço estável, metadados coerentes e redirecionamentos determinísticos. Pessoas precisam reconhecer a mesma promessa da busca até o contato. Quando versões concorrentes exibem conteúdo, canonical ou formulários diferentes, ambos perdem confiança.

A organização técnica não fica nos bastidores. Ela sustenta a continuidade da mensagem e impede que uma melhoria comercial seja publicada no lugar errado.