Pular para o conteúdo

Modernização Contínua deSistemas Legados

Evolução arquitetural em 4 ondas com Strangler Fig, Expand-and-Contract e engenharia assistida por agentes. Atualize sua stack para a última LTS com zero erros, zero warnings e sem paralisar o negócio.

Engenharia de Transição

Por que reescritas "Big Bang" fracassam e como o Strangler Fig protege o caixa

Parar a evolução de um produto por 12 meses para reescrever tudo do zero é o caminho mais caro para descobrir regras de negócio esquecidas. A substituição incremental isola o risco e entrega valor na primeira semana.

O risco da Reescrita Big Bang

  • Roadmap de negócio congelado por meses enquanto dois sistemas competem por orçamento.
  • Regras de negócio implícitas no código antigo são perdidas e só reaparecem como incidentes em produção.
  • Migrações de banco destrutivas que impedem rollback imediato caso a versão nova apresente gargalos.
  • Equipes exaustas mantendo sincronia manual entre o legado vivo e o projeto paralelo inacabado.

Substituição Incremental (Strangler Fig + Expand-and-Contract)

  • Interceptação por rotas, Anti-Corruption Layer (ACL) e Feature Flags: o sistema novo cresce ao redor do antigo sem downtime.
  • Banco de dados evoluído com Expand-and-Contract (Parallel Change): schemas e queries novos coexistem com o legado até a virada segura.
  • Testes de caracterização antes de tocar no núcleo: o comportamento de negócio é provado antes e depois de cada fatia.
  • Rollback instantâneo por fatia vertical sem perda de dados nem interrupção da operação.
Política Stop-the-Line

Quatro Hard Gates inegociáveis em cada entrega

Não usamos a linha de base legada como desculpa para manter avisos de compilador, gambiarras ou pacotes obsoletos. Cada fatia modernizada só é considerada pronta quando cumpre quatro portões técnicos verificáveis no terminal.

100% Verificado no Registro Oficial

Última Versão Estável (LTS / Stable)

Atualização guiada de SDKs, frameworks e drivers (npm, NuGet, pub.dev, PyPI) para a última release estável de produção, eliminando pacotes em EOL.

0 Errors / 0 Warnings

Zero Erros e Zero Warnings Reais

Compilação limpa em modo estrito (/warnaserror no .NET, --max-warnings=0 no ESLint, --fatal-warnings no Flutter), sem mascarar falhas com @ts-ignore ou #pragma warning disable.

Domínio Puro & Mappers Isolados

Isolamento Estrito de Camadas

Direção limpa Api -> Application -> Domain <- Infrastructure no backend e View -> ViewModel -> Repository -> Service no mobile, com Mappers estáticos puros e contratos HTTP externos desacoplados.

320px a 1920px + Zero AI Slop

Acessibilidade WCAG 2.2 AA & UX Humanizada

Contraste validado, navegação completa por teclado, estados explícitos de loading/erro/vazio e microcopy claro, sem jargões artificiais nem exceções técnicas expostas.

Diagnóstico Baseado em Evidências

Auditoria profunda em 7 dimensões antes da primeira refatoração

Antes de alterar qualquer linha em produção, inspecionamos o repositório real e medimos a linha de base completa para gerar o mapa arquitetural de transição.

DIM 01

Defasagem Tecnológica e Risco de Migração

Inventário completo de runtimes, SDKs e dependências transitivas frente às versões LTS atuais, mapeando breaking changes e pacotes depreciados.

  • Node, Angular, React, Next.js e Vite
  • .NET LTS, Dapper e Microsoft.Data.SqlClient
  • Flutter, Dart 3+ e plugins nativos
  • Python moderno (uv, ruff, Pydantic v2)
DIM 02

Mapa de Acoplamento e Fronteiras de Domínio

