📌 Hızlı Özet:
Tek başınıza çalışırken git push origin main yapmak kolaydır. Ancak 5 kişilik bir takımda herkes aynı dosyalara dokunmaya başladığında disiplinli bir branch stratejisi hayati önem taşır.


Git Branch ve Pull Request İş Akışı

GitHub Flow: Sade ve Güçlü

Modern takımların çoğu karmaşık GitFlow yerine basit GitHub Flow kullanır:

  1. main dalı her zaman yayına hazır ve kararlıdır.
  2. Yeni özellik için feature/login-page gibi açıklayıcı dal açılır.
  3. Düzenli commit atılır ve Pull Request (PR) oluşturulur.
  4. En az bir ekip arkadaşı onaylayıp testler geçince main’e merge edilir.

📌 Sıradaki İlgili Rehber: CI/CD Boru Hatlarında Otomatik Güvenlik ve SAST Kod Analizi
Dalları birleştirirken güvenlik ve zafiyet kapılarını kurun.

GitFlow vs. GitHub Flow vs. Trunk-Based Development

Takımın büyüklüğüne ve dağıtım sıklığına göre doğru dallanma stratejisi seçilmelidir:

Strateji Ana Dal Özellik Dalları Dağıtım Mantığı Takım Büyüklüğü
GitFlow main + develop feature/*, release/*, hotfix/* Planlı periyodik sürümler Büyük kurumsal takımlar
GitHub Flow main feature/* (Kısa ömürlü) PR onaylanınca anında dağıtım Modern web ve startup takımları
Trunk-Based main (Trunk) Günlük birleşen mikro dallar Feature flags ile sürekli entegrasyon Yüksek tempolu DevOps ekipleri

Rebase vs. Merge: Temiz Bir Git Ağacı İçin Karar Anı

  • git merge: İki dalın geçmişini korur ve yeni bir “Merge commit” oluşturur. Güvenlidir ancak karmaşık projelerde git geçmişini anlaşılmaz bir örümcek ağına dönüştürür.
  • git rebase: Özellik dalındaki commit’leri alır, ana dalın en son commit’inin üzerine taşır. Doğrusal (linear), tertemiz ve adım adım okunabilir bir tarihçe bırakır.
# Özellik dalını ana dal ile çatışmasız güncelleme
git checkout feature/odometri-filtresi
git fetch origin
git rebase origin/main

# Eğer çatışma (conflict) çıkarsa:
# Dosyaları düzenleyin, ardından:
git add .
git rebase --continue

Çatışmaları (Conflict) Önlemenin 3 Altın Kuralı

  1. Küçük ve Atomik PR’lar: 50 dosyayı birden değiştiren bir PR açmayın. Maksimum 3-5 dosyayı kapsayan, tek bir amaca hizmet eden PR’lar açın.
  2. Düzenli Senkronizasyon: Uzun süren özellik dallarında çalışırken her sabah git pull --rebase origin main yaparak ana daldaki değişiklikleri erkenden içeri alın.
  3. Otomatik Formatlayıcı (Prettier/Black) Çatışması: Tüm ekip aynı linter/formatter kurallarını pre-commit hook olarak çalıştırmalıdır.

Anlamsal Commit (Conventional Commits) Standardı

Büyük yazılım takımlarında commit geçmişinin otomatik changelog üretebilmesi ve okunabilir kalması için standart kurallar uygulanmalıdır:

  • feat: Sisteme yeni bir kullanıcı özelliği eklendiğinde (örn. feat(auth): add OAuth2 google login)
  • fix: Bir hata düzeltildiğinde (örn. fix(nav): resolve 404 broken category link)
  • refactor: Ne bir hata düzelten ne de özellik ekleyen kod düzenlemelerinde
  • perf: Performansı artıran sorgu veya asset optimizasyonlarında
  • chore: Bağımlılık güncellemeleri veya CI konfigürasyon değişikliklerinde

Git Cherry-Pick ve Git Bisect ile Hata Avcılığı

  • git cherry-pick <commit-hash>: Başka bir dalda yapılmış kritik tek bir güvenlik yamasını kendi dalınıza zahmetsizce aktarır.
  • git bisect: Yüzlerce commit öncesinde sisteme girmiş gizli bir hatayı ikili arama (binary search) algoritmasıyla 5 adımda nokta atışı bulmanızı sağlar.

Sıkça Karşılaşılan Sorular ve Sahadan Uzman Yanıtları (FAQ)

1. Bu mimariyi uygularken ilk aşamada en çok yapılan hata nedir?

En sık karşılaşılan tuzak, konfigürasyon parametrelerini ve sistem sınırlarını test etmeden doğrudan varsayılan değerlerle (default values) üretime almaktır. Özellikle yüksek eşzamanlılık (concurrency) ve bellek kısıtlı ortamlarda varsayılan ayarlar ani gecikme artışlarına ve soket tükenmesine (socket exhaustion) yol açar. Sistem her zaman kademeli yük testleriyle doğrulanmalıdır.

2. Performansı optimize ederken hangi metrikler izlenmelidir?

Sistemin sağlığını izlerken tek başına CPU kullanımına bakmak yanıltıcıdır. P95 ve P99 gecikme süreleri (latency percentiles), bellek tahsis hızları (heap allocation rate), I/O bekleme süreleri (iowait) ve hata oranları (error rate) birincil göstergeler olmalıdır. Grafana veya Prometheus gibi araçlarla bu metrikler anlık olarak takip edilmelidir.

3. Geriye dönük uyumluluk (Backward Compatibility) nasıl garanti edilir?

API ve veri formatı güncellemelerinde anlamsal sürümleme (SemVer) kurallarına sıkı sıkıya bağlı kalınmalıdır. Protokol veya şema değişikliklerinde eski versiyon en az iki ara sürüm boyunca desteklenmeli ve geçiş köprüleri (adapter layer) tanımlanmalıdır.

Üretime Alma ve Güvenlik Doğrulama Kontrol Listesi

Sistemi canlıya almadan veya sahaya çıkarmadan önce şu adımları tamamlayın:

  • Hata Yakalama ve Loglama: Tüm kritik akışlarda yapılandırılmış loglama (JSON formatında) ve panik/crash kurtarma mekanizmaları kuruldu.
  • Giriş Doğrulama (Sanitization): Dış dünyadan veya istemciden gelen tüm parametreler sıkı tip ve sınır denetiminden geçirildi.
  • Kaynak Sınırları (Resource Limits): Süreç bazında bellek (cgroups/RAM) ve dosya tanımlayıcı (ulimit -n) sınırları tanımlandı.
  • Otomatik Yedekleme ve Kurtarma: Sistem çökmesi durumunda otomatik yeniden başlama (systemd / restart: always) politikası test edildi.

Uzun Vadeli Bakım ve Mimari Yol Haritası (Long-Term Maintenance)

Bir yazılım sisteminin veya teknik altyapının gerçek maliyeti ilk geliştirme anında değil, sonraki 2-3 yıllık bakım ve işletim evresinde ortaya çıkar. Sürdürülebilir bir mühendislik disiplini için şu prensipler uygulanmalıdır:

  1. Teknik Borç Yönetimi: Her geliştirme sprintinin veya proje döngüsünün en az %15-20’lik bölümü refactoring, kütüphane bağımlılık güncellemeleri ve teknik borçların temizlenmesine ayrılmalıdır.
  2. Otomatik Regresyon Testleri: Kod tabanına eklenen her yeni özellik veya hata düzeltmesi, gelecekte aynı hatanın tekrar etmesini engelleyen otomatik regresyon testleriyle mühürlenmelidir.
  3. Şeffaf Ekip İletişimi: Mimari değişiklikler kişisel kararlarla değil, ekip içi ortak tasarım dokümanları ve RFC tartışmalarıyla olgunlaştırılmalıdır.