Tüm modüller

Egzersiz Kütüphanesi

Planında gördüğün her hareketin kartı var: kurulum, yapılış ipuçları, sık yapılan hatalar, tempo, nefes, hareket açıklığı, güvenlik uyarıları ve yapamadığında yerine konacak varyantlar. Katalog telefonunda değil sunucuda durur; içerik güncellenince mağaza güncellemesi beklemezsin.

Egzersiz Kütüphanesi — Egzersiz Kütüphanesi

Egzersiz Kütüphanesi · 1/5

NEREDESİN

Modülün giriş ekranı. Ana ekrandaki kütüphane kartından ya da bir hareket kartının üstündeki "Egzersiz Kütüphanesi" etiketinden buraya gelirsin. Adresi /exercise-library.

NE YAPARSIN

Kas grubuna göre kategori seçer, arama kutusuna hareket adı yazar ya da üç filtre şeridinden birini kullanarak listeyi daraltırsın.

NEREYE GİDER
  • Kategori kartı (Göğüs · Sırt · Bacak · Omuz · Kol · Core · Tüm Vücut) → o kategorinin liste ekranı (exercise_hub_build_methods_part.dart:267)
  • Bugünün Odağı kartı → o hareketin detay kartı (exercise_library_hub_screen.dart:178)
  • Öne Çıkan Hareketler şeridindeki kart → o hareketin detay kartı (exercise_hub_build_methods_part.dart:112)
  • "Form Kontrol Et" şeridindeki kart → o hareketin DETAY KARTI. Video çekimi buradan başlamaz; çekim düğmesi detay kartının içindedir (exercise_hub_build_methods_part.dart:208)
  • Geri → geldiğin ekran, doğrudan açıldıysan ana ekran (exercise_library_hub_screen.dart:112)
Bu ekranda ne var 6

Diyelim ki ekranı ilk kez açtın ve başlığın sağında yeşil noktalı bir rozette "1708+ EGZERSİZ" yazıyor.

O sayı katalogdaki toplam hareket sayısıdır ve sunucudan gelir.

Rozet ancak sunucunun cevabı geldikten sonra çizilir; cevap gelmemişse hiç çizilmez. Böyle kurulmasının sebebi şu: cihazın elinde bir yedek sayı olsaydı, sunucuya ulaşılamadığı anda ekran eski bir sayıyı gerçekmiş gibi gösterirdi. Uydurma sayı, eksik sayıdan daha zararlıdır çünkü kullanıcı ona güvenir.

Rozeti görüyorsan liste tazedir. Rozet yoksa ekran sana boş bir liste değil "getirilemedi, tekrar dene" der.

Buna sistemde "sunucu-otoriteli sayım" denir.

Diyelim ki en üstte yeşil çerçeveli bir kart var ve içinde "BUGÜNÜN ODAĞI — Eğimli Göğüs Presi" yazıyor. Yarın aynı ekranı açtığında orada başka bir hareket duruyor.

Kart her takvim günü için bir hareket seçer ve o gün boyunca değişmez.

Seçim rastgele değil, günün tarihine bağlı: aday havuzu zengin anlatımı olan sekiz harekettir ve içlerinden hangisinin gösterileceğine sunucu karar verir. Rastgele olsaydı ekranı iki kez açtığında iki farklı hareket görürdün ve kart bir öneri değil gürültü olurdu.

Her gün bir hareket okumak istiyorsan bu kart senin başlangıç noktan. Karta dokununca o hareketin tam kartına gidersin.

Buna sistemde "günlük odak" (daily focus) denir.

Diyelim ki "Form Kontrol Et" başlığını gördün, yanında "6 ÖRÜNTÜ" yazıyor ve altında kamera simgeli kartlar duruyor. Karta dokundun ve video çekimi başlamadı.

O şerit bir çekim düğmesi değil, kamerayla ölçülebilen hareketlerin kısayoludur; kart seni o hareketin bilgi kartına götürür.

Çekimi başlatan düğme bilerek detay kartının içindedir, çünkü çekimden önce hareketin nasıl yapıldığını okuman gerekir. Şeridin kendisi de sunucuda kürasyonludur: her temel hareket örüntüsü için bir temsilci hareket seçilir. Liste telefonda dursaydı, katalogdan bir hareket kalktığında şerit sessizce boş kart çizerdi.

