Plano de modernização pronto, orçamento preliminarmente aprovado. O fornecedor faz a primeira pergunta: «Onde está a documentação do sistema?». Descobre-se que existe uma wiki atualizada pela última vez há cinco anos, alguns esquemas «algures num disco de rede» e código que serve de documentação a si próprio. A proposta sobe um terço. Porque o fornecedor não está a orçamentar trabalho, mas incerteza.
Este texto descreve uma prática que tira essa incerteza da mesa: antes de alguém tocar no código de uma aplicação antiga, reconstitui-se o conhecimento sobre ela. Até há pouco tempo, uma etapa destas significava semanas de trabalho de um analista e poucos se decidiam por ela. Hoje, a IA executa a maior parte dessa análise em dias úteis. E isso muda a ordem de todo o projeto.
Primeiro o mapa, depois o código
Modernizar um sistema sem documentação atualizada é como renovar um edifício sem a planta das instalações. É possível, mas cada parede demolida é uma lotaria: pode não haver nada atrás dela, ou pode haver um cano do qual depende meio piso. Nas aplicações, esse cano é muitas vezes uma integração com o armazém de dados de que só o autor do código se lembrava, ou uma exportação noturna que a contabilidade usa discretamente.
Por isso, a ordem sensata é inversa à intuitiva. Não se começa por escrever código novo, nem sequer pelo orçamento. Começa-se pelo mapa.
O que a IA extrai do código, da base de dados e dos logs
As ferramentas modernas de análise conseguem ler três fontes de verdade sobre um sistema: o código-fonte, a estrutura da base de dados e os logs do funcionamento em produção. Do cruzamento delas nasce um mapa do sistema que abrange quatro camadas.
A primeira são os módulos: do que o sistema é feito e pelo que cada parte responde, descritos numa linguagem compreensível também para quem está fora do IT. A segunda são os fluxos de dados: por onde os dados entram, o que lhes acontece pelo caminho, onde acabam. A terceira são as integrações, ou seja, todos os pontos em que a aplicação comunica com outros sistemas: contabilidade, armazém, loja, parceiros. São elas que mais frequentemente se partem durante as alterações.
A quarta camada é a menos óbvia: o código morto. A análise dos logs mostra que funções não são chamadas há anos e em que tabelas ninguém escreve desde 2019. Nos sistemas mais antigos, esse lastro representa muitas vezes uma parte considerável do todo. Cada linha que não é preciso migrar é uma poupança real no projeto.
O que o mapa muda na decisão «reescrever ou modernizar»
Sobre a decisão em si escrevemos à parte, no texto sobre os quatro critérios: framework de decisão. O mapa do sistema dá a esses critérios dados concretos. Sem ele, a dívida tecnológica avalia-se por intuição e o risco com base em anedotas. Com ele, vê-se preto no branco: que módulos trazem valor de negócio, quais estão mortos, onde estão as integrações que elevam o risco de cada alteração.
Os resultados surpreendem nos dois sentidos. Às vezes, um sistema que «tem de ser reescrito de raiz» revela-se saudável em três quartos e basta substituir dois módulos. Outras vezes é o contrário: a aplicação parece inofensiva e o mapa revela uma dúzia de ligações não documentadas que tornam a modernização parcial mais cara do que a reescrita. Em ambos os casos, a decisão assenta em dados, não em emoções. E o fornecedor que recebe um mapa em vez de um enigma orçamenta trabalho em vez de risco.
Na nossa opinião, a reconstituição do mapa deve ser uma etapa autónoma e inicial do contrato de modernização, com a sua própria aceitação. Mesmo que depois dessa etapa decida que a modernização será feita por outro, ou que não a fará de todo, a documentação fica na empresa e continua a trabalhar.
Como verificar o que a IA gerou
A documentação gerada automaticamente não é um oráculo. É preciso verificá-la. O método mais eficaz é simples: uma revisão com a pessoa que melhor conhece o sistema, muitas vezes a única na empresa. A diferença face à abordagem clássica está no papel dessa pessoa. Não lhe pede que redija o conhecimento, coisa de que ninguém gosta e que se arrasta durante meses. Pede-lhe uma revisão de uma descrição pronta, e apontar «aqui está certo, aqui não» é várias vezes mais rápido do que escrever de raiz.
Uma boa prática é percorrer alguns dos processos mais importantes do princípio ao fim: encomenda, fatura, reclamação. Se o mapa descreve corretamente os fluxos críticos e os detalhes verificados por amostragem, pode confiar-se nele nas restantes áreas. Isso faz-se num dia.
O que a IA não consegue reconstituir
Aqui, uma ressalva honesta: o código diz o que o sistema faz, mas não diz para quê. Uma exceção estranha no cálculo de um desconto pode ser um erro, ou um acordo comercial de 2016 que continua a vigorar para um grande cliente. Isso nenhuma análise de código resolve. As intenções de negócio de há uma década reconstituem-se com entrevistas: conversas curtas com as pessoas das vendas, da contabilidade e das operações, conduzidas já com o mapa na mão. O mapa sugere o que perguntar, mas as respostas estão nas pessoas.
Um tema à parte é também o ambiente da aplicação: servidores, rede, cópias de segurança. Sobre a documentação dessa camada escrevemos no texto sobre a auditoria da documentação de infraestrutura.
Na ESKOM AI, conduzimos a etapa de mapeamento com uma equipa de agentes de IA especializados sob a supervisão de engenheiros experientes: a análise de um sistema empresarial típico demora dias úteis e o resultado é documentação legível para a administração e para a equipa técnica. Se depois dela for tomada a decisão de modernizar, os trabalhos seguintes decorrem num processo automatizado de desenvolvimento de software com uma bateria completa de testes — unitários, de integração, E2E, de UI, de segurança e de desempenho.
Por onde começar na sua empresa
Escolha um sistema: aquele cuja modernização adia há mais tempo ou no qual mais receia tocar. Encomende a reconstituição do seu mapa como uma etapa autónoma e pequena, antes de pedir a alguém um orçamento de reconstrução. Numa consulta gratuita, diremos como planear essa etapa e o que esperar dela.
Marque uma consulta gratuita através do formulário de contacto →