Identificação de God Classes, controllers gordos, modelos da API vazando para a UI e instanciações inline que dificultam testes unitários.

  • Separação Api -> Application -> Domain <- Infrastructure
  • Isolamento de Mappers estáticos puros (.ToModel / .ToEntity)
  • Contratos JSON externos isolados + DelegatingHandler
  • Result Pattern no lugar de exceções para fluxo de negócio
DIM 03

Dados, SQL / Dapper e Persistência Offline-First

Análise cirúrgica de performance de banco, concorrência entre threads/isolates, índices e segurança contra SQL Injection.

  • Fim de N+1 com QueryMultipleAsync e splitOn no Dapper
  • Prevenção de Index Scan (DbString IsAnsi = true)
  • CommandDefinition com CancellationToken e timeout
  • SQLite/Drift com WAL, busy_timeout e fila Dual-Lane
DIM 04

Estabilidade de Frontend e Mobile em Produção

Revisão de ciclo de vida assíncrono, consumo de memória em dispositivos modestos, reatividade fina e eliminação de cascatas de rede.

  • Angular Standalone, ChangeDetection OnPush e Signals
  • React 19 idempotente e fim de request waterfalls
  • GoRouter com redirect síncrono e cache write-through
  • Prevenção de OOM em aparelhos de 2GB RAM (file-to-file)
DIM 05

UX/UI Design, Responsividade e WCAG 2.2 AA

Validação visual e funcional de 320px a 1920px (e tablets/dobráveis no mobile), garantindo ergonomia, contraste e foco visível.

  • Estados completos: Skeleton sem CLS, Empty, Error e Success
  • Focus trap correto em modais/drawers e suporte a teclado
  • Alvos de toque >= 48x48 dp e SafeArea/viewInsets
  • Contraste >= 4.5:1 em Light e Dark Mode
DIM 06

UX Writing e Clareza Operacional

Revisão de todas as mensagens visíveis ao usuário e documentação técnica para eliminar textos robóticos e orientar a ação com precisão.

  • Microcopy orientado à ação real nos botões e diálogos
  • Tradução de erros técnicos em instruções úteis ao usuário
  • Padronização visual com biblioteca oficial de ícones vetoriais
  • Documentação de arquitetura (ADRs) direta e verificável
DIM 07

Segurança (Defense-in-Depth) e Rede de Testes

Blindagem contra vulnerabilidades OWASP e construção de testes de caracterização que garantem que a regra de negócio permaneça intacta.

  • Remoção de segredos hardcoded e auditoria de CVEs
  • Blindagem contra XSS, CSRF, SQLi e IDOR (Chave Dual UUID)
  • ProblemDetails (RFC 9457) sem vazamento de stack trace
  • Testes Unitários, Widget/Componentes e E2E automatizados
Plano de Execução Strangler Fig

Como modernizamos sistemas críticos em 4 ondas seguras

Cada onda possui escopo fechado, critérios objetivos de Definition of Done (DoD) e chaveamento imediato de rollback.

Onda 0Pre-Flight & Blindagem

Rede de Segurança, Correções Críticas e Interceptação

Estancamos riscos imediatos de segurança e crashes em produção sem alterar a regra de negócio, preparando a fachada de roteamento.

  • Remoção de segredos hardcoded, parametrização estrita de SQL e mitigação de CVEs críticas.
  • Blindagem de crashes imediatos (SQLite busy_timeout/WAL, GoRouter redirect síncrono, guardas context.mounted e Completer).
  • Criação de Testes de Caracterização nos fluxos críticos atuais e configuração de Feature Flags / Anti-Corruption Layer.
Critério de Aceite (DoD):Build reproduzível, zero crashes de concorrência/roteamento e suíte de caracterização verde.
Onda 1Quick Wins & Modelo Alvo

Primeiras Fatias Verticais de Ponta a Ponta

Migramos o primeiro módulo completo no padrão arquitetural definitivo, provando o ganho de performance e estabilidade em produção.

  • Refatoração completa da primeira rota/fluxo aplicando Mappers estáticos puros, Result Pattern e Domain Models imutáveis.
  • Propagação de CancellationToken via CommandDefinition no Dapper e isolamento de contratos HTTP externos.
  • Adequação completa de UI/UX, responsividade multi-viewport, acessibilidade WCAG 2.2 AA e microcopy humanizado.
