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 →Caderno de operação
Como organizar repositório, produção, aliases e rollback para que cada projeto tenha uma única origem verificável.
Solicitar triagem clínica →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.
Cada produto ativo deve caber em uma linha de inventário. Essa linha conecta identidade, código e publicação sem alternativas implícitas.
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.
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.
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.
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.