A empresa troca de fornecedor, traz o sistema para dentro de casa ou herda o projeto de uma equipe que saiu. Em todos os casos, alguém assume um código que não escreveu.
Antes da primeira mudança, confira os 10 itens abaixo.
1. Credenciais e acessos
Levante todas as credenciais: ambientes, repositório, ferramentas de publicação, serviços de nuvem e contas em serviços de terceiros. Inclua as chaves de API. A equipe anterior costuma deixá-las em arquivos de configuração.
Depois, troque as senhas e revogue os acessos da equipe anterior.
2. Onde o código está
Descubra onde o código está hospedado. Confirme que o repositório está atualizado e que o código compila. Verifique se as dependências externas estão registradas e disponíveis.
3. Código e produção são a mesma versão
Confirme que o código recebido é o mesmo que roda em produção. Se não for, a primeira publicação pode desfazer correções que só existiam no servidor.
4. Ambientes
Identifique os ambientes, como homologação e produção, e a configuração de cada um. Sem isso, você não consegue planejar os testes.
5. Como uma mudança chega à produção
Descubra o procedimento de publicação. Existe integração e entrega contínuas (CI/CD), ou a publicação é manual? Quem tem permissão para publicar?
6. Estratégia de branch
Entenda como a equipe anterior criava, juntava e mantinha os branches. Depois de entender a estratégia atual, você pode mudá-la.
7. Alertas na compilação e na publicação
Registre os alertas (warnings) que aparecem ao compilar e ao publicar. O alerta ignorado hoje costuma virar o erro de amanhã.
8. Testes automatizados
Verifique se existem testes automatizados, o que eles cobrem e se ainda passam. A cobertura mostra quanto você pode confiar no código na hora de mudá-lo.
9. Qualidade do código
Avalie a estrutura, a documentação e a facilidade de manutenção. Anote os pontos fracos: alguns pedem ação imediata, outros podem esperar.
10. Mudanças no banco de dados
Descubra como a equipe alterava o esquema do banco de dados. Existe migração versionada, ou os scripts rodavam à mão? Mudança de esquema sem controle é o caminho mais curto para a perda de dados.
Onde a IA ajuda
Um assistente de código pode ler o repositório e propor um resumo da arquitetura, das dependências e dos pontos de risco. Esse resumo pode encurtar a primeira semana.
O resumo é ponto de partida, não conclusão. Você só confirma credenciais, acessos e a versão em produção olhando os ambientes.
Antes de enviar o código a uma ferramenta de IA, confirme que o contrato permite. O código pode pertencer a outra empresa.
Depois do checklist
Com os 10 itens conferidos, monte o plano de melhoria: o que corrigir já e o que pode esperar. Enquanto for possível, mantenha um canal aberto com a equipe anterior.
Para ver como a CTGF conduz esse tipo de projeto, veja a página Consultoria.