Что такое Loose Coupling в FSD?

Что такое Loose Coupling в FSD?

Loose Coupling (слабая связанность) в Feature-Sliced Design (FSD) — это архитектурный принцип, который предполагает минимальную зависимость между отдельными модулями, слоями или фичами приложения. Цель — создать систему, где изменения в одной части не вызывают каскадных изменений в других, повышая гибкость, тестируемость и масштабируемость кода.

Ключевые аспекты Loose Coupling в FSD

1. Изоляция ответственности
   Каждый модуль (например, фича, сущность, виджет) инкапсулирует свою логику и данные. Например, фича UserProfile не должна напрямую зависеть от внутренней реализации фичи Payment.

2. Чёткие контракты взаимодействия
   Модули общаются через строго определённые API, например:

   • Публичные интерфейсы (TypeScript-типы, функции)
   • События (Event Bus, сообщения)
   • Параметры URL (для маршрутизации)

   // Пример: контракт для API фичи UserProfile
   export interface UserProfileApi {
     fetchUserData: (userId: string) => Promise<User>;
     updateUserAvatar: (file: File) => Promise<void>;
   }
   
   // Другая фича использует этот контракт, не зная деталей реализации
   

3. Использование Dependency Injection (DI)
   Зависимости передаются извне, а не создаются внутри модуля. Это упрощает мокирование в тестах и замену реализации.

   // ПЛОХО: жёсткая связанность
   import { PaymentService } from '@/features/payment';
   
   class OrderService {
     private paymentService = new PaymentService(); // Прямая зависимость
   }
   
   // ХОРОШО: слабая связанность через DI
   class OrderService {
     constructor(private paymentService: PaymentService) {}
   }
   

4. Соблюдение направленности зависимостей
   В FSD зависимости разрешены только "снизу вверх": слой виджетов может зависеть от фич, но фичи не должны зависеть от виджетов. Это предотвращает циклические связи.

   Разрешено:           Запрещено:
   widgets/            entities/
     UserCard   →        User   ←
         ↓                    ↑
   features/            widgets/
     UserProfile             UserCard
   

Преимущества Loose Coupling в FSD

• Упрощение рефакторинга: Изменение логики в одной фиче не затрагивает другие.
• Повторное использование: Модули можно легко переносить между проектами.
• Эффективное тестирование: Компоненты тестируются изолированно через моки.
• Параллельная разработка: Несколько команд могут работать над разными фичами одновременно.

Пример нарушения и исправления

// НАРУШЕНИЕ: жёсткая связанность
// features/order/lib/helpers.ts
import { api } from '@/features/payment/lib/api'; // Прямой импорт из другой фичи

export const processOrder = () => {
  const paymentResult = api.charge(); // Зависимость от деталей Payment
};

// СОБЛЮДЕНИЕ: слабая связанность
// features/order/lib/types.ts
export interface PaymentGateway {
  charge: (amount: number) => Promise<PaymentResult>;
}

// features/order/lib/helpers.ts
export const processOrder = (gateway: PaymentGateway) => {
  // Теперь зависимость абстрагирована
  return gateway.charge(100);
};

Практические рекомендации

• Используйте публичные API каждого слоя FSD (например, public-api.ts).
• Избегайте кросс-импортов между фичами и сущностями.
• Применяйте паттерны (Mediator, Observer) для взаимодействия модулей.
• Тестируйте модули через интеграционные тесты, проверяя только контракты.

Loose Coupling в FSD — не просто "меньше импортов", а философия проектирования, где каждый модуль автономен, а система становится устойчивой к изменениям. Это требует дисциплины, но окупается в долгосрочной поддержке проекта.