Skip to content

Standart finans uygulamalarının sıkıcılığına başkaldıran; yapay zeka destekli, stratejik varlık ve borç yönetimini Cyberpunk estetiğiyle sunan yeni nesil finans asistanı.

License

Notifications You must be signed in to change notification settings

neurodivergent-dev/FinancialAI

Repository files navigation

🚀 FinancialAI

"Financial Freedom, Cyberpunk Style." Standart finans uygulamalarının sıkıcılığına başkaldıran; yapay zeka destekli, stratejik varlık ve borç yönetimini Cyberpunk estetiğiyle sunan yeni nesil finans asistanı.

Expo React Native TypeScript Zustand NativeWind


🌌 Proje Hakkında

FinancialAI, klasik gelir-gider takibinin ötesine geçerek kullanıcıya kendi ekonomisinin CFO'su olma imkanı tanır. Modern yazılım mimarisi ve "Neurodivergent" dostu arayüzü ile karmaşık finansal verileri anlamlı, yönetilebilir ve estetik bir deneyime dönüştürür.

Uygulama, finansal verileri sadece listelemez; Net Değer (Net Worth), Güvenli Harcama Limiti ve Borçlanma Rasyoları gibi stratejik metriklerle analiz eder.

✨ Özellikler

📊 Stratejik Dashboard

  • Gerçek Zamanlı Net Değer: Tüm varlıklar ve borçların anlık konsolidasyonu.
  • Güvenli Harcama Limiti: Likit varlıklar ve borç dengesine göre hesaplanan, nakit akışını korumaya yönelik akıllı limit göstergesi.
  • Finansal Sağlık Analizi: Varlık/Borç oranı ve borçlanma yüzdesi ile anlık durum tespiti.

💳 Varlık & Borç Yönetimi

  • Çoklu Varlık Tipi: Nakit, Vadeli Hesap, Altın, Döviz ve Fon portföy yönetimi.
  • Kapsamlı Borç Takibi: Kredi kartı limitleri, güncel borçlar, kesim tarihleri ve şahıs borçları.
  • Alacak Yönetimi: Vade tarihi takipli özel alacak (Receivables) modülü.

⏳ Taksit Takibi (Installments)

  • Kalan ay sayısı ve bitiş tarihi projeksiyonu.
  • Taksitlerin aylık nakit akışına yükünü gösteren görselleştirilmiş ilerleme çubukları.

🎨 UI & UX Tasarımı

  • Cyberpunk Estetiği: Neon renk paleti, koyu mod (Dark Mode) ve gradient geçişler.
  • Akıcı Deneyim: NativeWind ile optimize edilmiş, performanslı animasyonlar ve geçişler.
  • Offline-First Mimari: AsyncStorage ve Zustand entegrasyonu ile internet bağımsız tam işlevsellik.

🛠️ Teknik Altyapı

Teknoloji Kullanım Amacı
Expo (SDK 54) Geliştirme Ortamı & Build Sistemi
React Native Cross-Platform Core Framework
TypeScript Statik Tip Güvenliği & Ölçeklenebilir Mimari
Zustand Global State Management & Persistence (Kalıcılık)
NativeWind Tailwind CSS tabanlı Styling Motoru
React Navigation 7 Modern Navigasyon Yapısı

🚀 Kurulum

Projeyi yerel ortamınızda çalıştırmak için:

# Repoyu klonlayın
git clone https://github.com/melihdemirdev/FinancialAI.git

# Klasöre girin
cd FinancialAI

# Bağımlılıkları yükleyin
npm install

# Uygulamayı başlatın

npx expo start

## 🤖 Yapay CFO Analizi (Gemini)

Dashboard'daki **“Yapay CFO Analizi”** kartı, mevcut varlık/borç/veri özetini Gemini'ye gönderip CFO tarzı bir yorum döndürür. Çalıştırmak için:

1) `.env` dosyasına Gemini anahtarınızı ekleyin:

EXPO_PUBLIC_GEMINI_API_KEY=YOUR_KEY_HERE

2) Expo'yu yeniden başlatın (`npx expo start --clear`), ardından Dashboard'da **Analiz al** butonuna basın.

Notlar:
- Yalnızca ilk birkaç kayıt (her kategoriden 3 örnek) ve temel metrikler gönderilir; veri mahremiyeti için prompt küçük tutulur.
- Yanıt gelmezse veya anahtar yoksa kart üzerinde hata mesajı görünür.

About

Standart finans uygulamalarının sıkıcılığına başkaldıran; yapay zeka destekli, stratejik varlık ve borç yönetimini Cyberpunk estetiğiyle sunan yeni nesil finans asistanı.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published