Pesquisadores do Instituto Metrópole Digital (IMD/UFRN) desenvolveram um novo sistema capaz de automatizar a comunicação no processo de revisão de código moderna (Modern Code Review – MCR). A solução, intitulada Smart Review, foi registrada junto ao Instituto Nacional da Propriedade Industrial (INPI) em maio e serve para deixar automáticos processos antes excessivamente manuais, como é o caso da comunicação entre desenvolvedores e revisores de código.

O sistema atua como uma ponte entre plataformas de comunicação (como Slack e Discord) e repositórios Git (controle de versão). Em outras palavras, a tecnologia automatiza a comunicação para capturar eventos de criação, atualização, aprovação ou rejeição de códigos, e em seguida, envia mensagens padronizadas para um canal de comunicação por meio de chatbots.

“Toda a comunicação se torna assíncrona. O desenvolvedor produz no melhor momento possível para ele e é completamente automático, diferente do manual de antes, o que otimiza significativamente os processos”, explica Alex Paiva, engenheiro de software criador da tecnologia.

Elaborado a partir de uma monografia de Trabalho de Conclusão de Curso (TCC) de Paiva, a ferramenta está disponível publicamente no GitHub, com código aberto.

Prática essencial

Conforme explica Paiva, a revisão de código por pares é uma prática essencial na engenharia de software moderna. A atividade consiste em um desenvolvedor (autor) submeter suas alterações a um ou mais revisores, que analisam o código em busca de defeitos, melhorias e aderência a padrões.

No entanto, há um problema recorrente nessa comunicação: a necessidade de notificar manualmente revisores, bem como acompanhar processos, lembrar prazos, entre outros aspectos.

“Normalmente, esse trabalho é totalmente manual. O desenvolvedor termina um código, acessa o canal e a pessoa que estiver disponível sinaliza que vai atender 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, só acompanhar”.

Como exemplo hipotético, o autor descreve um ambiente de desenvolvimento do IMD, com equipes de até dez desenvolvedores front-end que geram por volta de 20 solicitações de revisão por dia.

Cada um dos pedidos implicaria em: menções aos revisores, acompanhamento do status e envio de mensagens quando o código é ajustado. “Esse processo repetitivo consumia tempo e não tinha controle de prazo; revisões poderiam levar dois ou três dias, travando o andamento do projeto”, explica o engenheiro.

Estudo de caso

O trabalho de Paiva, redigido em 2025 e hoje disponível no repositório da UFRN, incluiu um estudo de caso com a equipe de front-end do SmartRetail – projeto de Pesquisa e Desenvolvimento (P&D) do IMD para controle de vendas de produtos. No estudo, o autor comparou duas semanas de comunicação manual com duas semanas utilizando o Smart Review.

Os resultados, coletados por meio de questionários com os desenvolvedores, revelaram satisfação de 100% no quesito de economia de tempo no processo de revisão.

Outros benefícios foram: facilitação na colaboração entre revisores e autor; garantia de que os comentários seguissem padrões e diretrizes da equipe; clareza e consistência das mensagens automáticas e auxílio considerável para o atendimento de prazos.

Além disso, a ferramenta possibilitou aos times de desenvolvimento um entendimento maior do tempo gasto com as revisões, de modo a evitar gargalos e melhorar a previsibilidade das entregas.

“Com a ferramenta, a gente implementou uma funcionalidade que, ao passar 24h, se ninguém viu a mensagem do bot, encerra-se o processo e continua o fluxo para não parar o desenvolvimento. Porque se o desenvolvimento parar, as entregas atrasam e o cliente não fica feliz”, destaca Alex Paiva.

Funcionalidades

Criado inicialmente em 2024, o Smart Review foi desenvolvido em Python utilizando o framework Django e o Django REST Framework para a construção da API. A ferramenta foi projetada para ser genérica e configurável, ou seja, o administrador pode definir as etapas do processo de revisão de código de acordo com a política de cada equipe.

Além disso, o manual de implantação, que acompanha o trabalho, permite que qualquer organização – não apenas a UFRN – configure o Smart Review para suas próprias ferramentas de controle de versão e comunicação. Isso facilita, segundo o autor, a escala do uso do Smart Review junto a diferentes contextos e instituições.

Já em uso no IMD, o sistema também mantém um histórico completo de eventos de cada solicitação de revisão (quem criou, quando foi atribuída, quando foi aprovada ou rejeitada, etc.), permitindo auditorias e análises de desempenho posteriores.