Yönetici Özeti ve Mimari Önem

GitHub'ın API'si aracılığıyla depo büyümesini izlemenin geleneksel yaklaşımı, GET /repos/{owner}/{repo}/stargazers uç noktasına dayanıyordu. Bir depoyu yıldızlayan kişileri listelemek için tasarlanan bu kaynak, kullanıcı kimliklerini açığa çıkarırken istemeden sayfalamayı ağır bir operasyonel yüke dönüştürdü. react/react gibi çok fazla yıldız almış projeler için, eksiksiz bir tarihi büyüme eğrisini yeniden oluşturmak, 2.500'den fazla farklı HTTP isteği üzerinden kabaca 251.000 kaydın işlenmesini gerektiriyordu. Bu mimari uyumsuzluk, kötü niyetli kişilerin kimlik avı ve istenmeyen posta kampanyaları için genel yıldız listelerini kazımasını davet etmekle kalmadı, aynı zamanda alttaki veritabanına ciddi bir vergi yükledi. Sayfalama hatası nedeniyle her bir sayfalama isteği, tüm mevcut yıldızların tam olarak sayılmasını zorunlu kıldı; bu da istek gecikmesini artırdı, veritabanı zaman aşımı hatalarına neden oldu ve sık sık katı API oran sınırlarına takıldı.

Bu kritik performans darboğazlarını ve güvenlik açıklarını gidermek için GitHub, ham yıldız ve gözlemci listelerini depo yöneticileri ve işbirlikçileri ile sınırlayarak açık veri kazıma vektörlerini kesti. Ancak bu erişim kısıtsızlığı, benimseme yörüngelerini çizebilmek için zaman damgası verilerine dayanan, yaygın olarak kullanılan Star History projesi gibi harici araçları yanlışlıkla bozdu. Araç geliştiricilerinin kullanıcı kimliklerinden ziyade toplulaştırılmış zaman serisi verilerine ihtiyaç duyduğunu fark eden GitHub, amaca yönelik bir toplulaştırma uç noktası tasarladı. Tasarım paradigmasını varlık getirmeden önceden filtrelenmiş zaman serisi toplulaştırmasına kaydıran GitHub, sürdürücülerin depo çekişini analiz etme biçimini dönüştürdü, veritabanı yükünü azalttı ve meta veri alımı için güvenli, yüksek düzeyde ölçeklenebilir bir model oluşturdu.

Temel İyileştirmeler ve Geliştirici Ergonomisi

Bu güncellemenin temel taşı, kullanıcı kimliklerini açığa çıkarmadan yıldız geçmişi eğrilerine hizmet etmek üzere özel olarak tasarlanmış uzmanlaşmış bir API uç noktasıdır. İstemcileri bireysel kullanıcıların sayfalandırılmış listeleri arasında yineleme yapmaya zorlamak yerine, yeni uç nokta tek bir atomik istekte 30 haftaya kadar günlük yıldız sayısını döndürür. Bu temel değişim, geliştirici ergonomisini büyük ölçüde geliştirerek istemci taraflı kod karmaşıklığını özyinelemeli sayfalama döngülerinden anlaşılır veri tüketimine indirger.

Kaputun altında, performans kazanımları hayati bir mimari optimizasyondan kaynaklanmaktadır: herhangi bir sayma işlemi gerçekleştirmeden önce yıldızların zaman damgasına göre filtrelenmesi. Eski uygulamada, veritabanı her sayfa isteğinde mevcut tüm yıldız kümesini geçmek ve saymak zorunda kalıyordu. Yeni uç nokta, veri kümesini veritabanı katmanında zamansal olarak kısıtlayarak sorgu yürütme yollarını optimize eder ve gereken çalışmanın deponun toplam popülaritesinden ziyade talep edilen zaman penceresiyle orantılı olarak ölçeklenmesini sağlar. Sonuç olarak, bu sorgularda harcanan veritabanı süresi yaklaşık %80 oranında düşerken, toplam istek hacmi %60 oranında azaldı ve platformu ardışık arızalardan ve oran sınırı tükenmesinden korudu.

Mimari Karşılaştırma Matrisi

Temel Değişiklikler ve Geçiş Uyarıları

Birincil kırılma değişikliği, eski GET /repos/{owner}/{repo}/stargazers ve izleyici uç noktalarına uygulanan güvenlik kısıtlamalarından kaynaklanmaktadır; bu uç noktalar artık depo yönetimi veya işbirliği ayrıcalıkları olmayan çağrılar için boş yanıtlar veya 403 Forbidden hataları döndürmektedir. Bu değişiklik, büyüme eğrilerini veya geçmiş metriklerini hesaplamak için daha önce eski uç noktayı kazıyan tüm üçüncü taraf analitik araçlarını, panolarını veya komut dosyalarını ani bir şekilde geçersiz kılar. Dahası, kullanıcı kimlikleri yeni toplulaştırılmış geçmiş uç noktasından kasıtlı olarak hariç tutulduğundan, geliştiriciler bireysel yıldız etkinlikleriyle ilişkili kullanıcı adlarını, kimlikleri veya hassas zaman damgalarını almak için bu yeni özelliği kullanamazlar. Eski uç noktadan göç eden ekipler, ham olay akışlarını tüketmek yerine önceden toplanmış günlük sayımları tüketmek için görselleştirme katmanlarını yeniden mimarileştirmelidir.

Adım Adım Yükseltme Kılavuzu

Uygulamanızı veya analitik araçlarınızı kullanımdan kaldırılan sayfalama yaklaşımından yeni optimize edilmiş modele taşımak için şu uygulama adımlarını izleyin:

1. Mevcut Entegrasyon Noktalarını Denetleyin: Geçmiş eğilim analizi için GET /repos/{owner}/{repo}/stargazers kullanan tüm dahili komut dosyalarını veya bağımlılıkları belirleyin ve sayfalama döngülerini kaldırın.
2. Toplulaştırılmış Uç Noktayı Benimseyin: API istemcinizi, zaman serisi verilerini doğrudan yeni toplanan yıldız geçmişi uç noktasından getirecek şekilde güncelleyin ve tek bir çağrıda günlük sayımların istenen penceresini isteyin.
3. İstemci Tarafı Görselleştirmesini Yeniden Düzenleyin: Veri alma ve grafikleme mantığınızı, bireysel kullanıcı düğümlerini işlemek yerine toplanan günlük aralıkları işleyecek şekilde ayarlayın.

// Örnek: Optimize edilmiş iş akışını kullanarak toplanan yıldız geçmişini getirme
async function fetchStarHistory(owner, repo) {
  const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/stats/star-history`, {
    headers: {
      'Accept': 'application/vnd.github+json',
      'Authorization': `Bearer ${process.env.GITHUB_TOKEN}`
    }
  });
  
  if (!response.ok) {
    throw new Error(`Yıldız geçmişi alınamadı: ${response.statusText}`);
  }
  
  // 30 haftaya kadar önceden filtrelenmiş günlük yıldız sayısını döndürür
  const starTimeSeries = await response.json();
  return starTimeSeries;
}