💬 Contexto: Ambiente mapeado, cronograma aprovado, método de implantação definido. Agora vem a parte que a maioria acha que é a implantação inteira — mas que na verdade é só uma das etapas: instalar e configurar o sistema. A diferença entre um técnico experiente e um iniciante não está em saber instalar mais rápido. Está em seguir um roteiro, documentar cada passo e não improvisar quando algo dá errado.

Antes de instalar qualquer coisa

Instalação sem preparação é a causa número um de retrabalho em implantações. Antes de rodar o primeiro comando, o técnico precisa ter em mãos:

• ✅ O levantamento do ambiente do cliente (feito no planejamento)
• ✅ O roteiro de instalação documentado
• ✅ As credenciais necessárias (banco de dados, servidor, etc.)
• ✅ O arquivo .env configurado para o ambiente de produção
• ✅ Backup dos dados existentes (se houver)
• ✅ Um plano de rollback — o que fazer se a instalação falhar

<aside> 🔴

Regra importante: se qualquer item dessa lista estiver faltando, a instalação não começa. Improvisar credenciais ou configurações em produção é uma das formas mais comuns de criar problemas difíceis de rastrear.

</aside>

🏗️ Requisitos de Infraestrutura

Cada sistema tem requisitos mínimos para funcionar. Parte do trabalho do técnico é verificar se o ambiente do cliente atende esses requisitos antes da instalação.

Para um sistema Node.js com PostgreSQL, os requisitos típicos são:

Hardware mínimo

Software necessário

Se algum requisito não for atendido, isso precisa ser resolvido antes de avançar. Nunca tente instalar o sistema em ambiente incompatível esperando que funcione.

🛣️O Roteiro de Instalação 🛣️

Um roteiro de instalação é uma lista de passos numerados, na ordem correta, que qualquer técnico consegue seguir e reproduzir. Não existe instalação "de cabeça" em produção.