Что должно находиться в слое Shared?

В многослойной архитектуре, такой как Clean Architecture или Onion Architecture, слой Shared (иногда называемый Core или Domain) играет ключевую роль в организации зависимостей. Он служит центральным узлом, содержащим элементы, общие для нескольких слоев, что позволяет избежать дублирования кода и нарушений принципа Dependency Inversion.

Что обычно находится в слое Shared?

• Общие модели данных (DTO, Entities, Value Objects): Базовые классы или интерфейсы, описывающие структуру данных, которые передаются между слоями.
• Интерфейсы репозиториев и сервисов: Абстракции, определяющие контракты для работы с данными или внешними сервисами. Их реализации будут в слое инфраструктуры.
• Утилиты и хелперы: Общие функции, такие как валидаторы, парсеры, математические вычисления, которые не зависят от конкретной бизнес-логики.
• Константы и перечисления (Enums): Общие для всего приложения значения, например, коды ошибок, статусы заказов.
• Кросс-компонентные зависимости (Cross-cutting concerns): Базовые реализации для логирования, обработки исключений, кэширования, если они абстрагированы от конкретных фреймворков.

Пример структуры и кода

Рассмотрим простой пример на TypeScript для приложения электронной коммерции. В слое Shared мы можем определить интерфейс репозитория и базовую модель продукта.

// shared/interfaces/IProductRepository.ts
export interface IProductRepository {
  findById(id: string): Promise;
  findAll(): Promise;
  save(product: Product): Promise;
}

// shared/models/Product.ts
export class Product {
  constructor(
    public id: string,
    public name: string,
    public price: number,
    public category: string
  ) {}

  // Общий метод, который может использоваться в разных слоях
  applyDiscount(percent: number): void {
    if (percent > 0 && percent <= 100) {
      this.price = this.price * (1 - percent / 100);
    }
  }
}

// shared/utils/validation.ts
export function isValidEmail(email: string): boolean {
  const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return regex.test(email);
}

Правила и ограничения

Критически важно, чтобы слой Shared не зависел от внешних слоев, таких как UI (например, React-компоненты), инфраструктура (базы данных, HTTP-клиенты) или фреймворки. Это предотвращает циклические зависимости и делает код более тестируемым и переиспользуемым. Например, интерфейс IProductRepository объявлен в Shared, а его реализация MongoProductRepository находится в слое инфраструктуры, который зависит от Shared.

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