← Tüm yazılar
Teknik

Changelog #2 — Teknik Altyapı: FastAPI, Next.js ve PostgreSQL

Pivotstat'ın mimarisi: backend, frontend, veritabanı, Docker ve günlük veri senkron pipeline'ları.

FastAPINext.jsPostgreSQLDocker

Genel mimari

Pivotstat iki ana bileşenden oluşur:

KatmanTeknolojiGörev
FrontendNext.js 16 (React, TypeScript)Maç listesi, detay, blog, admin
BackendFastAPI (Python 3.11)REST API, ML inference, scraper orchestration
VeritabanıPostgreSQLMaç, oran, istatistik, ML tahmin arşivi
DağıtımDocker ComposeBackend + frontend konteynerleri

Backend yapısı

  • routers/ — HTTP endpoint'leri (maç, bülten, ML, blog, admin)
  • ml/ — Tahmin motorları, piyasa modeli, eğitim bundle'ları
  • pipelines/ — Mackolik implied, canlı tarama, motor kayıt
  • integrations/ — API-Football istemcisi, kadro servisi
  • scripts/ — Günlük sync (fikstür, puan durumu, takım listesi)

Frontend yapısı

  • App Router ile sayfa bazlı routing
  • Maç detay: sekmeli yapı (oran, piyasa, tahmin, istatistik, kadro…)
  • Auth gate ile üye girişi; admin paneli ayrı rol

Veri akışı

  1. Scraper'lar Mackolik / İddaa verisini PostgreSQL'e yazar
  2. API-Football sync fikstür, kadro, puan durumu günceller
  3. Kapanış oranları gelince ML pipeline devreye girer
  4. Frontend API'den canlı veri çeker; ağır hesap backend'de kalır

Neden bu stack?

  • Python — scikit-learn, pandas ile ML ekosistemi olgun
  • FastAPI — hızlı geliştirme, tip güvenliği, async hazır
  • Next.js — SEO, SSR metadata, performanslı React
  • PostgreSQL — JSONB (motor tahminleri), güçlü sorgular, güvenilirlik

Sonraki yazı: veri kaynaklarımız ve arşiv derinliği.

Changelog #2 — Teknik Altyapı: FastAPI, Next.js ve PostgreSQL | Pivotstat