💪 SelfWorkout — Antrenman Takip Sistemi

Kişisel antrenman planlama ve ilerleme takibi için geliştirilmiş masaüstü uygulaması. Kullanıcılar egzersiz kütüphanesinden rutin oluşturur, antrenmanlarını canlı olarak kaydeder ve vücut ölçümleriyle gelişimlerini izler. Yöneticiler egzersiz, ekipman ve kas grubu kataloğunu yönetir, sistem raporlarını görüntüler.

Durum: Geliştirme aşamasında. Proje derleniyor ve temel akışlar uygulanmış durumda. Otomatik test altyapısı yoktur (test/ altındaki sınıflar elle çalıştırılan doğrulama betikleridir, JUnit testi değildir).

---

Özellikler

👤 Kullanıcı

• Egzersiz kütüphanesi — kas grubu ve ekipmana göre egzersizleri inceleme
• Rutin oluşturma — egzersizleri sıralayıp kendi antrenman programını kurma
• Canlı antrenman takibi — set, tekrar ve ağırlık kaydı
• Vücut ölçümleri — kilo ve ölçü geçmişi tutma
• İlerleme grafikleri — zaman içindeki gelişimi görüntüleme
• Favori egzersizler — sık kullanılanları işaretleme
• Profil yönetimi

⚙️ Yönetici

• Egzersiz yönetimi — katalog oluşturma, kas grubu ve ekipman eşleştirme
• Kas grubu ve ekipman yönetimi
• Kullanıcı yönetimi — hesap listeleme, rol atama
• Sistem raporları — kullanım istatistikleri
• Etkinlik günlüğü — sistemdeki işlemlerin kaydı

---

Mimari

Katmanlı mimari; her katman yalnızca bir alttakini tanır:

  FXML görünümleri  (20 ekran: admin/ + user/)
          │
     Controller     (19 sınıf)
          │
       Service      (17 sınıf — iş kuralları, doğrulama, raporlama)
          │
        DAO         (18 sınıf — SQL erişimi)
          │
       Model        (18 sınıf — veri nesneleri)
          │
    MSSQL Server    (17 tablo)

Öne çıkan altyapı sınıfları

Sınıf	Görevi
DatabaseConnection	Thread-safe singleton bağlantı yönetimi
ServiceManager	Servis örneklerinin merkezî dağıtımı
SceneManager	Ekranlar arası geçiş
ThemeManager	Tema değiştirme (3 CSS teması)
ValidationService	Ortak girdi doğrulama
ImportExportService	Veri içe/dışa aktarma

---

Kurulum

Gereksinimler

• JDK 17+
• Microsoft SQL Server (Express yeterli)
• Maven (wrapper dahil — mvnw)

1. Veritabanını oluştur

İki betik sırayla çalıştırılır. İlki şemayı ve başlangıç verisini kurar:

sqlcmd -S localhost\SQLEXPRESS -U sa -i src/main/sql/selfworkout.sql

İkincisi görünüm, fonksiyon, tetikleyici ve saklanan yordamları ekler:

sqlcmd -S localhost\SQLEXPRESS -U sa -i src/main/sql/selfworkout_objects.sql

Nesne betiği tekrar tekrar çalıştırılabilir; her nesne varsa önce düşürülür.

Ayrıntılı SQL Server kurulumu için MSSQL_Database_Setup.md.

2. Bağlantı bilgilerini ayarla

Kimlik bilgileri kaynak koda yazılmaz, ortam değişkenlerinden okunur:

Değişken	Zorunlu	Varsayılan	Açıklama
DB_URL	hayır	jdbc:sqlserver://localhost\SQLEXPRESS;databaseName=selfworkout;...	JDBC bağlantı adresi
DB_USERNAME	hayır	sa	SQL Server kullanıcısı
DB_PASSWORD	evet	—	Kullanıcının parolası

PowerShell'de:

$env:DB_PASSWORD="sql_server_parolaniz"

Bash'te:

export DB_PASSWORD="sql_server_parolaniz"

DB_PASSWORD tanımlı değilse uygulama açıklayıcı bir hata ile durur.

Windows kimlik doğrulaması: DB_URL içinde integratedSecurity=true kullanırsanız kullanıcı adı ve parola gerekmez, kimlik bilgisi işletim sisteminden alınır. Bu yöntem için JDBC sürücüsünün mssql-jdbc_auth DLL dosyasının sistemde bulunması gerekir. Varsayılan bağlantı ayarları src/main/resources/database.properties içindedir; ortam değişkeni tanımlıysa oradaki değerin yerine geçer.

3. Çalıştır

./mvnw javafx:run

---

Veri modeli

17 tablo. Çekirdek ilişkiler:

