Repository deseni nedir?

Question

Accepted Answer

**Repository** deseni, **veri erişimini** koleksiyon benzeri bir arabirim arkasında soyutlayarak — iş mantığını verinin nasıl depolandığından ve alındığından ayırır. Uygulamayı veri kaynaklarından (veritabanları, API'ler) ayrıştırarak testlenebilirliği ve bakım yapılabilirliği iyileştirir.

## Repository deseni ne yapar

```text
REPOSITORY → an abstraction layer between business logic and DATA ACCESS:
  → provides a clean interface (like a collection: findById, save, delete, findAll)
  → HIDES how/where data is actually stored (database, API, cache, files)
  → business logic uses the repository, NOT the database directly
→ separate WHAT data operations from HOW they're implemented
```

## Örnek

```js
// repository interface — business logic depends on THIS, not the DB
class UserRepository {
  async findById(id) { /* query the database (hidden behind here) */ }
  async save(user) { /* insert/update */ }
  async findByEmail(email) { /* ... */ }
}
// business logic uses the repository, unaware of the data source
const user = await userRepository.findById(42);
// → swap the DB, or use a mock in tests, without changing business logic
```

## Faydalar

```text
✓ DECOUPLING → business logic doesn't depend on data-access details (DB, ORM, API) →
  swap data sources without changing business logic
✓ TESTABILITY → use a MOCK/fake repository in tests (no real database needed)
✓ CENTRALIZED data access → query logic in one place (maintainable, consistent)
✓ CLEANER architecture → clear separation between domain/business logic and data
→ common in layered/clean architectures; works with DI
```

## Neden önemli

Repository deseni anlamak değerlidir çünkü iş mantığını veri erişiminden temiz bir şekilde ayırmak için **yaygın, pratik bir desendir**, bu nedenle ilgili tasarım bilgisidir.

Repository deseni, veri erişimini koleksiyon benzeri bir arabirim arkasında soyutlar (findById, save, delete), **verinin nasıl ve nerede depolandığını gizler**, böylece iş mantığı veritabanı yerine doğrudan repository'yi kullanır.

Ne yaptığını anlamak (temiz bir veri erişim arayüzü sağlayan ve gerçek depolamayı gizleyen, veri işlemlerinin *ne* olduğunu *nasıl* uygulandığından ayıran) temel bilgidir.

**Faydaları** anlamak anahtarıdır: **ayrıştırma** (iş mantığı veri erişim ayrıntılarına, belirli veritabanı, ORM veya API gibi bağlı değildir, böylece veri kaynaklarını iş mantığını değiştirmeden değiştirebilirsiniz — değerli bir mimari fayda), **testlenebilirlik** (testlerde mock/sahte repository'ler kullanarak gerçek veritabanına gerek olmaz — iş mantığının birim testlenmesi için önemli), **merkezi veri erişimi** (bakım ve tutarlılık için sorgu mantığı bir yerde), ve **daha temiz mimari** (domain/iş mantığı ve veri arasında açık ayrım).

Bu faydalar Repository desenini, bakım yapılabilir ve test edilebilir uygulamalar için pratik olarak değerli kılar.

Bunun **katmanlı/temiz mimarilerde** yaygın olduğunu ve bağımlılık enjeksiyonu ile çalıştığını anlamak, bunun modern mimarideki yerini açıklar.

Repository deseni yaygın olarak kullanılır çünkü iş mantığını veri erişiminden ayırmak (testlenebilirlik, bakım yapılabilirlik ve esneklik için) yaygın, önemli bir gereksinimdir.

Repository deseni iş mantığını veri erişiminden temiz bir şekilde ayırmak için yaygın, pratik bir desen olduğu (ayrıştırma, testlenebilirlik, merkezi veri erişimi, daha temiz mimari) — yaygın, önemli bir gereksinim — ve katmanlı/temiz mimarilerin merkezinde olduğu, ve ne yaptığını ve faydalarını anlamanın bakım yapılabilir uygulamalar oluşturmak için ilgili olduğu için, Repository desenini anlamak — mantık ve veriler arasında temiz ayrım sağlayan, ayrıştırma ve testlenebilirlik sağlayan, temiz/katmanlı mimarilerin merkezinde olan ve bakım yapılabilir, test edilebilir uygulamalar oluşturmak için önemli tasarım bilgisi olan veri erişiminden iş mantığını ayırmak için sık kullanılan bir desen — değerli, pratik olarak ilgili tasarım bilgisidir.