Formunu ölçtürmek istiyorsan karta dokun, açılan sayfayı okuyup en alttaki "Hareket Analizi" bölümünden çekimi başlat.

Buna sistemde "kürasyonlu şerit" denir.

Diyelim ki "Tüm Seviyeler" şeridinden "Orta"ya bastın ve liste beklediğinden çok daraldı — başlangıç hareketlerinin hiçbiri kalmadı.

Seviye şeridi "bu seviyeye kadar" değil, "tam olarak bu seviye" filtresidir.

Filtre, hareketin minimum beceri seviyesini seçtiğin değere eşitler. Yani "Orta" dediğinde başlangıç seviyeli hareketler de listeden çıkar. Kapsayıcı bir eşik olsaydı seçim yaptıkça liste büyür, filtre iş yapmadığı hissi verirdi.

Kendi seviyene uygun her şeyi görmek istiyorsan şeridi "Tüm Seviyeler"de bırak; belirli bir zorluk basamağı arıyorsan tek seviyeyi seç.

Buna sistemde "tam eşleşme filtresi" (exact-match filter) denir.

Diyelim ki "Ev" ortam filtresine bastın ve listede hem yalnız evde yapılan hem de her iki ortamda yapılabilen hareketler çıktı.

Ortam filtresi seçtiğin yeri kapsayan her hareketi getirir, yalnız o yere özel olanları değil.

"Ev" dediğinde ev hareketleri ile "her iki ortam" işaretli hareketler birlikte gelir; çünkü salonda da evde de yapılabilen bir hareket senin evinde yapılabilir. Katı okunsaydı barbell gerektirmeyen yüzlerce hareket ev listesinden düşerdi. "Her İkisi" seçeneği ise yalnız iki ortamda da işaretli olanları gösterir.

Evde çalışıyorsan "Ev"i seç; salona da gidiyorsan filtreyi hiç kullanma, liste zaten hepsini içerir.

Buna sistemde "kapsayıcı ortam uygunluğu" (environment eligibility) denir.

Diyelim ki arama kutusunun sağındaki ayar simgesine bastın ve hiçbir şey olmadı.

O simge şu an bir düğme değil, süs.

Ekranın filtreleri simgenin altındaki üç şerittir; ayrı bir filtre penceresi henüz yoktur. Simge dokunmayı kabul etseydi ve hiçbir şey açmasaydı, bu bir arıza gibi görünürdü — o yüzden dokunma ve ekran okuyucu erişimi bilerek kapatıldı: basılmıyor olduğu görülüyor.

Filtrelemek için simgenin altındaki spor alanı, ortam ve seviye şeritlerini kullan.

Buna arayüz dilinde "dokunma yanılsamasının önlenmesi" (touch deception guard) denir.

Perde arkası — sistem nasıl karar veriyor 6

Katalog nerede durur ve kaç hareket taşır

Diyelim ki uygulamayı indirdin ve kütüphaneyi açtın. Rozette 1708 hareket yazıyor ama uygulamanın boyutu bu kadar içeriği taşıyacak kadar büyük değil.

Katalog telefonunda değil, sunucuda durur; ekran ona soru sorar ve gelen cevabı çizer.

Katalog bir karar kaynağıdır: hangi hareket hangi kategoriye ait, hangisi önerilen sayılır, bir kategoride kaç tane var — hepsi ürün kararı. Bu kararlar telefonda dururken üç şey olur. Bir, uygulama paketi katalogla birlikte şişer. İki, katalog güncellendiğinde kullanıcı mağaza güncellemesi bekler. Üç, sunucudaki katalogla telefondaki sessizce ayrışır; liste dolu görünür ama yanlıştır. Bu yüzden ekran katalogu değil SORUYU taşır.

İçerik ekibi bir hareketin anlatımını düzelttiğinde ya da katalog büyüdüğünde uygulamayı güncellemene gerek kalmaz; bir sonraki açılışta yeni hâlini görürsün.

Buna sistemde "ince istemci" (thin client) denir.

