Um Trabalho de Conclusão de Curso (TCC) desenvolvido no Instituto Metrópole Digital (IMD/UFRN) deu origem ao Smart Review, uma ferramenta criada para automatizar a comunicação entre desenvolvedores e revisores durante processos de análise de código. A tecnologia, registrada junto ao Instituto Nacional da Propriedade Industrial (INPI) em maio, busca reduzir atividades manuais e aprimorar a organização das etapas de revisão em equipes de desenvolvimento de software. O trabalho foi apresentado para obtenção do grau de Engenheiro de Software por Alex Sandro de Paiva, sob orientação do professor Gibeon Soares de Aquino Junior. A notícia é da Agência de Comunicação da UFRN.
O sistema foi desenvolvido como parte do TCC e funciona por meio da integração entre plataformas de comunicação, como Slack e Discord, e repositórios Git, utilizados para controle de versões de código. A ferramenta acompanha eventos relacionados às revisões, como abertura de solicitações, alterações, aprovações e recusas, e envia automaticamente notificações aos canais definidos pelas equipes por meio de chatbots.
“Toda a comunicação se torna assíncrona. O desenvolvedor produz no melhor momento possível para ele, e tudo ocorre de forma completamente automática, diferentemente do processo manual anterior, o que otimiza significativamente os fluxos de trabalho”, explica o criador da tecnologia.
Automação de uma etapa estratégica
A revisão de código é uma etapa fundamental no desenvolvimento de sistemas, pois permite que alterações sejam avaliadas por outros profissionais antes de serem incorporadas aos projetos. Durante essa fase, os revisores analisam aspectos como qualidade, possíveis falhas e adequação aos padrões adotados pelas equipes.
Apesar da importância da prática, a comunicação envolvida no processo ainda costuma depender de ações manuais. Desenvolvedores precisam avisar colegas sobre novas solicitações, acompanhar respostas e verificar se as revisões foram concluídas dentro do prazo.
“Normalmente, esse trabalho é totalmente manual. O desenvolvedor finaliza um código, acessa o canal, e a pessoa que estiver disponível sinaliza que vai realizar o code review”, conta Paiva. “Com o Smart Review, você cria a solicitação, e o sistema já dispara a mensagem no canal. Você não precisa fazer mais nada, apenas acompanhar.”
Segundo o autor, a automação desse fluxo permite que as equipes tenham maior previsibilidade sobre o andamento das tarefas e reduzam interrupções causadas pela falta de comunicação entre os integrantes.
Avaliação em ambiente real
A eficácia da ferramenta foi analisada em um estudo de caso realizado com a equipe de front-end do SmartRetail, projeto de Pesquisa e Desenvolvimento (P&D) do IMD voltado ao controle de vendas de produtos.
O trabalho comparou períodos em que o processo era conduzido manualmente com a utilização do Smart Review. A avaliação dos desenvolvedores apontou benefícios relacionados à economia de tempo, à colaboração entre autores e revisores e à padronização das mensagens trocadas durante as análises.
A ferramenta também passou a registrar informações sobre cada solicitação de revisão, como responsáveis envolvidos, etapas realizadas e resultados obtidos. Esse histórico possibilita acompanhar o desempenho dos processos e identificar possíveis pontos de melhoria.
“Com a ferramenta, implementamos uma funcionalidade que, após 24 horas, encerra automaticamente o processo caso ninguém tenha visualizado a mensagem do bot, permitindo a continuidade do fluxo de trabalho e evitando a paralisação do desenvolvimento. Porque, se o desenvolvimento parar, as entregas atrasam e o cliente não fica satisfeito”, destaca Paiva.
Código aberto e possibilidade de expansão
Criado inicialmente em 2024, o Smart Review foi desenvolvido em Python, utilizando o framework Django e o Django REST Framework para construção da API. O sistema foi planejado para ser adaptável, permitindo que diferentes equipes configurem o funcionamento da revisão de código conforme suas próprias necessidades.
Além do uso no IMD, a ferramenta conta com documentação de implantação que possibilita sua adoção por outras organizações. Disponibilizado em código aberto, o projeto permite que desenvolvedores e instituições possam utilizar, avaliar e contribuir para a evolução da solução.
Gostou desta matéria? Apoie você também este projeto de divulgação científica. Considere apoiar com um pix de R$ 10 para contato@nossaciencia.com