Trilha Código Limpo e Refatoração: tudo o que estudar, tópico por tópico

Filosofia central do código limpo: o código deve ser legível por humanos primeiro, computadores depois. Cobre a Regra do Escoteiro, expressividade em vez de inteligência e o custo do código bagunçado ao longo do tempo.

Escolher nomes que revelam intenção, evitam desinformação e tornam as distinções significativas. Cobre nomenclatura de variáveis, funções, classes e como evitar codificações como notação húngara.

Compreender e reduzir a carga mental da leitura de código. Cobre complexidade ciclomática, profundidade de aninhamento, teoria da carga cognitiva aplicada ao código e técnicas para achatar o fluxo de controle.

Identificar sintomas de problemas de design mais profundos: métodos longos, classes grandes, código duplicado, código morto, inveja de funcionalidade, grupos de dados, obsessão primitiva e mudança divergente.

Princípios para escrever funções pequenas e focadas: fazer uma coisa, um nível de abstração por função, argumentos mínimos, sem efeitos colaterais e Separação Comando-Consulta.

Escrever tratamento de erros limpo: preferir exceções a códigos de erro, fornecer contexto com exceções, definir classes de exceção por necessidades do chamador, evitar retornar nulo e o princípio falha rápida.

Design orientado a objetos limpo: Lei de Deméter, encapsulamento de dados, evitando encadeamentos, distinguindo objetos de transferência de dados de registros ativos e a diferença entre objetos e estruturas de dados.

Uso limpo de estruturas de dados: evitando objetos híbridos, mantendo fronteiras entre camadas do sistema, encapsulando código de terceiros e usando adaptadores para isolar dependências externas.

Filosofia dos comentários: bom código se explica, comentários compensam falhas de expressão no código. Tipos de bons comentários (legais, informativos, intenção, aviso, TODO) versus maus comentários (ruído, enganosos, diário, murmúrio).

Formatação consistente como comunicação de equipe: abertura vertical entre conceitos, densidade vertical para código relacionado, ordenação de funções, alinhamento horizontal, indentação e o valor de guias de estilo padronizados.

Princípios F.I.R.S.T. de testes limpos: Rápido, Independente, Repetível, Autovalidante, Oportuno. Uma asserção por teste, conceito único por teste e estrutura de teste legível com Arrange-Act-Assert.

O ciclo TDD: Vermelho-Verde-Refatoração. Três leis do TDD, o impacto na qualidade do design, dublês de teste (mocks, stubs, fakes) e quando o TDD compensa versus quando adiciona sobrecarga.

Avaliando e melhorando suítes de testes: cobertura de testes versus efetividade, testes de mutação, testes frágeis, excesso de mocks, pirâmide de testes e distinguindo testes unitários, de integração e de ponta a ponta.

Definição e disciplina de refatoração: mudar a estrutura interna sem mudar o comportamento externo. O princípio dos dois chapéus, quando refatorar versus reescrever e manter uma rede de segurança de testes antes de refatorar.

As operações de refatoração mais comuns: Extrair Método, Extrair Variável, Método Inline, Extrair Classe e Mover Método. Mecânica, quando aplicar cada um e armadilhas comuns.

Refatorando lógica condicional complexa: Decompor Condicional, Consolidar Expressão Condicional, Substituir Condicional Aninhado por Cláusulas de Guarda e Substituir Condicional por Polimorfismo.

Padrões avançados de refatoração do catálogo de Fowler: Substituir Temporário por Consulta, Introduzir Objeto de Parâmetro, Substituir Valor de Dados por Objeto, Separar Consulta de Modificador e Substituir Número Mágico por Constante Simbólica.

Aplicando todos os cinco princípios SOLID em bases de código reais: identificar violações, refatorar para conformidade e entender quando a aderência rígida ao SOLID cria engenharia excessiva.

Três heurísticas fundamentais: Don't Repeat Yourself (evitando duplicação de conhecimento), You Aren't Gonna Need It (evitando generalidade especulativa) e Keep It Simple Stupid (favorecendo a solução mais simples).

Gerenciando dependências para testabilidade e manutenibilidade: injeção de dependência, Inversão de Controle, princípio de dependências estáveis e evitando dependências circulares.

Compreendendo tipos de acoplamento (conteúdo, comum, controle, carimbo, dados) e níveis de coesão (coincidental, lógica, temporal, comunicacional, funcional). Buscando alta coesão e baixo acoplamento no design de módulos.

Técnicas de Feathers para modificar código legado com segurança: costuras, testes de caracterização, método/classe broto, método/classe invólucro e a técnica do mestre dourado para código não testável.

Estratégias para refatoração em escala de sistema: padrão estrangulador de figueira, ramificação por abstração, mudança paralela (expandir-contrair) e gerenciamento de risco de refatoração em sistemas de produção com implantação contínua.

Revisões de código eficazes para qualidade: o que procurar, técnicas de feedback construtivo, design de lista de verificação de revisão, limites de tamanho para PRs revisáveis e automação versus julgamento humano.

Tipos de dívida técnica (deliberada/inadvertida, imprudente/prudente), modelo de quadrante de dívida, quantificação do impacto da dívida, comunicação com stakeholders não técnicos e estratégias de pagamento de dívida.

Arquitetura Limpa de Robert Martin: regra de dependência, camadas concêntricas (entidades, casos de uso, adaptadores de interface, frameworks), portas e adaptadores e como a arquitetura limpa possibilita testabilidade em escala.

Medidas quantitativas de qualidade de código: complexidade ciclomática, linhas de código, rotatividade de código, taxa de falha de mudança, instabilidade/abstração e as armadilhas de otimizar para qualquer métrica única.