• Users ↔ Roles — rol bazlı erişim (yönetici / kullanıcı)
• Exercises — MuscleGroups ve Equipments ile çoka-çok (ExerciseMuscles, ExerciseEquipments), ayrıca ExerciseTags ile etiketlenir
• ExerciseRoutines → RoutineExercises — kullanıcının oluşturduğu antrenman şablonları
• DailyWorkouts → WorkoutExercises — planlanan günlük antrenmanlar
• UserWorkouts → UserWorkoutExercises — gerçekleşen antrenman kayıtları
• BodyStats — kullanıcının ölçüm geçmişi
• FavoriteExercises, Logs — favoriler ve sistem etkinlik kaydı

Veritabanı nesneleri

Raporlama ve iş kuralları kısmen veritabanı katmanında çözülür (src/main/sql/selfworkout_objects.sql).

Görünümler

Görünüm	İşlevi
vw_UserWorkoutSummary	Antrenman başına süre, egzersiz/set sayısı ve toplam hacim
vw_ExerciseCatalog	Egzersizin kas grupları ve ekipmanları tek satırda (STRING_AGG)
vw_UserMonthlyProgress	Aylık antrenman sayısı, hacim, ortalama süre
vw_PopularExercises	Kullanım, favori ve rutin sayılarına göre popülerlik
vw_BodyStatsTrend	Ölçümlerin bir öncekine göre değişimi (LAG)

Fonksiyonlar

Fonksiyon	İşlevi
fn_WorkoutVolume	Antrenmanın toplam hacmi (tekrar × ağırlık)
fn_EstimatedOneRepMax	Epley formülüyle tahmini 1RM
fn_WorkoutStreak	Güncel kesintisiz antrenman serisi
fn_LongestWorkoutStreak	Şimdiye kadarki en uzun seri
fn_LatestBMI	Son ölçüme göre vücut kitle indeksi

Tetikleyiciler

Tetikleyici	İşlevi
trg_UserWorkoutCompleted	Antrenman tamamlanınca süreyi hesaplar ve Logs'a kayıt düşer
trg_PreventDuplicateFavorite	Aynı egzersizin iki kez favorilenmesini engeller
trg_ValidateBodyStats	Mantık dışı ölçüm değerlerini reddeder

Saklanan yordamlar

Yordam	İşlevi
sp_StartWorkout	Rutin veya tek egzersizden antrenman başlatır
sp_CompleteWorkout	Antrenmanı tamamlanmış olarak işaretler
sp_UserDashboardStats	Pano istatistiklerini tek çağrıda döndürür

---

Proje yapısı

src/main/
├── java/com/example/selfworkout/
│   ├── controller/      19 controller (admin/ ve user/ alt paketleri dahil)
│   ├── service/         17 servis — iş mantığı
│   ├── dao/             18 DAO — veritabanı erişimi (raporlama dahil)
│   ├── model/           18 veri sınıfı
│   ├── util/            bağlantı, sahne, tema, uyarı yardımcıları
│   └── test/            elle çalıştırılan doğrulama betikleri
├── resources/
│   ├── com/example/selfworkout/
│   │   ├── admin/       yönetici ekranları (FXML)
│   │   ├── user/        kullanıcı ekranları (FXML)
│   │   └── css/         3 tema
│   └── database.properties
└── sql/
    ├── selfworkout.sql          şema ve başlangıç verisi
    └── selfworkout_objects.sql  görünüm, fonksiyon, tetikleyici, yordam

---

Gelecek çalışmalar

Kısa vade

• Gerçek test altyapısı — test/ altındaki elle çalıştırılan betiklerin JUnit testlerine dönüştürülmesi (JUnit bağımlılığı pom.xml'de zaten mevcut)
• Bağlantı havuzu — database.properties içinde havuz ayarları tanımlı ama kod tek bir bağlantıyı yeniden kullanıyor; HikariCP'ye geçilmeli
• Yinelenen controller'ların birleştirilmesi — ExerciseManagementController ve ExerciseManagementContentController gibi çiftler

Orta vade

• Parola özetleme (hashing) — kullanıcı parolalarının BCrypt ile saklanması
• Şema göç (migration) yönetimi — Flyway ile sürümlenebilir şema
• Hata yönetiminin merkezîleştirilmesi — AlertUtil üzerinden tutarlı kullanıcı bildirimi
• Raporların dışa aktarımı — PDF ve Excel çıktısı

Uzun vade

• Antrenman şablonu paylaşımı — kullanıcılar arası rutin paylaşımı
• Grafik zenginleştirme — hacim, sıklık ve kişisel rekor grafikleri. Veri katmanı hazır: fn_WorkoutVolume, fn_EstimatedOneRepMax ve vw_UserMonthlyProgress mevcut, arayüz henüz kullanmıyor
• Çoklu dil desteği
• Mobil eşlik uygulaması

---

Lisans

MIT — bkz. LICENSE.