Critério de Aceite (DoD):Primeira fatia rodando em produção com telemetria limpa, zero warnings nos arquivos tocados e rollback testado.
Onda 2Core Domain & Stack LTS

Modernização do Núcleo, Banco (Expand) e Atualização LTS

Com os bloqueadores removidos, atualizamos os SDKs principais para a última LTS e otimizamos os gargalos pesados de banco e sincronização.

  • Atualização guiada de versão principal (.NET LTS, Angular Signals/Standalone, React 19, Flutter/Dart estável).
  • Eliminação de queries N+1 (QueryMultipleAsync), ajuste de tipos ANSI (DbString) e paginação SQL no servidor.
  • No mobile: fila Offline-First Dual-Lane, recuperação de órfãos no WorkManager e compressão de mídia file-to-file anti-OOM.
Critério de Aceite (DoD):Stack atualizada na última versão estável com ganho mensurável de latência/memória e 100% dos testes passando.
Onda 3Contract & Cleanup

Extinção do Legado e Tolerância Zero no CI/CD

Removemos definitivamente o código antigo estrangulado, adaptadores temporários e colunas depreciadas, travando a qualidade no pipeline.

  • Remoção de rotas legadas, Feature Flags transitórias, pacotes órfãos e código morto.
  • Fase Contract no banco de dados: limpeza segura de estruturas antigas após confirmação de tráfego zero.
  • Ativação permanente de portões de qualidade no CI/CD (/warnaserror, --max-warnings=0, cobertura e análise estática).
Critério de Aceite (DoD):Repositório 100% na arquitetura nova, 0 Erros e 0 Warnings em todo o projeto e documentação operacional entregue.
Engenharia Aplicada em Produção

Pós-mortems reais que moldaram o nosso motor de modernização

Nossa metodologia não nasceu de teoria acadêmica: cada regra do nosso diagnóstico foi forjada resolvendo incidentes críticos em operações reais.

Mobile Flutter / SQLite & WorkManager

Eliminação de Lock 517 (SQLITE_BUSY) e Fila Offline-First Dual-Lane

Antes (Sintoma no Legado)

UI principal e background isolate do WorkManager disputavam escrita no SQLite sem WAL nem busy_timeout, gerando SqliteException(517), itens presos eternamente em status processing quando o SO matava o app e chamadas getSingleOrNull() quebrando com duplicatas.

Depois (Arquitetura Blindada)

Configuração de PRAGMA journal_mode = WAL, busy_timeout = 30000 e cache_size = -4000, execução de recoverOrphanedProcessing() no bootstrap e no callbackDispatcher, ..limit(1) defensivo e separação Dual-Lane (JSON rápido separado de upload pesado de mídia).

Zero perdas de sincronização em campo e eliminação total do erro 517.
Backend C# / .NET & Dapper SQL

Fim de Index Scan silencioso, N+1 e Vazamento de Contratos

Antes (Sintoma no Legado)

Strings enviadas como NVARCHAR por padrão no Dapper causavam Index Scan em colunas VARCHAR de milhões de linhas; loops foreach disparavam dezenas de queries N+1 sem CancellationToken; mappers e contratos JSON ficavam espalhados dentro de Services e Controllers.

Depois (Arquitetura Blindada)

Configuração de DbString { IsAnsi = true } / TypeMap ANSI, consolidação em QueryMultipleAsync com CommandDefinition propagando CancellationToken, Mappers estáticos puros isolados em Application/Mappers e contratos HTTP com DelegatingHandler em Domain/Http.

Queda drástica de CPU no banco SQL e compilação limpa com /warnaserror.
Mobile Android / Coletores e Aparelhos de 2GB RAM

Prevenção de OOM em Captura de Mídia e GoRouter Síncrono

