Tüketici odaklı sözleşme testi nedir?

Question

Accepted Answer

**Sözleşme testi**, iki hizmetin API konusunda anlaştığını tam bir entegrasyon testi çalıştırmadan doğrular. **Tüketici odaklı sözleşmelerde (CDC)**, tüketici ihtiyaç duyduğu şeyi tanımlar ve sağlayıcı bunu teslim edebileceğini doğrular.

## Sorun

Birçok hizmette tam end-to-end testler yavaş, düzensiz ve her commit'te çalıştırılması zordur. Sözleşme testleri, kırılan API değişikliklerini erkenden, yalıtılmış şekilde yakalar.

## CDC nasıl çalışır (ör. Pact)

```text
1. Consumer writes expectations  ─▶ generates a CONTRACT (Pact file)
2. Contract published to a broker
3. Provider runs the contract against itself in its own pipeline
4. Provider build FAILS if it would break the consumer
```

## Tüketici tarafı örneği

```js
// consumer declares exactly what it expects from the provider
provider.given('order 42 exists')
  .uponReceiving('a request for order 42')
  .withRequest({ method: 'GET', path: '/orders/42' })
  .willRespondWith({
    status: 200,
    body: { id: '42', total: 99.5 } // the shape the consumer relies on
  });
```

Sağlayıcının CI'si bunu yeniden oynatır ve artık o şekli döndürmezse başarısız olur.

## CDC vs entegrasyon testleri

| | Sözleşme testi | Entegrasyon testi |
|---|---|---|
| Hizmetler çalışıyor | Birer birer | Hepsi birlikte |
| Hız | Hızlı | Yavaş |
| Yakalar | Sözleşme kırılması | Gerçek bağlantı sorunları |

## Neden önemli

Sözleşme testleri, tüm sistemin çalıştırılmasının maliyeti ve belirsizliği olmadan, sağlayıcının değişikliği tüketicileri kırmayacağına dair güven verir.

Bağımsız dağıtımı güvenli hale getirir: her ekibin boru hattı, değişikliğinin birinin bağlı olduğu bir sözleşmeyi ihlal edip etmeyeceğini hemen bilir.

	Sözleşme testi	Entegrasyon testi
Hizmetler çalışıyor	Birer birer	Hepsi birlikte
Hız	Hızlı	Yavaş
Yakalar	Sözleşme kırılması	Gerçek bağlantı sorunları