Kategorileme — 1708 hareket 7 kutuya nasıl giriyor

Diyelim ki "Bulgar Split Squat" arıyorsun. Bacak kategorisinde buluyorsun, ama o hareket kalçayı da karnı da çalıştırıyor.

Her hareket tek bir kategoride durur ve kategorisi birincil kas grubundan türetilir.

Kategori listesi sabit yedi kutudur: Göğüs, Sırt, Bacak, Omuz, Kol, Core, Tüm Vücut. Bir hareket birden çok kategoride görünseydi sayımlar bozulurdu — yedi kategorinin toplamı katalog boyunu aşar ve kullanıcı aynı hareketi iki yerde bulup iki farklı hareket sanardı. Yardımcı kaslar kategoriyi belirlemez, yalnız kartın "Yardımcı Kaslar" satırında yazılır.

Bir hareketi bulamıyorsan başka kategoriye bakmak yerine arama kutusunu kullan; arama kategori tanımaz, katalogun tamamına bakar.

Buna sistemde "kategori ağacı" (category tree) denir.

Teknik risk — hangi hareket "güvenli başlangıç" sayılır

Diyelim ki Bacak kategorisinde "Önerilen" sırasına geçtin ve üstte barbell arka squat değil, daha basit hareketler duruyor.

Sıralama teknik riski düşük hareketlere puan verir; riskli olanlar bu puanı alamaz.

Katalogda her hareketin bir teknik risk kademesi vardır. Düşük kademe ya da kademesiz olanlar +10 alır; orta ve yüksek olanlar almaz. Buna bir de seviye cezası eklenir: senin seviyenin üstündeki hareketler −10 alır. İki kural birlikte çalışınca "önerilen" listesi acemiyi ağır teknik isteyen bir harekete itmemiş olur. Risk kademesi katalogda hareketin kendi alanıdır, sıralama anında hesaplanmaz — yani aynı hareket her kullanıcıda aynı riski taşır.

Yeni bir kas grubuna başlıyorsan "Önerilen" sırasını aç; üstteki hareketler tekniği en az yanlış gidebilecek olanlardır.

Buna sistemde "teknik risk kademesi" (technical risk tier) denir.

Hareket değiştirme — kütüphane antrenman planıyla nasıl konuşuyor

Diyelim ki salı günkü planında "Arka Squat" var ama salonun kalabalık, squat kafesi boşalmıyor. Antrenman ekranından hareketi değiştirdin ve yerine "Leg Press" geldi.

Yerine gelen hareket rastgele seçilmez: aynı hareket örüntüsündeki adaylar arasından tek bir kural zinciriyle seçilir.

Zincir şöyle işler. Önce aday havuzu kurulur: katalogda aynı örüntüye sahip, kendisi olmayan bütün hareketler. Sonra yer kısıtı uygulanır — evdeysen ev-uyumlu olanlar, salondaysan salon-uyumlu olanlar süzülür; süzgeç havuzu tamamen boşaltırsa süzgeç uygulanmaz, çünkü hiç öneri vermemek yanlış öneri vermekten de kötüdür. Kalan adaylar üç ölçütle sıralanır: ekipmanı aslıyla birebir eşleşen önce gelir, sonra birincil kası aynı olan, eşitlikte kimlik alfabetik. Aynı girdi her zaman aynı hareketi verir; iki kullanıcı aynı koşulda aynı öneriyi alır. Karar sunucudadır ve cihaz susarsa yerel bir seçim YAPILMAZ — plan "değiştiremedim" der.

Kütüphanedeki "Hareket Tipi" satırı bu kararın girdisidir. Bir hareketi yapamıyorsan kartındaki hareket tipine bak; aynı tipteki hareketler senin de elle seçebileceğin adaylardır.

Buna sistemde "kural tabanlı ikame" (rule-based substitution) denir.

Varyasyon seçimi — "daha kolay" ile "yerine geçer" aynı şey değil

Diyelim ki arka squat kartında hem "Kolay Varyasyonlar" listesi hem de "Varyantlar" rozetleri var ve ikisinde farklı hareketler yazıyor.

Üç ayrı varyasyon kaynağı vardır ve üçü farklı soruya cevap verir.

