Pular para o conteúdo
71

Dev foi embora e não deixou documentação: como manter o sistema?

Galera, tô passando por uma situação bem complicada aqui. Eu trabalho em uma empresa que contratou um desenvolvedor freelancer pra criar um sistema interno. O problema é que ele foi embora e não deixou nenhuma documentação sobre o que foi feito. O sistema tá rodando, mas eu não tenho a menor ideia de como ele foi construído, quais tecnologias foram usadas e muito menos como fazer manutenção ou implementar novas funcionalidades. Já tentei entrar em contato com o dev, mas ele não responde mais. Estou preocupado porque, se algo quebrar, não vou saber como consertar. Alguém já passou por isso? Como vocês lidaram com a falta de documentação? O que posso fazer pra entender melhor o sistema e garantir que ele continue funcionando? Estou pensando em contratar alguém pra me ajudar, mas não sei nem por onde começar. Agradeço qualquer dica ou experiência que vocês puderem compartilhar.

Carla Freitas Carla Freitas · Desenvolvedor React/Next.js há 4 dias 271 visualizações 4 respostas

Receba ajuda de nossos Especialistas

Temos um time de especialistas treinado para te ajudar com o que você precisa.

Falar com Especialista

4 Respostas

49
Melhor resposta

Olha, essa situação é mais comum do que parece. A primeira coisa que eu faria é tentar entender o sistema por meio de uma análise de código. Se você tiver acesso ao repositório, comece a explorar os arquivos. Tente identificar as principais tecnologias usadas, como frameworks e bibliotecas. Uma dica é usar ferramentas como o Postman para testar as APIs e entender como elas funcionam. Além disso, considere fazer uma documentação própria enquanto explora o sistema. Isso vai te ajudar a ter um guia para futuras manutenções. Se você não se sentir confortável fazendo isso, pode ser uma boa ideia contratar um desenvolvedor que tenha experiência em refatoração de código. Um profissional pode cobrar entre R$ 100 a R$ 200 por hora, dependendo da complexidade do sistema e da região. O importante é agir rápido para evitar problemas maiores no futuro.

Amanda Lima Amanda Lima 91 karma há 4 dias
25

Outra dica é tentar fazer uma análise de dependências do projeto. Ferramentas como o npm ou o Composer podem te ajudar a entender quais pacotes estão sendo utilizados. Isso pode te dar uma ideia melhor de como o sistema foi construído e quais partes são críticas. Além disso, se você tiver acesso ao banco de dados, vale a pena dar uma olhada nas tabelas e relacionamentos. Isso pode te ajudar a entender a estrutura do sistema e como os dados estão sendo manipulados.

Renata Castro Renata Castro 29 karma há 4 dias

Receba ajuda de nossos Especialistas

Temos um time de especialistas treinado para te ajudar com o que você precisa.

Falar com Especialista
25

Por último, não subestime o poder da comunidade. Você pode postar perguntas específicas sobre partes do código que não entende em fóruns como Stack Overflow ou até mesmo aqui na Comunidade BRFreelas. Muitas vezes, outros desenvolvedores já passaram por situações semelhantes e podem oferecer insights valiosos. Além disso, se o sistema for muito complexo, considere a possibilidade de reescrever partes dele, mas isso deve ser feito com cautela e planejamento. O custo pode ser alto, mas pode valer a pena a longo prazo.

Sérgio Moreira Sérgio Moreira 973 karma há 4 dias
23

Uma alternativa que pode ajudar é buscar por freelancers ou consultores que tenham experiência em sistemas semelhantes. Você pode encontrar profissionais em plataformas como a BRFreelas ou Workana. Muitas vezes, eles conseguem entender o sistema rapidamente e podem te ajudar a criar uma documentação mais robusta. Além disso, eles podem sugerir melhorias e otimizações que você nem imaginava. O custo pode variar, mas é sempre bom fazer uma pesquisa de preços antes de fechar com alguém.

Isabela Ramos Isabela Ramos 1.242 karma há 4 dias