Skip to main content

> Terim

Architectural Decision Record

Önemli bir mimari kararın bağlamını, değerlendirilen alternatiflerini ve sonuçlarını kayıt altına alan kısa döküman.

Detaylı Açıklama

ADR'ler bir mühendislik ekibinin kurumsal hafızasıdır. O anki şartlar altında neden belirli bir teknik yola girildiğini gelecekteki ekiplere açıklar.

Neden Önemli?

Aynı mimari tartışmaların aylar sonra tekrar açılmasını engeller ve yeni gelenlerin legacy sistemlere bakıp dehşete düşmesini önler.

Yaygın Hata Senaryosu

Karar çoktan alınıp kod yazıldıktan sonra, sırf süreç gerektiriyor diye göstermelik bir ADR yazmak.

Pratik Örnek

Yüksek yazma hızı gerektiren bir servis için ilişkisel veritabanından NoSQL'e geçiş kararını bir ADR ile dökümante etmek.

Prodüksiyon Yansıması

Genelde repoda `/docs/adr` altında tutulan, sırayla numaralandırılmış markdown dosyaları bütünüdür.

Sıkça Sorulan Sorular

Architectural Decision Record kısaca nedir?

Önemli bir mimari kararın bağlamını, değerlendirilen alternatiflerini ve sonuçlarını kayıt altına alan kısa döküman.

En sık karşılaşılan hata nedir?

Karar çoktan alınıp kod yazıldıktan sonra, sırf süreç gerektiriyor diye göstermelik bir ADR yazmak.

AI Özeti

Önemli bir mimari kararın bağlamını, değerlendirilen alternatiflerini ve sonuçlarını kayıt altına alan kısa döküman. Aynı mimari tartışmaların aylar sonra tekrar açılmasını engeller ve yeni gelenlerin legacy sistemlere bakıp dehşete düşmesini önler.