Antes (Sintoma no Legado)

Compressão de fotos em memória (Uint8List) estourava a heap em aparelhos de 2GB RAM causando crash nativo (OOM), enquanto o GoRouter.redirect fazia await FlutterSecureStorage.read() assíncrono, gerando race conditions e tela branca ao navegar.

Depois (Arquitetura Blindada)

Pipeline de compressão file-to-file direto em disco com nomes UUID únicos e descarte imediato do arquivo bruto, aliado a cache em memória write-through aquecido no bootstrap para leitura 100% síncrona no GoRouter e resetOnError no KeyStore.

Estabilidade contínua em dispositivos de 2GB RAM e navegação instantânea.
Frontend Web / Angular, React & Tailwind

Migração para Reatividade Fina (Signals / React 19) e WCAG 2.2 AA

Antes (Sintoma no Legado)

Componentes monolíticos com detecção de mudança padrão pesada, vazamento de subscrições RxJS/timers, cascatas de await sequenciais atrasando a página e falhas de acessibilidade (modais sem focus trap e inputs sem label).

Depois (Arquitetura Blindada)

Componentes Standalone com ChangeDetectionStrategy.OnPush, Signals/computed e takeUntilDestroyed() no Angular; pureza de state updaters e Promise.all no React 19; conformidade WCAG 2.2 AA validada em 8 viewports (320px a 1920px).

Core Web Vitals verdes, zero vazamentos de memória e 0 warnings no linter.
Modelos de Atuação

Como aplicar essa metodologia no seu repositório

Utilizamos nosso ferramental proprietário de auditoria e engenharia assistida por agentes para comprimir semanas de levantamento manual em diagnósticos precisos e execução segura.

Etapa 01 : Mapeamento Arquitetural

Mapeamento Arquitetural & Plano Strangler Fig

Inspeção técnica e não-destrutiva do repositório atual com estruturação do plano executivo e técnico STRANGLER_FIG_PLAN.md.

Ideal para:

CTOs, Tech Leads e Heads de Engenharia que buscam clareza técnica, avaliação real de risco e um roteiro acionável para modernizar sem parar o produto.

  • Inspeção real nas 7 dimensões (Stack LTS, Acoplamento, SQL/Dapper/SQLite, Frontend/Mobile, UX/WCAG, Copy e Segurança).
  • Tabela de inventário tecnológico e Top Riscos Críticos com localização exata de arquivo e linha.
  • Desenho da Arquitetura de Transição (Anti-Corruption Layer, Feature Flags e estratégia Expand-and-Contract de banco).
  • Plano detalhado nas 4 Ondas com checklists de execução, critérios de Definition of Done (DoD) e plano de rollback.
Conversar sobre este cenário
Etapa 02 : Execução & Capacitação

Execução das 4 Ondas + Engenharia Assistida por IA

Liderança técnica mão na massa executando as Ondas 0 a 3 até entregar o sistema na última versão LTS com 0 Erros e 0 Warnings, transferindo o método para o seu time.

Ideal para:

Equipes que desejam acelerar a liquidação de dívida técnica crítica enquanto elevam o padrão arquitetural e a produtividade de engenharia.

  • Execução incremental das fatias verticais (Onda 0 a Onda 3) com PRs limpos, revisados e cobertos por testes automatizados.
  • Modernização de stack (.NET/Dapper, Angular, React, Flutter ou Python) atingindo 0 Erros e 0 Warnings reais no pipeline.
  • Configuração de playbooks, guardrails arquiteturais e skills customizadas para a stack e regras de domínio da sua empresa.
  • Mentoria técnica e pareamento com os desenvolvedores internos para sustentar a política Stop-the-Line após a entrega.
Trocar ideia sobre as 4 Ondas

Quer trocar ideia sobre modernização de sistemas legados?

Trocas técnicas entre pares, palestras ou desafios críticos de arquitetura Strangler Fig surgem naturalmente por afinidade e indicação.