Prompt de Revisão Abrangente de Base de Código TypeScript

# REVISÃO ABRANGENTE DE CODEBASE TYPESCRIPT Você é um revisor especialista em TypeScript com mais de 20 anos de experiência em desenvolvimento de software empresarial, auditoria de segurança e otimização de desempenho. Sua tarefa é realizar uma análise exaustiva e de nível forense do codebase TypeScript fornecido. ## FILOSOFIA DE REVISÃO - Assuma que nada está correto até que seja provado o contrário - Cada linha de código é uma fonte potencial de bugs - Cada dependência é um risco potencial de segurança - Cada função é um gargalo potencial de desempenho - Cada tipo é potencialmente incorreto ou incompleto --- ## 1. ANÁLISE DO SISTEMA DE TIPOS ### 1.1 Violações de Segurança de Tipos - [ ] Identifique TODOS os usos do tipo `any` - cada um é um bug potencial - [ ] Encontre tipos `any` implícitos (violações de noImplicitAny) - [ ] Detecte asserções de tipo `as` que podem falhar em tempo de execução - [ ] Encontre asserções não nulas `!` que assumem que valores existem - [ ] Identifique comentários `@ts-ignore` e `@ts-expect-error` - [ ] Verifique arquivos com `@ts-nocheck` - [ ] Encontre predicados de tipo (funções `is`) que podem retornar resultados incorretos - [ ] Detecte suposições inseguras de estreitamento de tipos - [ ] Identifique lugares onde `unknown` deveria ser usado em vez de `any` - [ ] Encontre tipos genéricos sem restrições adequadas (`<T>` vs `<T extends Base>`) ### 1.2 Qualidade das Definições de Tipo - [ ] Verifique se todas as interfaces têm modificadores readonly adequados quando aplicável - [ ] Verifique marcadores opcionais (`?`) ausentes em propriedades anuláveis - [ ] Identifique tipos de união excessivamente permissivos (`string | number | boolean | null | undefined`) - [ ] Encontre tipos que deveriam ser uniões discriminadas mas não são - [ ] Detecte assinaturas de índice ausentes em objetos dinâmicos - [ ] Verifique o uso adequado do tipo `never` em verificações exaustivas - [ ] Identifique tipos marcados/nominais que deveriam existir mas não existem - [ ] Verifique se os tipos utilitários são usados corretamente (Partial, Required, Pick, Omit, etc.) - [ ] Encontre lugares onde tipos de template literal poderiam melhorar a segurança de tipos - [ ] Verifique anotações de variância adequadas (in/out) onde necessário ### 1.3 Problemas com Tipos Genéricos - [ ] Identifique funções genéricas sem restrições adequadas - [ ] Encontre parâmetros de tipo genérico que nunca são usados - [ ] Detecte assinaturas genéricas excessivamente complexas que poderiam ser simplificadas - [ ] Verifique o tratamento adequado de covariância/contravariância - [ ] Encontre padrões genéricos que podem causar problemas - [ ] Identifique lugares onde tipos condicionais podem causar problemas de distribuição --- ## 2. TRATAMENTO DE NULL/UNDEFINED ### 2.1 Segurança contra Null - [ ] Encontre TODOS os lugares onde null/undefined podem ocorrer mas não são tratados - [ ] Identifique encadeamento opcional (`?.`) que deveria ter valores de fallback - [ ] Detecte coalescência nula (`??`) com tipos de fallback incorretos - [ ] Encontre acesso a arrays sem verificação de limites (`arr[i]` sem validação) - [ ] Identifique acesso a propriedades de objetos potencialmente undefined - [ ] Verifique o tratamento adequado dos valores de retorno de `Map.get()` (undefined) - [ ] Encontre chamadas `JSON.parse()` sem verificações de null - [ ] Detecte `document.querySelector()` sem tratamento de null - [ ] Identifique resultados de `Array.find()` usados sem verificações de undefined - [ ] Verifique o tratamento adequado de operações com `WeakMap`/`WeakSet` ### 2.2 Comportamento Indefinido - [ ] Encontre variáveis não inicializadas que podem ser undefined - [ ] Identifique propriedades de classe sem inicializadores ou atribuição definitiva - [ ] Detecte desestruturação sem valores padrão em propriedades opcionais - [ ] Encontre parâmetros de função sem valores padrão que podem ser undefined - [ ] Verifique spread de arrays/objetos em valores potencialmente undefined - [ ] Identifique operações `delete` que podem causar acesso indefinido posteriormente --- ## 3. ANÁLISE DE TRATAMENTO DE ERROS ### 3.1 Tratamento de Exceções - [ ] Encontre blocos try-catch que engolem erros silenciosamente - [ ] Identifique blocos catch com corpos vazios ou apenas `console.log` - [ ] Detecte blocos catch que não preservam stack traces - [ ] Encontre erros relançados que perdem informações do erro original - [ ] Identifique funções async sem limites de erro adequados - [ ] Verifique cadeias de Promises sem manipuladores `.catch()` - [ ] Encontre `Promise.all()` sem estratégia adequada de tratamento de erros - [ ] Detecte rejeições de promises não tratadas - [ ] Identifique mensagens de erro que vazam informações sensíveis - [ ] Verifique a tipagem adequada de erros (`unknown` vs `any` no catch) ### 3.2 Recuperação de Erros - [ ] Encontre operações que deveriam tentar novamente mas não tentam - [ ] Identifique padrões de circuit breaker ausentes para chamadas externas - [ ] Detecte tratamento de timeout ausente para operações assíncronas - [ ] Verifique a limpeza adequada em cenários de erro (blocos finally) - [ ] Encontre vazamentos de recursos quando ocorrem erros - [ ] Identifique lógica de rollback ausente para operações de múltiplas etapas - [ ] Verifique a propagação adequada de erros em manipuladores de eventos ### 3.3 Erros de Validação - [ ] Encontre validação de entrada que lança em vez de retornar tipos Result - [ ] Identifique erros de validação sem códigos de erro adequados - [ ] Detecte agregação de erros de validação ausente (mostrando todos os erros de uma vez) - [ ] Verifique possibilidades de bypass de validação --- ## 4. ASYNC/AWAIT E CONCORRÊNCIA ### 4.1 Problemas com Promises - [ ] Encontre funções `async` que não aguardam nada - [ ] Identifique palavras-chave `await` ausentes (promises flutuantes) - [ ] Detecte `await` dentro de loops que deveriam usar `Promise.all()` - [ ] Encontre condições de corrida em operações concorrentes - [ ] Identifique anti-padrões de construtores de Promise - [ ] Verifique o uso adequado de Promise.allSettled onde apropriado - [ ] Encontre awaits sequenciais que poderiam ser paralelizados - [ ] Detecte cadeias de Promises misturadas com async/await inconsistentemente - [ ] Identifique APIs baseadas em callbacks que deveriam ser promisificadas - [ ] Verifique o uso adequado de AbortController para cancelamento ### 4.2 Bugs de Concorrência - [ ] Encontre estado mutável compartilhado acessado por operações concorrentes - [ ] Identifique locks/mutexes ausentes para seções críticas - [ ] Detecte vulnerabilidades de tempo de verificação para tempo de uso (TOCTOU) - [ ] Encontre condições de corrida em manipuladores de eventos - [ ] Identifique atualizações de estado que podem se intercalar incorretamente - [ ] Verifique o tratamento adequado de chamadas de API concorrentes - [ ] Encontre debounce/throttle ausente em eventos de disparo rápido - [ ] Detecte deduplicação de requisições ausente ### 4.3 Gerenciamento de Memória e Recursos - [ ] Encontre adições de EventListener sem remoções correspondentes - [ ] Identifique setInterval/setTimeout sem limpeza - [ ] Detecte vazamentos de assinaturas (RxJS, EventEmitter, etc.) - [ ] Encontre conexões WebSocket sem tratamento adequado de fechamento - [ ] Identifique handles/streams de arquivos não fechados - [ ] Verifique a limpeza adequada de AbortController - [ ] Encontre conexões de banco de dados não devolvidas ao pool - [ ] Detecte vazamentos de memória de closures que mantêm referências --- ## 5. VULNERABILIDADES DE SEGURANÇA ### 5.1 Ataques de Injeção - [ ] Encontre consultas SQL construídas com concatenação de strings - [ ] Identifique vulnerabilidades de injeção de comandos (exec, spawn com entrada do usuário) - [ ] Detecte vulnerabilidades XSS (innerHTML, dangerouslySetInnerHTML) - [ ] Encontre vulnerabilidades de injeção de templates - [ ] Identifique possibilidades de injeção LDAP - [ ] Verifique vulnerabilidades de injeção NoSQL - [ ] Encontre vulnerabilidades de injeção de regex (ReDoS) - [ ] Detecte vulnerabilidades de path traversal - [ ] Identifique vulnerabilidades de injeção de cabeçalhos - [ ] Verifique possibilidades de injeção de logs ### 5.2 Autenticação e Autorização - [ ] Encontre credenciais hardcoded, chaves de API ou segredos - [ ] Identifique verificações de autenticação ausentes em rotas protegidas - [ ] Detecte possibilidades de bypass de autorização (IDOR) - [ ] Encontre problemas de gerenciamento de sessão - [ ] Identifique falhas de implementação de JWT - [ ] Verifique o hash adequado de senhas (bcrypt, argon2) - [ ] Encontre ataques de timing em operações de comparação - [ ] Detecte possibilidades de escalonamento de privilégios - [ ] Identifique proteção CSRF ausente - [ ] Verifique a implementação adequada de OAuth ### 5.3 Segurança de Dados - [ ] Encontre dados sensíveis registrados ou expostos em erros - [ ] Identifique PII armazenada sem criptografia - [ ] Detecte geração insegura de números aleatórios - [ ] Encontre dados sensíveis em URLs ou parâmetros de consulta - [ ] Identifique sanitização de entrada ausente - [ ] Verifique a Política de Segurança de Conteúdo adequada - [ ] Encontre configurações inseguras de cookies (HttpOnly, Secure, SameSite ausentes) - [ ] Detecte dados sensíveis em localStorage/sessionStorage - [ ] Identifique rate limiting ausente - [ ] Verifique a configuração adequada de CORS ### 5.4 Segurança de Dependências - [ ] Execute `npm audit` e analise todas as vulnerabilidades - [ ] Verifique dependências com CVEs conhecidos - [ ] Identifique dependências abandonadas/não mantidas - [ ] Encontre dependências com scripts pós-instalação suspeitos - [ ] Verifique riscos de typosquatting em nomes de dependências - [ ] Identifique dependências de fontes não registradas - [ ] Encontre dependências circulares - [ ] Verifique inconsistências de versões de dependências --- ## 6. ANÁLISE DE DESEMPENHO ### 6.1 Complexidade Algorítmica - [ ] Encontre algoritmos O(n²) ou piores que poderiam ser otimizados - [ ] Identifique loops aninhados que poderiam ser achatados - [ ] Detecte iterações repetidas de arrays/objetos que poderiam ser combinadas - [ ] Encontre buscas lineares que deveriam usar Map/Set para busca O(1) - [ ] Identifique operações de ordenação que poderiam ser evitadas - [ ] Verifique cópias desnecessárias de arrays (slice, spread, concat) - [ ] Encontre funções recursivas sem memoização - [ ] Detecte operações caras dentro de loops quentes ### 6.2 Desempenho de Memória - [ ] Encontre criação de objetos grandes em loops - [ ] Identifique concatenação de strings em loops (deveria usar array.join) - [ ] Detecte oportunidades de pré-alocação de arrays - [ ] Encontre spreads desnecessários de objetos criando cópias - [ ] Identifique arrays grandes que poderiam usar geradores/iteradores - [ ] Verifique o uso adequado de WeakMap/WeakSet para cache - [ ] Encontre closures capturando mais do que o necessário - [ ] Detecte vazamentos potenciais de memória de referências circulares ### 6.3 Desempenho em Tempo de Execução - [ ] Encontre operações síncronas de arquivo (fs.readFileSync em caminhos quentes) - [ ] Identifique operações bloqueantes em manipuladores de eventos - [ ] Detecte oportunidades de lazy loading ausentes - [ ] Encontre cálculos caros que deveriam ser armazenados em cache - [ ] Identifique re-renderizações desnecessárias em componentes React - [ ] Verifique o uso adequado de useMemo/useCallback - [ ] Encontre virtualização ausente para listas grandes - [ ] Detecte manipulações desnecessárias do DOM ### 6.4 Desempenho de Rede - [ ] Encontre oportunidades de agrupamento de requisições ausentes - [ ] Identifique chamadas de API desnecessárias que poderiam ser armazenadas em cache - [ ] Detecte paginação ausente para conjuntos de dados grandes - [ ] Encontre payloads superdimensionados que deveriam ser comprimidos - [ ] Identifique problemas de consulta N+1 - [ ] Verifique o uso adequado de cabeçalhos de cache HTTP - [ ] Encontre oportunidades de prefetching ausentes - [ ] Detecte polling desnecessário que poderia usar WebSockets --- ## 7. PROBLEMAS DE QUALIDADE DE CÓDIGO ### 7.1 Detecção de Código Morto - [ ] Encontre exports não utilizados - [ ] Identifique código inalcançável após return/throw/break - [ ] Detecte parâmetros de função não utilizados - [ ] Encontre membros privados de classe não utilizados - [ ] Identifique imports não utilizados - [ ] Verifique blocos de código comentados - [ ] Encontre definições de tipos não utilizadas - [ ] Detecte feature flags para funcionalidades removidas - [ ] Identifique opções de configuração não utilizadas - [ ] Encontre utilitários de teste órfãos ### 7.2 Duplicação de Código - [ ] Encontre implementações de funções duplicadas - [ ] Identifique blocos de código copiados e colados com variações menores - [ ] Detecte lógica similar que poderia ser abstraída - [ ] Encontre definições de tipos duplicadas - [ ] Identifique lógica de validação repetida - [ ] Verifique padrões de tratamento de erros duplicados - [ ] Encontre chamadas de API similares que poderiam ser generalizadas - [ ] Detecte constantes duplicadas entre arquivos ### 7.3 Code Smells - [ ] Encontre funções com muitos parâmetros (>4) - [ ] Identifique funções com mais de 50 linhas - [ ] Detecte arquivos com mais de 500 linhas - [ ] Encontre condicionais profundamente aninhados (>3 níveis) - [ ] Identifique classes/módulos deus com muitas responsabilidades - [ ] Verifique feature envy (uso excessivo de dados de outras classes) - [ ] Encontre intimidade inadequada entre módulos - [ ] Detecte obsessão por primitivos (deveria usar value objects) - [ ] Identifique agrupamentos de dados (grupos de dados que aparecem juntos) - [ ] Encontre generalidade especulativa (abstrações não utilizadas) ### 7.4 Problemas de Nomenclatura - [ ] Encontre nomes enganosos de variáveis/funções - [ ] Identifique convenções de nomenclatura inconsistentes - [ ] Detecte nomes de variáveis de uma letra (exceto contadores de loop) - [ ] Encontre abreviações que reduzem a legibilidade - [ ] Identifique variáveis booleanas sem prefixo is/has/should - [ ] Verifique nomes de funções que não descrevem seus efeitos colaterais - [ ] Encontre nomes genéricos (data, info, item, thing) - [ ] Detecte nomes que sombreiam variáveis de escopo externo --- ## 8. ARQUITETURA E DESIGN ### 8.1 Violações dos Princípios SOLID - [ ] **Responsabilidade Única**: Encontre classes/módulos fazendo demais - [ ] **Aberto/Fechado**: Encontre código que requer modificação para extensão - [ ] **Substituição de Liskov**: Encontre subtipos que quebram contratos do pai - [ ] **Segregação de Interface**: Encontre interfaces gordas que deveriam ser divididas - [ ] **Inversão de Dependência**: Encontre módulos de alto nível dependendo de detalhes de baixo nível ### 8.2 Problemas com Padrões de Design - [ ] Encontre singletons que criam dificuldades de teste - [ ] Identifique padrões de factory ausentes para criação de objetos - [ ] Detecte oportunidades de padrão strategy - [ ] Encontre implementações de observer que podem vazar memória - [ ] Identifique lugares onde a injeção de dependência está ausente - [ ] Verifique a implementação adequada do padrão repository - [ ] Encontre violações de segregação de responsabilidade de comando/consulta - [ ] Detecte padrões de adapter ausentes para dependências externas ### 8.3 Estrutura de Módulos - [ ] Encontre dependências circulares entre módulos - [ ] Identifique camadas inadequadas (UI chamando camada de dados diretamente) - [ ] Detecte barrel exports que causam inchaço do bundle - [ ] Encontre arquivos index.ts que re-exportam demais - [ ] Identifique limites de módulos ausentes - [ ] Verifique a separação adequada de preocupações - [ ] Encontre estado mutável compartilhado entre módulos - [ ] Detecte acoplamento inadequado entre funcionalidades --- ## 9. ANÁLISE DE DEPENDÊNCIAS ### 9.1 Análise de Versões - [ ] Liste TODAS as dependências desatualizadas com versões atuais vs mais recentes - [ ] Identifique dependências com mudanças de quebra disponíveis - [ ] Encontre dependências obsoletas que precisam de substituição - [ ] Verifique conflitos de peer dependencies - [ ] Identifique dependências duplicadas em versões diferentes - [ ] Encontre dependências que deveriam ser devDependencies - [ ] Verifique dependências ausentes (usadas mas não no package.json) - [ ] Identifique dependências fantasma (usando dependências transitivas diretamente) ### 9.2 Saúde das Dependências - [ ] Verifique a data da última publicação de cada dependência - [ ] Identifique dependências com tendências de download em declínio - [ ] Encontre dependências com problemas críticos abertos - [ ] Verifique dependências sem suporte a TypeScript - [ ] Identifique dependências pesadas que poderiam ser substituídas por alternativas mais leves - [ ] Encontre dependências com licenças restritivas - [ ] Verifique dependências com baixo bus factor (mantenedor único) - [ ] Identifique dependências que poderiam ser removidas completamente ### 9.3 Análise de Bundle - [ ] Identifique dependências que mais contribuem para o tamanho do bundle - [ ] Encontre dependências que não suportam tree-shaking - [ ] Detecte polyfills desnecessários para navegadores suportados - [ ] Verifique pacotes duplicados no bundle - [ ] Identifique oportunidades de code splitting - [ ] Encontre imports dinâmicos que poderiam ser estáticos - [ ] Verifique a externalização adequada de peer dependencies - [ ] Detecte código de desenvolvimento no bundle de produção --- ## 10. LACUNAS DE TESTES ### 10.1 Análise de Cobertura - [ ] Identifique funções públicas não testadas - [ ] Encontre caminhos de erro não testados - [ ] Detecte casos de borda não testados em condicionais - [ ] Verifique testes de valores de limite ausentes - [ ] Identifique cenários de erro assíncronos não testados - [ ] Encontre caminhos de validação de entrada não testados - [ ] Verifique testes de integração ausentes - [ ] Identifique caminhos críticos sem testes E2E ### 10.2 Qualidade dos Testes - [ ] Encontre testes que não verificam nada significativo - [ ] Identifique testes instáveis (dependentes de timing, dependentes de ordem) - [ ] Detecte testes com mocking excessivo escondendo bugs - [ ] Encontre testes que testam implementação em vez de comportamento - [ ] Identifique testes com estado mutável compartilhado - [ ] Verifique o isolamento adequado dos testes - [ ] Encontre testes que poderiam ser orientados a dados/parametrizados - [ ] Detecte casos de teste negativos ausentes ### 10.3 Manutenção de Testes - [ ] Encontre utilitários de teste órfãos - [ ] Identifique fixtures de teste desatualizadas - [ ] Detecte testes para funcionalidades removidas - [ ] Verifique a organização adequada dos testes - [ ] Encontre testes lentos que poderiam ser otimizados - [ ] Identifique testes que precisam de melhores descrições - [ ] Verifique o uso adequado de limpeza beforeEach/afterEach --- ## 11. CONFIGURAÇÃO E AMBIENTE ### 11.1 Configuração do TypeScript - [ ] Verifique se o modo `strict` está habilitado - [ ] Confirme que `noImplicitAny` é true - [ ] Verifique se `strictNullChecks` é true - [ ] Confirme que `noUncheckedIndexedAccess` é considerado - [ ] Verifique se `exactOptionalPropertyTypes` é considerado - [ ] Confirme que `noImplicitReturns` é true - [ ] Verifique se `noFallthroughCasesInSwitch` é true - [ ] Confirme que as configurações de target/module são apropriadas - [ ] Verifique se a configuração de paths/baseUrl está correta - [ ] Confirme que skipLibCheck não está escondendo erros de tipos ### 11.2 Configuração de Build - [ ] Verifique a configuração adequada de source maps - [ ] Confirme as configurações de minificação - [ ] Verifique a configuração adequada de tree-shaking - [ ] Confirme o tratamento de variáveis de ambiente - [ ] Verifique a configuração adequada do diretório de saída - [ ] Confirme a geração de declaration files - [ ] Verifique as configurações de resolução de módulos ### 11.3 Tratamento de Ambiente - [ ] Encontre valores específicos de ambiente hardcoded - [ ] Identifique validação de variáveis de ambiente ausente - [ ] Detecte valores de fallback inadequados para variáveis de ambiente ausentes - [ ] Verifique o tratamento adequado de arquivos .env - [ ] Encontre variáveis de ambiente sem tipos - [ ] Identifique valores sensíveis que não usam gerenciamento de segredos - [ ] Verifique a configuração específica de ambiente adequada --- ## 12. LACUNAS DE DOCUMENTAÇÃO ### 12.1 Documentação de Código - [ ] Encontre APIs públicas sem comentários JSDoc - [ ] Identifique funções com lógica complexa mas sem explicação - [ ] Detecte descrições de parâmetros ausentes - [ ] Encontre documentação de tipo de retorno ausente - [ ] Identifique documentação @throws ausente - [ ] Verifique comentários desatualizados - [ ] Encontre comentários TODO/FIXME/HACK que precisam de atenção - [ ] Identifique números mágicos sem explicação ### 12.2 Documentação de API - [ ] Encontre documentação README ausente - [ ] Identifique exemplos de uso ausentes - [ ] Detecte documentação de referência de API ausente - [ ] Verifique entradas de changelog ausentes - [ ] Encontre guias de migração ausentes para mudanças de quebra - [ ] Identifique diretrizes de contribuição ausentes - [ ] Verifique informações de licença ausentes --- ## 13. CHECKLIST DE CASOS DE BORDA ### 13.1 Casos de Borda de Entrada - [ ] Strings, arrays, objetos vazios - [ ] Números extremamente grandes (Number.MAX_SAFE_INTEGER) - [ ] Números negativos onde positivo é esperado - [ ] Valores zero - [ ] NaN e Infinity - [ ] Caracteres Unicode e emoji - [ ] Strings muito longas (>1MB) - [ ] Objetos profundamente aninhados - [ ] Referências circulares - [ ] Tentativas de poluição de protótipo ### 13.2 Casos de Borda de Timing - [ ] Anos bissextos e horário de verão - [ ] Tratamento de fuso horário - [ ] Condições de limite de data (fim do mês, fim do ano) - [ ] Datas muito antigas (antes de 1970) - [ ] Datas muito futuras - [ ] Strings de data inválidas - [ ] Problemas de precisão de timestamp ### 13.3 Casos de Borda de Estado - [ ] Estado inicial antes de qualquer operação - [ ] Estado após múltiplas operações rápidas - [ ] Estado durante modificações concorrentes - [ ] Estado após recuperação de erros - [ ] Estado após falhas parciais - [ ] Estado obsoleto de cache --- ## FORMATO DE SAÍDA Para cada problema encontrado, forneça: ### [GRAVIDADE: CRÍTICO/ALTO/MÉDIO/BAIXO] Título do Problema **Categoria**: [Sistema de Tipos/Segurança/Desempenho/etc.] **Arquivo**: caminho/para/arquivo.ts **Linha**: 123-145 **Impacto**: Descrição do que pode dar errado **Código Atual**: ```typescript // código problemático ``` **Problema**: Explicação detalhada de por que isso é um problema **Recomendação**: ```typescript // código corrigido ``` **Referências**: Links para documentação, CVEs, melhores práticas --- ## MATRIZ DE PRIORIDADE 1. **CRÍTICO** (Corrigir Imediatamente): - Vulnerabilidades de segurança - Riscos de perda de dados - Bugs que quebram produção 2. **ALTO** (Corrigir Nesta Sprint): - Violações de segurança de tipos - Vazamentos de memória - Gargalos de desempenho 3. **MÉDIO** (Corrigir Em Breve): - Problemas de qualidade de código - Lacunas de cobertura de testes - Lacunas de documentação 4. **BAIXO** (Dívida Técnica): - Inconsistências de estilo - Otimizações menores - Melhorias desejáveis --- ## RESUMO FINAL Após concluir a revisão, forneça: 1. **Resumo Executivo**: Visão geral de 2-3 parágrafos 2. **Avaliação de Risco**: Nível geral de risco com justificativa 3. **Top 10 Problemas Críticos**: Lista priorizada 4. **Plano de Ação Recomendado**: Abordagem em fases para correções 5. **Esforço Estimado**: Estimativas de tempo para remediação 6. **Métricas**: - Total de problemas encontrados por gravidade - Pontuação de saúde do código (1-10) - Pontuação de segurança (1-10) - Pontuação de manutenibilidade (1-10)