Pular para o conteúdo
Proposta Executiva & Técnica

Engenharia Reversa
Assistida por IA
Transformação Salesforce

Afastando a ilusão da documentação viva contínua para construir uma fundação As-Is baseada em evidências — determinística, rastreável e validada por humanos.

Explorar
Propósito Central

Descoberta e Preservação

Em ecossistemas Salesforce com anos de evolução orgânica, regras vitais habitam exclusivamente em milhares de linhas de Apex, Flows fragmentados e na mente de poucos especialistas. O propósito não é implementar documentação automatizada ad aeternum.

Fotografia de Alta Fidelidade

Congelar o As-Is

Executar uma fase intensiva de descoberta para mapear e compreender de forma exata o comportamento do sistema no seu estado atual.

Implícito → Explícito

Revelar o Oculto

Extrair regras embutidas no código, evitando a perda de conhecimento crítico de negócio durante o descomissionamento ou refatoração.

Decisões Auditáveis

Embasar a Engenharia

Fornecer insumos confiáveis para que arquitetos e product owners decidam de maneira consciente o que deve ser preservado, redesenhado ou descontinuado.

Estratégia Recomendada Top-Down com Deep Dive

Descoberta guiada por Jornadas Críticas e Risco (ex: Lead-to-Cash). Agentes de IA seguem a trilha de execução (call stack), mapeando todos os componentes — isolando rapidamente código morto das áreas de alto impacto.

Além do Flosum · Pool Multifacetado

Matriz de Evidências

O comportamento dinâmico de um sistema Salesforce vai muito além do código-fonte. Para evitar falsos-positivos, a IA analisa um pool multifacetado de insumos.

Insumos Estruturais

Metadados, Apex & Flows

Verdade estrutural e versionada extraída do Flosum: código-fonte real em produção, Validation Rules, metadados de objetos e campos, classes Apex compiladas e Flows declarativos.

Apex Classes Flows Validation Rules Flosum
Estado & Configuração

Custom Metadata & Settings

Custom Metadata Types, Custom Settings e dados parametrizadores em objetos administrativos — que alteram a lógica do código em tempo de execução sem deploy.

Custom Metadata Custom Settings Admin Objects
Insumos Operacionais

Event Monitoring & Debug Logs

Logs de execução produtivos e APM traces permitem que a IA identifique ramificações de código que nunca são executadas — revelando o código zumbi oculto no sistema.

Event Monitoring Debug Logs APM Traces
Humanos & Históricos

Git & Conhecimento Tácito

O conhecimento tácito fornece o "Por quê" da regra existir, complementando o "Como" descoberto pela máquina. Inclui histórico de commits e entrevistas com especialistas.

Git History Entrevistas SME
Ativo Final · Visão Holística

Inventário de Comportamentos

Abandonamos a visão redutora de um "catálogo de IFs/ELSEs". O ativo final é um inventário holístico que mapeia todo o espectro de comportamentos sistêmicos.

Regras de Negócio Core

Lógica que traduz a operação comercial. "Contratos acima de R$ 100k exigem alçada de diretoria"

Efeitos Colaterais

Comportamentos adjacentes (side effects). "Atualizar Fase engatilha 3 processos assíncronos e 1 chamada ao ERP"

Workarounds & Exceções

Débitos técnicos parametrizados. "Validação ignorada caso Profile seja SystemAdmin ou ID = X"

Matriz de Integrações

Endpoints consumidos e APIs expostas. Mapeamento Inbound/Outbound por fluxo com dependências externas

Definition of Done
100% Cobertura Tier 1

Todos os processos "Críticos Nível 1" com Inventário rastreado até a linha de código.

Rastreabilidade Bidirecional

Cada comportamento vinculado a uma fonte de evidência inquestionável. Zero regras deduzidas sem lastro.

Validação Humana (PR Review)

Todo artefato revisado e aprovado via Pull Request por um Especialista Funcional (SME) e um Tech Lead.

Isolamento de Opacidade

Pacotes gerenciados e integrações opacas tagueadas como "Caixa Preta" com I/O documentado via logs.

As-Is → To-Be · Ponte de Transformação

Como o As-Is Molda o To-Be

A Baseline de Descoberta alimenta cada decisão de migração com respostas exatas: o que preservar, redesenhar ou descontinuar.

Retido (Migrado As-Is)

Preservação Intacta

Componentes que funcionam corretamente e possuem baixo risco. Migrados sem alteração lógica para a nova arquitetura.

Refatorado

Lógica Mantida, Tech Trocada

Regra de negócio preservada, mas implementação modernizada. Ex: Workflow Rule legado → Flow/Apex moderno com cenários BDD de paridade.

Descontinuado

Código Obsoleto Eliminado

