275

YKS 2027 için günlük işletim yüzeyi: saat saat bloklar, deneme netleri, yanlış defteri, 39 haftalık faz planı ve kurallar. Bağımlılık yok, derleme yok.

Yayınlamak

Vercel (önerilen — depo gizli kalabilir):

1. Bu klasörü GitHub'a gizli depo olarak gönder (GitHub Desktop → Publish repository → Keep private).
2. vercel.com → Add New → Project → depoyu seç → Deploy. Ayar gerekmez, statik site.
3. Verilen *.vercel.app adresini telefonda aç → Ana ekrana ekle. Gerçek uygulama gibi kurulur.

GitHub Pages (depo herkese açık olmalı):

1. Depoyu public olarak gönder.
2. Settings → Pages → Source: main / root → Save.
3. https://<kullanıcı>.github.io/275/ adresini telefonda aç → Ana ekrana ekle.

Sayfa netlerini ve hedefini gösteriyor. Public'te bunlar herkese açık olur. Vercel + gizli depo aynı sonucu verir ve veri dışarı çıkmaz.

Veri

Kayıt tarayıcının localStorage'ında — cihaz başına ayrı. Sol alttaki Yedek al / yükle (telefonda: Plan → Veri) JSON indirir; öbür cihaza yükleyince aynı kayıt oraya geçer. Haftada bir yedek al.

Değişiklik yayınlarken

sw.js içindeki SURUM sabitini bir artır. Yoksa telefon eski sürümü önbellekten göstermeye devam eder.

Arşiv (arsiv/)

"Dünya Nasıl İşler" okuma arşivi aynı sitede, /arsiv/ adresinde. 275 ile aynı adreste durduğu için aynı tarayıcı kaydını görür:

• Blok kilidi. O gün sayılan blokların %60'ı işaretlenmeden arşiv açılmaz. Oran iki yerde: app.js → ARSIV_ORAN, arsiv/kaynak/kilit.html → KILIT.oran.
• Günlük süre. 45 dakika dolunca uyarı çıkar; "10 dakika daha" ile uzatılır. Ayar: KILIT.gunlukDk, KILIT.uzatmaDk.
• İstisna. Kilit ekranındaki "bugünlük istisna" o günü açar ve ay içinde kaç kez kullanıldığını gösterir.

Arşive bölüm eklemek: arsiv/kaynak/<dosya>/bolum-N.html yaz, başlığını arsiv/kaynak/dosyalar.json içine ekle, python arsiv/build.py çalıştır. arsiv/index.html derlenmiş çıktıdır; elle düzenleme.

Eşitleme (esitle.js, supabase/esitleme.sql)

Telefon ile bilgisayar arasında bloklar, netler, defter ve arşiv ilerlemesi eşitlenir.

1. Supabase projesinde SQL Editor'e supabase/esitleme.sql içeriğini yapıştırıp çalıştır.
2. esitle.js başındaki SB_URL ve SB_ANAHTAR satırlarını doldur (Project Settings → API).
3. Sitede Plan → "Cihazlar arası eşitleme" → bir cihazda başlat, öbüründe anahtarı gir.

Bloklar, takvim, giriş kodu

• bloklar.js günün bloklarını tutar: ad dışarıdan görünen ad, is uygulama içinde görünen asıl iş. Blokları değiştirince node araclar/takvim-uret.js ile takvim dosyalarını yeniden üret.
• takvim.ics (alarmlı) ve takvim-sessiz.ics: Plan → Takvim'den telefona eklenir.
• kasa.js giriş kodu ekranı: Plan → Giriş kodu. Kod cihazda kalır.

Tekrar araçları

• Bugün tekrar (Yanlış defteri): hata girilen konu 1, 3, 7, 21 gün sonra listeye düşer. Aralıklar: app.js → TEKRAR_ARALIK.
• Ders bazlı (Netler): her dersin son neti ve önceki üç denemenin ortalamasına göre farkı.
• Arşivde arama, sözlük, kaldığın yerden devam ve günlük beş soru: arsiv/kaynak/ek.html.

Anlık bildirim (api/bildir.js, supabase/bildirim.sql)

Supabase'deki zamanlayıcı 5 dakikada bir api/bildir'i çağırır; o da o dakikada başlayan blok varsa, ya da ara mesaj / durum yoklaması sırası geldiyse, kayıtlı cihazlara bildirim gönderir. Bildirimde yalnızca bloğun dış adı ve saat yazar.

1. Vercel → Settings → Environment Variables: VAPID_OZEL ve BILDIRIM_SIFRE (ikisi de gizli) → Redeploy.
2. Supabase → SQL Editor: supabase/bildirim.sql → Run.
3. Telefonda (ana ekrandaki uygulamadan) Bugün → "Bildirimleri aç".
4. Supabase → SQL Editor: select public.bildirim_kur('<BILDIRIM_SIFRE>', 'https://<site>'); Zamanlayıcıyı kurar ve bir deneme bildirimi gönderir. Mesaj metinleri ve saatleri: api/bildir.js → SERT, secim().

Gündem (api/gundem.js)

Seçili kaynakların son başlıklarını tek listede gösterir; yalnızca Vercel'de çalışır. Kaynak eklemek/çıkarmak: api/gundem.js → KAYNAKLAR. Kilit ve günlük süre: app.js → GUNDEM. Hesap bağlantıları: app.js → HESAPLAR.

