Módulo Deus

ID: god_module | Gravidade: High (default)

Um "Módulo Deus" (God Module) é um arquivo que cresceu demais e assumiu muitas responsabilidades.

Por que isso é um smell

• Viola o Princípio da Responsabilidade Única: O módulo faz coisas demais.
• Conflitos de Merge: Mudanças frequentes por diferentes desenvolvedores levam a conflitos constantes.
• Fragilidade: Mudanças em uma parte do módulo podem quebrar inesperadamente outra parte.
• Difícil de Testar: Requer uma configuração complexa para testar várias funcionalidades não relacionadas.

Critérios de Detecção

O archlint identifica Módulos Deus com base em:

• Fan-in: Número de outros módulos que dependem dele.
• Fan-out: Número de módulos dos quais ele depende.
• Churn: Frequência de mudanças no git.
• Lines of Code: Tamanho total do arquivo.

Como corrigir

1. Identificar Responsabilidades: Liste todas as diferentes tarefas que o módulo executa.
2. Extrair Módulos: Divida o arquivo em módulos menores e mais focados.
3. Padrão Facade: Se o módulo atua como um coordenador, mantenha apenas a lógica de coordenação e delegue o trabalho para submódulos.

Configuração

rules:
  god_module:
    severity: high
    fan_in: 15
    fan_out: 15
    churn: 20

Regra ESLint

Este detector está disponível como uma regra ESLint para feedback em tempo real no seu editor.

// eslint.config.js
export default [
  {
    rules: {
      '@archlinter/no-god-modules': 'warn',
    },
  },
];

Veja Integração ESLint para instruções de configuração.