kolaytercih/docs/ekip-raporlari/2026-10-07/yazilimci-paket-C.md

Yazılımcı raporu — Paket C · program varyant etiketi (madde 2-3)

Worktree: .claude/worktrees/agent-a5bcd7331b2f3c5b2, dal worktree-agent-a5bcd7331b2f3c5b2, taban 4d30dd1 (şartnamenin tabanı). Push yok.

Özet (5 madde)

1. Program.varyant tek kaynaktan: src/lib/program-varyant.ts (saf varyantEtiketi), db.ts SELECT_COLS üç ilişkili alt sorguyla program_ozellik'ten okur, programSatiri etiketi üretir. Başkent Tıp 6 satırı artık "Ücretli / %50 İndirimli / Burslu / Ücretli · İngilizce / Burslu · İngilizce / %50 İndirimli · İngilizce" olarak ayrışıyor (test çıktısı).
2. UI: /sonuc tablosu, rapor listesi (/listem), üniversite ve bölüm katalog tabloları tür çipinin hemen ardından SATIR_CIP ile çip çiziyor; çekmece ikinci satırda · {varyant}. Null ise hiçbir şey çizilmiyor.
3. Manuel liste ve kayıtlı rapor: ManuelTercih.varyant? (eski localStorage kayıtları geçer), programEkleIste etiketi kopyalar; kullanicininRaporu okuma anında tek sorguyla 24 id'ye varyant yazar (eski raporlar da kazanır, app.db'ye yazılmaz).
4. Model: havuzuKompaktJson varyant alanını taşıyor. B'nin dosyasına dokunulmadı; entegrasyon satırı aşağıda.
5. Doğrulama: scripts/eval/varyant-denetim.ts 14/14 ✔ çıkış 0; typegen + tsc + eslint temiz; pnpm tasarim:denetim 0 hata / 12 uyarı (hepsi dokunulmayan dosyalarda, önceden var). data/ git'te temiz.

Commit listesi

• 5c583ac feat(veri): Program.varyant — burs/dil/öğretim türü etiketi tek kaynaktan (program_ozellik) — src/types/yokatlas.ts, src/lib/db.ts, src/lib/program-varyant.ts (Y), src/lib/rapor-havuzu.ts, scripts/eval/varyant-denetim.ts (Y)
• 7c48f64 feat(liste): varyant çipi — sonuç tablosu, kendi listem çekmecesi, katalog tabloları — liste-queries.ts, liste-dogrula.ts, use-tercih-profili.ts, program-ekle-butonu.tsx, program-tablosu.tsx, liste-cekmecesi.tsx, universite-program-tablosu.tsx, bolum-program-listesi.tsx
• 10b3e5b feat(listem): kayıtlı raporun satırlarına varyant (okuma anında zenginleştirme) — rapor-queries.ts, types/rapor.ts, rapor-listesi.tsx

Dokunulan dosyaların tamamı şartnamenin C satırındadır; liste dışı dosya yok.

Kabul kriterleri

• ✔ Test 4/4 (14 alt denetim), çıkış 0 — pnpm tsx scripts/eval/varyant-denetim.ts koşuldu (react-server koşulu gerekmedi). dilimAra(100000,"say","dengeli",{limit:50}) 50 satırın 50'sinde varyant tanımlı, 34'ü etiketli; 107210332 Marmara Hukuk → null.
• ✔ pnpm exec next typegen && pnpm exec tsc --noEmit temiz (çıktı yok); pnpm exec eslint temiz; pnpm lint → "Tasarım denetimi: 0 hata, 12 uyarı" (uyarılar secimlerim-paneli.tsx, meraklisina-demo.tsx — bu pakette dokunulmadı).
• ✔ grep -c varyant: rapor-listesi 3, program-tablosu 2, liste-cekmecesi 2, universite-program-tablosu 2, bolum-program-listesi 5.
• ✔ data/yokatlas.db değişmedi: git status --short data boş; test ve getDb() readonly: true.
• ✔ Çip SATIR_CIP sınıf dizisiyle birebir (sabit import edildi, elle sınıf yazılmadı); dark: yok.

Şartnameden sapmalar / notlar

1. Worktree tabanı: verilen worktree a3cb058'deydi (şartname tabanı 4d30dd1'in 3 commit gerisi; paketin dosyaları — liste-cekmecesi, rapor-queries, types/rapor.ts, rapor-havuzu — iki commit arasında farklıydı). Çalışma ağacı temiz olduğu için git merge --ff-only 4d30dd1 ile ileri sarıldı; yıkıcı komut kullanılmadı. Dal 1760690 (v2 HEAD) ile değil 4d30dd1 ile başlıyor; v2'ye merge'de bir commit'lik fark var, paketin dosyalarıyla çakışması beklenmez (koddan çıkarım; 1760690 yalnız header rozeti + sürüm).
2. rapor.ts satır numarası: şartname :779 diyor, 4d30dd1'de ilgili satır 763. Orkestratörün ekleyeceği tam hâl:

   ...metindekiSayilar(p.isim, p.universite, p.varyant ?? ""),
   

   (src/lib/ai/rapor.ts:763, ustSayilar kümesinin içindeki ...metindekiSayilar(p.isim, p.universite), satırının yerine.) Bu satır eklenmezse model gerekçede "%50" yazdığında sayı denetimi o cümleyi düşürebilir — işlev bozulmaz, yalnız gerekçe kırpılır.
3. Veri gözlemi (şartnamedeki metinden fark): ogrenim_turu DB'de "Açık Öğretim" (iki kelime) ve "UOLP"; "İkinci Öğretim" / "Açıköğretim" değeri DB'de yok (SELECT DISTINCT ogrenim_turu). Etiket DB'deki metni olduğu gibi yazar; birim testteki "İkinci Öğretim" girdisi saf fonksiyonu ölçer. burs_orani devlette NULL yanında boş string de geliyor; boş string null gibi davranır (5. birim vakası).
4. DESIGN.md §4.15 ile tutarlılık: §4.15'te "Program varyantı ('… (İngilizce) (Burslu)') adın altında ayrı satır SATIR_ALT_AD" cümlesi var — o kural isimin parantezli hâli için (bölüm sayfasındaki bazAd farkı, bolum-program-listesi.tsx:218, aynen duruyor). Bu paketteki burs/dil/öğretim türü etiketi şartname gereği çip (SATIR_CIP, tür çipinin yanı). Belgeye bir cümle eklenmesi gerekir (docs/tasarim/DESIGN.md §4.15, paket dosya listesinde olmadığı için dokunmadım): "Burs/dil/öğretim türü etiketi (Program.varyant) tür çipinin hemen ardından SATIR_CIP ile; null ise çizilmez."
5. programdanManuelTercih (liste-store.ts) paket listesinde yok; varyant use-tercih-profili.ts içinde spread ile ekleniyor. liste-store'u doğrudan çağıran başka ekleme yolu yok (grep programEkleIste( → yalnız program-ekle-butonu.tsx).
6. Çekmece satırında · {varyant} shrink-0; üniversite adı min-w-0 link olduğu için uzun adlarda ad sarar, etiket kesilmez. 375 px notu (koddan çıkarım, tarayıcı açılmadı): meta satırı flex-wrap, en uzun etiket "%50 İndirimli · İngilizce" (~25 karakter, text-xs) tür çipi + il ile sığmazsa alt satıra iner; dokunma hedefi yok (çip interaktif değil). Bölüm sayfasında satır zaten iki 44 px düğmeyle 129 px; bir çip satırı daha eklenirse yükseklik değişmez (düğmeler belirliyor, §4.15). tasarimci kontrolü şartname C-5'te zaten var.
7. Rapor dosyasının yeri: ana checkout'taki docs/ekip-raporlari/2026-10-07/yazilimci-paket-C.md yoluna yazma worktree izolasyonu yüzünden reddedildi; rapor worktree içinde aynı göreli yolda, commit'lenmemiş (untracked) duruyor. Orkestratör ana checkout'a kopyalar.

Merge sonrası doğrulanması gerekenler

• Orkestratör rapor.ts:763 satırını ekledikten sonra pnpm tsx --conditions=react-server scripts/eval/akis-denetim.ts ve B'nin revizyon-denetim.ts'i (varyantlı havuz JSON'u ile prompt boyutu az artar; şema değişmedi).
• Gerçek üretimde bir listede aynı bölümün 2+ varyantı görünürse gerekçenin "burslu/ücretli" ayrımını yazıp yazmadığı (yapay-zeka-muhendisi eval'i; kod değil model davranışı).
• /listem eski kayıtlı raporda çipin göründüğü (okuma anında zenginleştirme) — Bilal'in kendi hesabında 1 bakış.
• Docker imajında program_ozellik tablosunun seed'de geldiği (Dockerfile) — şartname doğruladı, ben koddan teyit etmedim; tablo yoksa alt sorgu SQL hatası verir (koruma bilinçli yok).

Bilal'den istenen

1. docs/tasarim/DESIGN.md §4.15'e yukarıdaki tek cümlenin eklenmesine onay (ya da tasarımcıya verilmesi) — 2 dk.
2. Yok (para/giriş/kişisel veriye dokunulmadı; guvenlik-uyum denetimi gerekmiyor).