Birincisi bilgi kartındaki kolay varyasyonlardır: "bu hareket sana ağır geliyorsa hangi basamaktan başla" sorusunun cevabı. İkincisi alternatif hareketlerdir: "aynı işi başka nasıl yaparsın". Üçüncüsü katalogdaki varyant kurallarıdır ve her kuralın bir gerekçesi vardır — arka squat için gerekçe ekipmandır, yani barbell yoksa hangisi işini görür. Üçü tek listede birleştirilseydi kullanıcı "kolay olan" ile "ekipman yerine geçen" arasındaki farkı göremez, kendi seviyesinin üstünde bir hareketi kolay sanıp seçebilirdi.

Hareket ağır geliyorsa Kolay Varyasyonlar listesine bak. Ekipman yoksa Varyantlar rozetlerine bak. Sıkıldıysan Alternatif Hareketler listesine bak.

Buna sistemde "varyant kuralları" (variant rules) denir.

Hub tek soru sorar, altı veriyi birden alır

Diyelim ki kütüphane ana ekranını açtın. Ekranda altı ayrı veri var: sayaç, kategoriler, öne çıkanlar, form-kontrol şeridi, günün odağı ve filtre şeritleri.

Altısı tek bir istekte gelir, altı ayrı istekte değil.

Motor uçlarının dakikalık bir istek bütçesi vardır. Altı veri için altı istek atılsaydı tek ekran açılışı bütçenin büyük kısmını yerdi; kullanıcı ekrana birkaç kez girip çıkınca istekler reddedilmeye başlar ve ekran boş kalırdı. Bu yüzden hub toplu bir görüntüdür. Aynı disiplin arama tarafında da var: arama ve filtre kapalıyken liste sorusu hiç sorulmaz, vitrin görünümü yürürlükte kalır.

Ekran bir kerede dolar. Aşağı çekip yenilemeye ya da sekmeler arasında gezinmeye gerek yoktur.

Buna sistemde "toplu görüntü" (snapshot) denir.

Verin ne işe yarar 5

Antrenman ortamın (ev mi, salon mu)

Girersen Ortam şeridini kullandığında liste senin yapabileceğin hareketlere iner ve "Önerilen" sırası ortam uyumlu hareketlere +15 puan vererek onları üste taşır.

Girmezsen Filtre kapalıyken liste katalogun tamamıdır; evde barbell gerektiren hareketleri de görürsün. Ekran seni engellemez, yalnız ayıklamayı sana bırakır.

Beceri seviyen

Girersen "Önerilen" sırasında seviyene birebir uyan hareketler +20 puan alır, seviyenin üstündekiler −10 alır; liste sana uygun olanla başlar.

Girmezsen Seviye verilmezse bu iki puan hiç işlemez ve sıralama yalnız içerik zenginliği, risk ve hareket tipi üzerinden kurulur. Liste bozulmaz, sana özel olmaz.

Yer imi (kaydettiğin hareketler)

Girersen Kartın sağ üstündeki simgeye bastığında hareket telefonunda işaretlenir ve kartı tekrar açtığında dolu simgeyle karşılanırsın.

Girmezsen Hiçbir hareket kaydetmezsen simge boş kalır; kütüphane bundan etkilenmez, kaydedilmiş hareket listesi de boş kalır.

Üyelik kademen

Girersen Antrenman motoruna açık bir kademedeysen hareket kartındaki set/tekrar/dinlenme paneli sunucudan gelen gerçek sayılarla dolar.

Girmezsen Kapalı bir kademedeysen panel kilit metni gösterir ve hiçbir sayı yazmaz. Hareketin anlatımı, hataları, güvenlik uyarıları ve varyantları açık kalır — kilit yalnız reçete bölümündedir.

Hareket videosu (kendi çektiğin)

Girersen Kartın altındaki Hareket Analizi düğmesinden video çekersen tekniğin ölçülür ve form notun çıkar; bu iş HAREKET FORMU modülünde yapılır.

Girmezsen Video çekmezsen kütüphane tarafında hiçbir şey değişmez: anlatım, ipuçları ve güvenlik uyarıları herkes için aynıdır. Kütüphane kişiye göre değişen bir modül değildir.