Skip to main content

> Terim

source of truth drift

Mimari dokümanlar, wiki sayfaları ve diyagramlar ile prod ortamında gerçekten çalışan kod arasındaki kademeli kopuş.

Detaylı Açıklama

Mimari diyagramların ve tasarım belgelerinin zamanla güncelliğini yitirerek prod'daki gerçeklikten kopması (decay) durumudur.

Otomatik dokümantasyon araçları veya disiplinli bir güncelleme kültürü yoksa, o meşhur 'gerçeğin kaynağı' (source of truth) bir yalan kaynağına dönüşür; yeni gelenleri yanıltır ve kazalara yol açar.

Neden Önemli?

Tehlikeli bir 'sistemi anlıyoruz' illüzyonu yaratır. Mühendisler artık gerçekliği yansıtmayan diyagramlara bakarak kritik mimari kararlar alırlar.

Yaygın Hata Senaryosu

Yeni başlayan bir mühendisin eski bir şema dokümanına bakarak 'bu kolon kullanılmıyormuş' deyip prod'dan o kolonu uçurması ve faturalama servisini anında çökertmesi.

Pratik Örnek

Wiki'deki diyagramın tüm trafiğin merkezi bir API Gateway'den geçtiğini göstermesi, ancak gerçekte üç kritik servisin aylardır doğrudan gRPC ile birbirine gizlice bağlanması.

Prodüksiyon Yansıması

Toz tutmuş Confluence sayfaları, güncellenmemiş OpenAPI spec'leri ve geçen yıl eklenen üç yeni veritabanını göstermeyen sistem modelleri.

Sıkça Sorulan Sorular

source of truth drift kısaca nedir?

Mimari dokümanlar, wiki sayfaları ve diyagramlar ile prod ortamında gerçekten çalışan kod arasındaki kademeli kopuş.

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

Yeni başlayan bir mühendisin eski bir şema dokümanına bakarak 'bu kolon kullanılmıyormuş' deyip prod'dan o kolonu uçurması ve faturalama servisini anında çökertmesi.

AI Özeti

Mimari dokümanlar, wiki sayfaları ve diyagramlar ile prod ortamında gerçekten çalışan kod arasındaki kademeli kopuş. Tehlikeli bir 'sistemi anlıyoruz' illüzyonu yaratır. Mühendisler artık gerçekliği yansıtmayan diyagramlara bakarak kritik mimari kararlar alırlar.