Skip to content

hasankemaldemirci/finansor

Repository files navigation

Finansör Logo

Finansör

Tasarrufun eğlenceli hali

Modern ve akıllı finansal yönetim uygulaması. Oyunlaştırma (gamification) mekaniği ile gelir-gider takibi yapın, tasarruf hedeflerinize ulaşın!

Live Demo Version License

✨ Özellikler

  • 💰 Gelir-Gider Takibi: Minimal ve hızlı işlem ekleme, düzenleme ve silme
  • 💱 Çoklu Para Birimi: TRY, USD, EUR desteği
  • 🌍 Çoklu Dil Desteği: Türkçe ve İngilizce dil seçenekleri
  • 🔍 Gelişmiş Filtreleme: Tarih, kategori, tutar ve arama
  • 📈 Detaylı İstatistikler: Aylık trendler, kategori analizleri, tasarruf oranı
  • 🎮 Gamification: XP sistemi, 100 seviye, 25+ başarı
  • 🔔 Akıllı Bildirimler: Aylık hedef takibi ve tasarruf ipuçları
  • 🔒 Güvenlik: AES-256 şifreleme, XSS koruması, Zod validation
  • 📱 PWA: Mobil cihazlara yüklenebilir, offline çalışır
  • 🌗 Dark Mode: Açık/Koyu tema desteği
  • 🎯 Onboarding: İlk kullanıcılar için interaktif rehber
  • 📤 Sosyal Paylaşım: Başarılar ve istatistikleri paylaşma

🚀 Hızlı Başlangıç

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

# Development server'ı başlatın
npm run dev

🛠️ Teknolojiler

  • Frontend: React 18 + TypeScript
  • State: Zustand
  • UI: Tailwind CSS + shadcn/ui
  • i18n: react-i18next + i18next
  • Charts: Recharts
  • Build: Vite 5
  • PWA: Vite PWA Plugin

📦 Komutlar

npm run dev          # Dev server
npm run build        # Production build
npm run test         # Testleri çalıştır
npm run type-check   # TypeScript kontrolü

📱 PWA Kullanımı

  1. Chrome/Edge'de siteyi açın
  2. Adres çubuğundaki "Yükle" ikonuna tıklayın
  3. Uygulama cihazınıza yüklenecektir

📂 Proje Yapısı

src/
├── app/              # App initialization & routing
├── features/         # Feature modules
│   ├── transactions/ # Transaction feature
│   ├── gamification/ # Gamification feature
│   └── settings/     # Settings feature
├── shared/           # Shared utilities & components
└── pages/            # Page components

🤝 Katkıda Bulunma

  1. Fork edin
  2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
  3. Commit edin (git commit -m 'feat: Add amazing feature')
  4. Push edin (git push origin feature/amazing-feature)
  5. Pull Request açın

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

👤 Yazar

Hasan Kemal Demirci

☕ Destek

Bu projeyi beğendiyseniz, gelişimine katkıda bulunabilirsiniz:

☕ Buy Me a Coffee


⭐ Eğer bu projeyi beğendiyseniz yıldız vermeyi unutmayın!

About

Tasarrufun eğlenceli hali: Finansör

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors