> tpl_arc_002
Mimari Karar Kaydı (ADR) Paketi
MADR 3.0 ve ISO 42010 standartlarına dayanan, durum makinesi yaşam döngüsü, ağırlıklı seçenek matrisi ve ödünleşim kütüklerini içeren üretim kalitesinde mimari karar yönetişim çerçevesi.
Dağıtık bankacılık işlemleri için Outbox Saga ile 2PC'yi karşılaştıran standartlaştırılmış MADR 3.0 şablonu ve çalışılmış örnek. Karar etkenleri, ağırlıklı değerlendirme puanlaması, sonuçlar ve geri alma protokollerini içerir.
Önemli Teknik Doküman Şablonu ve Hukuki Uyarı
TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.
Çözülen Üretim Problemi
Önemli mühendislik kararları için değiştirilemez ve sürümlendirilmiş bir denetim izi kurarak kulaktan kulağa mimari sapmayı, belgelenmemiş geçici çözümleri ve ilkesiz teknoloji değişikliklerini önler.
Ne Zaman Kullanılmalı?
- •Önemli mimari desenlere (mikroservisler, olay güdümlü, CQRS, saga) karar verilirken.
- •Yeni bir altyapı katmanı, veritabanı veya mesaj aracısı sisteme dahil edilirken.
- •Eski dağıtık mutabakat protokolleri devreden çıkarılırken veya değiştirilirken.
- •Harici SOC 2 veya PCI-DSS denetimleri için mimari izlenebilirlik ve uyum sağlanırken.
Ne Zaman Kullanılmamalı?
- •Önemsiz kod seviyesi düzenlemeleri veya rutin kütüphane yamaları için (standart Git PR açıklamalarını kullanın).
- •Arayüz stil tercihleri, CSS düzenlemeleri veya mimari etkisi olmayan görsel değişiklikler için.
- •Kalıcı yapısal etkisi olmayan geçici özellik anahtarları için.
7 Şablon Bölümü ve Yapısal İskelet
Resmi karar başlığı, durum makinesi aşaması ve ARB inceleme katılımcıları.
Bu kararı zorunlu kılan iş ve teknik dinamikler.
Aday mimarileri derecelendiren ölçülebilir değerlendirme kriterleri.
Aday seçeneklerin karar etkenlerine göre puanlanan karşılaştırmalı analizi.
Resmi karar beyanı ve temel teknik değişmezler.
Bu kararla kazanılan somut yetenekler.
Katlanılan operasyonel maliyetler, karmaşıklıklar ve teknik borç.
Doldurma ve Uygulama Yönergeleri
Bağımsız İnceleme ve Onay Kontrol Listesi
- Başlık genel bir konu yerine aktif bir teknik kararı ifade ediyor mu?
- Bağlam, çözümü erkenden dayatmadan olgusal dinamikleri sunuyor mu?
- Ağırlıklı puanlama ile en az üç farklı aday mimari değerlendirildi mi?
- Olumsuz sonuçlar ve operasyonel yükler önlemleriyle birlikte kabul edildi mi?
- Geri alma veya gölge dağıtım acil durum planı açıkça belgelendi mi?
ADR-042: Çekirdek Bankacılık Defteri İçin Olay Güdümlü Outbox Saga
Örnek Organizasyon: ApexGlobal Çekirdek Bankacılık v4.0
10.000 TPS zirve yük altında kilit ağırlıklı İki Aşamalı İşleme (2PC) yerine Temporal ve Debezium CDC kullanan asenkron Outbox Saga mimarisine geçiş.
- •P99 mutabakat gecikmesi 4.200 ms'den 142 ms'ye düşürüldü (%96.6 azalma).
- •Kullanılabilirlik alanları arasındaki yıkıcı dağıtık kilit krizleri ortadan kaldırıldı.
- •Kriptografik olarak doğrulanan outbox olay akışı otomatik denetim uyumu sağladı.
Sıkça Sorulan Sorular
Bir ADR ne zaman REJECTED yerine SUPERSEDED olarak işaretlenmelidir?
Bir ADR, yalnızca daha önce KABUL EDİLMİŞ (ACCEPTED) ve üretimde kullanılmışsa, ancak sonradan gelişen teknoloji veya değişen gereksinimler nedeniyle yeni bir karar gerektiğinde SUPERSEDED olarak işaretlenir. REJECTED ise ilk inceleme aşamasında öneri reddedildiğinde kullanılır.
ADR dokümanları kod tabanında nerede saklanmalıdır?
ADR'lar kodla birlikte sürüm kontrolünde tutulmalı; genellikle `docs/adr/` veya `_PM/Agent-PM/Docs/ADRs/` altında numaralandırılmış Markdown dosyaları olarak saklanmalıdır.
Teknik Doküman Şablon Paketi
Giriş GerekliTüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.
Yetkili Standartlar ve Kaynaklar
- Documenting Architecture Decisions (Michael Nygard)Cognitect • INDUSTRY PRACTICE
- Markdown Architectural Decision Records (MADR 3.0)ADR GitHub Community • OFFICIAL RECOMMENDATION