Florence yatırım platformunun native Android uygulaması — canlı BIST piyasa verisi, döviz & kıymetli metaller, yapay zekâ destekli araştırma raporları ve sanal portföy simülatörü.
Florence Mobile, Florence web arayüzünün ve Florence backend'inin mobil karşılığıdır. Aynı /api/v1 uçlarını kullanır, aynı paylaşılan veritabanına bağlanır ve web uygulamasıyla birebir aynı davranır — hesaplar, portföyler, krediler ve raporlar iki platformda da aynı şekilde çalışır.
- Canlı BIST panosu — piyasa durumu, en çok hareket edenler, mini grafikli popüler hisseler
- Hisse arama & detay — şirket temel verileri, saf Compose Canvas ile çizilen interaktif mum grafikleri (üçüncü parti grafik kütüphanesi yok)
- Döviz & Metaller — resmi TCMB kurları (gold-api yedekli); altın türleri (gram, çeyrek, yarım, tam…), gümüş, platin, paladyum
- Yapay Zekâ Raporları — yerel LLM ile (Ollama,
qwen2.5:7b) hızlı & derin raporlar; internet LLM gerektirmez; kredi maliyeti önceden gösterilir - Sanal Portföy — gerçek zamanlı piyasa fiyatlarıyla al/sat simülasyonu, pozisyonlar, kâr-zarar ve işlem geçmişi
- Coin / Kredi Sistemi — bakiye panoda görünür, rapor üretimiyle harcanır, admin uçlarıyla yüklenir
- İzleme Listesi (Favoriler) — hisseleri tek dokunuşla takip et
- Halka Arzlar — yaklaşan ve güncel halka arzlar
- Bildirimler — bildirim merkezi ekranı
- Çok Dilli & Tema — varsayılan Türkçe, İngilizce seçeneği; açık/koyu tema
- Çekmece (drawer) menüsü özel uygulama logosuyla; açılış ve giriş ekranları
- Dev / Prod build türleri — yerel backend (
10.0.2.2:7055) ve canlı API
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
- Kotlin 2.x + Jetpack Compose (Material 3), Navigation Compose
- Hilt bağımlılık enjeksiyonu, KSP kod üretimi
- Retrofit + OkHttp + kotlinx.serialization — tip güvenli API katmanı
- EncryptedSharedPreferences — refresh token deposu; access token bellekte tutulur
- MVVM + Repository mimarisi, tek seferlik (single-flight) token yenileme
- Saf Compose Canvas ile tüm grafikler (üçüncü parti grafik bağımlılığı yok)
- minSdk 26 / targetSdk 36
app/src/main/java/com/florence/app/
├── core/ # ağ (interceptor/authenticator), token deposu, tema, DI
├── data/ # Retrofit API arayüzü, DTO'lar, repository'ler
└── presentation/ # Compose ekranlar, ViewModel'ler, navigasyon
API katmanı saf Kotlin + kotlinx.serialization ile ayrıştırılmıştır; ileride iOS hedeflenirse KMP modülüne taşınabilir.
- JDK 21 (Android Studio JBR) —
gradle.propertiesiçindekiorg.gradle.java.homeile ayarlanır - Android SDK
7055portunda çalışan Florence backend (ayrıntılar için backend deposu)
# Dev türü (yerel backend: http://10.0.2.2:7055)
./gradlew :app:assembleDevDebug
# Prod türü
./gradlew :app:assembleProdDebugWindows notu:
GRADLE_USER_HOMEdeğeriC:/gradle-homeolarak sabitlenmiştir (gradlewiçinde) ve proje apostrophesiz bir yolda tutulur; çünküGAMER'Skullanıcı klasörü Java'nın @argfile ayrıştırmasını bozar.
Backend Docker Compose ile 7055 portunda çalışıyorsa emülatör 10.0.2.2:7055 üzerinden erişir. Alternatif olarak:
adb reverse tcp:7055 tcp:7055 # ardından localhost:7055 kullanılabilirCleartext HTTP yalnızca dev hostları için serbesttir (res/xml/network_security_config.xml).
- Giriş:
POST /api/v1/auth/login— form-encoded (OAuth2PasswordRequestForm), JSON token çifti döner - Access token 1 saat geçerli;
TokenRefreshAuthenticator401'de tek seferlik (single-flight) yenileme yapıp isteği tekrar dener - Yenileme:
POST /api/v1/auth/refresh(JSON{ refresh_token }) — backend rate limiti 5 istek/dk - Web ile aynı hesaplar: tek
userstablosu, platform ayrımı yok
./gradlew :app:testDevDebugUnitTestAGPL-3.0 — ayrıntılar için LICENSE.








