Florence — akıllı yatırım asistanının masaüstü istemcisi. Piyasa verileri, yapay zekâ analizleri ve sanal portföy yönetimini tek bir masaüstü uygulamasında sunar. Tauri 2 + Rust arka uç; ön yüz, web/ git-subtree'sindeki React/Vite uygulamasıdır (web/dist prodüksiyon ön yüzü olarak paketlenir).
-
Rust (stable,
rustupile) -
Node.js 20+ (npm)
-
Linux sistem paketleri (Tauri 2 WebKitGTK gereksinimleri):
sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential curl wget file \ libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
libwebkit2gtk-4.1-dev— webview katmanı (zorunlu)libayatana-appindicator3-dev— sistem tepsisi (tray) ikonu (zorunlu)librsvg2-dev— AppImage bundling
npm install # kök bağımlılıklar (@tauri-apps/cli, cross-env)
npm run dev # = tauri dev → web dev sunucusu (Vite, :5173) + Rust uygulamasınpm run dev önce web/ içinde Vite'i, sonra Tauri uygulamasını başlatır. Kod değişiklikleri: Rust tarafı src-tauri/, ön yüz web/src/ (doğrudan web/ içinde düzenlenir; değişiklikler subtree sync ile gelir).
npm run build # = cross-env NO_STRIP=1 tauri build- Çıktılar:
src-tauri/target/release/bundle/(deb, rpm, AppImage, dmg, msi, exe…) NO_STRIP=1zorunludur: tauri-action'ın CI ortamında uyguladığıstripdavranışını yerel build'de de eşitler; CI ile tutarlı binary üretir.- Prodüksiyon ön yüzü
web/dist'ten paketlenir (beforeBuildCommand: npm --prefix web run build).
Tek aksiyon: web repo'sunda vX.Y.Z tag atmak. Gerisi otomatik:
web repo (project-florence/web)
│ package.json version → vX.Y.Z tag
▼
tag-from-version.yml (web)
├─► deploy iş akışı → sunucu (web uygulaması yayını)
└─► sync-desktop.yml (web)
├─ git subtree pull --prefix web → desktop/web güncellenir
├─ package.json + src-tauri/tauri.conf.json version = X.Y.Z
└─ desktop'a aynı vX.Y.Z tag
▼
build.yml (desktop, tag tetiklemeli)
├─ tauri-action → Windows/Linux/macOS (aarch64+x86_64) binary'leri
│ tagName: v__VERSION__ (tauri.conf.json'dan okur) → draft release
└─ publish işi → sunucu /downloads + manifest.json (indirme listesi)
- Sürümün tek kaynağı
web/package.json'dır;src-tauri/tauri.conf.jsonve kökpackage.jsonsync sırasında eşitlenir. build.ymlherv*tag'inde tetiklenir;tauri-actionreleaseDraft: trueile draft release açar,publishişi binary'leri/usr/share/nginx/html/downloads'a yükler vemanifest.jsonüretir.- macOS sürümleri hem
aarch64-apple-darwinhemx86_64-apple-darwinhedefleriyle derlenir.
- Tauri 2 + Rust (edition 2021):
src-tauri/src/lib.rs— uygulama girişi, tray, window event'leri ve 4 Tauri command'ı;src-tauri/src/store.rs— şifreli depo soyutlaması. web/git-subtree: ön yüz ayrıproject-florence/webrepo'sunda geliştirilir,sync-desktop.ymlile desktop'a squash-merge edilir.web/içindeki dosyaları doğrudan düzenlemeyin — bir sonraki sync'te üzerine yazılır.- Command sözleşmesi (frontend
web/src/lib/desktop.tsile paylaşılır — isimler ve parametreler asla değiştirilmemeli):secure_store_set { key, value }/secure_store_get { key }/secure_store_delete { key }→ OS keyring'i (florence-desktopservisi; erişim/refresh token saklar)notify { title, body }→ masaüstü bildirimi
- State:
AppState { store: Box<dyn SecureStore> }Builder::manageile enjekte edilir; command'larState<'_, AppState>üzerindenSecureStoretrait metodlarını çağırır (üretimdeKeyringStore, testlerdeMockStore). - Tray davranışı: sol tık → pencereyi göster; menü → "Florence'i Göster" / "Çıkış" (
app.exit(0)— gerçek çıkış). - Hide-on-close (Windows/Linux, macOS hariç): pencere kapatılınca uygulama çıkmaz; pencere gizlenir, tepside çalışmaya devam eder ve "Florence tepside çalışmaya devam ediyor" bildirimi gösterilir. Çıkış yalnızca tray "Çıkış" menüsünden yapılır.
- Wayland/NVIDIA reçetesi (
lib.rsiçinde): NVIDIA + WebKitGTK DMABUF çakışmasında pencere boş gelir/crash olur. Uygulama başlangıcında (kullanıcı override etmediyse)WEBKIT_DISABLE_DMABUF_RENDERER=1ve__NV_DISABLE_EXPLICIT_SYNC=1ayarlanır;GDK_BACKENDx11'e zorlanmaz (native Wayland korunur),WEBKIT_DISABLE_COMPOSITING_MODEbilerek ayarlanmaz (yazılım render'a düşer, kaydırma akıcılığı ölür). - CSP:
tauri.conf.json'dasecurity.csp(prod) vesecurity.devCsp(dev) tanımlıdır.style-src 'unsafe-inline'klinecharts'ın runtime style enjeksiyonu için şarttır;connect-srcAPI (api.florencex.com.tr) erişimini açar;devCspayrıca Vite HMR içinlocalhost:5173(http + ws) kaynaklarını içerir.
- Keyring
NoEntry: Kayıt bulunamadığı normal bir durumdur —secure_store_getOk(None)döner (hata değil). Frontend bu durumdalocalStorage'a düşer. Kalıcı keyring hatası olursa (ör. oturum kilidi altında Secret Service erişilemez): oturumu kilitleyip açın ya dasecret-tool clearileflorence-desktopservisini temizleyin. - Wayland'da boş/beyaz pencere veya "Gdk Error 71": NVIDIA + WebKitGTK DMABUF çakışması. Uygulama env reçetesini otomatik uygular; elle de deneyebilirsiniz:
WEBKIT_DISABLE_DMABUF_RENDERER=1 __NV_DISABLE_EXPLICIT_SYNC=1 npm run dev
- Dev'de HMR çalışmıyor / CSP ihlali:
devCspolmadan Vite HMR (ws://localhost:5173) ve'unsafe-inline'script engellenir.tauri.conf.json→security.devCsptanımlı olduğundan emin olun; değişiklik sonrasınpm run dev'i yeniden başlatın. - Tray ikonu görünmüyor:
libayatana-appindicator3-devkurulu değil (Linux). Kurun ve rebuild edin.
cargo test --manifest-path src-tauri/Cargo.tomlsrc-tauri/src/store.rs—SecureStoretrait'i,KeyringStore(NoEntry →Ok(None)dahil) veMockStoreunit testleri (set/get/delete, hata string'leri).src-tauri/src/lib.rs— tray menü id eşleştirmesi (tray_menu_action) veAppState+MockStorewiring testleri.