Dış API sayfaya değil, veri katmanına bağlanır.
Ücretsiz futbol kaynakları cron işçileri tarafından alınır, normalize edilir ve MySQL'e yazılır. Web/Premium/Flutter katmanı doğrudan yerel veriyi okur; aynı veri için her sayfa açılışında yeniden API çağrısı yapılmaz.







Ücretsiz kaynakları tek sağlayıcı gibi kullan.
Kaynaklar birbirini tamamlar. Bir provider'da bulunmayan alan başka kaynaktan gelebilir; bulunmayan istatistik ise sıfır yapılmaz, NULL olarak kalır.

Football-Data.co.uk
CSV · geçmiş maç + şut/SOT/korner/faul/kart

OpenLigaDB
Anahtarsız · Bundesliga / 2. Bundesliga fikstür-sonuç

football-data.org
Ücretsiz token · seçili üst liglerin fikstür/sonuç/tablo verisi

API-Football Free
100/gün kotayı boşluklar ve derin veri için kontrollü kullanır

TheSportsDB V1
Varsayılan kapalı: gelecekteki Flutter/App Store dağıtımı nedeniyle lisans şartları bilinçli olarak ayrı tutulur

OpenAI Responses
Haftalık yorum · yalnız cron · yorumlar MySQL cache
Aktif kaynak rotası
Bir kez çek, doğrula, tekrar kullan.
HTTP cache sağlayıcı kotasını korur; canonical merge farklı kaynakların aynı takım/maçı çoğaltmasını engeller.

Free Data Sync
Fikstür ve sonuçlar kaynak bazlı TTL ile indirilir. Aynı CSV/JSON dosyası lig başına tekrar indirilmez.

Canonical MySQL
Takım ve fikstürler ad, lig, rakip ve kickoff yakınlığıyla eşleştirilerek provider kimlikleri tek canonical kayda bağlanır.

20 sezon backfill
Football-Data.co.uk tarihsel sonuç ve mevcut olduğu yıllarda şut/SOT/korner/faul/kart gibi maç istatistiklerini doldurur.

Prediction v1.6
Yerel geçmiş + güncel fikstür + kadro/availability varsa bunlardan tahmin snapshot'ı üretir; dış API'yi model render sırasında çağırmaz.

Weekly AI Editor
Önümüzdeki haftanın maç bağlamı MySQL'den hazırlanır. OpenAI yalnız context hash değiştiğinde worker tarafından çağrılır.

Data Quality
Provider hatasında eski doğru veri korunur. Güncel kulüp reconciliation ve freshness gate tahminin hangi veriyle üretildiğini denetler.
Analiz katmanı yerel snapshot kullanır.
Kaynak sağlığı




Free Hub + haftalık AI
OpenAI anahtarı opsiyoneldir. Futbol verileri OpenAI olmadan da toplanır ve tahmin sistemi çalışır.
php scripts/config-check.phpFOOTBALL_PROVIDER=free_hubphp cron/sync-free-data.php 10php cron/sync-provider-bridges.php 4php cron/recalculate-predictions.php 40php cron/reconcile-fixture-consensus.php 120php cron/backfill-free-history.phpUzun işlem: cron/CLI üzerinden batch çalıştırın.php cron/rebuild-data-quality.php 60OPENAI_COMMENTARY_ENABLED=1OPENAI_API_KEY=...php cron/generate-ai-commentaries.php 7 24
