feat(tmdb): cast alanina gore katı eslesmeli arama destegi ekle

This commit is contained in:
2026-03-01 01:57:57 +03:00
parent 79f90cb287
commit 8c66fa9b82
4 changed files with 144 additions and 16 deletions

View File

@@ -0,0 +1,28 @@
---
date: 2026-03-01
topic: tmdb-cast-strict-matching
---
# TMDB Cast Bazlı Katı Eşleşme
## What We're Building
TMDB arama akışına opsiyonel `cast` alanı eklenecek. İstekte `cast` verildiğinde sistem, mevcut `title/year/seasonYear/seasonNumber/type` ile adayları bulduktan sonra ilk 5 adayı cast bilgisi ile doğrulayacak.
Cast doğrulaması katı olacak: verilen cast adı adayın oyuncu listesinde yoksa aday elenecek. İlk 5 adayda hiç eşleşme bulunmazsa boş sonuç dönülecek. `cast` verilmediğinde mevcut davranış korunacak.
## Why This Approach
Kullanıcı beklentisi yanlış eşleşmeleri azaltmak ve “başlık + tek oyuncu adı” ile daha doğru içeriği seçmek. Katı filtreleme, özellikle benzer isimli yapımlarda hatalı ilk sonucu engeller.
Top 5 doğrulama, doğruluk ve API maliyetini dengeler. `cast` alanını opsiyonel tutmak, mevcut istemcilerle geriye dönük uyumluluğu korur.
## Key Decisions
- `cast` alanı opsiyonel: Eski entegrasyonlar bozulmaz.
- Cast eşleşmesi katı: Eşleşme yoksa sonuç dönmez.
- Doğrulama kapsamı Top 5: Aşırı API çağrısından kaçınılır.
- Eşleşme modu esnek normalize: büyük/küçük harf, Türkçe karakter varyasyonları ve boşluk farklılıkları tolere edilir.
## Open Questions
- Cast eşleşmesi yokken yanıt sadece `results: []` mı olmalı, yoksa `reason` gibi açıklayıcı bir alan eklenmeli mi?
## Next Steps
-> `/workflows:plan`