Skip to content
afsozerPublic

About

Hukuk çalışması için kendi sunucusunda çalışan, çevrimdışı öncelikli PDF/video kütüphanesi, mevzuat okuyucu ve çalışma planlayıcı (Flutter + FastAPI)

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Belgelik

DOI

Proje sayfası: avfatihsozer.com/projeler/belgelik · English: README.en.md

Hukuk çalışması için kişisel, kendi sunucusunda çalışan bir çalışma ortamı: PDF ve video kütüphanesi, mevzuat okuyucu, çalışma planlayıcı ve not alma — birden çok cihaz arasında senkronize, çevrimdışı öncelikli.

Tek kullanıcılı, kişisel kullanım için tasarlandı; mağaza yayını, üyelik sistemi ya da bulut bağımlılığı yok. Veriler kullanıcının kendi makinesinde duran sunucuda tutulur, cihazlar ona özel ağ (Tailscale) üzerinden bağlanır.

GNU Affero Genel Kamu Lisansı sürüm 3 (AGPL-3.0-only) ile lisanslanmış açık kaynak bir projedir; ayrıntı aşağıdaki Lisans bölümünde.

Özellikler

Okuma ve kütüphane

  • Sunucudaki PDF kütüphanesini klasör yapısıyla gezme, içerikte tam metin arama
  • PDF okuyucu: tek/çift sayfa ve dikey akış düzenleri, içindekiler, yer imleri, kalem/vurgulayıcı ile işaretleme (basınca duyarlı çizim), gece filtresi
  • Kaldığın sayfa, işaretlemeler ve notlar cihazlar arasında taşınır
  • Video kütüphanesi: yükleme, kaldığı yerden devam, arka planda oynatma ve bildirim üzerinden medya kontrolü

Mevzuat

  • Kanun metinlerinin madde, fıkra ve bent düzeyinde ayrıştırılması (golden-fixture testli parser)
  • Cihazda çevrimdışı saklama ve tam metin arama (SQLite FTS5/FTS4)
  • Madde metninde kanun/madde atıflarının tıklanabilir bağlantıya dönüşmesi
  • Yeniden içe aktarımda değişen maddelerin tespiti, sürüm karşılaştırma
  • Madde bazında not, vurgu ve yer imi

Çalışma düzeni

  • Ders programı; derse bağlı kaynaklar ve kanunlar tek dokunuşla açılır
  • Pomodoro sayacı (arka planda ve bildirimle çalışır), çalışma istatistikleri
  • Sınav geri sayımı

Mimari

 Flutter istemcisi                           Sunucu (Python / FastAPI)
 Android · iOS · macOS · Windows · Linux
 ┌──────────────────────────────┐             ┌─────────────────────────────┐
 │ Okuyucu / Mevzuat / Program  │             │ REST API, profil izolasyonu │
 │ Yerel SQLite + FTS önbelleği │  HTTP/JSON  │ SQLite (profil başına)      │
 │ Senkron kuyruğu (offline)    │ ◄─────────► │ PDF / video deposu          │
 │ Token: güvenli depo          │  Tailscale  │ Günlük otomatik yedek       │
 └──────────────────────────────┘             └─────────────────────────────┘
  • Çevrimdışı öncelikli senkronizasyon: Değişiklikler önce yerelde yazılır, kuyruktan sunucuya gönderilir. Çakışmalar kayıt düzeyinde last-write-wins ile çözülür; silmeler tombstone olarak taşınır, istemci sunucunun alış zamanına dayalı bir imleçle yalnızca yeni değişiklikleri çeker.
  • Profil izolasyonu: Her profilin ayrı veritabanı ve kütüphane klasörü vardır; tüm uçlar kimlik doğrulamalı ve profil kapsamlıdır.
  • Platforma uyarlanan arayüz: Mobilde alt gezinme çubuğu, masaüstünde yan ray + gömülü okuyucu, bölünmüş görünüm ve klavye kısayolları.
  • Güvenlik: Erişim token'ı Android Keystore / iOS–macOS Keychain / Windows Credential Store'da tutulur; sunucu yalnızca özel ağdan erişilebilir.

Teknoloji

Katman Kullanılan
İstemci Flutter / Dart, pdfrx, sqflite (+ FFI), media_kit, flutter_secure_storage, perfect_freehand
Android yerel Kotlin (medya oynatma servisi, bildirim kontrolleri)
Sunucu Python, FastAPI, Uvicorn, SQLite
Test / CI flutter test, pytest, GitHub Actions (analiz + test, her push'ta)

Depo yapısı

app/        Flutter istemcisi (lib/, platform klasörleri, test/)
server/     FastAPI sunucusu (routers/, mevzuat ayrıştırıcı, yedekleme, test/)
contract/   İstemci–sunucu veri sözleşmesi (JSON şemaları)
docs/       Faz faz geliştirme notları ve tasarım belgeleri

Geliştirme süreci

Proje, her biri ayrı bir tasarım belgesiyle (docs/FAZ-*.md) tanımlanan fazlar halinde geliştirildi: PDF okuyucu → senkronizasyon → pomodoro ve ders programı → işaretleme → masaüstü arayüzü → senkron sağlamlığı, yedekleme, testler/CI → mevzuat modülü. Tasarım ve ürün kararları proje sahibine aittir; uygulama yapay zekâ destekli kodlama araçlarıyla (Claude Code) geliştirilmiştir.

Lisans

GNU Affero Genel Kamu Lisansı sürüm 3 ile lisanslanmıştır (AGPL-3.0-only); tam metin LICENSE dosyasındadır. Yazılımı değiştirip ağ üzerinden başkalarına hizmet olarak sunarsanız, değiştirdiğiniz kaynak kodu da o kullanıcılara aynı lisansla sunmanız gerekir. Güvenlik açıklarının nasıl bildirileceği SECURITY.md dosyasında anlatılıyor.

Telif hakkı © 2026 Alpaslan Fatih Sözer

About

Hukuk çalışması için kendi sunucusunda çalışan, çevrimdışı öncelikli PDF/video kütüphanesi, mevzuat okuyucu ve çalışma planlayıcı (Flutter + FastAPI)

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages