Archlence: Yerel Kişisel Finans ve Portföy Uygulaması

Tamam kanka, kod bloğu olmadan önceki gibi düzenli forum yazısı şeklinde:

[Açık Kaynak – MIT Lisanslı – Pre-Release] Archlence: Yerel Kişisel Finans ve Portföy Uygulaması​

Merhaba Techolay topluluğu,

Bir süredir tek başıma geliştirdiğim açık kaynaklı masaüstü uygulamam Archlence’i sizlerle paylaşmak istiyorum.

Archlence; gelir-gider takibi, banka hesapları, kredi kartları, borçlar, abonelikler, bütçeler ve yatırım varlıklarını tek bir uygulama üzerinden yönetmeyi amaçlayan, yerel öncelikli bir kişisel finans uygulamasıdır.

Proje ağırlıklı olarak Python, Kivy ve SQLite kullanılarak geliştiriliyor.

Önemli not: Archlence şu anda pre-release, yani ön yayım aşamasındadır. Uygulama denenebilir durumda olsa da henüz kararlı sürüm seviyesinde değildir. Hatalar, performans sorunları veya beklenmeyen davranışlarla karşılaşılabilir. Bu nedenle şimdilik gerçek ve kritik finansal veriler yerine test verileriyle kullanılması tavsiye edilir.

Genişletmek için tıkla...

Küçültmek için tıkla...

Açık kaynak ve MIT lisanslı​

Archlence’in kaynak kodu tamamen açıktır ve proje MIT Lisansı altında yayımlanmaktadır.

MIT Lisansı kapsamında kaynak kodunu:

• İnceleyebilir,
• Kendi bilgisayarınızda çalıştırabilir,
• Değiştirebilir ve geliştirebilir,
• Dağıtabilir,
• Lisans koşullarına uyarak kişisel veya ticari projelerinizde kullanabilirsiniz.

Kaynak kodu ve lisans dosyası GitHub deposunda açık şekilde bulunuyor.

Archlence neler sunuyor?​

Archlence içerisinde şu anda:

• Gelir ve gider işlemlerini kaydetme
• Nakit ve banka hesaplarını yönetme
• Hesap bakiyelerini ayrı ayrı takip etme
• Kredi kartı limiti ve borç takibi
• Kart ekstresi oluşturma ve borç ödeme
• Aylık bütçe hazırlama
• Abonelikleri ve düzenli ödemeleri takip etme
• Tekrarlayan işlemlerden abonelik önerileri oluşturma
• Borç, kredi ve taksit ilerlemesini görüntüleme
• Yaklaşan ödemeleri takip etme
• Tasarruf hedefleri oluşturma
• Hisse senedi, kripto para, döviz ve değerli maden takibi
• Portföy alış ve satış geçmişini görüntüleme
• Portföy kâr-zarar ve dağılım bilgilerini inceleme
• Finansal sağlık puanı
• Gelir-gider ve bakiye grafikleri
• Finansal işlem takvimi
• Faiz ve bileşik faiz hesaplama
• Kredi hesaplama
• Farklı finansal senaryoları denemek için What-If alanı
• CSV içe ve dışa aktarma
• Türkçe ve İngilizce dil desteği
• Açık ve koyu tema

gibi özellikler bulunuyor.

Ana ekran ve finansal genel bakış​

Archlence’in ana ekranında toplam bakiye, günlük değişim, gelir-gider özeti, aktif abonelikler, borçlar, yaklaşan ödemeler ve son işlemler birlikte görüntülenebiliyor.

Finansal sağlık puanı; tasarruf oranı, borç-gelir ilişkisi ve harcama hareketliliği gibi farklı verilerden genel bir değerlendirme üretmeyi amaçlıyor.

Uygulamada mevcut finansal hareketler üzerinden ileriye dönük tahminler de gösteriliyor. Ancak bu tahminler kesin sonuç veya yatırım tavsiyesi olarak değerlendirilmemelidir.

Gelir, gider ve hesap yönetimi​

Gelir ve gider işlemleri belirli bir nakit veya banka hesabıyla ilişkilendirilebiliyor. Böylece farklı hesaplardaki bakiyeler ayrı ayrı takip edilebiliyor.

İşlemler kategori, tarih, tutar ve açıklama bilgileriyle kaydedilebiliyor. Gelir ve gider dağılımları günlük, haftalık, aylık, yıllık veya tüm zamanlar kapsamında incelenebiliyor.

Kategori grafikleri sayesinde gelirin hangi kaynaklardan geldiği ve harcamaların hangi alanlarda yoğunlaştığı görülebiliyor.

Yatırım ve portföy takibi​

Archlence yalnızca standart gelir-gider takibi yapmıyor. Kullanıcılar farklı yatırım araçlarını da uygulama içerisinden takip edebiliyor.

Desteklenen varlık türleri arasında:

• Hisse senetleri
• Kripto paralar
• Dövizler
• Altın ve diğer değerli madenler

bulunuyor.

Portföye eklenen varlıklar için alış miktarı, birim maliyet, güncel değer, kâr-zarar durumu ve işlem geçmişi görüntülenebiliyor.

Desteklenen yatırım araçlarının güncel fiyatlarını almak için dış veri kaynakları kullanılabiliyor. Bu nedenle canlı fiyat güncellemeleri internet bağlantısı gerektirebilir.

Kredi kartı yönetimi​

Uygulama içerisinden birden fazla kredi kartı oluşturulabiliyor.

Her kart için:

• Kart limiti
• Kullanılabilir limit
• Güncel borç
• Kesim ve ödeme tarihi
• Son işlemler
• Ekstre bilgileri
• Borç ödeme durumu

takip edilebiliyor.

Kartı dondurma veya çevrim içi alışverişi kapatma gibi seçenekler uygulama içerisinde finansal planlama amacıyla bulunuyor.

Bu kontroller gerçek bankacılık sistemlerine bağlanmıyor ve yalnızca Archlence içerisindeki kart durumunu temsil ediyor.

Abonelikler ve düzenli ödemeler​

Kira, internet, spor salonu, dijital platform veya benzeri düzenli ödemeler abonelik olarak kaydedilebiliyor.

Her abonelik için ödeme tutarı, tekrar sıklığı ve sonraki ödeme tarihi takip ediliyor.

Archlence ayrıca işlem geçmişindeki tekrar eden harcamaları inceleyerek olası abonelikleri kullanıcıya önerebiliyor. Kullanıcı bu önerileri abonelik olarak ekleyebilir veya reddedebilir.

Düzenli ödemeler için otomatik kesinti özelliği de bulunuyor. Ödeme tarihi geldiğinde ilgili tutar seçilen hesaba gider işlemi olarak yansıtılabiliyor.

Borç ve taksit takibi​

Borç ve kredi kayıtlarında toplam borç, aylık ödeme miktarı, ödeme günü, toplam taksit ve kalan taksit sayısı görüntülenebiliyor.

Kullanıcı taksit ödemesi yapabilir veya borcu tamamen kapatabilir.

Yaklaşan ödemeler ayrı bir bölümde gösterildiği için kullanıcı hangi ödemenin ne zaman gerçekleşeceğini tek ekrandan takip edebilir.

Finansal araçlar​

Archlence içerisinde günlük finans takibinin yanında çeşitli planlama araçları da bulunuyor.

Bunlar arasında:

• Aylık bütçe
• Finansal takvim
• Genel hesap makinesi
• Faiz getirisi hesaplama
• Bileşik faiz hesaplama
• Kredi hesaplama
• Tasarruf hedefi
• What-If senaryo alanı

yer alıyor.

What-If alanının amacı, kullanıcının gerçek finansal kayıtlarını değiştirmeden farklı gelir, gider ve tasarruf senaryolarını deneyebilmesini sağlamak.

Yerel öncelikli ve gizlilik odaklı​

Finansal verilerin kullanılabilmesi için zorunlu olarak başka bir şirketin sunucularında tutulması fikrinden pek hoşlanmıyorum.

Bu nedenle Archlence’in temel finansal kayıtları kullanıcının kendi bilgisayarındaki yerel SQLite veritabanında saklanıyor.

Uygulamanın temel özelliklerini kullanmak için bir Archlence hesabı oluşturmak veya gelir, gider, borç ve hesap bilgilerini bir Archlence sunucusuna yüklemek gerekmiyor.

Canlı yatırım fiyatlarının alınması gibi özellikler için dış veri servisleriyle bağlantı kurulabiliyor. Ancak temel kişisel finans kayıtlarının bir bulut hizmetinde saklanması amaçlanmıyor.

Projede yerel PIN, verilerin şifreli saklanması, yedekleme ve kurtarma mekanizmaları üzerinde de çalışıyorum.

Bununla birlikte Archlence henüz pre-release aşamasında olduğu için güvenlik konusunda “tamamen güvenlidir” veya “kritik finansal veriler için hazırdır” gibi gerçekçi olmayan bir iddiada bulunmak istemiyorum.

Nasıl kurulur?​

Hazır kurulum paketlerini GitHub deposundaki Releases bölümünden indirebilirsiniz:

Releases · superuser-d0/archlence

Releases sayfasındaki sürümlerin pre-release olarak işaretlendiğini tekrar belirtmek isterim. Bu sürümler uygulamayı denemek, hataları tespit etmek ve geri bildirim sağlamak amacıyla yayımlanmaktadır.

Windows kurulumu​

Windows kullanıcıları Releases sayfasındaki en güncel ArchlenceSetup kurulum dosyasını indirebilir.

Kurulum için:

1. GitHub Releases sayfasını açın.
2. En güncel pre-release sürümün Windows kurulum dosyasını indirin.
3. İndirdiğiniz .exe dosyasını çalıştırın.
4. Kurulum adımlarını tamamlayın.
5. Archlence’i Başlat menüsünden veya oluşturduğunuz masaüstü kısayolundan açın.

Kurulum paketi henüz dijital olarak imzalanmadığı için Windows SmartScreen ilk çalıştırmada tanınmayan uygulama uyarısı gösterebilir.

Dosyayı yalnızca projenin resmî GitHub Releases sayfasından indirdiğinizden emin olduktan sonra Ek bilgi → Yine de çalıştır seçeneklerini kullanabilirsiniz.

Releases sayfasında SHA-256 doğrulama değeri yayımlanmışsa indirdiğiniz dosyanın bütünlüğünü bu değer üzerinden de kontrol edebilirsiniz.

Linux kurulumu – AppImage​

64-bit Linux kullanıcıları Releases sayfasındaki x86_64.AppImage dosyasını indirebilir.

Dosyanın bulunduğu klasörde terminal açarak çalıştırma izni verin:

Ardından uygulamayı çalıştırın:

FUSE veya AppImage bağlama hatası alınırsa şu yöntem denenebilir:

AppImage paketi Python veya diğer geliştirme araçlarının ayrıca kurulmasını gerektirmez.

Mevcut AppImage paketi x86_64 sistemler içindir. ARM tabanlı cihazlarda çalışmayabilir.

Arch Linux, Manjaro ve CachyOS​

Arch tabanlı dağıtımlarda projedeki PKGBUILD kullanılarak paket oluşturulabilir:

makepkg komutunun sudo ile çalıştırılmaması gerekiyor. Yönetici parolası yalnızca oluşturulan paketin sisteme kurulması sırasında istenir.

Kurulum tamamlandıktan sonra uygulamayı menüden veya terminal üzerinden çalıştırabilirsiniz:

Paket henüz AUR üzerinde bulunmuyorsa kurulum doğrudan GitHub deposundaki PKGBUILD üzerinden yapılır.

Kaynak koddan çalıştırma​

Kod yapısını incelemek, projeye katkıda bulunmak veya geliştirme sürümünü denemek isteyenler Archlence’i kaynak koddan da çalıştırabilir.

Windows, Linux ve macOS için ayrıntılı geliştirme ve kaynak kurulum talimatları GitHub deposundaki README dosyasında yer alıyor.

Projenin mevcut durumu​

Archlence şu anda pre-release ve erken geliştirme aşamasındadır.

Bu durum, uygulamanın henüz tamamlanmadığı ve kararlı sürüm olarak değerlendirilmemesi gerektiği anlamına geliyor.

Uygulama kurulup denenebiliyor ancak bazı özelliklerde:

• Hatalar,
• Performans sorunları,
• Arayüz problemleri,
• Beklenmeyen davranışlar,
• Platforma göre değişen uyumluluk sorunları

görülebilir.

Bu nedenle mevcut pre-release sürümlerde:

• Gerçek ve kritik finansal bilgiler yerine test verilerinin kullanılmasını,
• Güncelleme öncesinde yedek alınmasını,
• Karşılaşılan sorunların GitHub üzerinden bildirilmesini

öneriyorum.

Bu aşamadaki temel amacım uygulamayı mümkün olduğunca farklı sistemlerde test etmek, mevcut hataları bulmak ve kararlı sürüme ulaşmadan önce topluluk geri bildirimleriyle eksikleri gidermek.

Özellikle farklı Windows ve Linux sistemlerinde kurulum, arayüz davranışı, performans, hesap işlemleri, portföy takibi, kartlar ve düzenli ödeme sistemleri hakkında geri bildirime ihtiyacım var.

Topluluktan beklentim​

Archlence’i inceleyerek şu konularda görüşlerinizi paylaşabilirsiniz:

• Arayüz anlaşılır mı?
• İşlemler gereğinden fazla adım istiyor mu?
• Eksik gördüğünüz önemli bir özellik var mı?
• Gereksiz veya karmaşık bulduğunuz bölümler var mı?
• Windows veya Linux üzerinde kurulum sorunu yaşadınız mı?
• Performans veya takılma problemi bulunuyor mu?
• Finansal işlem akışları mantıklı mı?
• Kod yapısı ve mimari hakkında ne düşünüyorsunuz?
• Veri bütünlüğü ve güvenlik konusunda geliştirilmesi gereken noktalar neler?

Yalnızca olumlu yorumlar değil, doğrudan ve eleştirel geri bildirimler de benim için oldukça değerli.

“Bu özellik pratikte kullanılmaz”, “bu işlem daha kolay yapılabilir” veya “bu bölüm yanlış tasarlanmış” gibi yorumlar projenin gelişmesine ciddi şekilde katkı sağlayacaktır.

Bağlantılar​

GitHub deposu:

GitHub - superuser-d0/archlence: A privacy-centric, local-first personal finance and portfolio manager built with Python and Kivy, featuring a robust ledger architecture and smart caching.

Pre-release kurulum paketleri ve sürümler:

Releases · superuser-d0/archlence

Hata bildirme ve özellik önerme:

Issues · superuser-d0/archlence

Projeyi faydalı bulursanız GitHub üzerinden yıldız vererek destek olabilirsiniz.

Kodu inceleyen, pre-release sürümü deneyen ve geri bildirim paylaşan herkese şimdiden teşekkür ederim.