29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
---
|
||
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`
|