Metodoloji

Veriyi Nasıl Topluyoruz

Veri kaynakları ve güncelleme döngüleri

Car and Problems, sadece kamuya açık federal kaynaklarda yayımlanan birincil kaynakları kullanır. Her veri türü, farklı bir sıklıkla güncellenir:

Veri türüKaynakGüncelleme sıklığı
Geri çağırmalar (recalls)Federal recall API + günlük flat-fileGünlük (03:00 UTC)
Şikayetler (complaints) — 2023 ve sonrasıŞikayet APIHer 3 saat
Şikayetler — 2022 ve öncesiAylık flat-fileAylık (ayın 1'i 03:00 UTC)
SoruşturmalarAylık flat-fileAylık (ayın 1'i 04:00 UTC)
Üretici duyuruları (TSB)Beş-yıllık bulk arşivlerAylık (ayın 1'i 05:00 UTC)
Araç kataloğuResmi araç kataloğu bulk dumpAylık (yayın sonrası otomatik)

Araçları nasıl eşleştiriyoruz?

Her bir veri kaynağında araç tanımı farklı alan isimleriyle gelir: bazısında "MAKETXT/MODELTXT/YEARTXT", bazısında "ProductsAffected JSON array". Bunların hepsini normalize edip (make, model, year) üçlüsüyle aynı vehicle kaydına bağlıyoruz. Olağan isim varyasyonlarını (örn. "Mercedes-Benz" vs "Mercedes Benz" vs "Mercedes") slugify + ensureUniqueSlug yardımcılarıyla çözüyoruz.

Aynı geri çağırma birden fazla (yıl, marka, model) kombinasyonunu etkilediğinde, kampanyayı her birinin altında listeliyor ve affectedVehicles alanında orijinal kapsamı koruyoruz — bir vehicle profile'inde gördüğünüz kampanya o araç için geçerlidir, ancak kaynakta belirtilen tüm araçları da görebilirsiniz.

Bilinen sınırlamalar

  • Gecikme: Federal kaynak bir kampanyayı yayımladıktan ~6-24 saat sonra sitemize yansır. Çok yeni bir olay için resmi kaynak daha hızlıdır.
  • Eksik görseller: PDF'ten resim çıkarımı her belgede çalışmaz; bazı makalelerin hero görseli yerine varsayılan bir grafik görebilirsiniz.
  • Motosiklet ve ağır ticari: Bu kategoriler resmi kayıtlarda farklı iş akışına sahiptir ve şu an kısıtlı kapsanmaktadır.
  • Çeviriler: Özet Türkçe metinler büyük dil modelleriyle üretilip insan editörü tarafından gözden geçirilir; teknik terimlerde orijinal İngilizce ifadeyi parantez içinde bırakırız.

Güncelleme durumu

Son sync zamanlarını ana sayfanın alt kısmında şeffaf biçimde gösteriyoruz. Bir vehicle profile sayfasında "Last checked: 3 hr ago" etiketini gördüğünüzde, o veri o süreden daha yeni değildir.