Código zumbi, workarounds históricos e funcionalidades sem valor. Removidos com segurança graças à rastreabilidade completa do inventário.

Testes BDD de Paridade

Cenários Given-When-Then extraídos tornam-se o conjunto oficial de regressão. Se a nova arquitetura passa em todos os testes BDD do ambiente anterior, a paridade de negócio está garantida.

Strangler Fig Pattern

O Mapa de Dependências aponta as fronteiras sistêmicas ideais para desligamento incremental do monólito — sem quebrar referências externas nem interromper operações.

BPMN 2.0 · Fluxo Operacional

Modelagem do Processo

Da seleção da jornada crítica à deliberação final — cada etapa com governança e rastreabilidade.

Gatilho
Jornada Crítica
Agregar
Evidências
Análise Agêntica
(MCP)
Inventário
Markdown
Revisão Humana
(Fail-Closed)
Comitê
To-Be (ADR)
↩ Refinar Contexto/Fontes (Se Inconsistente)

Governança Fail-Closed: O modelo exige que um líder técnico valide o inventário via Pull Request. Nenhum artefato gerado pela IA prossegue sem aprovação humana explícita — mitigando 99% do risco de alucinações vazarem para os requisitos To-Be.

Análise Crítica · Transparência Total

Avaliação de Riscos e Certezas

Questionando pressupostos e antecipando atritos para desenhar uma implementação resiliente.

Sólido & Comprovado

  • Separação Descoberta vs. Doc Viva: "As-Is" congelado como projeto com início, meio e fim funciona brilhantemente em refatorações.
  • Governança Fail-Closed: Revisão via PR mitiga 99% do risco de alucinações nos requisitos To-Be.
  • Model Context Protocol (MCP): Navegação local reduz custos drasticamente vs. copiar repositório inteiro para o contexto LLM.

Ainda é Hipótese

  • Proficiência em Apex complexo: LLMs são espetaculares com Python/JS, mas Governor Limits, SOQL em Loops e padrões legados de Trigger podem causar erros de interpretação inicial.
  • A descoberta causal pode confundir impacto local com global em Trigger Handlers complexas de 20.000+ linhas.

Decisões em Aberto

  • Tratamento de Dados & IP: Metadados com PII hardcoded e regras comerciais sensíveis requerem camada Enterprise/Zero-Retention API junto à Anthropic/OpenAI.
  • Custo de Processamento: Hard caps por pipeline de análise precisam ser definidos antes da execução em escala.
Recomendação Final

Prova de Conceito:
Cancelamento no Service Cloud

Uma única jornada vertical completa — da seleção à aprovação do inventário. Quando a TI e o Negócio virem as regras implícitas e dependências mapeadas em dias, não semanas, o projeto atestará inequivocamente seu valor para a modernização final.

Em síntese

O que é Engenharia Reversa Assistida por IA

Antes de modernizar (To-Be), é preciso congelar uma fotografia de alta fidelidade do que o sistema realmente faz hoje (As-Is). O conhecimento crítico costuma viver escondido — em Apex, em Flows fragmentados e na cabeça de poucos. Modernizar sem mapear é apagar regras vitais sem saber.

É o pilar M1 (Mapear) da Engenharia da Confiança.

Perguntas frequentes

Perguntas frequentes

O que é engenharia reversa assistida por IA?

É o uso de IA para revelar e congelar, com alta fidelidade, o comportamento real de um sistema legado (o As-Is) antes de modernizá-lo. O objetivo não é gerar documentação eterna, e sim um inventário auditável para que arquitetos decidam o que preservar, redesenhar ou descontinuar.

Por que congelar o As-Is antes de modernizar?

Porque todo sistema legado sofre de "conhecimento tribal": regras que sustentam o negócio mas que ninguém escreveu. Modernizar sem mapear apaga regras vitais sem saber — o As-Is de alta fidelidade é a rede de segurança da transformação.

Qual a melhor estratégia de descoberta?

A descoberta guiada por jornadas críticas e risco (top-down com deep dive): parte-se de uma jornada de negócio, segue-se a trilha de execução (call stack) e mapeia-se todo componente que ela toca. Isso isola rapidamente o código morto, que não pertence a jornada nenhuma.

O que é a Matriz de Evidências?

É um pool multifacetado que evita falsos-positivos: insumos estruturais (metadados, Apex, Flows), de estado (Custom Metadata/Settings), operacionais (Event Monitoring, Debug Logs, que revelam o código zumbi) e humanos (commits, tickets, entrevistas, que dão o porquê da regra).

O que é o Inventário de Comportamentos?

É o ativo final do mapeamento: não um catálogo de IFs/ELSEs, mas regras core, efeitos colaterais e workarounds históricos, cada um classificado pela confiança da evidência. Ele é a matéria-prima dos contratos de validação da fase seguinte.