💰 FutureWallet Ultimate: AI Finansal Asistan

FutureWallet Ultimate, Bitcoin varlıklarınızın değerini gerçek zamanlı fiyatlar üzerinden takip etmenizi, geçmiş performansınızı diğer yatırım araçlarıyla (Altın, S&P 500, Enflasyon) kıyaslamanızı ve yapay zeka desteğiyle işlem stratejilerinizi analiz etmenizi sağlayan kapsamlı bir finansal simülasyon uygulamasıdır.

🚀 Özellikler

• Gerçek Zamanlı ve Esnek Veri: Binance API (ccxt) üzerinden anlık Bitcoin (BTC) fiyatını çeker. API erişim sorunu durumunda manuel fiyat girişi desteği sunar.
• Detaylı Geçmiş Analizi: Cüzdan performansınızı S&P 500, Altın ve ABD Enflasyonu ile grafik üzerinde karşılaştırır.
• Gelecek Simülasyonu & Yapay Zeka (ML):
  • Manuel Simülasyon: "Bitcoin X dolar olursa varlığım ne olur?" sorusuna yanıt verir.
  • XGBoost Tahmini: Makine öğrenmesi modeli (future-price.py) kullanarak belirli bir fiyat hedefine ulaşma olasılığını hesaplar.
• İşlem Geçmişi Analizi: Borsa veya Excel'den aldığınız işlem geçmişini (CSV/Excel) yükleyerek yapay zekaya (Gemini) stratejinizi, kar/zarar durumunuzu ve risk yönetiminizi yorumlatabilirsiniz.
• Dinamik Yapay Zeka Desteği: API anahtarınız ile mevcut Google Gemini modelleri (Flash, Pro vb.) arasından seçim yapabilir, analizlerinizi istediğiniz modelle gerçekleştirebilirsiniz.
• Kayıtlı Analizler: Yaptığınız tüm simülasyonları ve yapay zeka yorumlarını veritabanına (SQLite) kaydeder, dilediğiniz zaman geçmiş analizlerinizi inceleyebilir veya silebilirsiniz.
• Modüler Mimari: Uygulama, iş mantığı (services/) ve arayüz (views/) katmanlarına ayrılarak mobil geliştirmeye hazır hale getirilmiştir.
• Mobil Uyumlu Arayüz: Tüm grafikler ve tablolar mobil cihazlarda rahatça görüntülenebilecek şekilde optimize edilmiştir.

🛠️ Teknolojiler

Bu proje aşağıdaki teknolojiler kullanılarak geliştirilmiştir:

• Python (3.11+)
• Streamlit (Arayüz)
• Pandas & NumPy (Veri Analizi)
• XGBoost & Scikit-learn (Makine Öğrenmesi)
• CCXT (Kripto Para Borsası Verileri)
• yfinance (Borsa ve Emtia Verileri)
• Google Generative AI (Gemini Modelleri)
• SQLite (Veri Saklama)
• OpenPyXL & xlrd (Excel Desteği)

📦 Kurulum & Çalıştırma

Projeyi çalıştırmak için Python ortamı veya Docker kullanabilirsiniz.

Seçenek 1: Python ile Çalıştırma

1. Gerekli kütüphaneleri yükleyin:

   pip install -r requirements.txt

2. Konfigürasyon (Opsiyonel): Uygulama 12-Factor App prensiplerine uygun olarak Environment Variable desteği kazanmıştır. .env dosyası oluşturarak API anahtarınızı tanımlayabilirsiniz:

   # .env dosyası
   GOOGLE_API_KEY=AIzaSy...

   Eğer tanımlamazsanız, uygulama arayüzünden manuel girebilirsiniz.

3. Uygulamayı başlatın:

   streamlit run app.py

Seçenek 2: Docker ile Çalıştırma (Önerilen)

Projeyi izole bir ortamda çalıştırmak için Docker kullanabilirsiniz.

1. İmajı oluşturun:

   docker build -t futurewallet .

2. Konteyneri çalıştırın:

   docker run -p 8501:8501 --env-file .env futurewallet

   (Eğer .env dosyanız yoksa --env-file .env kısmını silebilirsiniz.)

Uygulama http://localhost:8501 adresinde çalışacaktır.

📱 Mobil Uyumluluk & Yol Haritası

Uygulama arayüzü mobil cihazlara uyumlu olacak şekilde optimize edilmiştir (Responsive Charts & Layouts).

Gelecekte tam teşekküllü bir mobil uygulamaya (iOS/Android) geçiş süreci için hazırlanan planı incelemek isterseniz: 👉 MOBILE_ROADMAP.md dosyasını okuyunuz.

📂 Dosya Yapısı

• app.py: Uygulamanın ana giriş noktası (Orchestrator).
• services/: İş mantığını içeren modüller (Portfolio, AI Service vb.).
• views/: Kullanıcı arayüzü bileşenleri.
• multi_asset_manager.py: Varlık yönetimi ve veri çekme sınıfı.
• future-price.py: XGBoost tabanlı fiyat olasılık tahmin modeli.
• requirements.txt: Proje bağımlılıkları.
• db.py: Veritabanı işlemleri (SQLite).
• check_model.py: Model ve API kontrol betiği.
• Dockerfile: Konteyner yapılandırması.
• shell.nix: Nix ortam yapılandırması.