Mimari Karar Kayıtları (Architecture Decision Records)

Bu klasör, Humindx'in mimari düzlemde aldığı "geriye dönülmesi pahalı" kararların gerekçeli kayıtlarını tutar. Amaç: "Bunu neden böyle yapmıştık?" sorusunu aylar sonra geldiğinde de tek bir dosya göstererek yanıtlayabilmek.

---

Ne Zaman ADR Yazılır?

Aşağıdaki 5 sorudan en az birine "evet" diyebiliyorsan ADR yaz:

1. Bu karardan geri dönmek bir hafta iş gerektirir mi? (kütüphane, DB seçimi, major framework)
2. Karar birden fazla servisin arayüzünü etkiliyor mu?
3. Güvenlik / gizlilik düzlemini değiştiriyor mu? (RLS, encryption, PII akışı)
4. Bir alternatifi bilinçli olarak eledik mi? (Pinecone yerine pgvector gibi)
5. Compliance (EU AI Act, GDPR) gereksinimine dayandı mı?

ADR yazılmaz ise: Kod stili, dosya isimlendirme, tek servisi etkileyen refactor, geri dönüşü 1 saatten kısa kararlar.

---

Nasıl Yazılır?

1. TEMPLATE.md dosyasını kopyala: NNN-kisa-isim.md formatında (sıradaki numara).
2. Status'u Önerildi olarak başlat, PR aç.
3. Tartışma PR'da yürür, karar verilince status Kabul Edildi olur.
4. Sonradan değişirse yeni ADR yaz, eskisini Yerine Geçti olarak işaretle — eskiyi düzenleme.

Numaralandırma: 3 haneli, sıralı, boşluksuz (001, 002, ...). Numara kilitlenmez — PR merge sırasına göre çakışma olursa sonraki PR yeniden numaralandırır.

---

Mevcut ADR'ler

#	Başlık	Durum	Tarih
001	Vektör Veritabanı Olarak pgvector Kullanımı	Kabul Edildi	2026-04-15
002	Saf Scrum Yerine Dual-Track Geliştirme	Kabul Edildi	2026-04-16
003	Monorepo Tek Repo + npm Workspaces	Kabul Edildi	2026-04-16
004	Release Otomasyonu — release-please	Kabul Edildi	2026-04-16

---

Durum Yaşam Döngüsü

Önerildi → Kabul Edildi → [Yerine Geçti | Reddedildi | Geçersiz]

• Önerildi: PR açıldı, tartışılıyor.
• Kabul Edildi: Merge edildi, uygulanıyor.
• Yerine Geçti: Yeni bir ADR bu kararı değiştirdi (referans ver: "ADR-XYZ tarafından yerine geçildi").
• Reddedildi: Tartışma sonucunda uygulanmadı — yine de kayıt kalır.
• Geçersiz: Bağlam değişti, artık geçerli değil (ama yeni karar yok).

---

Sahip: Simetri — Son Güncelleme: 2026-04-16