Market Watch Dashboard

Canlı finansal piyasa takip ekranı. Kripto paralar, Borsa İstanbul hisseleri, TEFAS fonları, emtia/forex ve Wall Street hisselerini tek panelde gerçek zamanlı izler.

Özellikler

• Gerçek zamanlı kripto akışı — Binance WebSocket (milisaniyelik) + CoinGecko yedek kaynak
• BIST / Wall Street hisseleri & endeksler — Yahoo Finance (XU100.IS, THYAO.IS vb.)
• TEFAS fonları & özel portföyler — TEFAS işlem verileri
• Gram Altın / Ons Altın — dinamik formül motoru (Ons × USDTRY)
• Teknik grafik — çizgi, mum, alan; MA(7), RSI, Bollinger overlay
• Portföy / cüzdan takibi — adet, maliyet, alış tarihi; anlık TL değer, getiri, yıllıklandırılmış getiri
• DCA hesaplayıcı, fon karşılaştırma, fiyat alarmları
• Çoklu tema & yerleşim (8 renk teması, 2 düzen)
• Canlı TV + haber akışı

Ekran Görüntüleri

Bölüm	Önizleme
Gösterge Paneli
Canlı Yayın TV
Parametreler (Ayarlar)
Çoklu Matris
Borsa Kılavuzu
Borsalar & Şirketler
Portföy (Gerçek)
Portföy (Sanal Simülasyon)

Teknoloji

• Ön yüz: saf HTML/CSS/JavaScript (framework'süz)
• Arka yüz: Python standart kütüphanesi (http.server) + websockets (yalnızca WebSocket köprüsü için)
• Harici bağımlılık yok; tek harici Python paketi websockets

Çalıştırma

1. HTTP sunucu (panel)

python3 server.py
# http://localhost:59999  (PORT ortam değişkeniyle değiştirilebilir)

2. WebSocket köprüsü (kripto anlık akışı için)

pip install -r requirements.txt
python3 ws_bridge.py
# ws://localhost:60000  (WS_PORT ortam değişkeniyle değiştirilebilir)

ws_bridge.py olmadan da panel çalışır; ancak kripto fiyatları WebSocket yerine CoinGecko yedeğinden (30 sn) beslenir.

systemd servisleri (isteğe bağlı)

# /etc/systemd/system/marketwatch-web.service
[Unit]
Description=Market Watch Web Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/path/to/project
ExecStart=/usr/bin/python3 /path/to/project/server.py
Restart=always

[Install]
WantedBy=multi-user.target

ws_bridge.py için de benzer bir birim açıp ExecStart satırını o dosyaya göre değiştirin.

Dosya Yapısı

index.html        # Ana arayüz (HTML + gömülü CSS)
app.js            # Arayüz motoru, varlık listeleri, portföy
app-core.js       # Fiyat güncelleme, WebSocket, grafik veri akışı
app-chart.js      # Canvas çizim motoru (çizgi/mum/alan + indikatörler)
app-init.js       # Başlatma, ayar dinleyicileri, tema, çerez
app-news-tv.js    # Haber + canlı TV
exchanges.js      # Borsa/şirket/fon veritabanı
server.py         # HTTP sunucu + API rotaları
ws_bridge.py      # Binance WebSocket köprüsü
tv-ticker.html    # TV haber bandı bileşeni

Veri Kaynakları

Varlık	Kaynak
Kripto	Binance (WebSocket) + CoinGecko (yedek)
Hisseler / endeksler	Yahoo Finance
TEFAS fonları	TEFAS işlem verileri
Gram/Ons Altın	PAXG + dinamik formül
Haber	Google Haber ağı

⚠️ Sorumluluk Reddi

Bu proje eğitim amaçlıdır. Veriler üçüncü taraf kaynaklardan (Binance, CoinGecko, Yahoo Finance, TEFAS) alınır. Bu kaynaklardan bazıları (özellikle Yahoo Finance ve TEFAS) resmî/kitlesel kullanıma kapalı olabilir; üretim veya ticari amaçlı kullanım öncesinde ilgili sağlayıcıların kullanım koşullarını inceleyin ve gerekli izinleri alın.

Opsiyonel Bağımlılıklar

"Canlı Yayın TV" sekmesindeki HLS çözümleme ve AI altyazı özellikleri için ayrıca gerekir:

• yt-dlp (YouTube canlı yayın URL'sini çözmek için — PATH içinde bulunması yeterli)
• ffmpeg (ses akışı dönüştürme)
• numpy (Whisper altyazı)

Bunlar kurulu değilse panel sorunsuz çalışır, yalnızca ilgili ek özellikler devre dışı kalır.

Lisans

MIT

Değişiklik Günlüğü

Tüm sürüm notları için bkz. CHANGELOG.md.