Módulo Hub

ID: hub_module | Gravidade: Medium (default)

Um "Módulo Hub" (Hub Module) é um ponto central no gráfico de dependências, caracterizado por alto Fan-in (muitos dependentes) e alto Fan-out (muitas dependências), enquanto contém relativamente pouca lógica interna.

Por que isso é um smell

Os módulos Hub representam "pontos únicos de falha" perigosos em sua arquitetura. Por estarem no centro de muitos caminhos, tornam-se extremamente frágeis. Uma pequena mudança em um módulo hub pode desencadear um efeito cascata massivo em toda a base de código, tornando-os difíceis e arriscados de refatorar.

Exemplos

Ruim

Um módulo que apenas reexporta ou coordena muitos serviços não relacionados e é usado por toda a aplicação.

// app-hub.ts
import { AuthService } from './auth';
import { ApiService } from './api';
import { LoggerService } from './logger';
import { ConfigService } from './config';
// ... mais 10 imports

export class AppHub {
  constructor(
    public auth: AuthService,
    public api: ApiService,
    public logger: LoggerService
    // ... mais 10 dependências
  ) {}
}

Bom

Divida o hub em coordenadores específicos e focados ou use injeção de dependência no nível do consumidor para evitar um hub central.

// auth-coordinator.ts (Focado em coordenação relacionada a auth)
import { AuthService } from './auth';
import { SessionStore } from './session';

export class AuthCoordinator {
  constructor(
    private auth: AuthService,
    private session: SessionStore
  ) {}
}

Configuração

rules:
  hub_module:
    severity: medium
    min_fan_in: 5
    min_fan_out: 5
    max_complexity: 5

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-hub-modules': 'warn',
    },
  },
];

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

Como corrigir

Quebre o hub! Identifique os diferentes caminhos de dados ou controle que passam pelo hub e extraia-os em módulos separados e mais focados.