Arka plan fotoğrafı

Depo köküne arkaplan.jpg adında bir fotoğraf koyarsan sayfanın arkasında soluk olarak görünür. Görünürlük: styles.css → --foto (0–1). Dosya yoksa bir şey olmaz.

Şifre (isteğe bağlı)

middleware.js Vercel'de çalışır. Vercel → Project → Settings → Environment Variables → SITE_SIFRE adında bir değişken ekle, değerine şifreni yaz, Redeploy. Değişken yoksa site açıktır. Giriş bir yıl hatırlanır. GitHub Pages'te çalışmaz.

Dosyalar

Dosya	İş
index.html	İskelet ve tüm sabit metin
styles.css	Tasarım sistemi — koyu öncelikli, açık tema data-theme="light"
app.js	Veri modeli, bloklar, deneme/defter, grafik, yol şeridi
sw.js	Çevrimdışı kabuk
manifest.webmanifest	Telefona kurulum
middleware.js	İsteğe bağlı şifre kapısı (yalnızca Vercel)
arsiv/	Okuma arşivi: derlenmiş index.html, kaynak/, build.py
icons/	Uygulama ikonları

Denetim (otomatik test)

node araclar/test.js — bağımlılık gerektirmez, birkaç saniye sürer. Değişiklik yayınlamadan önce çalıştırılır; "KALDI" yazıyorsa o değişiklik bir şeyi bozmuştur. Baktıkları: eşitleme birleştirmesi (iki cihaz benzetimi), blok listeleri, gizlilik (bildirim, takvim, uygulama adı, giriş ekranı gibi dışarıdan görünen hiçbir yerde ders ya da sınav adı geçmemesi), arşiv derlemesinin güncel olması, eksik dosya.

7 Ekim eklentileri

• Çalışma → Netler: "Gidiş ve tahmin" (son denemelerin haftalık eğimi ile hedefe gereken eğim; 5 denemeden önce uzatma yapmaz), "Sınav modu" (165/180 dk, ekranda yalnızca sayaç).
• Çalışma → Defter: "Konu haritası" (her kare bir konu, koyulaştıkça hata çok).
• Çalışma → Hafta: haftanın özeti (yüzde, gün gün, en çok atlanan blok, denemeler, deftere giren hata, günlük cümleler).
• Çalışma → Yıl: "Gün gün" yoğunluk takvimi.
• Bugün: "Bugünden tek cümle".
• Arşiv: metin seçip vurgulama, bölüm notu, bölüm ve pano kartlarında kaynak güveni rozeti. Pano rakamları arsiv/kaynak/pano.json içinde; güncellemek için yalnızca o dosya değişir, sonra python arsiv/build.py.

Spor

Ben → Spor. Program spor.js içinde (ev ve salon için ayrı; hareket, set ve tekrar aralıklarını oradan değiştirirsin; hareketin id alanına dokunma, kayıtlar ona bağlı). Günün antrenmanı açılır, her set için ağırlık ve tekrar yazılır, geçen seferki rakam kutuda soluk görünür. "Antrenmanı bitir" o günün Spor bloğunu işaretler. Kayıtlar eşitlenir ve yedeğe girer.

Ekim okuma planı ve ders sayfaları (9 Ekim)

• Arşiv artık sayfalara bölünüyor: arsiv/index.html (kütüphane, pano, ekonomi dosyaları) ve her ders için arsiv/ders-<id>.html. python arsiv/build.py hepsini yazar. Başka sayfadaki bir bölüme giden bağlantı otomatik o sayfaya gider; ders sayfalarında kilit ve süre sayacı yok.
• Panelde Oku: Arşiv, TYT, AYT. TYT: o an hangi parçanın okunacağını söyleyen bilgi kutusu, ders ders ilerleme, 9–29 Ekim planı (137 parça), bugünün parçaları saatleriyle, geride kalanlar, ders ilerlemesi, gün gün liste. Okundu bilgisi arşivle ortak (dni-done), eşitlenir. Bugün ekranının üstünde de özet kartı var.
• Plan araclar/okuma_plani.py ile üretilir (okuma.js). Gün başına parça sayısı ve saat dilimleri betiğin başında; değiştirip yeniden çalıştır.
• Bugünün ders sayfaları Dersler ekranı açılınca telefona kaydedilir; metroda internetsiz açılır.

Oku ekranı (9 Ekim)

• Panelde Oku: Storytel düzeni. Üstte "Kitaplığım / Tümü", kategori düğmeleri, "Devam et" satırı (TYT'nin sıradaki parçası ve yarım kalan dosyalar), yana kayan raflar, en altta "Yakında". Dosyaya dokununca dosya sayfası: kapak, süre, devam düğmesi, bölüm listesi (daireye basınca okundu işaretlenir).
• Raflar ve sıra arsiv/kaynak/kutuphane.html'den, bölümler dosyalar.json'dan okunur; araclar/katalog.py bunlardan katalog.js üretir. arsiv/build.py bunu kendisi çalıştırır.
• Kapak rengi ve simgesi app.js içindeki OK_KAPAK'ta; yeni dosya eklenince tanımlı değilse sırayla renk alır.