Зачем выделять отдельный слой репозитория, если бизнес-логика всё равно будет к нему обращаться?

Зачем нужен слой репозитория?

Репозиторий — это прослойка между бизнес-логикой и хранилищем данных. Его основная цель — абстрагировать детали доступа к данным и предоставить коллекцию объектов, с которыми можно работать как с обычной коллекцией в памяти.

Основные преимущества

• Тестирование: Вы можете легко подменить реальный репозиторий на mock или stub при юнит-тестировании бизнес-логики.
• Гибкость: Смена базы данных или ORM не затрагивает бизнес-логику — достаточно изменить реализацию репозитория.
• Централизация: Вся логика запросов (фильтрация, сортировка, пагинация) находится в одном месте, а не размазана по коду.
• Читаемость: Бизнес-логика оперирует понятными методами (getUserById, saveOrder), а не SQL-запросами или вызовами ORM.

Пример на TypeScript

// Интерфейс репозитория (абстракция)
interface UserRepository {
  findById(id: string): Promise<User | null>;
  save(user: User): Promise<void>;
}

// Реализация для PostgreSQL
class PostgresUserRepository implements UserRepository {
  async findById(id: string): Promise<User | null> {
    const result = await db.query('SELECT * FROM users WHERE id = $1', [id]);
    return result.rows[0] || null;
  }
}

// Бизнес-логика (сервис) не знает о БД
class UserService {
  constructor(private repo: UserRepository) {}

  async updateEmail(userId: string, newEmail: string) {
    const user = await this.repo.findById(userId);
    if (!user) throw new Error('User not found');
    user.email = newEmail;
    await this.repo.save(user);
  }
}

Когда это особенно полезно?

Репозиторий незаменим в больших проектах с несколькими источниками данных, при необходимости писать юнит-тесты без подключения к БД, а также при использовании DDD (Domain-Driven Design), где репозиторий является частью модели предметной области.

Вывод: Выделение слоя репозитория — это инвестиция в поддерживаемость и тестируемость кода. Даже если сейчас у вас одна база данных, абстракция окупается при первом же рефакторинге или добавлении нового источника данных.