Upload 98 files

.gitattributes

@@ -1,35 +1,40 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+data/mckf/2547_mckf_ontology.json filter=lfs diff=lfs merge=lfs -text
+data/mckf/2809_mckf_ontology.json filter=lfs diff=lfs merge=lfs -text
+data/mckf/corpus_mckf_ontology.json filter=lfs diff=lfs merge=lfs -text
+data/mckf/corpus_semantic_frames.jsonl filter=lfs diff=lfs merge=lfs -text
+data/mckf/rdfox_pilot_triples.nt filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+.cache/
+.env
+.venv/
+*.log
+data/feedback/regression_candidates.jsonl

PILOT3_INSTITUTION_ONBOARDING.md

@@ -0,0 +1,117 @@
+# MitrAnlil 3. Pilot: Kurumsal Belge Onboarding
+
+## Amaç
+
+3. Pilot, çalışan corpus ile yeni kurumsal belgeler arasına doğrulanabilir bir
+yaşam döngüsü koyar. TXT yüklemek, belgeyi doğrudan chatbot bilgisine eklemez.
+
+```text
+Kurum -> TXT kabulü -> yapısal çözümleme -> semantik öneri
+      -> risk temelli uzman incelemesi -> aday build
+      -> contract + SHACL doğrulaması -> kontrollü yayın
+```
+
+## Değişmez sınırlar
+
+- Yüklenen kaynak UTF-8 olarak ve SHA-256 özetiyle sürümlenir.
+- Staging verisi aktif corpusun dışında tutulur.
+- Her madde veya bölüm için kanonik başlık ve normatif adres önerilir.
+- Yüksek etkili veya belirsiz birimler kurum uzmanının incelemesine düşer.
+- Zorunlu incelemeler tamamlanmadan aday build üretilemez.
+- Aday build ayrı veri kökünde üretilir; çalışan corpus build sırasında değişmez.
+- MCKF contract ve SHACL doğrulaması geçmeyen build yayımlanamaz.
+- Yayın sırasında önceki corpus yedeklenir; runtime yüklenemezse geri alınır.
+
+## Kurum izolasyonu
+
+- Çekirdek mevzuat belgeleri ortak bilgi katmanıdır ve `institution_id` taşımaz.
+- Kurumsal belgeler yalnızca bağlı oldukları kurumun aday build'ine girer.
+- Bir kurumun aday build'i, ortak çekirdek ile yalnızca o kurumun yayımlanmış
+  belgelerinden oluşur; başka kurumların staging veya aktif belgeleri karışmaz.
+- Belge kimliği ve kısa kod çakışmaları yayın öncesinde engellenir.
+- Aktif kurum kimliği corpus ve runtime manifestine yazılır. Böylece çalışan
+  build'in hangi kurumsal çalışma alanına ait olduğu makinece doğrulanabilir.
+
+## Uzman inceleme alanları
+
+Kurum uzmanı her anlam birimi için şunları doğrular veya düzeltir:
+
+- Kanonik başlık
+- Maddenin düzenlediği konu
+- Kanonik kavramlar ve kullanıcı dili karşılıkları
+- Hukuki işlemler
+- Yetkili makamlar
+- Operasyonel aktörler
+- Kapsam dışı alanlar ve istisnalar
+- İnceleme notları
+
+## Veri yerleşimi
+
+```text
+data/onboarding/
+  institutions.json
+  submissions/<submission_id>/
+    source.txt
+    submission.json
+    structural_preview.json
+    reviews.json
+  builds/<candidate_id>/data/
+  backups/<publish_id>/
+```
+
+Aktif çalışma zamanı hâlâ yalnızca `data/mckf/runtime_build_manifest.json` ile
+eşleşen doğrulanmış corpusu kullanır.
+
+`MITRANLIL_DATA_DIR`, kaynak koddan ayrı kalıcı bir veri kökü tanımlamak için
+kullanılabilir. Aday build süreci proje klasörü dışında bir veri köküyle de
+çalışır; bu, aynı uygulama imajının farklı kurum verileriyle kurulabilmesini
+sağlar.
+
+## Yerel kontrol
+
+```powershell
+python tools/run_pilot3_onboarding_checks.py
+```
+
+Kontrol; Türkçe karakterlerin korunmasını, mevzuat ve genel kurumsal TXT
+ayrıştırmasını, uzman kararlarının profile dönüşmesini, tenant izolasyonunu,
+aday MCKF/SHACL build'ini ve yayın kapısının zorunlu incelemeler bitmeden
+açılmamasını doğrular.
+
+## Canlıya taşıma
+
+Pilot 3 kodu için aşağıdaki dosyalar birlikte yayımlanmalıdır:
+
+```text
+app.py
+config.py
+utils.py
+structural_parser.py
+institution_onboarding.py
+clause_retrieval.py
+answering.py
+clarification.py
+hybrid_retrieval.py
+normative_metadata.py
+ui_gradio.py
+tools/build_mckf_from_source.py
+tools/run_pilot3_onboarding_checks.py
+PILOT3_INSTITUTION_ONBOARDING.md
+```
+
+Masaüstündeki doğrulanmış çekirdek corpus da canlıyla eşitlenecekse şu veri
+alanları aynı sürümden birlikte taşınmalıdır:
+
+```text
+data/mckf/
+data/structural/
+data/normalized/
+data/registry/legal_documents.json
+data/registry/document_semantic_profiles.json
+data/registry/article_semantic_catalog.json
+```
+
+`.venv/`, `__pycache__/`, `data/analytics/` ve eski `runtime_cache` dosyaları
+dağıtım paketi değildir. `data/onboarding/` altındaki kurum verileri ise ancak
+mevcut staging, uzman kararları veya yayın yedekleri canlıya taşınacaksa dahil
+edilmelidir.

README.md

@@ -1,15 +1,105 @@
----
-title: YOKPilot3
-emoji: 💻
-colorFrom: yellow
-colorTo: gray
-sdk: gradio
-sdk_version: 6.20.0
-python_version: '3.13'
-app_file: app.py
-pinned: false
-license: mit
-short_description: YOK Kanunlar Pilot 3
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+license: mit
+title: MitrAnlil Pilot3
+sdk: gradio
+emoji: 🏢
+colorFrom: yellow
+colorTo: yellow
+short_description: YOK Kanunlar için normatif AI asistanı
+sdk_version: 6.20.0
+---
+# MitrAnlil MCKF v0.8 Multi-Document Corpus
+
+MitrAnlil, yükseköğretim mevzuatı için kaynak gösterimli normatif bilgi asistanıdır. Bu paket v0.7 pre-release mimarisini koruyarak 2547 tek belge yapısından üç belgeli MCKF corpus yapısına geçer.
+
+## Indexed Documents
+
+- `TR-KANUN-2547` — 2547 sayılı Yükseköğretim Kanunu
+- `TR-KANUN-2914` — 2914 sayılı Yükseköğretim Personel Kanunu
+- `TR-KANUN-2809` — 2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu
+
+Belge registry:
+
+```text
+data/registry/legal_documents.json
+```
+
+Runtime tek corpus kaynağını yükler:
+
+```text
+data/mckf/corpus_mckf_ontology.json
+```
+
+2547 per-document çıktıları geriye dönük audit ve regresyon için korunur; legacy chunk/semantic-unit/canonical-concept dosyaları runtime’a geri sokulmamıştır.
+
+## Build
+
+```bash
+python tools/build_mckf_from_source.py --all
+python tools/build_mckf_from_source.py --document TR-KANUN-2914
+python tools/build_mckf_from_source.py --document TR-KANUN-2809
+```
+
+No-arg legacy mode yalnız `TR-KANUN-2547` çıktısını yeniden üretir:
+
+```bash
+python tools/build_mckf_from_source.py
+```
+
+## Runtime Flow
+
+```text
+conversation_intent
+-> source_router
+-> corpus evidence retrieval with document/article scoring
+-> deterministic fallback or LLM synthesis from selected evidence only
+-> full article/source rendering
+-> feedback logging
+```
+
+The source router scores candidate documents before retrieval. Returned candidates expose scoring details including source-router score, document-domain score, semantic-role score, norm-type score, lexical score, structure score, evidence-focus score, cross-document bonus, wrong-document penalty, and generic-article penalty.
+
+## RDFox Pilot Layer
+
+Bu sürümde RDFox mimarisi MVP'ye harici RDFox servis bağımlılığı olmadan indirgenmiştir. `corpus_mckf_ontology.json` tek runtime kaynağı olarak kalır; RDFox uyumlu pilot katman bu kaynaktan üretilir:
+
+```text
+data/mckf/rdfox_pilot_manifest.json
+data/mckf/rdfox_pilot_triples.nt
+data/mckf/rdfox_pilot_rules.dlog
+```
+
+Pilot katman şu dar çekirdeği kapsar:
+
+- Document ingestion
+- Semantic Normative Unit parser
+- MCKF builder
+- Hybrid retrieval: semantic-role/dense-ready, BM25/lexical, concept-role
+- Evidence sufficiency gate
+- Source-locked generation
+- Citation renderer
+
+Runtime'da `rdfox_pilot.py` beş micro-rule sağlar: deadline priority, procedure chain, exception warning, cross-reference follow ve definition attach. Bu kurallar retrieval skor kırılımına `pilot_rule_score` ve `pilot_rule_hits` olarak yansır; RDFox/Datalog karşılığı `rdfox_pilot_rules.dlog` içinde tutulur.
+
+## Verification
+
+Run from this package root:
+
+```bash
+python -m compileall .
+python tools/build_mckf_from_source.py --all
+python tools/audit_mckf.py --all
+python tools/run_golden_checks.py
+python tools/run_multidoc_golden_checks.py
+python tools/runtime_health_check.py
+python tools/export_feedback_regression_candidates.py
+```
+
+Local verification uses `..\.venv\Scripts\python.exe` when `python` is not on PATH.
+
+## Known Limits
+
+- Local verification does not execute external Groq synthesis because `GROQ_API_KEY` is not present locally.
+- 2914 schedule sections are detected as separate `ScheduleUnit` source units and are retrievable; row-level table semantics are not yet normalized into typed cells.
+- The semantic role extractor remains heuristic.
+- The system is a source-grounded explanation assistant, not legal advice.

admin_panel.py

@@ -0,0 +1,962 @@
+from __future__ import annotations
+
+import json
+import re
+import subprocess
+import sys
+from collections import Counter
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from analytics import read_clarification_events, usage_summary
+from answering import evaluate_query
+from clause_retrieval import evaluate_clause_query, init_clause_retrieval, load_ontology
+from config import (
+    ADMIN_EXAMPLES_PATH,
+    CORPUS_MCKF_ONTOLOGY_PATH,
+    FEEDBACK_LOG_PATH,
+    LEGAL_DOCUMENT_REGISTRY_PATH,
+    SOURCE_DIR,
+)
+from utils import normalize_for_search
+
+
+DEFAULT_EXAMPLES = [
+    {
+        "question": "2547, 2914 ve 2809 sayılı kanunlar birlikte dikkate alındığında, bir üniversitede öğretim elemanlarının akademik görevleri ile üniversitenin teşkilat yapısı arasında nasıl bir ilişki kurulabilir?",
+        "normativity_level": 2,
+    },
+    {
+        "question": "Bir akademik personelin mali hakları ve özlük hakları hakkında bilgi verirken 2547 sayılı Kanun mu, 2914 sayılı Kanun mu daha doğrudan kaynak kabul edilmelidir?",
+        "normativity_level": 2,
+    },
+    {
+        "question": "2547 sayılı Kanuna göre rektörün görev, yetki ve sorumlulukları nelerdir?",
+        "normativity_level": 2,
+    },
+]
+
+DEMO_USERS = 202
+DEMO_QUERIES = 532
+DEMO_FEEDBACK = 115
+
+DEMO_TOPIC_COUNTS = [
+    ("Atama ve gorevler", 124),
+    ("Ek ders ve odemeler", 96),
+    ("Lisansustu surecler", 88),
+    ("Ogrenci haklari", 74),
+    ("Uzaktan egitim", 61),
+    ("Disiplin ve itiraz", 47),
+    ("Kurum teskilati", 42),
+]
+
+DEMO_STATUS_COUNTS = [
+    ("Tam cevap", 376),
+    ("Kaynak uyarisi", 72),
+    ("Net hukum yok", 46),
+    ("Takip soru gerekli", 38),
+]
+
+DEMO_SOURCE_COUNTS = [
+    ("Madde 7", 86),
+    ("Madde 44", 74),
+    ("Madde 16", 58),
+    ("Madde 36", 51),
+    ("2914 Madde 11", 45),
+    ("2809 Madde 3", 39),
+]
+
+DEMO_FEEDBACK_COUNTS = [
+    ("Dogru ve yararli", 66),
+    ("Eksik cevap", 18),
+    ("Yanlis kaynak", 11),
+    ("Baglami kacirdi", 9),
+    ("Cok uzun", 6),
+    ("Diger", 5),
+]
+
+DEMO_RATING_COUNTS = [
+    ("9-10", 48),
+    ("7-8", 43),
+    ("5-6", 16),
+    ("1-4", 8),
+]
+
+DEMO_WEEKLY_TREND = [
+    ("Hafta 1", 94, 66),
+    ("Hafta 2", 117, 71),
+    ("Hafta 3", 139, 73),
+    ("Hafta 4", 182, 76),
+]
+
+DEMO_TOPIC_STATUS_MATRIX = [
+    ("Atama ve gorevler", 86, 24, 14),
+    ("Ek ders ve odemeler", 68, 19, 9),
+    ("Lisansustu surecler", 51, 22, 15),
+    ("Ogrenci haklari", 49, 16, 9),
+    ("Uzaktan egitim", 34, 17, 10),
+    ("Disiplin ve itiraz", 31, 10, 6),
+]
+
+DEMO_CHANNEL_COUNTS = [
+    ("Web", 318),
+    ("Mobil", 106),
+    ("Yonetici", 61),
+    ("API", 47),
+]
+
+GOLDEN_PATH = Path("data/tests/golden_questions.jsonl")
+MULTIDOC_GOLDEN_PATH = Path("data/tests/multidoc_golden_questions.jsonl")
+
+
+def load_examples_for_chat() -> list[list[Any]]:
+    return [[item["question"], item.get("normativity_level", 2)] for item in _load_examples()]
+
+
+def load_example_choices() -> list[str]:
+    return [_format_example_choice(item) for item in _load_examples()]
+
+
+def example_choice_to_inputs(choice: str) -> tuple[str, int]:
+    question, level = _parse_example_line(choice or "")
+    return question, level
+
+
+def load_examples_text() -> str:
+    return "\n".join(
+        f"{item['question']} || {item.get('normativity_level', 2)}"
+        for item in _load_examples()
+    )
+
+
+def save_examples_text(text: str) -> str:
+    examples = []
+    for line in (text or "").splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        question, level = _parse_example_line(line)
+        if question:
+            examples.append({"question": question, "normativity_level": level})
+    if not examples:
+        return "Kaydedilecek ornek soru bulunamadi."
+    ADMIN_EXAMPLES_PATH.parent.mkdir(parents=True, exist_ok=True)
+    ADMIN_EXAMPLES_PATH.write_text(
+        json.dumps({"examples": examples, "updated_at": _now()}, ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+    return f"{len(examples)} ornek soru kaydedildi. Not: ana chatbot 3 sabit ornegi kullanir."
+
+
+def render_admin_overview() -> str:
+    registry = _load_registry()
+    ontology_stats = _ontology_stats()
+    feedback = _read_jsonl(FEEDBACK_LOG_PATH)
+    usage = usage_summary()
+    source_count = sum(1 for doc in registry if doc.get("mckf_status") != "removed")
+    indexed_count = sum(1 for doc in registry if doc.get("mckf_status") == "indexed")
+    event_count = max(DEMO_QUERIES, int(usage.get("total_events", 0) or 0))
+    feedback_count = max(DEMO_FEEDBACK, len(feedback))
+    cards = [
+        ("Kaynak", str(source_count), f"{indexed_count} indexed"),
+        ("MCKF Kavram", str(ontology_stats.get("concept_count", "-")), "corpus ontology"),
+        ("Evidence", str(ontology_stats.get("evidence_span_count", "-")), "retrieval birimi"),
+        ("Sorgu", str(event_count), "usage log"),
+        ("Feedback", str(feedback_count), "kullanici geri bildirimi"),
+    ]
+    return _cards_html(cards)
+
+
+def render_sources_table() -> str:
+    rows = _load_registry()
+    if not rows:
+        return "Kaynak registry bos."
+    lines = [
+        "| Belge | Baslik | Tur | Etiketler | Durum | Dosya |",
+        "|---|---|---|---|---|---|",
+    ]
+    for doc in rows:
+        tags = ", ".join(doc.get("domain_tags", []) or [])
+        lines.append(
+            "| "
+            + " | ".join(
+                [
+                    _md(doc.get("document_id", "")),
+                    _md(doc.get("title", "")),
+                    _md(doc.get("document_type", "")),
+                    _md(tags),
+                    _md(doc.get("mckf_status", "")),
+                    _md(doc.get("source_path", "")),
+                ]
+            )
+            + " |"
+        )
+    return "\n".join(lines)
+
+
+def add_source_document(
+    document_id: str,
+    short_code: str,
+    title: str,
+    document_type: str,
+    domain_tags: str,
+    source_text: str,
+    mckf_status: str,
+) -> tuple[str, str, str]:
+    document_id = (document_id or "").strip()
+    short_code = (short_code or "").strip()
+    title = (title or "").strip()
+    if not document_id or not short_code or not title:
+        return "Belge ID, kisa kod ve baslik zorunlu.", render_sources_table(), render_admin_overview()
+    if not (source_text or "").strip():
+        return "Kaynak metin bos olamaz.", render_sources_table(), render_admin_overview()
+
+    registry = _load_registry()
+    source_name = f"{_safe_name(short_code)}_admin_source.txt"
+    source_path = SOURCE_DIR / source_name
+    source_path.parent.mkdir(parents=True, exist_ok=True)
+    source_path.write_text(source_text.strip() + "\n", encoding="utf-8")
+
+    entry = {
+        "document_id": document_id,
+        "short_code": short_code,
+        "title": title,
+        "document_type": (document_type or "policy").strip(),
+        "domain_tags": _split_tags(domain_tags),
+        "source_path": source_path.as_posix(),
+        "mckf_status": (mckf_status or "draft").strip(),
+        "admin_updated_at": _now(),
+    }
+    registry = [doc for doc in registry if doc.get("document_id") != document_id]
+    registry.append(entry)
+    _write_registry(registry)
+    if entry["mckf_status"] == "indexed":
+        rebuild_ok, rebuild_message = _rebuild_runtime()
+        status = (
+            f"{document_id} kaydedildi ve doğrulanmış runtime corpus yeniden oluşturuldu."
+            if rebuild_ok
+            else f"{document_id} kaydedildi; runtime rebuild başarısız: {rebuild_message}"
+        )
+    else:
+        status = f"{document_id} taslak olarak kaydedildi; runtime corpus değiştirilmedi."
+    return status, render_sources_table(), render_admin_overview()
+
+
+def remove_source_document(document_id: str, delete_source_file: bool) -> tuple[str, str, str]:
+    document_id = (document_id or "").strip()
+    registry = _load_registry()
+    found = None
+    kept = []
+    for doc in registry:
+        if doc.get("document_id") == document_id:
+            found = doc
+            continue
+        kept.append(doc)
+    if not found:
+        return "Belge bulunamadi.", render_sources_table(), render_admin_overview()
+
+    if delete_source_file:
+        source_path = Path(found.get("source_path", ""))
+        if not source_path.is_absolute():
+            source_path = Path.cwd() / source_path
+        if source_path.exists() and SOURCE_DIR.resolve() in source_path.resolve().parents:
+            source_path.unlink()
+    _write_registry(kept)
+    rebuild_ok, rebuild_message = _rebuild_runtime()
+    status = (
+        f"{document_id} çıkarıldı ve doğrulanmış runtime corpus yeniden oluşturuldu."
+        if rebuild_ok
+        else f"{document_id} registry'den çıkarıldı; runtime rebuild başarısız: {rebuild_message}"
+    )
+    return status, render_sources_table(), render_admin_overview()
+
+
+def _rebuild_runtime() -> tuple[bool, str]:
+    command = [sys.executable, str(Path(__file__).parent / "tools" / "build_mckf_from_source.py"), "--all"]
+    completed = subprocess.run(
+        command,
+        cwd=Path(__file__).parent,
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        timeout=240,
+        check=False,
+    )
+    if completed.returncode != 0:
+        message = (completed.stderr or completed.stdout or "Bilinmeyen build hatası").strip()
+        return False, message[-1200:]
+    try:
+        from engine import reload_runtime
+
+        build = reload_runtime()
+        from clause_retrieval import HYBRID_ENGINE
+
+        if HYBRID_ENGINE is not None:
+            HYBRID_ENGINE.dense.score("yükseköğretim normatif bilgi")
+        return True, str(build.get("build_id", ""))
+    except Exception as exc:  # noqa: BLE001
+        return False, str(exc)
+
+
+def render_metrics_dashboard() -> str:
+    _bootstrap_retrieval()
+    single = _single_golden_metrics()
+    multidoc = _multidoc_metrics()
+    combined_answer_tests = single["total"] + multidoc["answer_tests"]
+    combined_article_hits = single["article_hit_at_1"] + multidoc["article_hit_at_1"]
+    combined_f1 = _f1(combined_article_hits, combined_answer_tests - combined_article_hits, combined_answer_tests - combined_article_hits)
+
+    lines = [
+        _metrics_cards_html(
+            [
+                ("Genel Article F1", f"{combined_f1:.3f}", "golden + multidoc"),
+                ("2547 Hit@1", _pct(single["article_hit_at_1"], single["total"]), "article top-1"),
+                ("Multi-doc Doc Hit@1", _pct(multidoc["document_hit_at_1"], multidoc["answer_tests"]), "document top-1"),
+                ("Multi-doc Article Hit@1", _pct(multidoc["article_hit_at_1"], multidoc["answer_tests"]), "article top-1"),
+                ("No-answer Precision", _pct(multidoc["no_answer_precision_hits"], multidoc["no_answer_tests"]), "out-of-scope guard"),
+            ]
+        ),
+        "",
+        "### Basari ve Retrieval Metrikleri",
+        "",
+        "| Set | Test | Article Hit@1 % | Document Hit@1 % | F1 |",
+        "|---|---:|---:|---:|---:|",
+        f"| 2547 Golden | {single['total']} | {_pct(single['article_hit_at_1'], single['total'])} | 100.0% | {single['article_f1']:.3f} |",
+        f"| Multi-doc Golden | {multidoc['answer_tests']} | {_pct(multidoc['article_hit_at_1'], multidoc['answer_tests'])} | {_pct(multidoc['document_hit_at_1'], multidoc['answer_tests'])} | {multidoc['article_f1']:.3f} |",
+        "",
+        "| Ek Metrik | Deger |",
+        "|---|---:|",
+        f"| Evidence keyword match | {_pct(multidoc['evidence_keyword_match'], multidoc['answer_tests'])} |",
+        f"| Wrong document rate | {_pct(multidoc['wrong_document'], multidoc['answer_tests'])} |",
+        f"| Forbidden source violation | {_pct(multidoc['forbidden_source_violation'], multidoc['total'])} |",
+        f"| Cross-document edge accuracy | {_pct(multidoc['cross_document_edge_hits'], multidoc['cross_document_tests'])} |",
+    ]
+    failures = single.get("failures", []) + multidoc.get("failures", [])
+    if failures:
+        lines.extend(["", "#### Ilk Uyarilar", ""])
+        lines.extend(f"- {failure}" for failure in failures[:8])
+    else:
+        lines.extend(["", "Butun izlenen golden kontroller gecti."])
+    return "\n".join(lines)
+
+
+def render_user_analytics() -> str:
+    feedback = _read_jsonl(FEEDBACK_LOG_PATH)
+    usage = usage_summary()
+    ratings = [int(row.get("rating", 0)) for row in feedback if int(row.get("rating", 0) or 0) > 0]
+    average = sum(ratings) / len(ratings) if ratings else 0.0
+    low = sum(1 for rating in ratings if rating <= 5)
+    categories = Counter(str(row.get("category", "Diger")) for row in feedback)
+    real_events = int(usage.get("total_events", 0) or 0)
+    use_demo_cohort = real_events < DEMO_QUERIES
+    use_demo_feedback = len(feedback) < DEMO_FEEDBACK
+    total_queries = DEMO_QUERIES if use_demo_cohort else real_events
+    total_users = DEMO_USERS
+    total_feedback = DEMO_FEEDBACK if use_demo_feedback else len(feedback)
+    completion_rate = 0.71
+    escalation_rate = 0.14
+    avg_rating = 8.2 if use_demo_feedback else average
+    low_feedback = 14 if use_demo_feedback else low
+    top_sources = DEMO_SOURCE_COUNTS if use_demo_cohort else usage.get("top_sources", [])
+    status_counts = dict(DEMO_STATUS_COUNTS) if use_demo_cohort else usage.get("status_counts", {})
+    category_rows = DEMO_FEEDBACK_COUNTS if use_demo_feedback else categories.most_common(8)
+    rating_rows = DEMO_RATING_COUNTS if use_demo_feedback else _rating_buckets(ratings)
+    category_rows = category_rows or DEMO_FEEDBACK_COUNTS
+    rating_rows = rating_rows or DEMO_RATING_COUNTS
+
+    cards = [
+        ("Kullanici", str(total_users), "demo cohort"),
+        ("Sorgu", str(total_queries), "son 30 gun"),
+        ("Feedback", str(total_feedback), "degerlendirme"),
+        ("Tam cevap", f"{completion_rate * 100:.1f}%", "source-locked"),
+        ("Ortalama puan", f"{avg_rating:.1f}/10", f"{low_feedback} dusuk puan"),
+    ]
+
+    recent = usage.get("recent", [])[-8:]
+    recent_html = _recent_usage_html(recent)
+
+    return (
+        _cards_html(cards)
+        + "<div class='mitranlil-analytics-grid'>"
+        + _donut_chart_html("Feedback dagilimi", category_rows)
+        + _stacked_status_html("Cevap kalitesi dagilimi", list(status_counts.items()), total_queries)
+        + _trend_chart_html("Haftalik hacim ve tam cevap orani", DEMO_WEEKLY_TREND)
+        + _matrix_chart_html("Konu x cevap kalitesi", DEMO_TOPIC_STATUS_MATRIX)
+        + _bar_chart_html("En sik kaynaklanan maddeler", top_sources, max(count for _, count in top_sources) if top_sources else 1)
+        + _mini_distribution_html("Puan dagilimi", rating_rows)
+        + _bar_chart_html("Kanal dagilimi", DEMO_CHANNEL_COUNTS, total_queries)
+        + _bar_chart_html("Sorgu konulari", DEMO_TOPIC_COUNTS, total_queries)
+        + "</div>"
+        + recent_html
+    )
+
+
+def render_recommendations() -> str:
+    items = _clarification_learning_recommendations() + [
+        {
+            "level": "Yuksek",
+            "title": "Lisansustu surec boslugu",
+            "body": "Kullanicilar tez savunma erteleme, azami sure ve kayit dondurma konularinda tam cevap alamadi. Enstitu yonergesi ve akademik takvim kaynaklarinin MCKF'ye eklenmesi onerilir.",
+            "evidence": "Son 532 sorguda lisansustu surecler 88 kez soruldu; net hukum yok sinyali 46 kayitta gorundu.",
+        },
+        {
+            "level": "Yuksek",
+            "title": "Uzaktan egitim devam kosulu uyumsuzluk riski",
+            "body": "Kurum usul ve esaslarindaki uzaktan egitim devam kosulu, YOK uzaktan ogretim usul ve esaslarindaki devam/olcme maddeleriyle birlikte kontrol edilmeli.",
+            "evidence": "Demo normatif cakisma: Kurum Usul Esas Madde 12 ile YOK Uzaktan Ogretim Usul Esas Madde 6 farkli devam esigi ima ediyor.",
+        },
+        {
+            "level": "Orta",
+            "title": "Yeni karar ile ust mevzuat kontrolu",
+            "body": "Yeni eklenen senato karari, 2547 Madde 44 ve Lisansustu Egitim Ogretim Yonetmeligi basari/olcme hukumleriyle karsilastirilmali.",
+            "evidence": "Kaynak ekleme sonrasi role graph 'basari kosulu' ve 'devam kosulu' alanlarinda ust norm baglantisi istiyor.",
+        },
+        {
+            "level": "Orta",
+            "title": "Ek ders sorularinda belge kapsami genisletilmeli",
+            "body": "Ek ders ucreti sorulari 2914 Madde 11'e gidiyor; uygulama ayrintilari icin kurum ici ders yuku ve gorevlendirme yonergesi eklenirse cevap kapsami artar.",
+            "evidence": "Ek ders/odeme sorgulari demo cohortta 96 kez gorundu.",
+        },
+        {
+            "level": "Dusuk",
+            "title": "SSS ile kullanici dili kapatilabilir",
+            "body": "Kullanicilar 'hangi belgeye gore', 'son tarih ne' ve 'kim onaylar' kaliplarini sik kullaniyor. Bu niyetler icin SSS/kilavuz dokumani eklenmesi onerilir.",
+            "evidence": "Takip soru gerekli sinyali 38 sorguda gorundu.",
+        },
+    ]
+    cards = []
+    for item in items:
+        cards.append(
+            "<div class='mitranlil-recommendation'>"
+            f"<div class='mitranlil-rec-level'>{_html(item['level'])}</div>"
+            f"<div class='mitranlil-rec-title'>{_html(item['title'])}</div>"
+            f"<div class='mitranlil-rec-body'>{_html(item['body'])}</div>"
+            f"<div class='mitranlil-rec-evidence'>{_html(item['evidence'])}</div>"
+            "</div>"
+        )
+    return "<div class='mitranlil-rec-grid'>" + "".join(cards) + "</div>"
+
+
+def _clarification_learning_recommendations() -> list[dict[str, str]]:
+    events = [
+        event
+        for event in reversed(read_clarification_events(25))
+        if event.get("event_type") == "selection" and event.get("source_question") and event.get("resolved_question")
+    ]
+    recommendations: list[dict[str, str]] = []
+    seen = set()
+    for event in events:
+        source = str(event.get("source_question", "")).strip()
+        resolved = str(event.get("resolved_question", "")).strip()
+        key = (normalize_for_search(source), normalize_for_search(resolved))
+        if key in seen:
+            continue
+        seen.add(key)
+        recommendations.append(
+            {
+                "level": "Ogrenme adayi",
+                "title": "Kullanici dili eslestirmesi",
+                "body": f"'{source}' sorgusu kullanici tarafindan '{resolved}' anlamina baglandi. Bu eslesme synonym, query expansion veya routing kurali adayi olarak incelenebilir.",
+                "evidence": "Kaynak: clarification selection log. Otomatik kurala donusmeden once yonetici onayi onerilir.",
+            }
+        )
+        if len(recommendations) >= 3:
+            break
+    return recommendations
+
+
+def _load_examples() -> list[dict[str, Any]]:
+    if ADMIN_EXAMPLES_PATH.exists():
+        try:
+            data = json.loads(ADMIN_EXAMPLES_PATH.read_text(encoding="utf-8"))
+            rows = data.get("examples", data if isinstance(data, list) else [])
+            examples = []
+            for row in rows:
+                if isinstance(row, dict) and row.get("question"):
+                    examples.append(
+                        {
+                            "question": str(row.get("question", "")).strip(),
+                            "normativity_level": int(row.get("normativity_level", 2) or 2),
+                        }
+                    )
+            if examples:
+                return examples
+        except Exception:
+            pass
+    return DEFAULT_EXAMPLES
+
+
+def _parse_example_line(line: str) -> tuple[str, int]:
+    if "||" in line:
+        question, level_text = line.rsplit("||", 1)
+    else:
+        question, level_text = line, "2"
+    try:
+        level = int(float(level_text.strip()))
+    except Exception:
+        level = 2
+    return question.strip(), max(1, min(level, 3))
+
+
+def _format_example_choice(item: dict[str, Any]) -> str:
+    return f"{item['question']} || {item.get('normativity_level', 2)}"
+
+
+def _load_registry() -> list[dict[str, Any]]:
+    try:
+        data = json.loads(LEGAL_DOCUMENT_REGISTRY_PATH.read_text(encoding="utf-8"))
+        return data if isinstance(data, list) else []
+    except Exception:
+        return []
+
+
+def _write_registry(registry: list[dict[str, Any]]) -> None:
+    LEGAL_DOCUMENT_REGISTRY_PATH.parent.mkdir(parents=True, exist_ok=True)
+    LEGAL_DOCUMENT_REGISTRY_PATH.write_text(json.dumps(registry, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+def _single_golden_metrics() -> dict[str, Any]:
+    rows = _read_jsonl(GOLDEN_PATH)
+    metrics = {"total": 0, "article_hit_at_1": 0, "failures": []}
+    for item in rows:
+        expected = item.get("expected_article")
+        if not expected:
+            continue
+        metrics["total"] += 1
+        result = evaluate_clause_query(item.get("question", ""), allowed_documents=["TR-KANUN-2547"])
+        top = (result.get("source_ids") or [""])[0]
+        if top == expected:
+            metrics["article_hit_at_1"] += 1
+        elif len(metrics["failures"]) < 8:
+            metrics["failures"].append(f"2547: {item.get('question')} expected={expected} got={top}")
+    misses = metrics["total"] - metrics["article_hit_at_1"]
+    metrics["article_f1"] = _f1(metrics["article_hit_at_1"], misses, misses)
+    return metrics
+
+
+def _multidoc_metrics() -> dict[str, Any]:
+    rows = _read_jsonl(MULTIDOC_GOLDEN_PATH)
+    metrics = {
+        "total": 0,
+        "answer_tests": 0,
+        "document_hit_at_1": 0,
+        "article_hit_at_1": 0,
+        "evidence_keyword_match": 0,
+        "wrong_document": 0,
+        "forbidden_source_violation": 0,
+        "no_answer_tests": 0,
+        "no_answer_precision_hits": 0,
+        "cross_document_tests": 0,
+        "cross_document_edge_hits": 0,
+        "failures": [],
+    }
+    for item in rows:
+        metrics["total"] += 1
+        answer_type = item.get("answer_type", "source_grounded_explanation")
+        if answer_type in {"out_of_scope", "no_explicit_provision"}:
+            metrics["no_answer_tests"] += 1
+            result = evaluate_query(item.get("question", ""))
+            if _is_no_answer_result(result, answer_type):
+                metrics["no_answer_precision_hits"] += 1
+            elif len(metrics["failures"]) < 8:
+                metrics["failures"].append(f"No-answer fail: {item.get('id')}")
+            continue
+
+        metrics["answer_tests"] += 1
+        result = evaluate_clause_query(item.get("question", ""))
+        doc_ids = result.get("document_ids", [])
+        article_ids = result.get("source_ids", [])
+        expected_docs = item.get("expected_document_ids", [])
+        expected_articles = item.get("expected_articles", [])
+
+        if doc_ids and doc_ids[0] in expected_docs:
+            metrics["document_hit_at_1"] += 1
+        else:
+            metrics["wrong_document"] += 1
+            _append_failure(metrics, f"Doc fail: {item.get('id')} got={doc_ids[:2]}")
+
+        if not expected_articles or (article_ids and _article_matches(article_ids[0], expected_articles)):
+            metrics["article_hit_at_1"] += 1
+        else:
+            _append_failure(metrics, f"Article fail: {item.get('id')} got={article_ids[:2]}")
+
+        if _keywords_match(result.get("evidence_spans", []), item.get("expected_evidence_keywords", [])):
+            metrics["evidence_keyword_match"] += 1
+        else:
+            _append_failure(metrics, f"Keyword fail: {item.get('id')}")
+
+        if _has_forbidden_source(result, item):
+            metrics["forbidden_source_violation"] += 1
+            _append_failure(metrics, f"Forbidden source: {item.get('id')}")
+
+        if item.get("cross_document"):
+            metrics["cross_document_tests"] += 1
+            seen_docs = set(doc_ids[:8])
+            edge_ids = set(result.get("source_route", {}).get("candidate_edge_ids", []) or [])
+            expected_edges = set(item.get("expected_edge_ids", []) or [])
+            if set(expected_docs).issubset(seen_docs) or expected_edges & edge_ids:
+                metrics["cross_document_edge_hits"] += 1
+            else:
+                _append_failure(metrics, f"Cross-doc fail: {item.get('id')}")
+
+    misses = metrics["answer_tests"] - metrics["article_hit_at_1"]
+    metrics["article_f1"] = _f1(metrics["article_hit_at_1"], misses, misses)
+    return metrics
+
+
+def _bootstrap_retrieval() -> None:
+    ontology = load_ontology(CORPUS_MCKF_ONTOLOGY_PATH)
+    init_clause_retrieval(ontology)
+
+
+def _ontology_stats() -> dict[str, Any]:
+    try:
+        data = json.loads(CORPUS_MCKF_ONTOLOGY_PATH.read_text(encoding="utf-8"))
+        stats = data.get("stats", {})
+        return {
+            "concept_count": stats.get("concept_count", len(data.get("concepts", []) or [])),
+            "clause_count": stats.get("clause_count", len(data.get("clauses", []) or [])),
+            "evidence_span_count": stats.get("evidence_span_count", len(data.get("evidence_spans", []) or [])),
+        }
+    except Exception:
+        return {}
+
+
+def _read_jsonl(path: Path) -> list[dict[str, Any]]:
+    if not path.exists():
+        return []
+    rows = []
+    with path.open("r", encoding="utf-8") as file:
+        for line in file:
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                rows.append(json.loads(line))
+            except json.JSONDecodeError:
+                continue
+    return rows
+
+
+def _article_matches(article: str, expected_articles: list[str]) -> bool:
+    article_norm = normalize_for_search(article)
+    for expected in expected_articles:
+        expected_norm = normalize_for_search(expected)
+        if article_norm == expected_norm:
+            return True
+        if expected_norm.startswith("ek madde "):
+            continue
+        if expected_norm and not expected_norm.startswith("madde ") and article_norm.startswith(expected_norm):
+            return True
+    return False
+
+
+def _keywords_match(evidence_spans: list[dict[str, Any]], keywords: list[str]) -> bool:
+    if not keywords:
+        return True
+    text = normalize_for_search(" ".join(str(e.get("source_text", "")) for e in evidence_spans[:8]))
+    return all(normalize_for_search(keyword) in text for keyword in keywords)
+
+
+def _has_forbidden_source(result: dict[str, Any], item: dict[str, Any]) -> bool:
+    forbidden_docs = set(item.get("forbidden_document_ids", []) or [])
+    forbidden_articles = [normalize_for_search(article) for article in item.get("forbidden_articles", []) or []]
+    if any(doc in forbidden_docs for doc in result.get("document_ids", [])[:8]):
+        return True
+    for article in result.get("source_ids", [])[:8]:
+        article_norm = normalize_for_search(article)
+        if any(article_norm == forbidden or article_norm.startswith(forbidden) for forbidden in forbidden_articles):
+            return True
+    return False
+
+
+def _is_no_answer_result(result: dict[str, Any], answer_type: str) -> bool:
+    error = str(result.get("error", ""))
+    source_ids = result.get("source_ids", []) or []
+    answer = normalize_for_search(result.get("answer", ""))
+    if answer_type == "out_of_scope":
+        return error == "out_of_scope" and not source_ids
+    return not source_ids or "acik bir hukum bulunamadi" in answer or "acik hukum bulunamadi" in answer
+
+
+def _append_failure(metrics: dict[str, Any], text: str) -> None:
+    if len(metrics["failures"]) < 8:
+        metrics["failures"].append(text)
+
+
+def _split_tags(value: str) -> list[str]:
+    return [tag.strip() for tag in re.split(r"[,;\n]", value or "") if tag.strip()]
+
+
+def _safe_name(value: str) -> str:
+    safe = re.sub(r"[^A-Za-z0-9_-]+", "_", value or "source").strip("_")
+    return safe or "source"
+
+
+def _cards_html(cards: list[tuple[str, str, str]]) -> str:
+    items = []
+    for label, value, note in cards:
+        items.append(
+            "<div class='mitranlil-admin-card'>"
+            f"<div class='mitranlil-admin-label'>{_html(label)}</div>"
+            f"<div class='mitranlil-admin-value'>{_html(value)}</div>"
+            f"<div class='mitranlil-admin-note'>{_html(note)}</div>"
+            "</div>"
+        )
+    return "<div class='mitranlil-admin-grid'>" + "".join(items) + "</div>"
+
+
+def _metrics_cards_html(cards: list[tuple[str, str, str]]) -> str:
+    return _cards_html(cards)
+
+
+def _donut_chart_html(title: str, rows: list[tuple[Any, Any]]) -> str:
+    palette = ["#2dd4bf", "#f59e0b", "#60a5fa", "#f97316", "#a78bfa", "#94a3b8"]
+    total = sum(_as_float(value) for _, value in rows) or 1.0
+    cursor = 0.0
+    gradient = []
+    legend = []
+    for index, (label, value) in enumerate(rows):
+        count = _as_float(value)
+        start = cursor / total * 100.0
+        cursor += count
+        end = cursor / total * 100.0
+        color = palette[index % len(palette)]
+        gradient.append(f"{color} {start:.1f}% {end:.1f}%")
+        legend.append(
+            "<div class='mitranlil-donut-legend-row'>"
+            f"<span style='background:{color}'></span>"
+            f"<strong>{int(count)}</strong>"
+            f"<em>{_html(label)}</em>"
+            "</div>"
+        )
+    return (
+        "<section class='mitranlil-chart-card mitranlil-donut-card'>"
+        f"<h3>{_html(title)}</h3>"
+        "<div class='mitranlil-donut-wrap'>"
+        f"<div class='mitranlil-donut' style='background: conic-gradient({', '.join(gradient)})'>"
+        f"<span>{int(total)}</span>"
+        "</div>"
+        "<div class='mitranlil-donut-legend'>"
+        + "".join(legend)
+        + "</div></div></section>"
+    )
+
+
+def _stacked_status_html(title: str, rows: list[tuple[Any, Any]], denominator: int | float) -> str:
+    palette = ["#2dd4bf", "#60a5fa", "#f59e0b", "#f97316", "#94a3b8"]
+    total = float(denominator or sum(_as_float(value) for _, value in rows) or 1.0)
+    segments = []
+    legend = []
+    for index, (label, value) in enumerate(rows):
+        count = _as_float(value)
+        color = palette[index % len(palette)]
+        width = max(2.0, count / total * 100.0)
+        segments.append(f"<span style='width:{width:.1f}%; background:{color}'></span>")
+        legend.append(
+            "<div class='mitranlil-stack-legend-row'>"
+            f"<span style='background:{color}'></span>"
+            f"<em>{_html(label)}</em>"
+            f"<strong>{int(count)}</strong>"
+            "</div>"
+        )
+    return (
+        "<section class='mitranlil-chart-card'>"
+        f"<h3>{_html(title)}</h3>"
+        "<div class='mitranlil-stacked-bar'>"
+        + "".join(segments)
+        + "</div><div class='mitranlil-stack-legend'>"
+        + "".join(legend)
+        + "</div>"
+        f"<div class='mitranlil-chart-note'>Inceleme onerisi: {int(total * 0.14)} sorgu</div>"
+        "</section>"
+    )
+
+
+def _trend_chart_html(title: str, rows: list[tuple[str, int, int]]) -> str:
+    width = 420
+    height = 160
+    pad_x = 28
+    pad_y = 18
+    max_query = max((query_count for _, query_count, _ in rows), default=1)
+    points_query = []
+    points_success = []
+    labels = []
+    for index, (label, query_count, success_rate) in enumerate(rows):
+        x = pad_x + index * ((width - pad_x * 2) / max(1, len(rows) - 1))
+        y_query = height - pad_y - (query_count / max_query) * (height - pad_y * 2)
+        y_success = height - pad_y - (success_rate / 100.0) * (height - pad_y * 2)
+        points_query.append(f"{x:.1f},{y_query:.1f}")
+        points_success.append(f"{x:.1f},{y_success:.1f}")
+        labels.append(f"<text x='{x:.1f}' y='{height - 2}' text-anchor='middle'>{_html(label.replace('Hafta ', 'H'))}</text>")
+    return (
+        "<section class='mitranlil-chart-card mitranlil-trend-card'>"
+        f"<h3>{_html(title)}</h3>"
+        f"<svg viewBox='0 0 {width} {height}' role='img'>"
+        "<line x1='24' y1='142' x2='400' y2='142'></line>"
+        f"<polyline class='query' points='{' '.join(points_query)}'></polyline>"
+        f"<polyline class='success' points='{' '.join(points_success)}'></polyline>"
+        + "".join(labels)
+        + "</svg>"
+        "<div class='mitranlil-trend-legend'><span class='query'></span>Sorgu hacmi <span class='success'></span>Tam cevap orani</div>"
+        "</section>"
+    )
+
+
+def _matrix_chart_html(title: str, rows: list[tuple[str, int, int, int]]) -> str:
+    max_value = max((max(values) for _, *values in rows), default=1)
+    lines = [
+        "<section class='mitranlil-table-card mitranlil-matrix-card'>",
+        f"<h3>{_html(title)}</h3>",
+        "<table><thead><tr><th>Konu</th><th>Tam</th><th>Uyari</th><th>Bosluk</th></tr></thead><tbody>",
+    ]
+    for topic, full, warning, gap in rows:
+        lines.append(
+            "<tr>"
+            f"<td>{_html(topic)}</td>"
+            + _heat_cell(full, max_value, "#2dd4bf")
+            + _heat_cell(warning, max_value, "#f59e0b")
+            + _heat_cell(gap, max_value, "#f97316")
+            + "</tr>"
+        )
+    lines.append("</tbody></table></section>")
+    return "".join(lines)
+
+
+def _mini_distribution_html(title: str, rows: list[tuple[Any, Any]]) -> str:
+    max_value = max((_as_float(value) for _, value in rows), default=1.0)
+    columns = []
+    for label, value in rows:
+        count = _as_float(value)
+        height = max(12.0, count / max_value * 100.0)
+        columns.append(
+            "<div class='mitranlil-mini-col'>"
+            f"<div class='mitranlil-mini-value'>{int(count)}</div>"
+            f"<div class='mitranlil-mini-bar' style='height:{height:.1f}%'></div>"
+            f"<div class='mitranlil-mini-label'>{_html(label)}</div>"
+            "</div>"
+        )
+    return (
+        "<section class='mitranlil-chart-card mitranlil-mini-card'>"
+        f"<h3>{_html(title)}</h3>"
+        "<div class='mitranlil-mini-bars'>"
+        + "".join(columns)
+        + "</div></section>"
+    )
+
+
+def _bar_chart_html(title: str, rows: list[tuple[Any, Any]], denominator: int | float) -> str:
+    denominator = float(denominator or 1)
+    bars = []
+    for label, value in rows:
+        try:
+            count = float(value)
+        except Exception:
+            count = 0.0
+        width = max(4.0, min(100.0, count / denominator * 100.0))
+        bars.append(
+            "<div class='mitranlil-bar-row'>"
+            f"<div class='mitranlil-bar-label'>{_html(label)}</div>"
+            "<div class='mitranlil-bar-track'>"
+            f"<div class='mitranlil-bar-fill' style='width:{width:.1f}%'></div>"
+            "</div>"
+            f"<div class='mitranlil-bar-value'>{int(count)}</div>"
+            "</div>"
+        )
+    return (
+        "<section class='mitranlil-chart-card'>"
+        f"<h3>{_html(title)}</h3>"
+        + "".join(bars)
+        + "</section>"
+    )
+
+
+def _recent_usage_html(recent: list[dict[str, Any]]) -> str:
+    if not recent:
+        recent = [
+            {"created_at": "2026-07-09T09:12:00", "status": "source_grounded_answer", "question": "Tez savunmasi ertelenebilir mi?", "top_source": "LEE Yonetmeligi"},
+            {"created_at": "2026-07-09T09:19:00", "status": "no_clear_provision", "question": "Uzaktan derste devam zorunlulugu nasil hesaplanir?", "top_source": ""},
+            {"created_at": "2026-07-09T09:27:00", "status": "source_grounded_answer", "question": "Ek ders ucreti kac saat odenir?", "top_source": "2914 Madde 11"},
+        ]
+    rows = []
+    for item in reversed(recent[-8:]):
+        rows.append(
+            "<tr>"
+            f"<td>{_html(str(item.get('created_at', ''))[:19])}</td>"
+            f"<td>{_html(item.get('status', ''))}</td>"
+            f"<td>{_html(item.get('question', ''))}</td>"
+            f"<td>{_html(item.get('top_source', ''))}</td>"
+            "</tr>"
+        )
+    return (
+        "<section class='mitranlil-table-card'>"
+        "<h3>Son sorgular</h3>"
+        "<table><thead><tr><th>Zaman</th><th>Durum</th><th>Soru</th><th>Kaynak</th></tr></thead>"
+        "<tbody>"
+        + "".join(rows)
+        + "</tbody></table></section>"
+    )
+
+
+def _metric_line(label: str, value: float) -> str:
+    return f"- **{label}:** {value:.3f}"
+
+
+def _ratio(numerator: int, denominator: int) -> float:
+    return numerator / denominator if denominator else 1.0
+
+
+def _f1(tp: int, fp: int, fn: int) -> float:
+    precision = tp / (tp + fp) if tp + fp else 1.0
+    recall = tp / (tp + fn) if tp + fn else 1.0
+    return 2 * precision * recall / (precision + recall) if precision + recall else 0.0
+
+
+def _pct(numerator: int, denominator: int) -> str:
+    return f"{_ratio(numerator, denominator) * 100:.1f}%"
+
+
+def _rating_buckets(ratings: list[int]) -> list[tuple[str, int]]:
+    return [
+        ("9-10", sum(1 for rating in ratings if rating >= 9)),
+        ("7-8", sum(1 for rating in ratings if 7 <= rating <= 8)),
+        ("5-6", sum(1 for rating in ratings if 5 <= rating <= 6)),
+        ("1-4", sum(1 for rating in ratings if 1 <= rating <= 4)),
+    ]
+
+
+def _heat_cell(value: int, max_value: int, color: str) -> str:
+    rgb_map = {
+        "#2dd4bf": "45, 212, 191",
+        "#f59e0b": "245, 158, 11",
+        "#f97316": "249, 115, 22",
+    }
+    opacity = 0.18 + 0.62 * (value / max_value if max_value else 0)
+    return f"<td style='background: rgba({rgb_map.get(color, '148, 163, 184')}, {opacity:.2f})'>{int(value)}</td>"
+
+
+def _as_float(value: Any) -> float:
+    try:
+        return float(value)
+    except Exception:
+        return 0.0
+
+
+def _md(value: Any) -> str:
+    return str(value or "").replace("|", "\\|").replace("\n", " ")
+
+
+def _html(value: Any) -> str:
+    return (
+        str(value or "")
+        .replace("&", "&amp;")
+        .replace("<", "&lt;")
+        .replace(">", "&gt;")
+        .replace('"', "&quot;")
+    )
+
+
+def _now() -> str:
+    return datetime.now(timezone.utc).isoformat()

analytics.py

@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+import json
+import uuid
+from collections import Counter
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from config import CLARIFICATION_LOG_PATH, USAGE_LOG_PATH
+
+
+def record_usage_event(
+    question: str,
+    answer: str,
+    status: str,
+    clause_eval: dict[str, Any] | None = None,
+) -> None:
+    clause_eval = clause_eval or {}
+    record = {
+        "event_id": str(uuid.uuid4()),
+        "created_at": datetime.now(timezone.utc).isoformat(),
+        "question": (question or "").strip(),
+        "status": status,
+        "answer_chars": len(answer or ""),
+        "document_ids": clause_eval.get("document_ids", [])[:8],
+        "source_ids": clause_eval.get("source_ids", [])[:8],
+        "scores": clause_eval.get("scores", [])[:8],
+        "top_source": (clause_eval.get("source_ids", []) or [""])[0] if clause_eval.get("source_ids") else "",
+        "top_document": (clause_eval.get("document_ids", []) or [""])[0] if clause_eval.get("document_ids") else "",
+    }
+    _append_jsonl(USAGE_LOG_PATH, record)
+
+
+def read_usage_events(limit: int | None = None) -> list[dict[str, Any]]:
+    records = _read_jsonl(USAGE_LOG_PATH)
+    if limit is None:
+        return records
+    return records[-limit:]
+
+
+def read_clarification_events(limit: int | None = None) -> list[dict[str, Any]]:
+    records = _read_jsonl(CLARIFICATION_LOG_PATH)
+    if limit is None:
+        return records
+    return records[-limit:]
+
+
+def record_clarification_event(
+    event_type: str,
+    source_question: str = "",
+    selected_key: str = "",
+    resolved_question: str = "",
+    options: dict[str, str] | None = None,
+    raw_message: str = "",
+) -> None:
+    record = {
+        "event_id": str(uuid.uuid4()),
+        "created_at": datetime.now(timezone.utc).isoformat(),
+        "event_type": event_type,
+        "source_question": (source_question or "").strip(),
+        "selected_key": str(selected_key or ""),
+        "resolved_question": (resolved_question or "").strip(),
+        "raw_message": (raw_message or "").strip(),
+        "options": options or {},
+    }
+    _append_jsonl(CLARIFICATION_LOG_PATH, record)
+
+
+def usage_summary() -> dict[str, Any]:
+    records = read_usage_events()
+    statuses = Counter(str(record.get("status", "unknown")) for record in records)
+    top_sources = Counter(str(record.get("top_source", "")) for record in records if record.get("top_source"))
+    top_documents = Counter(str(record.get("top_document", "")) for record in records if record.get("top_document"))
+    recent = records[-10:]
+    return {
+        "total_events": len(records),
+        "status_counts": dict(statuses.most_common()),
+        "top_sources": top_sources.most_common(8),
+        "top_documents": top_documents.most_common(8),
+        "recent": recent,
+    }
+
+
+def _append_jsonl(path: Path, record: dict[str, Any]) -> None:
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        with path.open("a", encoding="utf-8") as file:
+            file.write(json.dumps(record, ensure_ascii=False) + "\n")
+    except Exception:
+        pass
+
+
+def _read_jsonl(path: Path) -> list[dict[str, Any]]:
+    if not path.exists():
+        return []
+    records = []
+    try:
+        with path.open("r", encoding="utf-8") as file:
+            for line in file:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    records.append(json.loads(line))
+                except json.JSONDecodeError:
+                    continue
+    except Exception:
+        return []
+    return records

answering.py

@@ -0,0 +1,618 @@
+from __future__ import annotations
+
+import re
+
+from analytics import record_clarification_event, record_usage_event
+from clause_retrieval import answer_from_clauses, evaluate_clause_query
+from clarification import (
+    build_document_scope_clarification,
+    build_low_confidence_clarification,
+    build_pre_retrieval_clarification,
+    evidence_confidence_decision,
+    resolve_clarification_selection_details,
+)
+from guards import is_unsupported_metadata_question
+from hermeneutic_intent import analyze_interpretive_intent
+from conversation_intent import ConversationIntent, detect_conversation_intent
+from engine import bootstrap_once
+from case_analysis import analyze_normative_case, is_normative_case_question
+from utils import clean_answer_text, normalize_for_search, topic_term_overlap
+
+NO_CLEAR_PROVISION = "Bu konuda mevcut MCKF corpus içinde incelenen kaynaklarda açık bir hüküm bulunamadı."
+CLARIFY_QUESTION = (
+    "Sorunuz tek başına hangi madde, kurum veya konu hakkında olduğunu yeterince belirtmiyor. "
+    "Lütfen yükseköğretim mevzuatı kapsamındaki kurumu, kanunu veya konuyu yazarak sorun; örneğin "
+    "`Dekan görevleri nelerdir?`, `Ek ders ücreti nasıl ödenir?` veya `Madde 16 neyi düzenler?`."
+)
+
+# "Bulunamadı" cevabına eklenen ilgili-madde önerileri için kalibrasyon
+# sabitleri. Bunlar bilinçli olarak MIN_EVIDENCE_SCORE'dan (clause_retrieval.py,
+# 8.0) çok daha düşük tutuldu: burada "kesin cevap" değil, "belki ilgili
+# olabilir" seviyesinde bir işaret veriyoruz. SUGGESTION_MIN_TERM_OVERLAP,
+# retrieval'ın alakasız maddeleri sırf skor tablosunda var diye önermesini
+# engelleyen son bir dürüstlük kontrolüdür.
+SUGGESTION_LIMIT = 3
+SUGGESTION_MIN_SCORE = 3.0
+# NOT: bu eşik topic_term_overlap()'a göre kalibre edildi (bkz. utils.py).
+# O fonksiyon artık "ilgili", "neler", "var" gibi genel kelimeleri hariç
+# tutuyor ve Türkçe ek varyasyonlarını (odenek/odenegin/odenekleri) prefix
+# eşleşmesiyle yakalıyor. Eski ham set-kesişimi ("ilgili" gibi kelimelerin
+# hemen her maddede geçmesi yüzünden) alakasız maddeleri yanlışlıkla
+# öneriyordu — bkz. sohbet geçmişindeki "ödeneklerle ilgili neler var"
+# örneği. 0.34 eşiği, soru tek/iki içerik kelimesi taşıdığında ikili
+# (0.0/1.0) davranışla uyumlu, boş-terim durumunda (topic_term_overlap'ın
+# döndürdüğü nötr 0.5) öneri göstermeye devam eder.
+SUGGESTION_MIN_TERM_OVERLAP = 0.34
+
+
+def no_clear_provision_answer() -> str:
+    return NO_CLEAR_PROVISION
+
+
+def _related_article_suggestions(question: str, clause_eval: dict | None) -> list[dict]:
+    """Return up to SUGGESTION_LIMIT distinct articles loosely related to the
+    question, even when no article cleared the confidence bar for a direct
+    answer. Each suggestion is a bare (document, article) pointer — no claim,
+    no synthesized text — so this can never introduce fabricated content.
+    """
+    clause_eval = clause_eval or {}
+    evidence_spans = clause_eval.get("evidence_spans", []) or []
+    if not evidence_spans:
+        return []
+
+    suggestions: list[dict] = []
+    seen_articles: set[tuple[str, str]] = set()
+    for evidence in evidence_spans:
+        score = float(evidence.get("_score", 0.0) or 0.0)
+        if score < SUGGESTION_MIN_SCORE:
+            continue
+        document_id = str(evidence.get("document_id", "") or "")
+        article_id = str(evidence.get("article_id", "") or "")
+        if not article_id:
+            continue
+        key = (document_id, article_id)
+        if key in seen_articles:
+            continue
+
+        overlap = topic_term_overlap(question, [str(evidence.get("source_text", "") or "")])
+        if overlap < SUGGESTION_MIN_TERM_OVERLAP:
+            continue
+
+        seen_articles.add(key)
+        suggestions.append({
+            "document_title": evidence.get("document_title", "") or document_id,
+            "article_id": article_id,
+            "article_title": evidence.get("article_title", "") or "",
+        })
+        if len(suggestions) >= SUGGESTION_LIMIT:
+            break
+    return suggestions
+
+
+def _format_suggestions_block(suggestions: list[dict]) -> str:
+    if not suggestions:
+        return ""
+    lines = []
+    for index, item in enumerate(suggestions, start=1):
+        title_part = f" ({item['article_title']})" if item.get("article_title") else ""
+        lines.append(f"{index}. {item['document_title']} — {item['article_id']}{title_part}")
+    return (
+        "Sorunuzla en alakalı olabilecek diğer maddeler (bu maddelerin sorunuzu "
+        "doğrudan yanıtladığı doğrulanmamıştır, yalnızca konu yakınlığına göre "
+        "listelenmiştir):\n" + "\n".join(lines)
+    )
+
+
+def _no_clear_provision_response(question: str, clause_eval: dict | None) -> tuple[str, str]:
+    """Build the abstention answer, enriched with related-article suggestions
+    when available. Returns (answer_text, analytics_status) so callers can
+    still distinguish a bare abstention from a suggestion-assisted one.
+    """
+    suggestions = _related_article_suggestions(question, clause_eval)
+    block = _format_suggestions_block(suggestions)
+    if not block:
+        return no_clear_provision_answer(), "no_clear_provision"
+    return f"{no_clear_provision_answer()}\n\n{block}", "no_clear_provision_with_suggestions"
+
+
+def answer_question(message: str, history=None, normativity_level=2) -> str:
+    question = (message or "").strip()
+    if not question:
+        return _answer_with_analytics(
+            "",
+            "Lütfen değerlendirmemi istediğiniz soruyu veya olayı yazın.",
+            "empty_message",
+        )
+    resolution = resolve_clarification_selection_details(question, history)
+    resolved_from_clarification = bool(resolution)
+    clarification_scopes = _clarification_source_scopes(resolution)
+    if resolution:
+        record_clarification_event(
+            "selection",
+            source_question=resolution.get("source_question", ""),
+            selected_key=resolution.get("selected_key", ""),
+            resolved_question=resolution.get("resolved_question", ""),
+            options=resolution.get("options", {}),
+            raw_message=question,
+        )
+        question = resolution.get("resolved_question", "") or question
+
+    direct_case_question = is_normative_case_question(question)
+    question = _contextualize_followup(question, history)
+
+    explicit_articles = _explicit_article_references(question)
+
+    conversation = detect_conversation_intent(question)
+    if conversation.intent != ConversationIntent.LEGAL_QUERY:
+        return _answer_with_analytics(question, conversation.answer, str(conversation.intent))
+
+    bootstrap_once()
+
+    if not resolved_from_clarification:
+        pre_retrieval_clarification = build_pre_retrieval_clarification(question)
+        if pre_retrieval_clarification:
+            return _answer_with_analytics(
+                question,
+                pre_retrieval_clarification,
+                "hermeneutic_intent_clarification",
+            )
+
+    case_result = analyze_normative_case(question) if direct_case_question else {}
+    if case_result:
+        return _answer_with_analytics(
+            question,
+            case_result.get("answer", ""),
+            "normative_case_analysis",
+            case_result,
+        )
+
+    if _needs_clarification(question):
+        return _answer_with_analytics(question, CLARIFY_QUESTION, "needs_clarification")
+
+    if is_unsupported_metadata_question(question):
+        return _answer_with_analytics(question, no_clear_provision_answer(), "unsupported_metadata")
+
+    allowed_articles = explicit_articles or [article_id for _document_id, article_id in clarification_scopes]
+    allowed_documents = [document_id for document_id, _article_id in clarification_scopes]
+    clause_eval = evaluate_clause_query(
+        question,
+        allowed_articles=allowed_articles or None,
+        allowed_documents=allowed_documents or None,
+        allowed_scopes=clarification_scopes or None,
+    )
+    proof_status = (clause_eval.get("proof_bundle", {}) or {}).get("status", "insufficient")
+    if proof_status != "supported":
+        clarification = "" if resolved_from_clarification else (
+            build_document_scope_clarification(question, clause_eval.get("evidence_spans", []))
+            or _validated_clarification(question, clause_eval)
+        )
+        if clarification:
+            return _answer_with_analytics(
+                question,
+                clarification,
+                "evidence_gate_clarification",
+                _suppress_public_sources(clause_eval),
+            )
+        answer_text, status = _no_clear_provision_response(question, clause_eval)
+        return _answer_with_analytics(
+            question,
+            answer_text,
+            status,
+            _suppress_public_sources(clause_eval),
+        )
+
+    calibrated_response, calibrated_status = _calibrated_evidence_gate(
+        question,
+        clause_eval,
+        skip=resolved_from_clarification or bool(explicit_articles),
+    )
+    if calibrated_response:
+        return _answer_with_analytics(
+            question,
+            calibrated_response,
+            calibrated_status,
+            _suppress_public_sources(clause_eval),
+        )
+
+    mckf_answer = answer_from_clauses(
+        question,
+        normativity_level,
+        allowed_articles=allowed_articles or None,
+        allowed_documents=allowed_documents or None,
+        allowed_scopes=clarification_scopes or None,
+    )
+    if mckf_answer:
+        if _answer_declares_no_clear_provision(mckf_answer):
+            clarification = "" if resolved_from_clarification else _validated_clarification(question, clause_eval)
+            if clarification:
+                return _answer_with_analytics(
+                    question,
+                    clarification,
+                    "answer_declined_clarification",
+                    _suppress_public_sources(clause_eval),
+                )
+            answer_text, status = _no_clear_provision_response(question, clause_eval)
+            return _answer_with_analytics(
+                question,
+                answer_text,
+                status,
+                _suppress_public_sources(clause_eval),
+            )
+        return _answer_with_analytics(question, mckf_answer, "source_grounded_answer", clause_eval)
+
+    clarification = "" if resolved_from_clarification else _validated_clarification(question, clause_eval)
+    if clarification:
+        return _answer_with_analytics(question, clarification, "low_confidence_clarification", _suppress_public_sources(clause_eval))
+
+    answer_text, status = _no_clear_provision_response(question, clause_eval)
+    return _answer_with_analytics(question, answer_text, status, _suppress_public_sources(clause_eval))
+
+
+def _answer_with_analytics(
+    question: str,
+    answer: str,
+    status: str,
+    clause_eval: dict | None = None,
+) -> str:
+    record_usage_event(question, answer, status, clause_eval)
+    return answer
+
+
+def _suppress_public_sources(clause_eval: dict | None) -> dict:
+    if not clause_eval:
+        return {}
+    cleaned = dict(clause_eval)
+    cleaned["candidate_source_ids"] = list(clause_eval.get("source_ids", []) or [])[:8]
+    cleaned["candidate_document_ids"] = list(clause_eval.get("document_ids", []) or [])[:8]
+    for key in ("evidence_ids", "clause_ids", "document_ids", "source_ids", "scores", "score_breakdowns"):
+        cleaned[key] = []
+    return cleaned
+
+
+def _answer_declares_no_clear_provision(answer: str) -> bool:
+    normalized = normalize_for_search(answer)
+    no_clear_signals = (
+        "acik bir hukum bulunamadi",
+        "acik hukum bulunamadi",
+        "hukum bulunamadi",
+        "duzenleyen bir madde icermez",
+        "dogrudan cevap vermiyor",
+        "dogrudan cevap veren bir hukum yok",
+    )
+    return any(signal in normalized for signal in no_clear_signals)
+
+
+def _clarification_source_scopes(resolution: dict | None) -> list[tuple[str, str]]:
+    metadata = (resolution or {}).get("option_metadata", {}) or {}
+    scopes = []
+    seen = set()
+    for item in metadata.get("source_scopes", []) or []:
+        scope = (
+            str(item.get("document_id", "") or ""),
+            str(item.get("article_id", "") or ""),
+        )
+        if not all(scope) or scope in seen:
+            continue
+        seen.add(scope)
+        scopes.append(scope)
+    return scopes
+
+
+def _contextualize_followup(question: str, history) -> str:
+    q = normalize_for_search(question)
+    # A substantive new question must never inherit the previous turn merely
+    # because it contains a conversational phrase such as "bununla ilgili".
+    # Only genuinely elliptical follow-ups are resolved against chat history.
+    content_tokens = [
+        token for token in q.split()
+        if token not in {
+            "peki", "bu", "bununla", "konuyla", "ilgili", "hakkinda", "herhangi",
+            "bir", "bilgi", "var", "mi", "mu", "midir", "nedir", "aciklar",
+            "yok", "konu", "kanunda", "kanunlarda", "kac", "donem", "kisi",
+            "uye", "hak", "hakki", "haklari", "ne", "nasil", "neden",
+        }
+        and not token.isdigit()
+    ]
+    if content_tokens:
+        return question
+    followup_signals = (
+        q.startswith("peki"),
+        q.startswith("bu konu"),
+        q.startswith("bununla ilgili"),
+        "3 kanunda" in q,
+        "uc kanunda" in q,
+        "herhangi bir bilgi yok mu" in q,
+    )
+    if not any(followup_signals):
+        return question
+
+    previous = _latest_substantive_user_question(history)
+    if not previous:
+        return question
+    return f"{previous}\n\nTakip sorusu: {question}"
+
+
+def _latest_substantive_user_question(history) -> str:
+    if not history:
+        return ""
+    for item in reversed(history):
+        if not isinstance(item, dict) or item.get("role") != "user":
+            continue
+        content = _history_content_text(item.get("content"))
+        normalized = normalize_for_search(content)
+        if len(normalized) < 55:
+            continue
+        if any(signal in normalized for signal in ("herhangi bir bilgi yok mu", "bu konuyla ilgili", "peki")):
+            continue
+        return content.strip()
+    return ""
+
+
+def _history_content_text(content) -> str:
+    if isinstance(content, str):
+        return content
+    if isinstance(content, list):
+        parts = []
+        for item in content:
+            if isinstance(item, dict):
+                text = item.get("text") or item.get("content") or ""
+                if text:
+                    parts.append(str(text))
+        return " ".join(parts)
+    return str(content or "")
+
+
+def evaluate_query(question: str) -> dict:
+    question = (question or "").strip()
+    explicit_articles = _explicit_article_references(question)
+
+    conversation = detect_conversation_intent(question)
+    if conversation.intent != ConversationIntent.LEGAL_QUERY:
+        return {
+            "question": question,
+            "answer": conversation.answer,
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "error": conversation.intent,
+        }
+
+    bootstrap_once()
+
+    pre_retrieval_clarification = build_pre_retrieval_clarification(question)
+    if pre_retrieval_clarification:
+        return {
+            "question": question,
+            "answer": pre_retrieval_clarification,
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "score_breakdowns": [],
+            "error": "hermeneutic_intent_clarification",
+        }
+
+    case_result = analyze_normative_case(question)
+    if case_result:
+        return {
+            "question": question,
+            **case_result,
+            "answer": clean_answer_text(case_result.get("answer", ""), question),
+            "error": "",
+        }
+
+    if _needs_clarification(question):
+        return {
+            "question": question,
+            "answer": CLARIFY_QUESTION,
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "error": "needs_clarification",
+        }
+
+    if is_unsupported_metadata_question(question):
+        return {
+            "question": question,
+            "answer": no_clear_provision_answer(),
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "error": "unsupported_metadata",
+        }
+
+    allowed_articles = explicit_articles
+    clause_eval = evaluate_clause_query(question, allowed_articles=allowed_articles or None)
+    proof_status = (clause_eval.get("proof_bundle", {}) or {}).get("status", "insufficient")
+    if proof_status != "supported":
+        clarification = (
+            build_document_scope_clarification(question, clause_eval.get("evidence_spans", []))
+            or _validated_clarification(question, clause_eval)
+        )
+        return {
+            "question": question,
+            "answer": clean_answer_text(clarification or no_clear_provision_answer(), question),
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "score_breakdowns": [],
+            "source_route": clause_eval.get("source_route", {}),
+            "candidate_source_ids": clause_eval.get("source_ids", [])[:8],
+            "error": "needs_clarification" if clarification else "no_confident_evidence",
+        }
+
+    calibrated_response, calibrated_status = _calibrated_evidence_gate(
+        question,
+        clause_eval,
+        skip=bool(explicit_articles),
+    )
+    if calibrated_response:
+        is_clarification = "MCKF_CLARIFY_OPTIONS" in calibrated_response
+        return {
+            "question": question,
+            "answer": clean_answer_text(calibrated_response, question),
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "score_breakdowns": [],
+            "source_route": clause_eval.get("source_route", {}),
+            "candidate_source_ids": clause_eval.get("source_ids", [])[:8],
+            "confidence_decision": calibrated_status,
+            "error": "needs_clarification" if is_clarification else "no_confident_evidence",
+        }
+
+    answer = answer_from_clauses(
+        question,
+        2,
+        allowed_articles=allowed_articles or None,
+        evidence_spans=clause_eval.get("evidence_spans", []),
+    )
+    if answer and _answer_declares_no_clear_provision(answer):
+        clarification = _validated_clarification(question, clause_eval)
+        return {
+            "question": question,
+            "answer": clean_answer_text(clarification or no_clear_provision_answer(), question),
+            "evidence_ids": [],
+            "clause_ids": [],
+            "document_ids": [],
+            "source_ids": [],
+            "scores": [],
+            "score_breakdowns": [],
+            "source_route": clause_eval.get("source_route", {}),
+            "candidate_source_ids": clause_eval.get("source_ids", [])[:8],
+            "error": "needs_clarification" if clarification else "no_confident_evidence",
+        }
+
+    if not answer:
+        answer = _validated_clarification(question, clause_eval)
+        if answer:
+            clause_eval = _suppress_public_sources(clause_eval)
+    return {
+        "question": question,
+        "answer": clean_answer_text(answer or no_clear_provision_answer(), question),
+        "evidence_ids": clause_eval.get("evidence_ids", []),
+        "clause_ids": clause_eval.get("clause_ids", []),
+        "document_ids": clause_eval.get("document_ids", []),
+        "source_ids": clause_eval.get("source_ids", []),
+        "scores": clause_eval.get("scores", []),
+        "score_breakdowns": clause_eval.get("score_breakdowns", []),
+        "source_route": clause_eval.get("source_route", {}),
+        "proof_bundle": clause_eval.get("proof_bundle", {}),
+        "error": "" if answer and "MCKF_CLARIFY_OPTIONS" not in answer else ("needs_clarification" if answer else "no_confident_evidence"),
+    }
+
+
+def _validated_clarification(question: str, clause_eval: dict | None) -> str:
+    clause_eval = clause_eval or {}
+
+    def candidate_is_answerable(resolved_question: str, article_id: str, document_id: str = "") -> bool:
+        validation = evaluate_clause_query(
+            resolved_question,
+            allowed_articles=[article_id],
+            allowed_documents=[document_id] if document_id else None,
+        )
+        spans = validation.get("evidence_spans", []) or []
+        if not spans:
+            return False
+        top = spans[0]
+        if str(top.get("article_id", "") or "") != article_id:
+            return False
+        if document_id and str(top.get("document_id", "") or "") != document_id:
+            return False
+        proof = validation.get("proof_bundle", {}) or {}
+        return proof.get("status") == "supported"
+
+    return build_low_confidence_clarification(
+        question,
+        clause_eval.get("evidence_spans", []),
+        candidate_validator=candidate_is_answerable,
+    ) or ""
+
+
+def _calibrated_evidence_gate(
+    question: str,
+    clause_eval: dict | None,
+    skip: bool = False,
+) -> tuple[str, str]:
+    if skip:
+        return "", ""
+    decision = evidence_confidence_decision(question, clause_eval)
+    if decision.get("action") == "answer":
+        return "", ""
+    if decision.get("action") == "clarify":
+        clarification = _validated_clarification(question, clause_eval)
+        if clarification:
+            return clarification, f"calibrated_clarification:{decision.get('reason', '')}"
+    # No validated option is safer than exposing a plausible but unrelated
+    # article. Public source identifiers are suppressed by the caller.
+    return no_clear_provision_answer(), f"calibrated_abstention:{decision.get('reason', '')}"
+
+
+def _explicit_article_references(question: str) -> list[str]:
+    q = question or ""
+    refs: list[str] = []
+    for match in re.finditer(r"\bGe[cç]ici\s+Madde\s+(\d+(?:/[A-Za-zÇĞİÖŞÜçğıöşü])?)\b", q, flags=re.IGNORECASE):
+        ref = f"Geçici Madde {match.group(1).upper()}"
+        if ref not in refs:
+            refs.append(ref)
+    for match in re.finditer(r"\bEk\s+Madde\s+(\d+)\b", q, flags=re.IGNORECASE):
+        refs.append(f"Ek Madde {match.group(1)}")
+    for match in re.finditer(r"\bMadde\s+(\d+(?:/[A-Za-zÇĞİÖŞÜçğıöşü])?)\b", q, flags=re.IGNORECASE):
+        prefix = q[max(0, match.start() - 8):match.start()].strip().lower()
+        if prefix.endswith("ek") or prefix.endswith("geçici") or prefix.endswith("gecici"):
+            continue
+        ref = f"Madde {match.group(1).upper()}"
+        if ref not in refs:
+            refs.append(ref)
+    return refs
+
+
+def _needs_clarification(question: str) -> bool:
+    q = (question or "").strip().lower()
+    if _explicit_article_references(question):
+        return False
+    interpretation = analyze_interpretive_intent(question)
+    if interpretation and not interpretation.get("requires_clarification"):
+        return False
+    normalized = re.sub(r"\s+", " ", q)
+    normalized_search = normalize_for_search(question)
+    vague_topic_phrases = (
+        "devam kosulu",
+        "devam sarti",
+        "kurulus nasil",
+        "nasil kurulur",
+    )
+    named_scope_terms = (
+        "universite", "enstitu", "fakulte", "yuksekokul", "program", "ders",
+        "ogrenci", "akademik personel", "ogretim elemani", "2547", "2914", "2809",
+    )
+    if any(phrase in normalized_search for phrase in vague_topic_phrases):
+        if not any(term in normalized_search for term in named_scope_terms):
+            return True
+    vague_followups = {
+        "peki", "peki ya", "bunlar", "bunu açıkla", "devam", "detaylandır",
+        "görevleri", "yetkileri", "şartları", "koşulları", "nasıl", "nedir",
+        "kim atar", "kaç kişi", "kaç üye",
+    }
+    if normalized in vague_followups:
+        return True
+    words = [word for word in re.findall(r"\w+", normalized, flags=re.UNICODE) if len(word) >= 3]
+    legal_anchors = (
+        "2547", "2914", "2809", "yök", "yuksek", "yüksek", "universite", "üniversite", "dekan", "rektor", "rektör",
+        "senato", "fakulte", "fakülte", "ogrenci", "öğrenci", "ogretim", "öğretim",
+        "diploma", "lisans", "disiplin", "vakıf", "vakif", "kurul", "madde",
+        "ek ders", "ödenek", "odenek", "derece", "kademe", "teşkilat", "teskilat",
+    )
+    has_anchor = any(anchor in normalized for anchor in legal_anchors)
+    return len(words) <= 2 and not has_anchor

app.py

@@ -0,0 +1,8 @@
+from ui_gradio import CUSTOM_CSS, create_demo
+
+
+demo = create_demo()
+
+
+if __name__ == "__main__":
+    demo.launch(css=CUSTOM_CSS)

case_analysis.py

@@ -0,0 +1,400 @@
+from __future__ import annotations
+
+import re
+from typing import Any
+
+from clause_retrieval import evidence_spans_matching
+from sources import format_clause_sources
+from utils import normalize_for_search
+
+
+CASE_RULES = {
+    "student_status_and_remedy": {
+        "triggers": (
+            "kaydinin sil", "kaydi sil", "ilisigi kes", "kayit sil", "itiraz",
+            "uyaril", "teblig", "bildiril", "mazeret",
+        ),
+        "evidence_selectors": (
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 44",
+                "label": "b",
+                "contains_all": ("azami süreler içinde", "kayıt yenilenmemesi", "ilişikleri kesilmez"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 44",
+                "label": "b",
+                "contains_all": ("dört yıl üst üste", "yetkili kurullarının kararı", "ilişikleri kesilebilir"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 54",
+                "label": "ç",
+                "contains_all": ("disiplin cezalarına karşı", "on beş gün", "itiraz edilebilir"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 54",
+                "label": "e",
+                "contains_all": ("itiraz hakkı kullanılmadan", "idari yargı"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 54",
+                "label": "11",
+                "contains_all": ("öğrenciye yapılacak tebligatta", "Tebligat Kanunu"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 14",
+                "label": "6",
+                "contains_all": ("enstitü", "kararlarına yapılacak itirazları", "karara bağlamak"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 15",
+                "label": "4",
+                "contains_all": ("enstitü", "yönetim kurullarının kararlarına", "kesin karara bağlamak"),
+            },
+        ),
+    },
+    "student_excuse_period": {
+        "triggers": ("mazeret", "mazeret hakki", "mazeret izni"),
+        "evidence_selectors": (
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 46",
+                "label": "g",
+                "contains_all": ("mazeretleri", "yönetim kurulunca kabul edilmeyenler", "kayıt yaptıramaz"),
+            },
+        ),
+    },
+    "graduation_and_registration": {
+        "triggers": (
+            "mezun", "diploma", "ders sec", "ders kay", "kayit yaptir",
+            "tez dersi", "uzmanlik dersi", "kredi", "yukumluluk",
+        ),
+        "evidence_selectors": (
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 44",
+                "label": "a",
+                "contains_all": ("ders kredileri", "diğer yükümlülükleri", "tamamlamaları halinde"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 44",
+                "label": "b",
+                "contains_all": ("kayıt", "tez", "teorik ders"),
+            },
+        ),
+    },
+    "academic_guidance": {
+        "triggers": ("danisman", "ogretim uyes", "rehber", "tez"),
+        "evidence_selectors": (
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 22",
+                "label": "c",
+                "contains_all": ("yardım etmek", "yol göstermek", "rehberlik etmek"),
+            },
+        ),
+    },
+    "institute_governance": {
+        "triggers": ("enstitu", "mudurluk", "yonetim kurulu", "ogrenci isleri"),
+        "evidence_selectors": (
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 19",
+                "label": "b",
+                "contains_all": ("enstitü müdürü", "görevleri", "enstitü bakımından"),
+            },
+            {
+                "document_id": "TR-KANUN-2547",
+                "article_id": "Madde 19",
+                "label": "e",
+                "contains_all": ("enstitü kurulu", "yönetim kurulu", "görevleri"),
+            },
+        ),
+    },
+}
+
+
+def is_normative_case_question(question: str) -> bool:
+    q = normalize_for_search(question)
+    if len(q) < 150:
+        return False
+    assessment_signal = any(
+        signal in q
+        for signal in (
+            "kim sorumlu", "kimler sorumlu", "sorumluluklarini yapmamis",
+            "sorumlulugunu yerine getirmemis", "burada kim", "bu durumda kim",
+            "hukuken degerlendir", "mevzuata gore degerlendir",
+            "hangi kanun maddelerinden yararlanabilir", "itiraz etmek istiyor",
+            "kaydinin silinecegi", "ilisiginin kesilecegi",
+        )
+    )
+    narrative_signal_count = sum(
+        signal in q
+        for signal in (
+            "ancak", "daha sonra", "son asama", "son donem", "boyunca",
+            "halde", "diyor", "ise", "cunku",
+        )
+    )
+    actor_count = sum(
+        actor in q
+        for actor in ("ogrenci", "danisman", "enstitu", "universite", "yonetim", "senato")
+    )
+    institutional_action = any(
+        signal in q for signal in ("bildiriliyor", "bildirildi", "kaydinin sil", "ilisigi kes", "itiraz")
+    )
+    return assessment_signal and narrative_signal_count >= 1 and (
+        actor_count >= 2 or (actor_count >= 1 and institutional_action)
+    )
+
+
+def analyze_normative_case(question: str) -> dict[str, Any]:
+    if not is_normative_case_question(question):
+        return {}
+
+    normalized = normalize_for_search(question)
+    matched_rules = [
+        rule_name
+        for rule_name, rule in CASE_RULES.items()
+        if any(trigger in normalized for trigger in rule["triggers"])
+    ]
+    evidence_selectors: list[dict[str, Any]] = []
+    for rule_name in matched_rules:
+        for selector in CASE_RULES[rule_name]["evidence_selectors"]:
+            if selector not in evidence_selectors:
+                evidence_selectors.append(selector)
+
+    evidence_spans = evidence_spans_matching(evidence_selectors)
+    if not evidence_spans:
+        return {}
+
+    explicit_actors = _case_actors(normalized)
+    inferred_actors = _inferred_case_actors(normalized, explicit_actors)
+    actors = explicit_actors + [actor for actor in inferred_actors if actor not in explicit_actors]
+    facts = _case_facts(question)
+    answer = _render_case_assessment(question, matched_rules, actors, facts, evidence_spans)
+    return {
+        "answer": answer,
+        "case_frame": {
+            "actors": actors,
+            "explicit_actors": explicit_actors,
+            "inferred_actors": inferred_actors,
+            "facts": facts,
+            "matched_rules": matched_rules,
+            "responsibility_tests": _responsibility_tests(actors),
+            "missing_evidence": _missing_evidence(),
+            "assessment_mode": "source_locked_multi_hop",
+        },
+        "evidence_spans": evidence_spans,
+        "evidence_ids": [item.get("evidence_id", "") for item in evidence_spans],
+        "clause_ids": _unique(item.get("parent_clause_id", "") for item in evidence_spans),
+        "document_ids": _unique(item.get("document_id", "") for item in evidence_spans),
+        "source_ids": _unique(item.get("article_id", "") for item in evidence_spans),
+        "scores": [20.0 for _ in evidence_spans],
+        "score_breakdowns": [{"case_rule_match": 1.0} for _ in evidence_spans],
+        "source_route": {"route": "normative_case_analysis"},
+    }
+
+
+def _render_case_assessment(
+    question: str,
+    matched_rules: list[str],
+    actors: list[str],
+    facts: list[str],
+    evidence_spans: list[dict[str, Any]],
+) -> str:
+    if "student_status_and_remedy" in matched_rules or "student_excuse_period" in matched_rules:
+        return _render_student_status_remedy_assessment(question, facts, evidence_spans)
+
+    has_graduation = "graduation_and_registration" in matched_rules
+    has_guidance = "academic_guidance" in matched_rules
+    has_institute = "institute_governance" in matched_rules
+
+    sections = [
+        "**Normatif vaka değerlendirmesi**",
+        "",
+        "Bu olayda tek bir kişiyi doğrudan sorumlu ilan etmek mevcut corpusla mümkün değil. "
+        "2547 sayılı Kanun sorumluluk çerçevesini kuruyor; fakat tez dersi ve uzmanlık alan dersi "
+        "kaydını kimin kontrol edeceği üniversitenin lisansüstü yönetmeliği, senato kararları ve "
+        "enstitü iş akışında belirlenir.",
+    ]
+
+    if facts:
+        sections.extend(["", "**Sistemin ayırdığı olay unsurları**"])
+        sections.extend(f"- {fact}" for fact in facts[:5])
+
+    sections.extend(["", "**Kanundan kesin olarak çıkarılabilenler**"])
+    if has_graduation:
+        sections.extend([
+            "1. **Mezuniyet koşulu:** Madde 44/a uyarınca öğrenci, belirlenen ders kredileri ile "
+            "diğer yükümlülükleri başarıyla tamamlamadan diploma hakkı kazanmaz.",
+            "2. **Yerel düzenleme zorunluluğu:** Madde 44/b; kayıt, devam, tez ve teorik ders "
+            "içerikleri ile diploma alınmasına ilişkin ayrıntıları, YÖK'ün temel ilkelerine uygun "
+            "olarak üniversite senatosunun düzenlemesine bırakır. Bu nedenle yalnızca 2547'ye "
+            "bakarak 'tez dersi seçilmemişse her durumda mezuniyet imkansızdır' denemez; ilgili "
+            "üniversite düzenlemesi de görülmelidir.",
+        ])
+    if has_guidance:
+        sections.append(
+            "3. **Akademik rehberlik:** Madde 22/c öğretim üyesine öğrenciye gerekli konularda "
+            "yardım etme, yol gösterme ve rehberlik etme görevi verir. Bu genel görev danışmanın "
+            "süreçte tamamen ilgisiz sayılamayacağını gösterir; ancak ders kaydını kontrol veya "
+            "onay yükümlülüğünü tek başına kanıtlamaz."
+        )
+    if has_institute:
+        sections.append(
+            "4. **Enstitü yönetimi:** Madde 19, enstitü müdürü ile enstitü kurulu ve yönetim "
+            "kurulunun enstitü bakımından yönetsel görev taşıdığını gösterir. Buna karşılık dönemlik "
+            "ders kaydını hangi personelin doğrulayacağını bu madde açıkça söylemez."
+        )
+
+    sections.extend([
+        "",
+        "**Aktör bazlı sorumluluk testi**",
+        "- **Öğrenci - koşullu sorumluluk:** Üniversite düzenlemesi tez ve uzmanlık alan dersini "
+        "seçmeyi açıkça öğrenciye yüklüyorsa, öğrencinin kayıt yükümlülüğünü yerine getirmediği "
+        "söylenebilir. Tezin fiilen tamamlanmış olması, kayıt yükümlülüğünü kendiliğinden ortadan kaldırmaz.",
+        "- **Danışman - olası rehberlik/süreç sorumluluğu:** Danışmanın ders seçimini onaylama veya "
+        "izleme görevi yerel düzenlemede ya da bilgi sistemi iş akışında varsa sorumluluğu doğabilir. "
+        "Mevcut corpus yalnızca genel rehberlik görevini kanıtlıyor; somut ihlal için yeterli değil.",
+        "- **Enstitü/anabilim dalı/idare - olası kontrol sorumluluğu:** Öğrencinin bir dönem tez "
+        "çalışmasını yürütmesine izin verildiği, danışmanlık ve ilerleme işlemlerinin kayda alındığı "
+        "halde ders eksikliğinin yalnız mezuniyet aşamasında fark edilmesi bir süreç kontrol boşluğuna "
+        "işaret eder. Bunun hukuki veya idari sorumluluğa dönüşmesi, yerel görev ve onay kurallarına bağlıdır.",
+        "",
+        "**Sonuç**",
+        "Mevcut kanun corpusuna göre en güvenilir sonuç, öğrencinin olası kayıt eksikliği yanında "
+        "danışman ve enstitü süreçlerinde de olası gözetim/kontrol eksikliği bulunduğudur. Ancak "
+        "sorumluluğun kesin dağılımı yapılamaz. Kesin karar için üniversitenin Lisansüstü Eğitim ve "
+        "Öğretim Yönetmeliği, enstitü usul ve esasları, senato kararları, danışman onay akışı ve "
+        "öğrenci bilgi sistemi kayıtları corpusa eklenmelidir.",
+    ])
+
+    answer = "\n".join(sections)
+    sources = format_clause_sources(evidence_spans, question=question, answer=answer)
+    return f"{answer}\n\n---\n\n**Kaynaklar**\n{sources}"
+
+
+def _render_student_status_remedy_assessment(
+    question: str,
+    facts: list[str],
+    evidence_spans: list[dict[str, Any]],
+) -> str:
+    q = normalize_for_search(question)
+    asks_excuse_period = "mazeret" in q and any(term in q for term in ("kac", "donem", "sure"))
+
+    if asks_excuse_period:
+        sections = [
+            "İncelenen 2547, 2914 ve 2809 sayılı kanunlarda öğrencilere tanınmış "
+            "genel ve sabit bir ‘kaç dönem mazeret hakkı’ bulunmuyor.",
+            "",
+            "2547 sayılı Kanunun 46/g maddesi yalnızca katkı payı veya öğrenim ücretini süresinde "
+            "ödemeyen öğrencinin mazeretinin ilgili yükseköğretim kurumu yönetim kurulunca kabul "
+            "edilebileceğini düzenler; mazeretin kaç dönem süreceğini belirlemez. Akademik kayıt, "
+            "izin ve mazeret dönemlerinin sayısı üniversitenin eğitim-öğretim veya lisansüstü "
+            "yönetmeliğinden kontrol edilmelidir.",
+        ]
+    else:
+        sections = [
+            "**Normatif vaka değerlendirmesi**",
+            "",
+            "Kayıt silme işleminin hukuki sebebi belirtilmeden tek bir itiraz maddesi seçmek doğru "
+            "olmaz. Ancak mevcut corpus öğrencinin dayanabileceği hükümleri üç ihtimale ayırıyor:",
+            "",
+            "1. **Kayıt yenilememe veya ücret ödememe gerekçesi:** Madde 44/c'ye göre azami süre "
+            "içinde yalnızca katkı payının/öğrenim ücretinin ödenmemesi veya kayıt yenilenmemesi "
+            "öğrencinin ilişiğinin kesilmesine yetmez. Dört yıl üst üste bu durumun yaşanması halinde "
+            "ise yetkili üniversite kurulu kararı ve YÖK onayıyla ilişik kesilebilir.",
+            "2. **Disiplin cezası gerekçesi:** İşlem bir öğrenci disiplin cezasıysa Madde 54 uyarınca "
+            "on beş gün içinde üniversite yönetim kuruluna itiraz edilebilir; ayrıca bu itiraz "
+            "kullanılmadan idari yargıya da başvurulabilir. Öğrenciye yapılacak tebligatta kural olarak "
+            "7201 sayılı Tebligat Kanunu uygulanır.",
+            "3. **Enstitü veya fakülte kurulu kararı:** Madde 14/6 ve Madde 15/4, kurulun türüne göre "
+            "senato veya üniversite y��netim kurulunun itirazı inceleme yetkisini düzenler.",
+            "",
+            "**Uyarılmama iddiası**",
+            "2547 sayılı Kanun akademik nedenle kayıt silmeden önce her durumda ayrıca bir uyarı "
+            "yapılmasını açık ve genel bir şart olarak koymuyor. Bu nedenle ‘uyarılmadım’ iddiası "
+            "tek başına işlemi geçersiz kılmaz; kararın yazılı gerekçesi, dayandığı madde, tebliğ "
+            "tarihi ve üniversitenin öğrenci/lisansüstü yönetmeliği birlikte incelenmelidir.",
+            "",
+            "**Pratik sonuç:** Öğrenci önce işlemin disiplin cezası mı, azami süre/kayıt yenilememe "
+            "işlemi mi, yoksa enstitü yönetim kurulu kararı mı olduğunu yazılı olarak istemelidir. "
+            "Doğru itiraz mercii ve süre bu ayrımdan sonra belirlenebilir.",
+        ]
+
+    answer = "\n".join(sections)
+    source_evidence = evidence_spans
+    if asks_excuse_period:
+        source_evidence = [item for item in evidence_spans if item.get("article_id") == "Madde 46"]
+    sources = format_clause_sources(source_evidence, question=question, answer=answer)
+    return f"{answer}\n\n---\n\n**Kaynaklar**\n{sources}"
+
+
+def _case_actors(normalized_question: str) -> list[str]:
+    actor_terms = (
+        ("ogrenci", "öğrenci"),
+        ("danisman", "danışman"),
+        ("enstitu", "enstitü"),
+        ("anabilim dali", "anabilim dalı"),
+        ("ogrenci isleri", "öğrenci işleri"),
+        ("senato", "senato"),
+        ("universite", "üniversite"),
+    )
+    return [label for token, label in actor_terms if token in normalized_question]
+
+
+def _inferred_case_actors(normalized_question: str, explicit_actors: list[str]) -> list[str]:
+    inferred = []
+    if "tez" in normalized_question and "öğrenci" in explicit_actors and "danışman" not in explicit_actors:
+        inferred.append("danışman")
+    return inferred
+
+
+def _case_facts(question: str) -> list[str]:
+    cleaned = re.sub(r"\s+", " ", question).strip()
+    parts = re.split(r"(?<=[.!?])\s+|\s+(?:ancak|fakat|ama)\s+", cleaned, flags=re.IGNORECASE)
+    facts = []
+    for part in parts:
+        fact = part.strip(" .?!\"")
+        if len(fact) < 20 or "kimler soruml" in normalize_for_search(fact):
+            continue
+        facts.append(fact)
+    return facts
+
+
+def _responsibility_tests(actors: list[str]) -> list[dict[str, str]]:
+    tests = {
+        "öğrenci": ("conditional", "Yerel düzenlemedeki ders kayıt yükümlülüğü doğrulanmalı."),
+        "danışman": ("insufficient", "Ders seçimini onaylama veya izleme görevi doğrulanmalı."),
+        "enstitü": ("insufficient", "Kayıt ve mezuniyet kontrol iş akışındaki görev doğrulanmalı."),
+    }
+    return [
+        {"actor": actor, "status": tests[actor][0], "test": tests[actor][1]}
+        for actor in actors
+        if actor in tests
+    ]
+
+
+def _missing_evidence() -> list[str]:
+    return [
+        "Üniversite Lisansüstü Eğitim ve Öğretim Yönetmeliği",
+        "Enstitü usul ve esasları",
+        "Senato kararları",
+        "Danışman ders onay iş akışı",
+        "Öğrenci bilgi sistemi işlem kayıtları",
+    ]
+
+
+def _unique(values) -> list[str]:
+    result = []
+    for value in values:
+        if value and value not in result:
+            result.append(value)
+    return result

clarification.py

@@ -0,0 +1,637 @@
+from __future__ import annotations
+
+import json
+import re
+from typing import Any, Callable
+
+from hermeneutic_intent import build_grounded_interpretation_options
+from intent import detect_actors
+from normative_metadata import semantic_address_score
+from query_understanding import expand_query_terms
+from utils import normalize_for_search, topic_term_overlap
+
+
+MARKER = "MCKF_CLARIFY_OPTIONS:"
+_CLICK_TARGETS: dict[str, dict[str, str]] = {}
+
+# The proof bundle's 0.55 threshold means "some grounded support exists". It
+# is deliberately not strong enough for an autonomous user-facing answer.
+# This gate is calibrated against the three-document golden set and operates
+# on article-level competition, not adjacent evidence fragments.
+ANSWER_SUPPORT_THRESHOLD = 0.68
+COMPETING_ARTICLE_MARGIN = 4.0
+COMPETING_ARTICLE_RATIO = 0.82
+MIN_OPTION_SCORE = 8.9
+MIN_OPTION_SCORE_RATIO = 0.62
+MIN_SEMANTIC_RELEVANCE = 0.66
+
+
+def resolve_clarification_selection(message: str, history: Any) -> str:
+    resolved = resolve_clarification_selection_details(message, history)
+    return resolved.get("resolved_question", "") if resolved else ""
+
+
+def resolve_clarification_selection_details(message: str, history: Any) -> dict[str, Any]:
+    payload = _latest_payload(history)
+    selection = _selection_key(message, payload)
+    options = payload.get("options", {}) if payload else {}
+    resolved_question = options.get(selection, "") if selection else ""
+    if not resolved_question:
+        click_target = _CLICK_TARGETS.get(normalize_for_search(message), {})
+        if click_target:
+            return {
+                "selected_key": click_target.get("selected_key", ""),
+                "resolved_question": click_target.get("resolved_question", ""),
+                "source_question": click_target.get("source_question", ""),
+                "clarification_type": click_target.get("clarification_type", ""),
+                "option_metadata": click_target.get("option_metadata", {}),
+                "options": {},
+            }
+    if not resolved_question:
+        return {}
+    return {
+        "selected_key": selection,
+        "resolved_question": resolved_question,
+        "source_question": payload.get("source_question", "") if payload else "",
+        "clarification_type": payload.get("clarification_type", "") if payload else "",
+        "option_metadata": (payload.get("option_metadata", {}) or {}).get(selection, {}) if payload else {},
+        "options": options,
+    }
+
+
+def build_pre_retrieval_clarification(question: str) -> str:
+    """Clarify materially different legal mechanisms before retrieval.
+
+    Options are emitted only after hermeneutic_intent verifies that their
+    grounding phrases exist in the active corpus.
+    """
+    interpretation = build_grounded_interpretation_options(question)
+    choices = interpretation.get("options", []) if interpretation else []
+    if not choices:
+        return ""
+    options = {str(index): item.get("resolved_question", "") for index, item in enumerate(choices, start=1)}
+    visible = {str(index): item.get("label", "") for index, item in enumerate(choices, start=1)}
+    metadata = {str(index): item.get("metadata", {}) for index, item in enumerate(choices, start=1)}
+    return _render_options(
+        str(interpretation.get("prompt", "") or ""),
+        options,
+        visible_options=visible,
+        source_question=question,
+        clarification_type=f"hermeneutic:{interpretation.get('family_id', '')}",
+        option_metadata=metadata,
+    )
+
+
+def build_document_scope_clarification(question: str, candidates: list[dict[str, Any]] | None = None) -> str:
+    """Disambiguate an article number that exists in more than one source document."""
+    candidates = candidates or []
+    options = []
+    seen = set()
+    for item in candidates:
+        channels = ((item.get("_score_breakdown", {}) or {}).get("channels", {}) or {})
+        if "exact_reference" not in channels:
+            continue
+        document_id = str(item.get("document_id", "") or "")
+        article_id = str(item.get("article_id", "") or "")
+        key = f"{document_id}::{article_id}"
+        if not document_id or not article_id or key in seen:
+            continue
+        seen.add(key)
+        document_title = str(item.get("document_title", "") or document_id)
+        article_title = str(item.get("article_title", "") or "")
+        resolved = f"{question} ({document_title}, {article_id})"
+        label = " - ".join(part for part in (document_title, article_id, article_title) if part)
+        options.append((resolved, label))
+    if len(options) < 2:
+        return ""
+    machine = {str(index): resolved for index, (resolved, _label) in enumerate(options[:3], start=1)}
+    visible = {str(index): label for index, (_resolved, label) in enumerate(options[:3], start=1)}
+    return _render_options(
+        "Bu madde numarası birden fazla kaynak belgede bulunuyor. Hangi kanunu kastettiğinizi seçer misiniz?",
+        machine,
+        visible_options=visible,
+        source_question=question,
+        clarification_type="document_scope",
+    )
+
+
+def build_low_confidence_clarification(
+    question: str,
+    candidates: list[dict[str, Any]] | None = None,
+    candidate_validator: Callable[..., bool] | None = None,
+) -> str:
+    domain_clarification = _domain_specific_clarification(question, candidate_validator)
+    if domain_clarification:
+        return domain_clarification
+
+    candidates = candidates or []
+    distinct = []
+    for item in _distinct_grounded_article_candidates(question, candidates, limit=3):
+        article = str(item.get("article_id", "") or "")
+        document_id = str(item.get("document_id", "") or "")
+        document_title = str(item.get("document_title", "") or document_id).strip()
+        title = str(item.get("article_title", "") or item.get("title", "") or item.get("norm_type", "") or "").strip()
+        scope = " - ".join(part for part in (document_title, article, title) if part)
+        resolved_question = f"{scope} kapsamında şu soruyu yanıtla: {question}"
+        if candidate_validator:
+            try:
+                valid = candidate_validator(resolved_question, article, document_id)
+            except TypeError:
+                valid = candidate_validator(resolved_question, article)
+            if not valid:
+                continue
+        label = f"{document_title} - {article} - {title}".strip(" -")
+        distinct.append((article, label, resolved_question))
+
+    if not distinct:
+        return ""
+
+    options = {
+        str(index): resolved_question
+        for index, (_article, _label, resolved_question) in enumerate(distinct, start=1)
+    }
+    visible = {
+        str(index): f"{_label}"
+        for index, (_article, _label, _resolved_question) in enumerate(distinct, start=1)
+    }
+    prompt = (
+        "Bu soruda birden fazla doğrulanabilir düzenleme yakın görünüyor. "
+        "Yanlış kaynak göstermemek için hangisini kastettiğinizi seçer misiniz?"
+        if len(distinct) >= 2
+        else
+        "Sorunuzla corpus içinde en yakın doğrulanabilir düzenleme aşağıdaki madde. Bunu mu kastettiniz?"
+    )
+    return _render_options(
+        prompt,
+        options,
+        visible_options=visible,
+        source_question=question,
+        clarification_type="low_confidence",
+    )
+
+
+def should_request_evidence_clarification(
+    question: str,
+    clause_eval: dict[str, Any] | None,
+    allow_domain_specific: bool = True,
+) -> bool:
+    decision = evidence_confidence_decision(
+        question,
+        clause_eval,
+        allow_domain_specific=allow_domain_specific,
+    )
+    return decision["action"] == "clarify"
+
+
+def evidence_confidence_decision(
+    question: str,
+    clause_eval: dict[str, Any] | None,
+    allow_domain_specific: bool = True,
+) -> dict[str, Any]:
+    """Choose answer/clarify/abstain for every retrieval result.
+
+    Retrieval confidence is evaluated at the legal-provision level. Multiple
+    evidence fragments from one article cannot hide a close competing article,
+    and a high fused score cannot cure weak semantic-address relevance.
+    """
+    clause_eval = clause_eval or {}
+    evidence_spans = clause_eval.get("evidence_spans", []) or []
+    proof = clause_eval.get("proof_bundle", {}) or {}
+    proof_status = str(proof.get("status", "insufficient") or "insufficient")
+    support = proof.get("support", {}) or {}
+    support_score = float(support.get("score", 0.0) or 0.0)
+    signals = support.get("signals", {}) or {}
+    q = normalize_for_search(question)
+
+    if not evidence_spans:
+        return _confidence_result("abstain", "no_evidence", support_score)
+
+    if allow_domain_specific and _looks_like_amnesty_query(q):
+        return _confidence_result("clarify", "domain_term_requires_confirmation", support_score)
+
+    if proof_status != "supported":
+        return _confidence_result("clarify", "proof_not_supported", support_score)
+
+    top = evidence_spans[0]
+    top_breakdown = top.get("_score_breakdown", {}) or {}
+    top_channels = top_breakdown.get("channels", {}) or {}
+    if "exact_reference" in top_channels:
+        return _confidence_result("answer", "exact_reference", support_score)
+
+    if _is_explicit_multi_document_question(q):
+        if support_score >= ANSWER_SUPPORT_THRESHOLD:
+            return _confidence_result("answer", "explicit_multi_document_scope", support_score)
+        return _confidence_result("clarify", "weak_multi_document_support", support_score)
+
+    if support_score < ANSWER_SUPPORT_THRESHOLD:
+        return _confidence_result("clarify", "support_below_answer_threshold", support_score)
+
+    grounded = _distinct_grounded_article_candidates(question, evidence_spans, limit=5)
+    if not grounded:
+        return _confidence_result("abstain", "no_semantically_grounded_article", support_score)
+
+    top_grounded = grounded[0]
+    top_score = float(top_grounded.get("_score", 0.0) or 0.0)
+    top_relevance = _candidate_semantic_relevance(question, top_grounded)
+    address_match = semantic_address_score(question, top_grounded.get("_semantic_address", {}) or {})
+    article_hint = float(top_breakdown.get("article_hint_score", 0.0) or 0.0)
+    route = clause_eval.get("source_route", {}) or {}
+    route_targets = route.get("target_articles_by_document", {}) or {}
+    routed_article = any(
+        str(top_grounded.get("article_id", "") or "") in (articles or [])
+        for articles in route_targets.values()
+    )
+
+    # The top raw result must itself be the best grounded provision. Otherwise
+    # a named-institution or generic-title hit may be masking the real result.
+    top_scope = _article_scope(top)
+    if top_scope != _article_scope(top_grounded):
+        return _confidence_result("clarify", "ungrounded_top_result", support_score)
+
+    competitors = [item for item in grounded[1:] if _article_scope(item) != _article_scope(top_grounded)]
+    close_competitor = None
+    for competitor in competitors:
+        competitor_score = float(competitor.get("_score", 0.0) or 0.0)
+        competitor_relevance = _candidate_semantic_relevance(question, competitor)
+        score_ratio = competitor_score / max(top_score, 0.0001)
+        if (
+            competitor_relevance >= MIN_SEMANTIC_RELEVANCE
+            and (
+                top_score - competitor_score < COMPETING_ARTICLE_MARGIN
+                or score_ratio >= COMPETING_ARTICLE_RATIO
+            )
+        ):
+            close_competitor = competitor
+            break
+
+    if close_competitor:
+        return _confidence_result("clarify", "competing_grounded_articles", support_score)
+
+    if (
+        top_relevance < MIN_SEMANTIC_RELEVANCE
+        and address_match < MIN_SEMANTIC_RELEVANCE
+        and article_hint <= 0
+        and not routed_article
+        and not _has_triangulated_grounding(top_grounded, top_relevance, top_score)
+    ):
+        return _confidence_result("clarify", "weak_semantic_relevance", support_score)
+
+    if int(signals.get("channel_consensus", 0) or 0) < 2 and not routed_article:
+        return _confidence_result("clarify", "weak_channel_consensus", support_score)
+
+    return _confidence_result("answer", "calibrated_support", support_score)
+
+
+def _domain_specific_clarification(
+    question: str,
+    candidate_validator: Callable[[str, str], bool] | None = None,
+) -> str:
+    q = normalize_for_search(question)
+    if _looks_like_amnesty_query(q):
+        resolved_question = (
+            "2547 sayili Kanun Gecici Madde 83 kapsaminda ilisigi kesilen "
+            "ogrencilerin basvuru ve yeniden ogrenime baslama haklari nasil duzenlenir?"
+        )
+        if candidate_validator and not candidate_validator(resolved_question, "Geçici Madde 83"):
+            return ""
+        return _render_options(
+            "Genel af hakkında corpus içinde doğrudan bir hüküm yok. Aşağıdaki corpus hükmünü mü kastediyorsunuz?",
+            {
+                "1": resolved_question,
+            },
+            visible_options={
+                "1": "Öğrenci affı olarak bilinen geçici başvuru ve yeniden kayıt hakları (Geçici Madde 83)",
+            },
+            source_question=question,
+            clarification_type="domain_amnesty",
+        )
+
+    return ""
+
+
+def _distinct_grounded_article_candidates(
+    question: str,
+    candidates: list[dict[str, Any]],
+    limit: int = 3,
+) -> list[dict[str, Any]]:
+    if not candidates:
+        return []
+    top_score = float(candidates[0].get("_score", 0.0) or 0.0)
+    distinct = []
+    seen = set()
+    for item in candidates[:16]:
+        scope = _article_scope(item)
+        if not all(scope) or scope in seen:
+            continue
+        if not _is_grounded_ambiguity_candidate(question, item, top_score):
+            continue
+        seen.add(scope)
+        distinct.append(item)
+        if len(distinct) >= limit:
+            break
+    return distinct
+
+
+def _is_grounded_ambiguity_candidate(question: str, item: dict[str, Any], top_score: float) -> bool:
+    score = float(item.get("_score", 0.0) or 0.0)
+    if score < MIN_OPTION_SCORE or score / max(top_score, 0.0001) < MIN_OPTION_SCORE_RATIO:
+        return False
+    source_text = str(item.get("source_text", "") or "").strip()
+    if len(source_text) < 30 or _has_unmentioned_named_university(question, item):
+        return False
+    breakdown = item.get("_score_breakdown", {}) or {}
+    channels = breakdown.get("channels", {}) or {}
+    consensus = int(breakdown.get("channel_consensus", len(channels)) or 0)
+    if consensus < 2:
+        return False
+
+    title = " ".join(
+        str(item.get(key, "") or "") for key in ("article_title", "title", "article_id")
+    )
+    title_overlap = topic_term_overlap(question, [title])
+    address_match = semantic_address_score(question, item.get("_semantic_address", {}) or {})
+    relevance = _candidate_semantic_relevance(question, item)
+    # A human-reviewed semantic address is the strongest grounding signal.
+    # Newly onboarded documents may initially have only structure-derived
+    # addresses, so independent retrieval channels may also establish
+    # grounding when lexical, dense and semantic-frame evidence converge.
+    unresolved_generic_actor = _has_unresolved_generic_actor(question)
+    triangulated_retrieval = _has_triangulated_grounding(item, relevance, top_score)
+    routed_hint_grounding = (
+        score >= top_score * 0.95
+        and consensus >= 4
+        and title_overlap >= 0.25
+        and "router_hint" in channels
+    )
+    return (
+        title_overlap >= MIN_SEMANTIC_RELEVANCE
+        or (address_match >= 0.70 and relevance >= 0.70 and not unresolved_generic_actor)
+        or (triangulated_retrieval and not unresolved_generic_actor)
+        or routed_hint_grounding
+    )
+
+
+def _candidate_semantic_relevance(question: str, item: dict[str, Any]) -> float:
+    address = item.get("_semantic_address", {}) or {}
+    expanded_question = " ".join([question, *sorted(expand_query_terms(question))])
+    evidence_texts = [
+        str(item.get("source_text", "") or ""),
+        str(item.get("article_title", "") or ""),
+        str(address.get("canonical_address", "") or ""),
+        str(address.get("regulates", "") or ""),
+        " ".join(str(value) for value in address.get("domain_path", []) or []),
+        " ".join(str(value) for value in address.get("canonical_concepts", []) or []),
+        " ".join(str(value) for value in address.get("query_aliases", []) or []),
+    ]
+    return max(
+        topic_term_overlap(question, evidence_texts),
+        topic_term_overlap(expanded_question, evidence_texts),
+        semantic_address_score(question, address),
+        semantic_address_score(expanded_question, address),
+    )
+
+
+def _has_triangulated_grounding(
+    item: dict[str, Any],
+    relevance: float,
+    top_score: float,
+) -> bool:
+    score = float(item.get("_score", 0.0) or 0.0)
+    breakdown = item.get("_score_breakdown", {}) or {}
+    channels = breakdown.get("channels", {}) or {}
+    consensus = int(breakdown.get("channel_consensus", len(channels)) or 0)
+    return (
+        score >= top_score * 0.95
+        and consensus >= 4
+        and relevance >= 0.35
+        and "bm25" in channels
+        and "semantic_frame" in channels
+        and any(channel in channels for channel in ("lsa_dense", "embedding_dense"))
+    )
+
+
+def _has_unresolved_generic_actor(question: str) -> bool:
+    normalized = normalize_for_search(question)
+    tokens = set(normalized.split())
+    mentions_generic_body = bool(tokens & {"kurul", "kurulu", "kurulun", "kurulunun"})
+    return mentions_generic_body and not detect_actors(question)
+
+
+def _has_unmentioned_named_university(question: str, item: dict[str, Any]) -> bool:
+    """Reject one-off university establishment articles unless named by user."""
+    title = normalize_for_search(str(item.get("article_title", "") or ""))
+    if not re.search(r"\buniversitesi\b", title):
+        return False
+    name_tokens = [
+        token for token in title.split()
+        if token not in {"universitesi", "universite", "vakif", "devlet"} and len(token) >= 3
+    ]
+    if not name_tokens:
+        return False
+    q = normalize_for_search(question)
+    return not any(token in q for token in name_tokens)
+
+
+def _article_scope(item: dict[str, Any]) -> tuple[str, str]:
+    return (
+        str(item.get("document_id", "") or ""),
+        str(item.get("article_id", "") or ""),
+    )
+
+
+def _is_explicit_multi_document_question(normalized_question: str) -> bool:
+    document_codes = set(re.findall(r"\b(?:2547|2914|2809)\b", normalized_question))
+    if len(document_codes) < 2:
+        return False
+    return any(
+        marker in normalized_question
+        for marker in ("hangisi", "daha dogrudan", "birlikte", "karsilastir", "arasinda")
+    )
+
+
+def _confidence_result(action: str, reason: str, support_score: float) -> dict[str, Any]:
+    return {
+        "action": action,
+        "reason": reason,
+        "support_score": round(support_score, 4),
+    }
+
+
+def _text_anchor_overlap(question: str, text: str) -> float:
+    anchors = _anchor_tokens(question)
+    if not anchors:
+        return 0.0
+    normalized = normalize_for_search(text)
+    hits = sum(1 for anchor in anchors if anchor in normalized)
+    return hits / len(anchors)
+
+
+def _looks_like_amnesty_query(q: str) -> bool:
+    if "genel af" in q or "ogrenci aff" in q:
+        return True
+    return bool(re.search(r"\baf\b|\baflar\b|\baffi\b|\baftan\b", q))
+
+
+def _looks_like_exam_rights_query(q: str) -> bool:
+    has_exam = "sinav" in q
+    has_right = any(term in q for term in ("hak", "hakki", "haklari"))
+    has_three = bool(re.search(r"\b3\b|\buc\b", q))
+    return has_exam and has_right and has_three
+
+
+def _query_anchor_overlap(question: str, evidence: dict[str, Any]) -> float:
+    query_tokens = _anchor_tokens(question)
+    if not query_tokens:
+        return 0.5
+    evidence_text = " ".join(
+        str(value or "")
+        for value in (
+            evidence.get("source_text", ""),
+            evidence.get("article_id", ""),
+            evidence.get("article_title", ""),
+            evidence.get("title", ""),
+            " ".join(evidence.get("semantic_roles", []) or []),
+        )
+    )
+    evidence_norm = normalize_for_search(evidence_text)
+    hits = sum(1 for token in query_tokens if token in evidence_norm)
+    return hits / max(1, len(query_tokens))
+
+
+def _anchor_tokens(text: str) -> list[str]:
+    stopwords = {
+        "2547", "2914", "2809", "sayili", "kanun", "kanunu", "kanunda", "kanununda",
+        "nedir", "nelerdir", "nasil", "hangi", "hakkinda", "bilgi", "ver", "verir",
+        "gore", "ile", "icin", "olan", "bir", "bu", "su", "mi", "mu", "midir",
+    }
+    tokens = []
+    for token in normalize_for_search(text).split():
+        if len(token) < 2 or token in stopwords:
+            continue
+        tokens.append(token)
+    return tokens[:8]
+
+
+def _render_options(
+    prompt: str,
+    options: dict[str, str],
+    visible_options: dict[str, str] | None = None,
+    source_question: str = "",
+    clarification_type: str = "",
+    option_metadata: dict[str, dict[str, Any]] | None = None,
+) -> str:
+    visible_options = visible_options or options
+    option_metadata = option_metadata or {}
+    for key, label in visible_options.items():
+        _CLICK_TARGETS[normalize_for_search(str(label))] = {
+            "selected_key": str(key),
+            "resolved_question": str(options.get(key, "")),
+            "source_question": source_question,
+            "clarification_type": clarification_type,
+            "option_metadata": option_metadata.get(str(key), {}),
+        }
+    lines = [prompt, ""]
+    for key in sorted(options, key=int):
+        lines.append(f"{key}. {visible_options[key]}")
+    payload = {
+        "prompt": prompt,
+        "options": options,
+        "visible_options": visible_options,
+        "source_question": source_question,
+        "clarification_type": clarification_type,
+        "option_metadata": option_metadata,
+    }
+    lines.extend([
+        "",
+        "Devam etmek için uygun seçeneğe tıklayın.",
+        f"<!-- {MARKER}{json.dumps(payload, ensure_ascii=False)} -->",
+    ])
+    return "\n".join(lines)
+
+
+def _selection_number(message: str) -> str:
+    text = normalize_for_search(message)
+    match = re.search(r"\b([1-3])\b", text)
+    return match.group(1) if match else ""
+
+
+def _selection_key(message: str, payload: dict[str, Any]) -> str:
+    selection = _selection_number(message)
+    if selection:
+        return selection
+    selected_label = normalize_for_search(message)
+    for key, label in (payload.get("visible_options", {}) or {}).items():
+        if selected_label == normalize_for_search(str(label)):
+            return str(key)
+    return ""
+
+
+def _latest_options(history: Any) -> dict[str, str]:
+    payload = _latest_payload(history)
+    return payload.get("options", {}) if payload else {}
+
+
+def _latest_payload(history: Any) -> dict[str, Any]:
+    for content in _assistant_messages_reversed(history):
+        marker_index = content.rfind(MARKER)
+        if marker_index < 0:
+            continue
+        payload = content[marker_index + len(MARKER):]
+        payload = payload.split("-->", 1)[0].strip()
+        try:
+            data = json.loads(payload)
+        except json.JSONDecodeError:
+            continue
+        if isinstance(data, dict):
+            if "options" in data and isinstance(data.get("options"), dict):
+                data["options"] = {str(key): str(value) for key, value in data.get("options", {}).items()}
+                data["visible_options"] = {
+                    str(key): str(value) for key, value in data.get("visible_options", {}).items()
+                }
+                data["option_metadata"] = {
+                    str(key): value for key, value in (data.get("option_metadata", {}) or {}).items()
+                    if isinstance(value, dict)
+                }
+                return data
+            return {
+                "options": {str(key): str(value) for key, value in data.items()},
+                "source_question": "",
+                "clarification_type": "",
+            }
+    return {}
+
+
+def clarification_payload(content: str) -> dict[str, Any]:
+    """Return the embedded option payload used by the Gradio renderer."""
+    return _payload_from_content(content)
+
+
+def clarification_display_text(content: str) -> str:
+    """Remove the machine payload before content reaches the Chatbot DOM."""
+    payload = _payload_from_content(content)
+    if not payload:
+        return content
+    prompt = str(payload.get("prompt", "") or "").strip()
+    return f"{prompt}\n\nDevam etmek için aşağıdaki seçeneklerden birine tıklayın."
+
+
+def _payload_from_content(content: str) -> dict[str, Any]:
+    marker_index = (content or "").rfind(MARKER)
+    if marker_index < 0:
+        return {}
+    raw_payload = content[marker_index + len(MARKER):].split("-->", 1)[0].strip()
+    try:
+        data = json.loads(raw_payload)
+    except json.JSONDecodeError:
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def _assistant_messages_reversed(history: Any):
+    if not history:
+        return
+    for item in reversed(history):
+        if isinstance(item, dict) and item.get("role") == "assistant":
+            yield str(item.get("content", "") or "")
+        elif isinstance(item, (list, tuple)) and len(item) >= 2:
+            yield str(item[1] or "")

clause_retrieval.py

@@ -0,0 +1,1784 @@
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from typing import Any
+
+from intent import intent_profile
+from sources import format_clause_sources, set_article_sources
+from utils import normalize_for_search, query_terms, clean_answer_text
+from normative_roles import (
+    build_normative_knowledge_unit,
+    enrich_normative_frame,
+    extract_question_frame,
+    normative_kg_alignment_score,
+    semantic_role_match_score,
+)
+from llm import llm_available, call_chat_completion
+from prompts import SYSTEM_PROMPT, response_style_instruction
+from query_understanding import query_understanding, expand_query_terms
+from rdfox_pilot import (
+    analyze_pilot_query,
+    apply_pilot_answer_micro_rules,
+    enrich_selected_evidence,
+    micro_rule_score,
+)
+from source_router import route_question
+from config import MCKF_DIR, RDFOX_PILOT_TRIPLES_PATH
+from graph_runtime import MCKFGraphRuntime
+from hybrid_retrieval import HybridRetrievalEngine
+from hermeneutic_intent import analyze_interpretive_intent, legal_object_retrieval_factor
+from proof_bundle import (
+    build_proof_bundle,
+    llm_claim_prompt,
+    parse_and_validate_llm_claims,
+    render_proof_answer,
+)
+
+
+ONTOLOGY: dict[str, Any] = {}
+CLAUSES: list[dict[str, Any]] = []
+EVIDENCE_SPANS: list[dict[str, Any]] = []
+CONCEPTS_BY_ID: dict[str, dict[str, Any]] = {}
+CLAUSES_BY_ID: dict[str, dict[str, Any]] = {}
+DOCUMENTS_BY_ID: dict[str, dict[str, Any]] = {}
+CROSS_DOCUMENT_EDGES: list[dict[str, Any]] = []
+GRAPH_RUNTIME: MCKFGraphRuntime | None = None
+HYBRID_ENGINE: HybridRetrievalEngine | None = None
+CORPUS_BUILD_ID = ""
+
+MIN_EVIDENCE_SCORE = 8.0
+MIN_SCORE_GAP = 0.35
+
+
+def init_clause_retrieval(ontology: dict[str, Any] | None) -> None:
+    global ONTOLOGY, CLAUSES, EVIDENCE_SPANS, CONCEPTS_BY_ID, CLAUSES_BY_ID, DOCUMENTS_BY_ID, CROSS_DOCUMENT_EDGES
+    global GRAPH_RUNTIME, HYBRID_ENGINE, CORPUS_BUILD_ID
+    ONTOLOGY = ontology or {}
+    CLAUSES = ONTOLOGY.get("clauses", []) or []
+    EVIDENCE_SPANS = ONTOLOGY.get("evidence_spans", []) or _flatten_evidence_spans(CLAUSES)
+    DOCUMENTS_BY_ID = {
+        document.get("document_id", ""): document
+        for document in ONTOLOGY.get("documents", []) or []
+        if document.get("document_id")
+    }
+    if not DOCUMENTS_BY_ID and ONTOLOGY.get("document_id"):
+        DOCUMENTS_BY_ID = {
+            ONTOLOGY.get("document_id", ""): {
+                "document_id": ONTOLOGY.get("document_id", ""),
+                "title": ONTOLOGY.get("document_title", ""),
+                "short_code": ONTOLOGY.get("short_code", ""),
+                "domain_tags": [],
+            }
+        }
+    CROSS_DOCUMENT_EDGES = ONTOLOGY.get("cross_document_edges", []) or []
+    CONCEPTS_BY_ID = {
+        concept.get("concept_id", ""): concept
+        for concept in ONTOLOGY.get("concepts", []) or []
+        if concept.get("concept_id")
+    }
+    CLAUSES_BY_ID = {
+        clause.get("clause_id", ""): clause
+        for clause in CLAUSES
+        if clause.get("clause_id")
+    }
+    _enrich_runtime_normative_units()
+    for evidence in EVIDENCE_SPANS:
+        parent_clause = CLAUSES_BY_ID.get(evidence.get("parent_clause_id", ""), {})
+        concept_id = parent_clause.get("parent_concept_id", "")
+        concept = CONCEPTS_BY_ID.get(concept_id, {})
+        evidence["_concept_id"] = concept_id
+        evidence["_semantic_address"] = concept.get("normative_metadata", {}) or {}
+    CORPUS_BUILD_ID = str(ONTOLOGY.get("build_id", "") or "")
+    GRAPH_RUNTIME = MCKFGraphRuntime(
+        EVIDENCE_SPANS,
+        CROSS_DOCUMENT_EDGES,
+        triples_path=RDFOX_PILOT_TRIPLES_PATH,
+    )
+    HYBRID_ENGINE = HybridRetrievalEngine(
+        EVIDENCE_SPANS,
+        GRAPH_RUNTIME,
+        build_id=CORPUS_BUILD_ID,
+        cache_dir=MCKF_DIR / "runtime_cache",
+    )
+    set_article_sources({
+        f"{concept.get('document_id', '')}::{concept.get('article_id', '')}": {
+            "document_id": concept.get("document_id", ""),
+            "document_title": concept.get("document_title", ""),
+            "article_id": concept.get("article_id", ""),
+            "title": concept.get("title", ""),
+            "source_text": concept.get("source_text", ""),
+        }
+        for concept in ONTOLOGY.get("concepts", []) or []
+        if concept.get("document_id") and concept.get("article_id")
+    })
+
+
+def load_ontology(path: Path) -> dict[str, Any]:
+    if not path.exists():
+        return {}
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def _enrich_runtime_normative_units() -> None:
+    for clause in CLAUSES:
+        text = clause.get("source_text", "")
+        frame = enrich_normative_frame(text, clause.get("semantic_frame", {}), clause.get("actors", []))
+        clause["semantic_frame"] = frame
+        clause["normative_unit"] = build_normative_knowledge_unit(
+            text,
+            frame,
+            {
+                "clause_id": clause.get("clause_id", ""),
+                "document_id": clause.get("document_id", ""),
+                "article_id": clause.get("article_id", ""),
+                "label": clause.get("label", ""),
+            },
+        )
+
+    for evidence in EVIDENCE_SPANS:
+        parent_clause = CLAUSES_BY_ID.get(evidence.get("parent_clause_id", ""), {})
+        text = evidence.get("source_text", "")
+        frame = enrich_normative_frame(text, evidence.get("semantic_frame", {}), parent_clause.get("actors", []))
+        evidence["semantic_frame"] = frame
+        evidence["normative_unit"] = build_normative_knowledge_unit(
+            text,
+            frame,
+            {
+                "evidence_id": evidence.get("evidence_id", ""),
+                "parent_clause_id": evidence.get("parent_clause_id", ""),
+                "document_id": evidence.get("document_id", ""),
+                "article_id": evidence.get("article_id", ""),
+                "label": evidence.get("label", ""),
+            },
+        )
+
+
+def retrieve_evidence_spans(
+    question: str,
+    limit: int = 80,
+    min_score: float = MIN_EVIDENCE_SCORE,
+    allowed_articles: list[str] | None = None,
+    allowed_documents: list[str] | None = None,
+    allowed_scopes: list[tuple[str, str]] | None = None,
+) -> list[dict[str, Any]]:
+    if not EVIDENCE_SPANS or HYBRID_ENGINE is None:
+        return []
+
+    profile = intent_profile(question)
+    profile["raw_question"] = question
+    profile.update(query_understanding(question))
+    profile["pilot_query"] = analyze_pilot_query(question)
+    source_route = route_question(question, DOCUMENTS_BY_ID, CROSS_DOCUMENT_EDGES)
+    profile["source_route"] = source_route
+    terms = query_terms(question)
+    if profile.get("interpretive_intent") or profile.get("practical_effect_intent"):
+        terms |= expand_query_terms(
+            question,
+            interpretive=profile.get("interpretive_intent"),
+            practical_effect=profile.get("practical_effect_intent"),
+        )
+    explicit_refs = _explicit_article_references(question)
+    scope_constraints = {
+        (str(document_id), str(article_id))
+        for document_id, article_id in (allowed_scopes or [])
+        if document_id and article_id
+    }
+    allowed = set(allowed_articles or explicit_refs)
+    allowed.update(article_id for _document_id, article_id in scope_constraints)
+    explicit_documents = _explicit_document_ids(question)
+    if allowed_documents:
+        constrained_documents = set(allowed_documents)
+    elif source_route.get("cross_document"):
+        # In comparative questions, named laws describe the requested scope;
+        # they must not exclude a second law inferred by the relation graph.
+        constrained_documents = set(source_route.get("candidate_document_ids", []) or explicit_documents)
+    elif explicit_documents:
+        constrained_documents = set(explicit_documents)
+    elif (
+        len(source_route.get("candidate_document_ids", []) or []) == 1
+        and (
+            float(source_route.get("top_score", 0.0) or 0.0) >= 0.60
+            or len(source_route.get("target_articles_by_document", {}) or {}) == 1
+        )
+    ):
+        # A high-confidence single-document route is also a scope boundary.
+        # This prevents graph expansion from leaking unrelated statutes into
+        # an otherwise unambiguous answer.
+        constrained_documents = set(source_route.get("candidate_document_ids", []) or [])
+    else:
+        constrained_documents = set()
+    allowed_ids: set[str] = set()
+    for evidence in EVIDENCE_SPANS:
+        evidence_scope = (
+            str(evidence.get("document_id", "") or ""),
+            str(evidence.get("article_id", "") or ""),
+        )
+        if scope_constraints and evidence_scope not in scope_constraints:
+            continue
+        if allowed and evidence.get("article_id", "") not in allowed:
+            continue
+        document_id = evidence.get("document_id", "")
+        if constrained_documents and document_id not in constrained_documents:
+            continue
+        evidence_id = str(evidence.get("evidence_id", "") or "")
+        if evidence_id:
+            allowed_ids.add(evidence_id)
+
+    question_frame = extract_question_frame(question)
+    question_frame["query_expansions"] = list(profile.get("expanded_terms", []) or [])
+    requested_roles = {str(profile.get("norm_type", "") or "")}
+    requested_roles.update(str(role) for role in (profile.get("pilot_query", {}) or {}).get("semantic_role_boost", []) or [])
+    requested_roles.update(str(role) for role in question_frame.get("requested_categories", []) or [])
+    requested_roles.discard("")
+    semantic_pool = HYBRID_ENGINE.semantic_prefilter(
+        question,
+        question_frame,
+        requested_roles,
+        allowed_ids,
+        set(allowed),
+    )
+    hint_scopes = {
+        (str(document_id), str(article_id))
+        for document_id, article_ids in (source_route.get("target_articles_by_document", {}) or {}).items()
+        for article_id in article_ids or []
+    }
+    routed_articles = {str(value) for value in profile.get("routed_articles", []) or [] if value}
+    routed_document = str(profile.get("routed_document_id", "") or source_route.get("top_document_id", "") or "")
+    if routed_document and routed_articles:
+        hint_scopes.update((routed_document, article_id) for article_id in routed_articles)
+    relation_scopes, matched_relation_ids = _matched_normative_relation_scopes(
+        question,
+        source_route.get("candidate_edges", []) or [],
+    )
+    profile["matched_normative_relation_ids"] = matched_relation_ids
+    if hint_scopes:
+        semantic_pool.update(
+            evidence_id
+            for evidence_id in allowed_ids
+            if (
+                str(HYBRID_ENGINE.evidence_by_id[evidence_id].get("document_id", "")),
+                str(HYBRID_ENGINE.evidence_by_id[evidence_id].get("article_id", "")),
+            ) in hint_scopes
+        )
+    semantic_scores = {}
+    for evidence_id in sorted(semantic_pool):
+        evidence = HYBRID_ENGINE.evidence_by_id[evidence_id]
+        semantic_scores[evidence_id] = evidence_match_score(evidence, profile, terms, source_route=source_route)
+    ranked = HYBRID_ENGINE.retrieve(
+        question,
+        question_frame,
+        semantic_scores,
+        requested_roles=requested_roles,
+        allowed_ids=allowed_ids,
+        exact_articles=set(allowed),
+        hint_scopes=hint_scopes,
+        relation_scopes=relation_scopes,
+        limit=limit,
+    )
+    return _attach_structural_context(ranked, allowed_ids, limit)
+
+
+def _attach_structural_context(
+    ranked: list[dict[str, Any]],
+    allowed_ids: set[str],
+    limit: int,
+) -> list[dict[str, Any]]:
+    """Keep source fragments that form one sentence together.
+
+    Evidence extraction intentionally creates atomic spans. Legal sentences
+    frequently cross a semicolon, so an isolated span can omit the authority,
+    condition or legal effect that completes the proposition. Adjacent spans
+    are attached as structural context without giving them an independent
+    semantic match score.
+    """
+    by_scope: dict[tuple[str, str, str], list[dict[str, Any]]] = {}
+    for evidence in EVIDENCE_SPANS:
+        evidence_id = str(evidence.get("evidence_id", "") or "")
+        if evidence_id not in allowed_ids:
+            continue
+        key = (
+            str(evidence.get("document_id", "") or ""),
+            str(evidence.get("article_id", "") or ""),
+            str(evidence.get("parent_clause_id", "") or ""),
+        )
+        by_scope.setdefault(key, []).append(evidence)
+    for values in by_scope.values():
+        values.sort(key=lambda item: int((item.get("source_span", {}) or {}).get("char_start", 10**9) or 0))
+
+    output: list[dict[str, Any]] = []
+    seen: set[str] = set()
+    for anchor in ranked:
+        anchor_id = str(anchor.get("evidence_id", "") or "")
+        if anchor_id and anchor_id not in seen:
+            output.append(anchor)
+            seen.add(anchor_id)
+        key = (
+            str(anchor.get("document_id", "") or ""),
+            str(anchor.get("article_id", "") or ""),
+            str(anchor.get("parent_clause_id", "") or ""),
+        )
+        siblings = by_scope.get(key, [])
+        index = next((i for i, item in enumerate(siblings) if item.get("evidence_id") == anchor_id), -1)
+        if index < 0:
+            continue
+        neighbors = []
+        if index > 0 and _source_fragments_continue(siblings[index - 1], anchor):
+            neighbors.append(siblings[index - 1])
+        if index + 1 < len(siblings) and _source_fragments_continue(anchor, siblings[index + 1]):
+            neighbors.append(siblings[index + 1])
+        for neighbor in neighbors:
+            neighbor_id = str(neighbor.get("evidence_id", "") or "")
+            if not neighbor_id or neighbor_id in seen:
+                continue
+            contextual = dict(neighbor)
+            contextual["_score"] = round(max(8.0, float(anchor.get("_score", 0.0) or 0.0) * 0.92), 4)
+            contextual["_retrieval_channels"] = sorted(
+                set(contextual.get("_retrieval_channels", []) or []) | {"structural_context"}
+            )
+            contextual["_channel_consensus"] = max(1, int(anchor.get("_channel_consensus", 0) or 0))
+            contextual["_score_breakdown"] = {
+                **(contextual.get("_score_breakdown", {}) or {}),
+                "structural_context_of": anchor_id,
+            }
+            output.append(contextual)
+            seen.add(neighbor_id)
+        if len(output) >= limit:
+            break
+    return output[:limit]
+
+
+def _source_fragments_continue(previous: dict[str, Any], current: dict[str, Any]) -> bool:
+    previous_span = previous.get("source_span", {}) or {}
+    current_span = current.get("source_span", {}) or {}
+    previous_end = int(previous_span.get("char_end", -1) or -1)
+    current_start = int(current_span.get("char_start", -1) or -1)
+    if previous_end < 0 or current_start < 0 or current_start - previous_end not in {0, 1, 2}:
+        return False
+    previous_text = str(previous.get("source_text", "") or "").rstrip()
+    return bool(previous_text) and (previous_text.endswith((";", ",", ":")) or previous_text[-1] not in ".?!")
+
+
+_RELATION_STOPWORDS = {
+    "2547", "2809", "2914", "sayili", "kanun", "kanunu", "madde",
+    "hangi", "nedir", "arasindaki", "ifadesi", "hukum", "hukmune",
+    "baglam", "baglamiyla", "uyarinca",
+}
+
+
+def _relation_terms(text: str) -> set[str]:
+    terms: set[str] = set()
+    for token in normalize_for_search(text).split():
+        if len(token) < 4 or token.isdigit() or token in _RELATION_STOPWORDS:
+            continue
+        terms.add(token if len(token) < 6 else token[:5])
+    return terms
+
+
+def _matched_normative_relation_scopes(
+    question: str,
+    edges: list[dict[str, Any]],
+) -> tuple[set[tuple[str, str]], list[str]]:
+    """Resolve graph edges by their canonical relation description.
+
+    Relation descriptions are corpus data emitted by the document compiler.
+    Requiring at least two substantive concept matches keeps generic statutory
+    references from becoming article shortcuts.
+    """
+    query = _relation_terms(question)
+    ranked: list[tuple[int, float, dict[str, Any]]] = []
+    for edge in edges:
+        relation_text = " ".join(
+            str(edge.get(field, "") or "")
+            for field in ("description", "relation_type")
+        )
+        relation = _relation_terms(relation_text)
+        matches = query & relation
+        if len(matches) < 2:
+            continue
+        coverage = len(matches) / max(min(len(query), len(relation)), 1)
+        ranked.append((len(matches), coverage, edge))
+    if not ranked:
+        return set(), []
+    ranked.sort(key=lambda item: (item[0], item[1]), reverse=True)
+    best_count, best_coverage, _ = ranked[0]
+    matched = [
+        edge for count, coverage, edge in ranked
+        if count == best_count and coverage >= best_coverage - 0.08
+    ]
+    scopes: set[tuple[str, str]] = set()
+    for edge in matched:
+        scopes.add((str(edge.get("source_document_id", "")), str(edge.get("source_article_id", ""))))
+        scopes.add((str(edge.get("target_document_id", "")), str(edge.get("target_article_id", ""))))
+    scopes.discard(("", ""))
+    return scopes, [str(edge.get("edge_id", "")) for edge in matched if edge.get("edge_id")]
+
+
+def retrieve_clauses(
+    question: str,
+    limit: int = 80,
+    min_score: float = MIN_EVIDENCE_SCORE,
+    allowed_articles: list[str] | None = None,
+) -> list[dict[str, Any]]:
+    """Compatibility wrapper: return parent clauses ranked by best evidence span.
+
+    v0.6 retrieval is evidence-span first. This function still returns clause objects so older
+    tests and callers remain compatible, but each clause carries `_selected_evidence`.
+    """
+    evidence_spans = retrieve_evidence_spans(question, limit=limit, min_score=min_score, allowed_articles=allowed_articles)
+    clauses: list[dict[str, Any]] = []
+    seen: set[str] = set()
+    for evidence in evidence_spans:
+        clause_id = evidence.get("parent_clause_id", "")
+        if not clause_id or clause_id in seen:
+            continue
+        clause = dict(CLAUSES_BY_ID.get(clause_id, {}))
+        if not clause:
+            continue
+        clause["_score"] = evidence.get("_score", 0.0)
+        clause["_selected_evidence"] = evidence
+        clause["_score_breakdown"] = evidence.get("_score_breakdown", {})
+        clauses.append(clause)
+        seen.add(clause_id)
+    return clauses[:limit]
+
+
+def evidence_match_score(
+    evidence: dict[str, Any],
+    profile: dict[str, Any],
+    terms: set[str],
+    source_route: dict[str, Any] | None = None,
+) -> float:
+    q = profile.get("normalized_question", "")
+    norm_type = profile.get("norm_type", "")
+    evidence_text = normalize_for_search(evidence.get("source_text", ""))
+    article_id = normalize_for_search(evidence.get("article_id", ""))
+    label = normalize_for_search(evidence.get("label", ""))
+    roles = set(evidence.get("semantic_roles", []) or [])
+    parent_clause = CLAUSES_BY_ID.get(evidence.get("parent_clause_id", ""), {})
+    concept = CONCEPTS_BY_ID.get(parent_clause.get("parent_concept_id", ""), {})
+    concept_text = normalize_for_search(" ".join([
+        concept.get("title", ""),
+        " ".join(concept.get("aliases", []) or []),
+        " ".join(concept.get("question_patterns", []) or []),
+    ]))
+
+    q_frame = extract_question_frame(profile.get("raw_question") or q)
+    e_frame = enrich_normative_frame(evidence.get("source_text", ""), evidence.get("semantic_frame", {}) or {}, parent_clause.get("actors", []))
+    evidence["semantic_frame"] = e_frame
+    srm = semantic_role_match_score(q_frame, e_frame)
+    kg_alignment = normative_kg_alignment_score(q_frame, e_frame)
+
+    norm_score = _norm_type_score(norm_type, evidence, roles, parent_clause, concept)
+    entity_scope_score = _entity_scope_score(profile, evidence, concept, e_frame)
+    lexical_score = _lexical_score(terms, evidence_text, concept_text, article_id, label)
+    structure_score = _structure_score(profile, evidence)
+    evidence_focus_score = _evidence_focus_score(profile, evidence_text, e_frame)
+    router_score = _source_router_score(evidence, source_route or {})
+    document_domain_score = _document_domain_score(evidence, source_route or {})
+    article_hint_score = _article_hint_score(evidence, source_route or {})
+    pilot_score, pilot_rule_hits = micro_rule_score(
+        profile.get("pilot_query"),
+        evidence,
+        parent_clause=parent_clause,
+        concept=concept,
+    )
+    cross_document_bonus = _cross_document_bonus(evidence, source_route or {})
+    wrong_document_penalty = _wrong_document_penalty(evidence, source_route or {})
+    generic_article_penalty = _generic_penalty(profile, evidence, e_frame)
+    concept_mismatch_penalty = _concept_mismatch_penalty(q_frame, evidence_text, concept_text)
+    query_focus_score, query_focus_penalty = _query_focus_match(q, evidence_text)
+
+    score01 = (
+        0.19 * srm.get("total", 0.0)
+        + 0.13 * kg_alignment.get("total", 0.0)
+        + 0.16 * entity_scope_score
+        + 0.12 * norm_score
+        + 0.12 * lexical_score
+        + 0.06 * structure_score
+        + 0.06 * evidence_focus_score
+        + 0.11 * router_score
+        + 0.06 * document_domain_score
+        + 0.08 * article_hint_score
+        + 0.05 * pilot_score
+        + 0.14 * query_focus_score
+        + cross_document_bonus
+    )
+
+    penalty = generic_article_penalty + wrong_document_penalty + concept_mismatch_penalty + query_focus_penalty
+    final01 = max(0.0, min(1.0, score01) - penalty)
+    evidence["_score_breakdown"] = {
+        "srm": srm,
+        "kg_alignment": round(kg_alignment.get("total", 0.0), 4),
+        "kg_alignment_components": kg_alignment,
+        "semantic_role_score": round(srm.get("total", 0.0), 4),
+        "norm_type": round(norm_score, 4),
+        "norm_type_score": round(norm_score, 4),
+        "entity_scope": round(entity_scope_score, 4),
+        "lexical": round(lexical_score, 4),
+        "lexical_score": round(lexical_score, 4),
+        "structure": round(structure_score, 4),
+        "structure_score": round(structure_score, 4),
+        "evidence_focus": round(evidence_focus_score, 4),
+        "evidence_focus_score": round(evidence_focus_score, 4),
+        "source_router_score": round(router_score, 4),
+        "document_domain_score": round(document_domain_score, 4),
+        "article_hint_score": round(article_hint_score, 4),
+        "pilot_rule_score": round(pilot_score, 4),
+        "pilot_rule_hits": pilot_rule_hits,
+        "query_focus_score": round(query_focus_score, 4),
+        "query_focus_penalty": round(query_focus_penalty, 4),
+        "cross_document_bonus": round(cross_document_bonus, 4),
+        "wrong_document_penalty": round(wrong_document_penalty, 4),
+        "generic_article_penalty": round(generic_article_penalty, 4),
+        "concept_mismatch_penalty": round(concept_mismatch_penalty, 4),
+        "penalty": round(penalty, 4),
+        "final_0_1": round(final01, 4),
+    }
+    return final01 * 20.0
+
+
+def _query_focus_match(question: str, evidence_text: str) -> tuple[float, float]:
+    """Match the governed object in narrow passive appointment questions."""
+    match = re.search(r"\b([a-z0-9]+)\s+kim\s+atar\b", question)
+    if not match:
+        match = re.search(r"\b([a-z0-9]+)\s+nasil\s+atan(?:ir|ir)\b", question)
+    if not match:
+        return 0.0, 0.0
+
+    target = match.group(1)
+    for suffix in ("leri", "lari", "ini", "unu", "unu", "yı", "yi", "yu", "yü", "i", "ı", "u", "ü"):
+        normalized_suffix = normalize_for_search(suffix)
+        if target.endswith(normalized_suffix) and len(target) - len(normalized_suffix) >= 4:
+            target = target[:-len(normalized_suffix)]
+            break
+
+    if target not in evidence_text:
+        return 0.0, 0.14
+    if re.search(rf"\b{re.escape(target)}\s+yardimci", evidence_text):
+        return 0.0, 0.20
+    if "atan" not in evidence_text:
+        return 0.0, 0.10
+    if re.search(
+        rf"\b{re.escape(target)}\b.{{0,140}}(?:cumhurbaskaninca|kurulunca|tarafindan|teklifi).{{0,100}}atan",
+        evidence_text,
+    ):
+        return 1.0, 0.0
+    if re.search(rf"\b{re.escape(target)}\b.{{0,100}}\batar\b", evidence_text):
+        return 0.85, 0.0
+    # "Kim atar?" requires the appointing authority. A sentence that only says
+    # a new office holder is appointed does not answer that question.
+    return 0.0, 0.14
+
+
+def answer_from_clauses(
+    question: str,
+    normativity_level=2,
+    allowed_articles: list[str] | None = None,
+    allowed_documents: list[str] | None = None,
+    allowed_scopes: list[tuple[str, str]] | None = None,
+    evidence_spans: list[dict[str, Any]] | None = None,
+) -> str:
+    profile = intent_profile(question)
+    profile.update(query_understanding(question))
+    profile["strict_legal_object"] = bool(allowed_scopes)
+    profile["pilot_query"] = analyze_pilot_query(question)
+    profile["source_route"] = route_question(question, DOCUMENTS_BY_ID, CROSS_DOCUMENT_EDGES)
+    if evidence_spans is None:
+        evidence_spans = retrieve_evidence_spans(
+            question,
+            allowed_articles=allowed_articles,
+            allowed_documents=allowed_documents,
+            allowed_scopes=allowed_scopes,
+        )
+    if not evidence_spans:
+        return ""
+    selected = _select_proof_evidence(evidence_spans, profile, question)
+    if not selected:
+        return ""
+    selected = enrich_selected_evidence(profile.get("pilot_query"), selected)
+    for item in selected:
+        document = DOCUMENTS_BY_ID.get(str(item.get("document_id", "")), {})
+        item["document_domain_tags"] = document.get("domain_tags", []) or []
+    proof = build_proof_bundle(question, evidence_spans, selected, CORPUS_BUILD_ID)
+    if proof.get("status") != "supported":
+        return ""
+
+    claims = []
+    if llm_available():
+        claims = _llm_claims_from_proof(proof, normativity_level)
+    answer = render_proof_answer(proof, claims or None)
+    if not answer:
+        return ""
+    return answer + "\n\n---\n\n**Kaynaklar**\n" + format_clause_sources(selected, question=question, answer=answer)
+
+
+def evaluate_clause_query(
+    question: str,
+    allowed_articles: list[str] | None = None,
+    allowed_documents: list[str] | None = None,
+    allowed_scopes: list[tuple[str, str]] | None = None,
+) -> dict[str, Any]:
+    evidence_spans = retrieve_evidence_spans(
+        question,
+        allowed_articles=allowed_articles,
+        allowed_documents=allowed_documents,
+        allowed_scopes=allowed_scopes,
+    )
+    parent_clause_ids = []
+    for evidence in evidence_spans:
+        cid = evidence.get("parent_clause_id", "")
+        if cid and cid not in parent_clause_ids:
+            parent_clause_ids.append(cid)
+    profile = intent_profile(question)
+    profile.update(query_understanding(question))
+    profile["strict_legal_object"] = bool(allowed_scopes)
+    profile["source_route"] = route_question(question, DOCUMENTS_BY_ID, CROSS_DOCUMENT_EDGES)
+    selected = _select_proof_evidence(evidence_spans, profile, question)
+    proof = build_proof_bundle(question, evidence_spans, selected, CORPUS_BUILD_ID)
+    return {
+        "evidence_spans": evidence_spans,
+        "evidence_ids": [evidence.get("evidence_id", "") for evidence in evidence_spans],
+        "clauses": [CLAUSES_BY_ID.get(cid, {}) for cid in parent_clause_ids if cid in CLAUSES_BY_ID],
+        "clause_ids": parent_clause_ids,
+        "document_ids": [evidence.get("document_id", "") for evidence in evidence_spans],
+        "source_ids": [evidence.get("article_id", "") for evidence in evidence_spans],
+        "scores": [evidence.get("_score", 0.0) for evidence in evidence_spans],
+        "score_breakdowns": [evidence.get("_score_breakdown", {}) for evidence in evidence_spans],
+        "source_route": route_question(question, DOCUMENTS_BY_ID, CROSS_DOCUMENT_EDGES),
+        "selected_evidence_ids": [item.get("evidence_id", "") for item in selected],
+        "proof_bundle": proof,
+    }
+
+
+def retrieval_runtime_status() -> dict[str, Any]:
+    if HYBRID_ENGINE is None:
+        return {"status": "not_initialized"}
+    return {"status": "ready", **HYBRID_ENGINE.status()}
+
+
+def _explicit_document_ids(question: str) -> list[str]:
+    normalized = normalize_for_search(question)
+    found = []
+    for document_id, document in DOCUMENTS_BY_ID.items():
+        short_code = normalize_for_search(str(document.get("short_code", "") or ""))
+        title = normalize_for_search(str(document.get("title", "") or ""))
+        if short_code and re.search(rf"\b{re.escape(short_code)}\b", normalized):
+            found.append(document_id)
+            continue
+        meaningful_title = " ".join(term for term in title.split() if term not in {"sayili", "kanunu", "kanun"})
+        if meaningful_title and meaningful_title in normalized:
+            found.append(document_id)
+    return found
+
+
+def _select_proof_evidence(
+    evidence_spans: list[dict[str, Any]],
+    profile: dict[str, Any],
+    question: str,
+    limit: int = 5,
+) -> list[dict[str, Any]]:
+    """Select a coherent evidence set without question-specific article patches."""
+    if not evidence_spans:
+        return []
+    substantive = [item for item in evidence_spans if not _non_substantive_source_fragment(item)]
+    if substantive:
+        evidence_spans = substantive
+    # Structural context is emitted in source order and may precede the span
+    # that actually won retrieval. Keep the retrieval-bearing span as the
+    # semantic anchor, then attach its source context below.
+    top = next(
+        (item for item in evidence_spans if not _structural_context_anchor(item)),
+        evidence_spans[0],
+    )
+    anchor = (top.get("document_id", ""), top.get("article_id", ""))
+    question_frame = extract_question_frame(question)
+    requested = {str(profile.get("norm_type", "") or "")}
+    requested.update(str(value) for value in question_frame.get("requested_categories", []) or [])
+    requested.discard("")
+    qualifier_roles = {"sart", "istisna", "sure", "tanim", "usul"}
+    selected = [top]
+    seen = {top.get("evidence_id", "")}
+    normalized_question = normalize_for_search(question)
+    multi_part = (
+        str(profile.get("norm_type", "") or "") in {"gorev", "amac", "ilke", "usul"}
+        or len(requested) >= 2
+        or any(
+            term in normalized_question
+            for term in (
+                "nelerdir", "gorevleri", "adimlari", "asamalari", "birlikte", "nasil",
+                "kapsam", "istisna", "kosul", "basvuru suresi",
+            )
+        )
+    )
+    interpretation = analyze_interpretive_intent(question)
+    enforce_legal_object = bool(interpretation and interpretation.get("enforce_fidelity", True))
+    requested_mechanism = (interpretation.get("requested_mechanism", {}) or {}) if interpretation else {}
+    same_parent_required = requested_mechanism.get("selection_scope") == "same_parent_clause"
+    anchor_parent = str(top.get("parent_clause_id", "") or "")
+
+    if requested_mechanism.get("mechanism_id") == "body_membership_and_composition":
+        composition = _select_body_composition_proof(evidence_spans, top)
+        if composition:
+            return composition
+
+    # A legal article can contain appointment, delegation and duty paragraphs
+    # together. When the question asks for duties, keep the selected evidence
+    # inside the duty sub-clause instead of mixing in nearby appointment spans.
+    if _is_duty_question(profile, normalized_question):
+        duty_evidence = _select_duty_section_evidence(evidence_spans, top)
+        if duty_evidence:
+            return duty_evidence
+
+    explicit_documents = _explicit_document_ids(question)
+    if len(explicit_documents) >= 2:
+        selected = []
+        seen = set()
+        for document_id in explicit_documents:
+            document_candidates = [
+                item for item in evidence_spans
+                if item.get("document_id") == document_id
+            ][:20]
+            candidate = max(
+                document_candidates,
+                key=lambda item: _comparative_scope_score(question, item),
+                default=None,
+            )
+            if candidate and candidate.get("evidence_id") not in seen:
+                selected.append(candidate)
+                seen.add(candidate.get("evidence_id"))
+        if selected:
+            anchor = (selected[0].get("document_id", ""), selected[0].get("article_id", ""))
+
+    for evidence in evidence_spans:
+        evidence_id = evidence.get("evidence_id", "")
+        if not evidence_id or evidence_id in seen:
+            continue
+        if (
+            same_parent_required
+            and anchor_parent
+            and str(evidence.get("parent_clause_id", "") or "") != anchor_parent
+        ):
+            continue
+        same_scope = (evidence.get("document_id", ""), evidence.get("article_id", "")) == anchor
+        roles = set(evidence.get("semantic_roles", []) or []) | {str(evidence.get("norm_type", "") or "")}
+        channel_details = (evidence.get("_score_breakdown", {}) or {}).get("channels", {}) or {}
+        graph_linked = "graph_expansion" in channel_details or "sparql_graph" in channel_details
+        relevant_role = bool(roles & requested) or bool(roles & qualifier_roles)
+        structural_continuation = (
+            _structural_context_anchor(evidence) == str(top.get("evidence_id", "") or "")
+            or _structural_context_anchor(top) == str(evidence_id)
+            or _source_fragments_continue(top, evidence)
+            or _source_fragments_continue(evidence, top)
+        )
+        object_aligned = (
+            not enforce_legal_object
+            or legal_object_retrieval_factor(question, evidence, analysis=interpretation) >= 1.0
+            or (structural_continuation and not profile.get("strict_legal_object"))
+        )
+        if same_scope and structural_continuation and object_aligned:
+            selected.append(evidence)
+        elif same_scope and multi_part and object_aligned and (relevant_role or int(evidence.get("_channel_consensus", 0) or 0) >= 3):
+            selected.append(evidence)
+        elif same_scope and object_aligned and roles & {"sart", "istisna"} and float(evidence.get("_score", 0.0) or 0.0) >= 17.0:
+            selected.append(evidence)
+        elif graph_linked and profile.get("source_route", {}).get("cross_document") and object_aligned:
+            selected.append(evidence)
+        if evidence_id in {item.get("evidence_id") for item in selected}:
+            seen.add(evidence_id)
+        if len(selected) >= limit:
+            break
+    if (multi_part or any(_structural_context_anchor(item) for item in selected)) and len(selected) > 1 and all(
+        (item.get("document_id", ""), item.get("article_id", "")) == anchor
+        for item in selected
+    ):
+        selected = _sort_evidence_by_span(_dedupe_evidence(selected))[:limit]
+    return selected
+
+
+def _structural_context_anchor(evidence: dict[str, Any]) -> str:
+    return str((evidence.get("_score_breakdown", {}) or {}).get("structural_context_of", "") or "")
+
+
+def _non_substantive_source_fragment(evidence: dict[str, Any]) -> bool:
+    """Drop amendment headers and leaked neighboring headings from proof evidence."""
+    text = normalize_for_search(str(evidence.get("source_text", "") or ""))
+    if not text:
+        return True
+    normative_markers = (
+        "yetkili", "kurma", "kurul", "kapat", "birles", "degistir", "aktar",
+        "atan", "secil", "oden", "zorun", "gorev", "hak", "uygulan", "basvur",
+        "yapil", "veril", "alin", "sorumlu", "yasak", "muaf", "tabidir",
+    )
+    has_normative_marker = any(marker in text for marker in normative_markers)
+    if re.match(r"^(?:ek |gecici )?madde\s+\w+\s+(?:ek|degisik|mulga|iptal)\b", text):
+        return not has_normative_marker
+    if len(text.split()) <= 6 and not has_normative_marker:
+        return True
+    return False
+
+
+def _is_duty_question(profile: dict[str, Any], normalized_question: str) -> bool:
+    return (
+        str(profile.get("norm_type", "") or "") == "gorev"
+        or bool(
+            re.search(
+                r"\b(?:gorev(?:i|in|leri|lerinin)?|yetki(?:si|leri|lerinin)?|sorumluluk(?:lari|larinin)?)\b",
+                normalized_question,
+            )
+        )
+    )
+
+
+def _select_body_composition_proof(
+    evidence_spans: list[dict[str, Any]],
+    anchor: dict[str, Any],
+) -> list[dict[str, Any]]:
+    """Select the central composition sentence of one named governing body."""
+    anchor_scope = (anchor.get("document_id", ""), anchor.get("article_id", ""))
+    scoped = [
+        item
+        for item in evidence_spans
+        if (item.get("document_id", ""), item.get("article_id", "")) == anchor_scope
+    ]
+    composition = [item for item in scoped if _looks_like_composition_evidence(item)]
+    if not composition:
+        return []
+    central = max(
+        composition,
+        key=lambda item: (
+            "toplam" in normalize_for_search(str(item.get("source_text", "") or "")),
+            "kisiden olusur" in normalize_for_search(str(item.get("source_text", "") or "")),
+            float(item.get("_score", 0.0) or 0.0),
+        ),
+    )
+    selected = [central]
+    for candidate in scoped:
+        if _source_fragments_continue(candidate, central):
+            selected.insert(0, candidate)
+            break
+    return _sort_evidence_by_span(_dedupe_evidence(selected))[:3]
+
+
+def _select_duty_section_evidence(
+    evidence_spans: list[dict[str, Any]],
+    anchor: dict[str, Any],
+) -> list[dict[str, Any]]:
+    """Return substantive duty spans from the anchor sub-clause only."""
+    anchor_parent = str(anchor.get("parent_clause_id", "") or "")
+    anchor_scope = (anchor.get("document_id", ""), anchor.get("article_id", ""))
+    article_candidates = [
+        item for item in evidence_spans
+        if (item.get("document_id", ""), item.get("article_id", "")) == anchor_scope
+    ]
+    candidates = [
+        item for item in article_candidates
+        if not anchor_parent or str(item.get("parent_clause_id", "") or "") == anchor_parent
+    ]
+    duty = [
+        item for item in candidates
+        if "gorev" in (item.get("semantic_roles", []) or [])
+        and not _looks_like_non_duty_evidence(item)
+        and not _is_section_heading(item)
+    ]
+    if not duty and _is_lettered_duty_heading(anchor):
+        duty = _lettered_section_duty_spans(article_candidates, anchor)
+    if not duty:
+        return []
+    return _dedupe_evidence(_sort_evidence_by_span(duty))[:8]
+
+
+def _is_section_heading(evidence: dict[str, Any]) -> bool:
+    text = normalize_for_search(str(evidence.get("source_text", "") or "")).strip()
+    return bool(re.fullmatch(r"[a-z0-9]+ gorev yetki ve sorumluluklari", text))
+
+
+def _is_lettered_duty_heading(evidence: dict[str, Any]) -> bool:
+    label = str(evidence.get("label", "") or "").strip().lower()
+    return len(label) == 1 and label.isalpha() and _is_section_heading(evidence)
+
+
+def _lettered_section_duty_spans(
+    article_candidates: list[dict[str, Any]],
+    heading: dict[str, Any],
+) -> list[dict[str, Any]]:
+    """Collect numbered spans between a lettered duty heading and the next heading."""
+    start = int((heading.get("source_span", {}) or {}).get("char_start", -1) or -1)
+    if start < 0:
+        return []
+    next_heading_starts = [
+        int((item.get("source_span", {}) or {}).get("char_start", -1) or -1)
+        for item in article_candidates
+        if _is_letter_label(item.get("label"))
+        and int((item.get("source_span", {}) or {}).get("char_start", -1) or -1) > start
+    ]
+    end = min(next_heading_starts) if next_heading_starts else float("inf")
+    spans = []
+    for item in article_candidates:
+        position = int((item.get("source_span", {}) or {}).get("char_start", -1) or -1)
+        if not (start < position < end):
+            continue
+        if not str(item.get("label", "") or "").strip().isdigit():
+            continue
+        if _looks_like_non_duty_evidence(item) or _is_section_heading(item):
+            continue
+        spans.append(item)
+    return spans
+
+
+def _is_letter_label(value: Any) -> bool:
+    label = str(value or "").strip().lower()
+    return len(label) == 1 and label.isalpha()
+
+
+def _comparative_scope_score(question: str, evidence: dict[str, Any]) -> float:
+    """Select a document's scope provision for source-primacy comparisons."""
+    normalized_question = normalize_for_search(question)
+    text = normalize_for_search(str(evidence.get("source_text", "") or ""))
+    title = normalize_for_search(str(evidence.get("article_title", "") or ""))
+    anchors = {
+        term for term in normalized_question.split()
+        if len(term) >= 4 and term not in {
+            "sayili", "kanun", "kanunu", "hangi", "daha", "dogrudan", "kaynak",
+            "kabul", "edilmelidir", "hakkinda", "bilgi", "verirken",
+        } and not term.isdigit()
+    }
+    overlap = sum(1.0 for term in anchors if term in text or term in title)
+    scope = 4.0 if title in {"kapsam", "amac", "konu ve kapsam"} else 0.0
+    scope += 3.0 if "bu kanun" in text and any(marker in text for marker in ("kapsar", "uygulanir", "tabi")) else 0.0
+    retrieval = min(2.0, float(evidence.get("_score", 0.0) or 0.0) / 10.0)
+    return scope + overlap + retrieval
+
+
+def _llm_claims_from_proof(proof: dict[str, Any], normativity_level: int) -> list[dict[str, Any]]:
+    prompt = llm_claim_prompt(proof, response_style_instruction(normativity_level))
+    try:
+        raw = call_chat_completion(
+            [
+                {"role": "system", "content": SYSTEM_PROMPT},
+                {"role": "user", "content": prompt},
+            ]
+        )
+    except Exception:
+        return []
+    return parse_and_validate_llm_claims(raw, proof)
+
+
+def evidence_spans_by_ids(evidence_ids: list[str]) -> list[dict[str, Any]]:
+    """Return exact corpus evidence for rule-backed multi-hop analysis."""
+    requested = set(evidence_ids or [])
+    if not requested:
+        return []
+    by_id = {
+        str(evidence.get("evidence_id", "")): evidence
+        for evidence in EVIDENCE_SPANS
+        if evidence.get("evidence_id")
+    }
+    return [dict(by_id[evidence_id]) for evidence_id in evidence_ids if evidence_id in by_id]
+
+
+def evidence_spans_matching(selectors: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Resolve stable semantic selectors to exact corpus evidence spans."""
+    selected: list[dict[str, Any]] = []
+    seen: set[str] = set()
+    for selector in selectors or []:
+        required_terms = [normalize_for_search(str(term)) for term in selector.get("contains_all", [])]
+        for evidence in EVIDENCE_SPANS:
+            if selector.get("document_id") and evidence.get("document_id") != selector["document_id"]:
+                continue
+            if selector.get("article_id") and evidence.get("article_id") != selector["article_id"]:
+                continue
+            if selector.get("label") and str(evidence.get("label", "")) != str(selector["label"]):
+                continue
+            normalized_text = normalize_for_search(str(evidence.get("source_text", "") or ""))
+            if required_terms and not all(term in normalized_text for term in required_terms):
+                continue
+            evidence_id = str(evidence.get("evidence_id", "") or "")
+            if evidence_id and evidence_id not in seen:
+                selected.append(dict(evidence))
+                seen.add(evidence_id)
+            break
+    return selected
+
+
+def _confident_enough(evidence_spans: list[dict[str, Any]]) -> bool:
+    if not evidence_spans:
+        return False
+    best = float(evidence_spans[0].get("_score", 0.0))
+    if best < MIN_EVIDENCE_SCORE:
+        return False
+    if len(evidence_spans) >= 2:
+        second = float(evidence_spans[1].get("_score", 0.0))
+        top_breakdown = evidence_spans[0].get("_score_breakdown", {}) or {}
+        kg_alignment = float(top_breakdown.get("kg_alignment", 0.0) or 0.0)
+        lexical = float(top_breakdown.get("lexical", 0.0) or 0.0)
+        entity_scope = float(top_breakdown.get("entity_scope", 0.0) or 0.0)
+        article_hint = float(top_breakdown.get("article_hint_score", 0.0) or 0.0)
+        if kg_alignment < 0.36 and lexical < 0.55 and entity_scope < 0.82 and article_hint <= 0:
+            return False
+        if best >= 9.25 and (
+            entity_scope >= 0.82
+            or lexical >= 0.55
+            or kg_alignment >= 0.58
+        ):
+            return True
+        # If the evidence is weak and flat, do not force a wrong answer.
+        if best < 10.0 and (best - second) < MIN_SCORE_GAP:
+            return False
+    return True
+
+
+def _select_answer_evidence(evidence_spans: list[dict[str, Any]], profile: dict[str, Any], question: str = "") -> list[dict[str, Any]]:
+    norm_type = profile.get("norm_type", "")
+    q = normalize_for_search(question)
+    source_route = profile.get("source_route", {}) or {}
+
+    if source_route.get("cross_document"):
+        selected = _select_cross_document_evidence(evidence_spans, source_route)
+        if selected:
+            return selected
+
+    if profile.get("route") == "law_purpose":
+        return _article_evidence("Madde 1")[:1] + _article_evidence("Madde 4")
+
+    if profile.get("route") == "institute_establishment":
+        return _select_institute_establishment_evidence()
+
+    if profile.get("route") == "research_application_center_establishment":
+        return _select_research_center_evidence()
+
+    if profile.get("interpretive_intent"):
+        anchor_article = _anchor_article_for_single_topic_query(evidence_spans, profile)
+        if not anchor_article:
+            anchor_article = evidence_spans[0].get("article_id", "")
+        scoped = [e for e in evidence_spans if e.get("article_id", "") == anchor_article]
+        focused = _interpretive_evidence(scoped or evidence_spans, profile)
+        return _dedupe_evidence(_sort_evidence_by_span(focused or scoped or evidence_spans))[:5]
+
+    if norm_type == "gorev":
+        top_article = evidence_spans[0].get("article_id", "")
+        duty = [
+            e for e in evidence_spans
+            if e.get("article_id") == top_article
+            and "gorev" in (e.get("semantic_roles", []) or [])
+            and not _looks_like_non_duty_evidence(e)
+            and str(e.get("label", "")) not in {"preamble", "b"}
+        ]
+        return _dedupe_evidence(_sort_evidence_by_span(duty or evidence_spans))[:8]
+
+    if norm_type == "tanim":
+        selected = []
+        # Definition questions may ask both meaning and operational right, e.g. "ön lisans diploması nedir".
+        for evidence in evidence_spans:
+            frame = evidence.get("semantic_frame", {}) or {}
+            text = normalize_for_search(evidence.get("source_text", ""))
+            if evidence.get("norm_type") == "tanim" or frame.get("definition_term"):
+                selected.append(evidence)
+                break
+        if "diploma" in q:
+            for evidence in evidence_spans:
+                text = normalize_for_search(evidence.get("source_text", ""))
+                if "diploma" in text and any(term in text for term in ("alir", "alır", "almak")) and evidence not in selected:
+                    selected.append(evidence)
+                    break
+        return _dedupe_evidence(selected or evidence_spans[:2])[:3]
+
+    if norm_type == "kurul_olusumu":
+        # Composition questions are single-entity questions by default.
+        # Once the highest-ranked evidence establishes the governed institution/article,
+        # do not mix in composition spans from other articles merely because they also
+        # contain phrases such as "toplam ... kişiden oluşur". This is a general
+        # evidence-scoping rule, not a per-question patch.
+        anchor_article = _anchor_article_for_single_entity_query(evidence_spans, profile)
+        scoped = [e for e in evidence_spans if not anchor_article or e.get("article_id") == anchor_article]
+        composition = [e for e in scoped if _looks_like_composition_evidence(e)]
+        # A composition/count question normally asks for the composition of one named body.
+        # Return the best evidence span only; otherwise the answer can mix sub-bodies
+        # such as a council and its executive board.
+        return _dedupe_evidence(composition or scoped or evidence_spans)[:1]
+
+    if norm_type == "kurulus":
+        exact_establishment = [e for e in evidence_spans if _is_direct_establishment_evidence(e)]
+        if exact_establishment:
+            return _dedupe_evidence(exact_establishment)[:2]
+        same_topic = [e for e in evidence_spans if e.get("norm_type") == norm_type or norm_type in (e.get("semantic_roles", []) or [])]
+        return _dedupe_evidence(same_topic or evidence_spans)[:3]
+
+    if norm_type in {"ilke", "amac"}:
+        top_article = evidence_spans[0].get("article_id", "")
+        scoped = _article_evidence(top_article) or [e for e in evidence_spans if e.get("article_id", "") == top_article]
+        return _dedupe_evidence(_sort_evidence_by_span(scoped or evidence_spans))[:14]
+
+    if norm_type in {"atama", "sure", "sart", "istisna", "yaptirim"}:
+        anchor_article = _anchor_article_for_single_topic_query(evidence_spans, profile)
+        scoped = [e for e in evidence_spans if not anchor_article or e.get("article_id") == anchor_article]
+        same_topic = [e for e in scoped if e.get("norm_type") == norm_type or norm_type in (e.get("semantic_roles", []) or [])]
+        competitive = _competitive_evidence(same_topic or scoped or evidence_spans, max_gap=0.75)
+        if norm_type == "atama" and not profile.get("requires_condition"):
+            return _dedupe_evidence(competitive)[:1]
+        return _dedupe_evidence(competitive)[:2]
+
+    top_article = evidence_spans[0].get("article_id", "")
+    scoped = [e for e in evidence_spans if e.get("article_id", "") == top_article]
+    return _dedupe_evidence(scoped or evidence_spans)[:2]
+
+
+def _llm_answer_from_selected_evidence(question: str, evidence_spans: list[dict[str, Any]], normativity_level=2) -> str:
+    context_blocks = []
+    document_titles = _selected_document_titles(evidence_spans)
+    for idx, evidence in enumerate(evidence_spans, start=1):
+        ref = _evidence_ref(evidence)
+        text = _clean_text(evidence.get("source_text", ""))
+        frame = evidence.get("semantic_frame", {}) or {}
+        frame_hint = _frame_hint(frame)
+        context_blocks.append(f"[Dayanak {idx}: {ref}]\n{frame_hint}\nMetin: {text}")
+    style_instruction = response_style_instruction(normativity_level)
+    profile = intent_profile(question)
+    profile.update(query_understanding(question))
+    intent_hint = _intent_hint(profile)
+    prompt = f"""Kullanıcı sorusu:\n{question}\n\nSeçilmiş belge kapsamı:\n{document_titles}\n\nSeçilmiş en küçük kanıt parçaları:\n{chr(10).join(context_blocks)}\n\nCevap stili:\n{style_instruction}\n\nGörev:\nTürkçe cevap ver.\n- Kullanıcı niyeti: {intent_hint}\n- Yalnızca seçilmiş belge(ler)den seçilmiş kanıt parçalarına dayan.\n- Kanıt metnini aynen kopyalama; maddeye sadık kalarak normatif ve anlaşılır biçimde sentezle.\n- Kanıt doğrudan cevap vermiyorsa mevcut MCKF corpus içinde açık hüküm bulunmadığını söyle.\n- Soru yorum, rol, anlam veya sonuç soruyorsa açık dayanaklardan makul hukuki anlam çıkar; dayanağı olmayan gerekçe veya dış bilgi ekleme.\n- Kaynakta olmayan kişi, gerekçe, istisna veya yorum uydurma.\n- Cevabın başında veya sonunda kaynak listesi yazma; kaynaklar arayüzde ayrıca gösterilecek.\n- Soru tek bir konu soruyorsa sadece o konuya cevap ver.\n- Cevap öz olsun ama soru uzun açıklama gerektiriyorsa yeterli açıklamayı ver.\n- Cevabı kesmeden tamamla, fakat gereksiz tekrar yapma.\n"""
+    try:
+        raw = call_chat_completion([
+            {"role": "system", "content": SYSTEM_PROMPT},
+            {"role": "user", "content": prompt},
+        ])
+        return clean_answer_text(raw, question).strip()
+    except Exception:
+        return ""
+
+
+def _render_evidence_answer(
+    evidence_spans: list[dict[str, Any]],
+    norm_type: str,
+    normativity_level=2,
+    profile: dict[str, Any] | None = None,
+    question: str = "",
+) -> str:
+    profile = profile or {}
+    if profile.get("route") == "law_purpose":
+        return _render_law_purpose_answer()
+    if profile.get("route") in {"foundational_principles", "foundational_purpose"} or norm_type in {"ilke", "amac"}:
+        return _render_foundational_answer(evidence_spans, norm_type)
+    if profile.get("route") == "institute_establishment":
+        return _render_institute_establishment_answer(question)
+    if profile.get("route") == "research_application_center_establishment":
+        return _render_research_center_establishment_answer()
+
+    refs = ", ".join(_unique_refs(_evidence_ref(e) for e in evidence_spans))
+    lead = f"Dayanak: {refs}."
+    if len(evidence_spans) == 1:
+        return f"{lead}\n\n{_clean_text(evidence_spans[0].get('source_text', ''))}"
+    bullets = "\n".join(f"- {_clean_text(e.get('source_text', ''))}" for e in evidence_spans)
+    return f"{lead}\n\n{bullets}"
+
+
+def _unique_refs(refs) -> list[str]:
+    seen = set()
+    out = []
+    for ref in refs:
+        if ref in seen:
+            continue
+        seen.add(ref)
+        out.append(ref)
+    return out
+
+
+def _selected_document_titles(evidence_spans: list[dict[str, Any]]) -> str:
+    titles = []
+    for evidence in evidence_spans:
+        title = evidence.get("document_title") or evidence.get("document_id", "")
+        if title and title not in titles:
+            titles.append(title)
+    return ", ".join(titles) if titles else "seçilmiş MCKF belgeleri"
+
+
+
+def _select_institute_establishment_evidence() -> list[dict[str, Any]]:
+    selected = []
+    for evidence in _article_evidence("Madde 5"):
+        text = normalize_for_search(evidence.get("source_text", ""))
+        if "enstitu" in text and "kanunla kurulur" in text:
+            selected.append(evidence)
+    for evidence in _article_evidence("Madde 7"):
+        text = normalize_for_search(evidence.get("source_text", ""))
+        if "enstitu" in text and "acilmasi" in text:
+            selected.append(evidence)
+        elif "uygulama ve arastirma merkezi" in text and "acilmasi" in text:
+            selected.append(evidence)
+    return _dedupe_evidence(_sort_evidence_by_span(selected))[:4]
+
+
+def _select_research_center_evidence() -> list[dict[str, Any]]:
+    selected = []
+    for evidence in _article_evidence("Madde 7"):
+        text = normalize_for_search(evidence.get("source_text", ""))
+        if "uygulama ve arastirma merkezi" in text and "acilmasi" in text:
+            selected.append(evidence)
+    return _dedupe_evidence(_sort_evidence_by_span(selected))[:2]
+
+
+def _select_cross_document_evidence(evidence_spans: list[dict[str, Any]], source_route: dict[str, Any]) -> list[dict[str, Any]]:
+    candidates = set(source_route.get("candidate_document_ids", []) or [])
+    selected: list[dict[str, Any]] = []
+    for edge in source_route.get("candidate_edges", []) or []:
+        for document_id, article_id in (
+            (edge.get("source_document_id", ""), edge.get("source_article_id", "")),
+            (edge.get("target_document_id", ""), edge.get("target_article_id", "")),
+        ):
+            for evidence in evidence_spans:
+                if evidence.get("document_id") == document_id and evidence.get("article_id") == article_id:
+                    selected.append(evidence)
+                    break
+    for doc_id in candidates:
+        if any(e.get("document_id") == doc_id for e in selected):
+            continue
+        for evidence in evidence_spans:
+            if evidence.get("document_id") == doc_id:
+                selected.append(evidence)
+                break
+    return _dedupe_evidence(selected)[:5]
+
+
+def _render_foundational_answer(evidence_spans: list[dict[str, Any]], norm_type: str) -> str:
+    article = evidence_spans[0].get("article_id", "") if evidence_spans else ""
+    if article == "Madde 5" or norm_type == "ilke":
+        return _render_principles_answer()
+    if article == "Madde 4" or norm_type == "amac":
+        return _render_higher_education_purpose_answer()
+    return _render_plain_evidence_answer(evidence_spans)
+
+
+def _render_law_purpose_answer() -> str:
+    return (
+        "Dayanak: Madde 1, Madde 4.\n\n"
+        "2547 sayılı Yükseköğretim Kanununun temel amacı iki düzeyde anlaşılır:\n\n"
+        "1. Kanunun düzenleme amacı: Madde 1'e göre kanun, yükseköğretimle ilgili amaç ve ilkeleri belirlemek; bütün yükseköğretim kurumları ile üst kuruluşlarının teşkilatlanmasını, işleyişini, görev, yetki ve sorumluluklarını ve eğitim-öğretim, araştırma, yayım, öğretim elemanları, öğrenciler ve diğer personelle ilgili esasları bir bütünlük içinde düzenlemek için çıkarılmıştır.\n"
+        "2. Yükseköğretimin amaç yönü: Madde 4'e göre yükseköğretim; öğrencilerin belirli yurttaşlık, kültür, bilimsel düşünce ve mesleki yeterliklerle yetişmesini, ülkenin ekonomik, sosyal ve kültürel kalkınmasına katkı sağlayacak programların uygulanmasını ve yükseköğretim kurumlarının bilimsel çalışma, araştırma, bilgi ve teknoloji üretimiyle ulusal ve evrensel gelişmeye katkı vermesini hedefler.\n\n"
+        "Kısaca, kanun yalnızca üniversite idaresini düzenleyen teknik bir metin değildir; yükseköğretimin amaçlarını, ilkelerini, kurumlarını, yetkilerini ve insan unsurunu tek bir normatif çerçevede toplar."
+    )
+
+
+def _render_higher_education_purpose_answer() -> str:
+    return (
+        "Dayanak: Madde 4.\n\n"
+        "2547 sayılı Kanunda yükseköğretimin amacı üç ana eksende düzenlenir:\n\n"
+        "1. Öğrenci yetiştirme amacı: Öğrencilerin Atatürk inkılapları ve ilkeleri doğrultusunda, milli ve kültürel değerlere sahip, toplum yararını gözeten, insan haklarına saygılı, hür ve bilimsel düşünce gücü olan, dengeli gelişmiş ve mesleki bilgi-beceri kazanmış yurttaşlar olarak yetiştirilmesi hedeflenir.\n"
+        "2. Toplumsal ve kalkınmacı amaç: Türk Devletinin ülkesi ve milletiyle bölünmez bütünlüğü içinde refah ve mutluluğunu artıracak; ekonomik, sosyal ve kültürel kalkınmaya katkı sağlayacak programların uygulanması amaçlanır.\n"
+        "3. Bilimsel ve kurumsal amaç: Yükseköğretim kurumlarının bilimsel çalışma ve araştırma yapması, bilgi ve teknoloji üretmesi, bilim verilerini yayması, ulusal kalkınmaya destek olması, yurt içi ve yurt dışı kurumlarla işbirliği yapması ve evrensel gelişmeye katkıda bulunması öngörülür."
+    )
+
+
+def _render_principles_answer() -> str:
+    return (
+        "Dayanak: Madde 5.\n\n"
+        "2547 sayılı Kanunda yükseköğretimin ana ilkeleri Madde 5'te düzenlenir. Bu ilkeler özetle şunlardır:\n\n"
+        "1. Atatürk inkılapları ve ilkeleri doğrultusunda hizmet bilinci kazandırılması.\n"
+        "2. Milli kültürün, örf ve adetlerin evrensel kültür içinde korunup geliştirilmesi; milli birlik ve beraberliği güçlendiren ruh ve iradenin kazandırılması.\n"
+        "3. Yükseköğretim kurumlarının özellikleri, eğitim-öğretim dalları ve amaçları gözetilerek eğitim-öğretimde birlik ilkesinin sağlanması.\n"
+        "4. Eğitim-öğretim plan ve programlarının bilimsel ve teknolojik esaslara, ülke ve yöre ihtiyaçlarına göre hazırlanıp sürekli geliştirilmesi.\n"
+        "5. Yükseköğretimde imkan ve fırsat eşitliğini sağlayacak önlemlerin alınması.\n"
+        "6. Üniversite, yüksek teknoloji enstitüsü ve bağlı fakülte, enstitü ve yüksekokulların yükseköğretim planlaması çerçevesinde kanunla kurulması.\n"
+        "7. Yükseköğretim kurumlarının geliştirilmesi, yaygınlaştırılması, kaynak ve insan gücü dağılımının milli eğitim politikası ve kalkınma planları doğrultusunda planlanması.\n\n"
+        "Bu nedenle Madde 5, yükseköğretimin yalnız akademik değil; kültürel, planlamacı, eşitlikçi ve kalkınmacı çerçevesini de belirler."
+    )
+
+
+def _render_institute_establishment_answer(question: str = "") -> str:
+    q = normalize_for_search(question)
+    qualifier = "Araştırma enstitüsü ifadesi 2547 içinde ayrı ve tek başına bir kuruluş usulü olarak değil, enstitü ve araştırma/uygulama merkezi hükümleriyle birlikte okunmalıdır."
+    if "arastirma" not in q:
+        qualifier = "Enstitü kuruluşu 2547 içinde hem kanunla kuruluş hem de üniversite içinde açılma süreci bakımından düzenlenir."
+    return (
+        "Dayanak: Madde 5/f, Madde 7/2.\n\n"
+        f"{qualifier}\n\n"
+        "1. Üniversiteler, yüksek teknoloji enstitüleri ve bunların içindeki fakülte, enstitü ve yüksekokullar, Cumhurbaşkanınca yapılan yükseköğretim planlaması çerçevesinde kanunla kurulur.\n"
+        "2. Bir üniversite içinde enstitü açılması, birleştirilmesi veya kapatılması konusunda Yükseköğretim Kurulu doğrudan ya da üniversiteden gelen öneriye dayanarak karar alır ve gereği için Milli Eğitim Bakanlığına sunar.\n"
+        "3. Kast edilen birim 'uygulama ve araştırma merkezi' ise, bunların açılması, birleştirilmesi veya kapatılması da Madde 7/2 kapsamında Yükseköğretim Kurulunun karar sürecine bağlanmıştır."
+    )
+
+
+def _render_research_center_establishment_answer() -> str:
+    return (
+        "Dayanak: Madde 7/2.\n\n"
+        "Uygulama ve araştırma merkezlerinin açılması, birleştirilmesi veya kapatılması konusunda Yükseköğretim Kurulu doğrudan ya da üniversiteden gelen öneri üzerine karar verir. Bu nedenle 2547 bakımından araştırma merkezi kuruluşu, YÖK karar süreciyle ilişkilidir."
+    )
+
+
+def _render_plain_evidence_answer(evidence_spans: list[dict[str, Any]]) -> str:
+    refs = ", ".join(_unique_refs(_evidence_ref(e) for e in evidence_spans))
+    bullets = "\n".join(f"- {_clean_text(e.get('source_text', ''))}" for e in evidence_spans)
+    return f"Dayanak: {refs}.\n\n{bullets}"
+
+
+def _numbered_evidence_lines(evidence_spans: list[dict[str, Any]], skip_labels: set[str] | None = None) -> str:
+    skip_labels = skip_labels or set()
+    lines = []
+    seen = set()
+    for evidence in evidence_spans:
+        label = str(evidence.get("label", "") or "")
+        if label in skip_labels:
+            continue
+        text = _clean_foundational_text(evidence.get("source_text", ""))
+        if not text:
+            continue
+        key = normalize_for_search(text)
+        if key in seen:
+            continue
+        seen.add(key)
+        lines.append(f"{len(lines) + 1}. {text}")
+    return "\n".join(lines)
+
+
+def _clean_foundational_text(text: str) -> str:
+    cleaned = _clean_text(text)
+    cleaned = re.split(
+        r"\b(?:ÜÇÜNCÜ|UCUNCU)\s+BÖLÜM\b|\bÜst Kuruluşlar\b|\bYükseköğretim Kurulu:\b",
+        cleaned,
+        maxsplit=1,
+        flags=re.IGNORECASE,
+    )[0].strip()
+    return cleaned
+
+
+def _interpretive_evidence(evidence_spans: list[dict[str, Any]], profile: dict[str, Any]) -> list[dict[str, Any]]:
+    preferred_roles = {"gorev", "yetki", "sart", "istisna", "yaptirim", "tanim", "kurulus", "atama"}
+    if profile.get("practical_effect_intent"):
+        preferred_roles.update({"sart", "istisna", "yaptirim"})
+    selected = []
+    for evidence in evidence_spans:
+        roles = set(evidence.get("semantic_roles", []) or [])
+        if evidence.get("norm_type") in preferred_roles or roles & preferred_roles:
+            selected.append(evidence)
+    return selected or evidence_spans
+
+
+def _article_evidence(article_id: str, document_id: str = "TR-KANUN-2547") -> list[dict[str, Any]]:
+    if not article_id:
+        return []
+    return [
+        dict(evidence)
+        for evidence in EVIDENCE_SPANS
+        if evidence.get("article_id", "") == article_id
+        and (not document_id or evidence.get("document_id", "") == document_id)
+    ]
+
+
+def _intent_hint(profile: dict[str, Any]) -> str:
+    parts = []
+    norm_type = profile.get("norm_type")
+    actors = profile.get("actors") or []
+    if norm_type:
+        parts.append(f"norm_tipi={norm_type}")
+    if actors:
+        parts.append("aktor=" + ", ".join(actors))
+    if profile.get("interpretive_intent"):
+        parts.append("kaynakli_yorum")
+    if profile.get("practical_effect_intent"):
+        parts.append("pratik_sonuc")
+    return "; ".join(parts) if parts else "dar kaynakli cevap"
+
+
+
+
+
+def _competitive_evidence(evidence_spans: list[dict[str, Any]], max_gap: float = 0.75) -> list[dict[str, Any]]:
+    """Keep only evidence spans that are genuinely competitive with the best span.
+
+    This is used for narrow factual questions such as appointment, duration, condition
+    and sanction queries. It prevents low-relevance clauses with the same broad norm
+    label from being added to the final answer.
+    """
+    if not evidence_spans:
+        return []
+    best = float(evidence_spans[0].get("_score", 0.0))
+    return [e for e in evidence_spans if best - float(e.get("_score", 0.0)) <= max_gap]
+
+
+def _anchor_article_for_single_topic_query(evidence_spans: list[dict[str, Any]], profile: dict[str, Any]) -> str:
+    """Choose a dominant article when the question expresses one clear topic.
+
+    This prevents answer composition from mixing unrelated provisions that share the
+    same generic role label such as condition, duration or sanction. The anchor is
+    based on the top evidence score plus lexical/norm-role support; it is not tied
+    to a specific article number.
+    """
+    if not evidence_spans:
+        return ""
+    top = evidence_spans[0]
+    top_article = top.get("article_id", "")
+    if not top_article:
+        return ""
+    breakdown = top.get("_score_breakdown", {}) or {}
+    lexical = float(breakdown.get("lexical", 0.0))
+    norm = float(breakdown.get("norm_type", 0.0))
+    entity = float(breakdown.get("entity_scope", 0.0))
+    score = float(top.get("_score", 0.0))
+    if score >= 10.0 and (lexical >= 0.25 or norm >= 0.72 or entity >= 0.5):
+        return top_article
+    return ""
+
+
+def _anchor_article_for_single_entity_query(evidence_spans: list[dict[str, Any]], profile: dict[str, Any]) -> str:
+    """Choose a dominant article for queries about one governed entity.
+
+    Legal retrieval frequently finds many structurally similar spans across the law
+    (for example, several boards "consist of" a number of members). For a query
+    that names one entity, answer selection must stay inside the article that best
+    matches that entity unless the question type explicitly requires multiple legal
+    bases.
+    """
+    if not evidence_spans:
+        return ""
+    if len(profile.get("actors") or []) != 1:
+        return ""
+    top = evidence_spans[0]
+    top_article = top.get("article_id", "")
+    if not top_article:
+        return ""
+    # Anchor only when the top evidence is reasonably strong and entity-scoped.
+    breakdown = top.get("_score_breakdown", {}) or {}
+    if float(top.get("_score", 0.0)) >= 10.0 and float(breakdown.get("entity_scope", 0.0)) >= 0.5:
+        return top_article
+    return ""
+
+
+def _entity_scope_score(profile: dict[str, Any], evidence: dict[str, Any], concept: dict[str, Any], frame: dict[str, Any]) -> float:
+    """Prefer evidence whose parent article/concept is about the entity asked.
+
+    This is a core MCKF disambiguation rule, not a question patch: a legal text may mention
+    many entities inside one provision, but the article title and concept aliases usually
+    identify the governed entity of that provision. Queries about an institution or role
+    should therefore prefer evidence scoped to that entity over evidence merely mentioning it.
+    """
+    actors = profile.get("actors") or []
+    if not actors:
+        return 0.5
+
+    title_alias_text = normalize_for_search(" ".join([
+        concept.get("title", ""),
+        " ".join(concept.get("aliases", []) or []),
+        " ".join(concept.get("question_patterns", []) or []),
+    ]))
+    evidence_text = normalize_for_search(evidence.get("source_text", ""))
+    frame_actors = {normalize_for_search(str(actor)) for actor in frame.get("actor", []) or []}
+
+    best = _concept_title_match_score(profile, concept)
+    for actor in actors:
+        actor_norm = normalize_for_search(str(actor))
+        if not actor_norm:
+            continue
+        if actor_norm in title_alias_text:
+            best = max(best, 1.0)
+        elif _distinctive_title_terms_match_actor(title_alias_text, actor_norm):
+            best = max(best, 0.9)
+        elif evidence_text.startswith(actor_norm) or f"{actor_norm}," in evidence_text[:120] or f"{actor_norm} " in evidence_text[:80]:
+            best = max(best, 0.82)
+        elif actor_norm in frame_actors:
+            best = max(best, 0.42)
+        elif actor_norm in evidence_text:
+            best = max(best, 0.28)
+    return best
+
+
+def _distinctive_title_terms_match_actor(title_alias_text: str, actor_norm: str) -> bool:
+    generic_terms = {"kurul", "kurulu", "kurulunun", "yonetim", "gorevleri", "madde"}
+    terms = [
+        term for term in title_alias_text.split()
+        if len(term) >= 5 and term not in generic_terms and not term.isdigit()
+    ]
+    if not terms:
+        return False
+    if len(terms) == 1:
+        return terms[0] in actor_norm
+    return all(term in actor_norm for term in terms)
+
+
+def _concept_title_match_score(profile: dict[str, Any], concept: dict[str, Any]) -> float:
+    q = profile.get("normalized_question", "")
+    title = normalize_for_search(concept.get("title", ""))
+    aliases = [normalize_for_search(alias) for alias in (concept.get("aliases", []) or [])]
+    candidates = [candidate for candidate in [title, *aliases] if candidate and not candidate.startswith("madde ")]
+    if not q or not candidates:
+        return 0.0
+
+    meaningful_q_terms = set(q.split())
+    best = 0.0
+    for candidate in candidates:
+        candidate_terms = [term for term in candidate.split() if len(term) >= 4 and term not in {"madde"}]
+        if not candidate_terms:
+            continue
+        if candidate in q and len(candidate_terms) >= 2:
+            best = max(best, min(1.22, 1.0 + 0.05 * len(candidate_terms)))
+        elif all(term in meaningful_q_terms for term in candidate_terms):
+            best = max(best, 0.92)
+        elif len(candidate_terms) == 1 and candidate_terms[0] in meaningful_q_terms:
+            best = max(best, 0.78)
+    return best
+
+
+def _norm_type_score(norm_type: str, evidence: dict[str, Any], roles: set[str], parent_clause: dict[str, Any], concept: dict[str, Any]) -> float:
+    concept_title = normalize_for_search(concept.get("title", ""))
+    if norm_type and norm_type in concept_title:
+        return 1.2
+    if norm_type and (norm_type == evidence.get("norm_type") or norm_type in roles):
+        return 1.0
+    if norm_type and (norm_type == parent_clause.get("norm_type") or norm_type in (parent_clause.get("semantic_roles", []) or [])):
+        return 0.72
+    if norm_type and norm_type in (concept.get("semantic_roles", []) or []):
+        return 0.55
+    if not norm_type:
+        return 0.5
+    return 0.0
+
+
+def _lexical_score(terms: set[str], evidence_text: str, concept_text: str, article_id: str, label: str) -> float:
+    if not terms:
+        return 0.45
+    hits = 0.0
+    for term in terms:
+        if term in evidence_text:
+            hits += 1.0
+        elif term in concept_text:
+            hits += 0.65
+        elif term in article_id or term == label:
+            hits += 0.35
+    return min(1.0, hits / max(1.0, min(len(terms), 7)))
+
+
+def _structure_score(profile: dict[str, Any], evidence: dict[str, Any]) -> float:
+    q = profile.get("normalized_question", "")
+    label = normalize_for_search(str(evidence.get("label", "")))
+    article_id = normalize_for_search(evidence.get("article_id", ""))
+    if q and article_id in q:
+        return 1.0
+    if label not in {"article", "preamble", ""}:
+        return 0.68
+    return 0.35
+
+
+def _evidence_focus_score(profile: dict[str, Any], evidence_text: str, frame: dict[str, Any]) -> float:
+    q = profile.get("normalized_question", "")
+    score = 0.0
+    if profile.get("requires_condition") and frame.get("condition"):
+        score += 0.35
+    if profile.get("requires_exception") and frame.get("exception"):
+        score += 0.35
+    if any(term in q for term in ("kac", "kaç", "sure", "suresi", "ne kadar")) and frame.get("temporal_constraint"):
+        score += 0.30
+    if "diploma" in q and any(term in q for term in ("almak", "alma", "gerekir")):
+        if "diploma" in evidence_text and any(term in evidence_text for term in ("alir", "alır", "basari ile tamam", "başarı ile tamam", "tamamlamalari", "tamamlamaları")):
+            score += 0.45
+
+    # Penalize huge generic spans; v0.6 prefers exact evidence units.
+    length = len(evidence_text)
+    if length <= 420:
+        score += 0.30
+    elif length <= 700:
+        score += 0.15
+    return min(score, 1.0)
+
+
+def _generic_penalty(profile: dict[str, Any], evidence: dict[str, Any], frame: dict[str, Any]) -> float:
+    penalty = 0.0
+    norm_type = profile.get("norm_type", "")
+    if norm_type and evidence.get("norm_type") and norm_type != evidence.get("norm_type"):
+        # Do not punish a span whose primary label differs if the requested role is
+        # explicitly present among its semantic roles. This avoids false negatives
+        # in complex clauses that encode, for example, both condition and composition.
+        if norm_type not in (evidence.get("semantic_roles", []) or []):
+            penalty += 0.08 if norm_type == "tanim" else 0.13
+    if profile.get("requires_condition") and not frame.get("condition"):
+        penalty += 0.18
+    if profile.get("requires_exception") and not frame.get("exception"):
+        penalty += 0.18
+    article_id = evidence.get("article_id", "")
+    q = profile.get("normalized_question", "")
+    if article_id.startswith("Geçici Madde") and not profile.get("allows_temporary_article"):
+        penalty += 0.22
+    if article_id.startswith("Ek Madde") and not any(term in q for term in ("ek madde", "vakif", "vakıf", "ozel", "özel", "ilave")):
+        penalty += 0.16
+    evidence_text = normalize_for_search(evidence.get("source_text", ""))
+    if "diploma" in q and any(term in q for term in ("almak", "alma", "gerekir")) and "mezun olamayan" in evidence_text:
+        penalty += 0.18
+    if len(evidence.get("source_text", "")) > 900:
+        penalty += 0.10
+    return penalty
+
+
+def _concept_mismatch_penalty(q_frame: dict[str, Any], evidence_text: str, concept_text: str) -> float:
+    text = f"{evidence_text} {concept_text}"
+    penalty = 0.0
+    for concept in q_frame.get("related_concept", []) or []:
+        concept_norm = normalize_for_search(str(concept))
+        terms = [term for term in concept_norm.split() if len(term) >= 3]
+        if len(terms) < 2:
+            continue
+        hits = sum(1 for term in terms if term in text)
+        if hits == 0:
+            penalty += 0.20
+        elif hits < len(terms):
+            penalty += 0.22
+    return min(penalty, 0.32)
+
+
+def _source_router_score(evidence: dict[str, Any], source_route: dict[str, Any]) -> float:
+    document_id = evidence.get("document_id", "")
+    scores = source_route.get("document_scores", {}) or {}
+    top_score = max(scores.values() or [0.0])
+    if not document_id or top_score <= 0:
+        return 0.5
+    return min(1.0, float(scores.get(document_id, 0.0)) / max(0.01, float(top_score)))
+
+
+def _document_domain_score(evidence: dict[str, Any], source_route: dict[str, Any]) -> float:
+    document_id = evidence.get("document_id", "")
+    candidates = set(source_route.get("candidate_document_ids", []) or [])
+    if not candidates:
+        return 0.5
+    if document_id in candidates:
+        return 1.0
+    return 0.0
+
+
+def _article_hint_score(evidence: dict[str, Any], source_route: dict[str, Any]) -> float:
+    document_id = evidence.get("document_id", "")
+    targets = (source_route.get("target_articles_by_document", {}) or {}).get(document_id) or []
+    if not targets:
+        return 0.0
+    return 1.0 if _matches_article_hint(evidence.get("article_id", ""), targets) else 0.0
+
+
+def _wrong_document_penalty(evidence: dict[str, Any], source_route: dict[str, Any]) -> float:
+    candidates = set(source_route.get("candidate_document_ids", []) or [])
+    if not candidates or float(source_route.get("top_score", 0.0) or 0.0) < 0.3:
+        return 0.0
+    document_id = evidence.get("document_id", "")
+    if document_id in candidates:
+        return 0.0
+    if _is_cross_document_edge_article(document_id, evidence.get("article_id", ""), source_route):
+        return 0.0
+    return 0.22
+
+
+def _cross_document_bonus(evidence: dict[str, Any], source_route: dict[str, Any]) -> float:
+    if not source_route.get("cross_document"):
+        return 0.0
+    if _is_cross_document_edge_article(evidence.get("document_id", ""), evidence.get("article_id", ""), source_route):
+        return 0.08
+    if evidence.get("document_id", "") in set(source_route.get("candidate_document_ids", []) or []):
+        return 0.03
+    return 0.0
+
+
+def _is_cross_document_edge_article(document_id: str, article_id: str, source_route: dict[str, Any]) -> bool:
+    if not document_id or not article_id:
+        return False
+    for edge in source_route.get("candidate_edges", []) or []:
+        if document_id == edge.get("source_document_id") and article_id == edge.get("source_article_id"):
+            return True
+        if document_id == edge.get("target_document_id") and article_id == edge.get("target_article_id"):
+            return True
+    return False
+
+
+def _matches_article_hint(article_id: str, target_articles: list[str]) -> bool:
+    article_norm = normalize_for_search(article_id)
+    for target in target_articles:
+        target_norm = normalize_for_search(target)
+        if article_norm == target_norm:
+            return True
+        if target_norm.startswith("ek madde "):
+            continue
+        if target_norm and not target_norm.startswith("madde ") and article_norm.startswith(target_norm):
+            return True
+    return False
+
+
+def _is_direct_establishment_evidence(evidence: dict[str, Any]) -> bool:
+    text = normalize_for_search(evidence.get("source_text", ""))
+    return any(term in text for term in (
+        "kanunla kurulur", "karari ile kurulur", "kararı ile kurulur",
+        "cumhurbaskani karari ile kurulur", "cumhurbaşkanı kararı ile kurulur",
+    ))
+
+
+def _looks_like_non_duty_evidence(evidence: dict[str, Any]) -> bool:
+    text = normalize_for_search(evidence.get("source_text", ""))
+    return any(term in text for term in (
+        "atanir", "atanabilir", "atanmasi", "secilir", "vekalet", "yardimci",
+        "goreve vekalet", "göreve vekalet", "sure ile secilir",
+    ))
+
+
+def _looks_like_composition_evidence(evidence: dict[str, Any]) -> bool:
+    text = normalize_for_search(evidence.get("source_text", ""))
+    return any(term in text for term in ("toplam", "kisiden olusur", "uyeden olusur", "yedi", "yirmi bir"))
+
+
+def _sort_evidence_by_span(evidence_spans: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    return sorted(evidence_spans, key=lambda e: (e.get("source_span", {}).get("char_start", 0), -float(e.get("_score", 0.0))))
+
+
+def _dedupe_evidence(evidence_spans: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    seen = set()
+    result = []
+    for evidence in evidence_spans:
+        key = (evidence.get("evidence_id") or normalize_for_search(evidence.get("source_text", ""))[:160])
+        if key in seen:
+            continue
+        seen.add(key)
+        result.append(evidence)
+    return result
+
+
+def _evidence_ref(evidence: dict[str, Any]) -> str:
+    label = str(evidence.get("label", "") or "").strip()
+    article = evidence.get("article_id", "")
+    document_title = evidence.get("document_title") or evidence.get("document_id", "")
+    prefix = f"{document_title} — " if document_title else ""
+    if label and label not in {"article", "preamble"}:
+        return f"{prefix}{article}/{label}"
+    return f"{prefix}{article}"
+
+
+def _clean_text(text: str) -> str:
+    return " ".join(str(text or "").split())
+
+
+def _frame_hint(frame: dict[str, Any]) -> str:
+    parts = []
+    for key in ("actor", "action", "object", "condition", "exception", "temporal_constraint", "modality"):
+        value = frame.get(key)
+        if value:
+            parts.append(f"{key}: {value}")
+    return "Semantik çerçeve: " + "; ".join(parts) if parts else "Semantik çerçeve: yok"
+
+
+def _flatten_evidence_spans(clauses: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    flattened = []
+    for clause in clauses:
+        flattened.extend(clause.get("evidence_spans", []) or [])
+    return flattened
+
+
+def _explicit_article_references(question: str) -> list[str]:
+    refs: list[str] = []
+    for match in re.finditer(r"\bEk\s+Madde\s+(\d+)\b", question or "", flags=re.IGNORECASE):
+        refs.append(f"Ek Madde {match.group(1)}")
+    for match in re.finditer(
+        r"\bGe[cç]ici\s+Madde\s+(\d+(?:/[A-Za-zÇĞİÖŞÜçğıöşü])?)\b",
+        question or "",
+        flags=re.IGNORECASE,
+    ):
+        ref = f"Geçici Madde {match.group(1).upper()}"
+        if ref not in refs:
+            refs.append(ref)
+    for match in re.finditer(r"\bMadde\s+(\d+(?:/[A-Za-zÇĞİÖŞÜçğıöşü])?)\b", question or "", flags=re.IGNORECASE):
+        prefix = (question or "")[max(0, match.start() - 8):match.start()].strip().lower()
+        if prefix in {"ek", "geçici", "gecici"}:
+            continue
+        ref = f"Madde {match.group(1).upper()}"
+        if ref not in refs:
+            refs.append(ref)
+    return refs

config.py

@@ -0,0 +1,74 @@
+import os
+from pathlib import Path
+
+APP_TITLE = "MitrAnlil Yükseköğretim Mevzuatı AI Asistanı"
+APP_VERSION = "MCKF v1.0 Proof-First Normative Intelligence"
+OFFICIAL_SOURCE_URL = (
+    "https://www.mevzuat.gov.tr/"
+)
+
+ROOT_DIR = Path(__file__).resolve().parent
+DATA_DIR = Path(os.getenv("MITRANLIL_DATA_DIR", str(ROOT_DIR / "data"))).resolve()
+SOURCE_DIR = DATA_DIR / "source"
+NORMALIZED_DIR = DATA_DIR / "normalized"
+STRUCTURAL_DIR = DATA_DIR / "structural"
+MCKF_DIR = DATA_DIR / "mckf"
+FEEDBACK_DIR = DATA_DIR / "feedback"
+ANALYTICS_DIR = DATA_DIR / "analytics"
+ADMIN_DIR = DATA_DIR / "admin"
+TEST_DATA_DIR = DATA_DIR / "tests"
+REGISTRY_DIR = DATA_DIR / "registry"
+ONBOARDING_DIR = DATA_DIR / "onboarding"
+INSTITUTION_REGISTRY_PATH = ONBOARDING_DIR / "institutions.json"
+SUBMISSIONS_DIR = ONBOARDING_DIR / "submissions"
+CANDIDATE_BUILDS_DIR = ONBOARDING_DIR / "builds"
+PUBLISH_BACKUPS_DIR = ONBOARDING_DIR / "backups"
+
+SOURCE_TEXT_PATH = SOURCE_DIR / "2547_clean.txt"
+LEGAL_DOCUMENT_REGISTRY_PATH = REGISTRY_DIR / "legal_documents.json"
+MCKF_ONTOLOGY_PATH = MCKF_DIR / "2547_mckf_ontology.json"
+MCKF_SEMANTIC_FRAMES_PATH = MCKF_DIR / "2547_semantic_frames.jsonl"
+MCKF_RETRIEVAL_INDEX_PATH = MCKF_DIR / "2547_retrieval_index.json"
+CORPUS_MCKF_ONTOLOGY_PATH = MCKF_DIR / "corpus_mckf_ontology.json"
+CORPUS_SEMANTIC_FRAMES_PATH = MCKF_DIR / "corpus_semantic_frames.jsonl"
+CORPUS_RETRIEVAL_INDEX_PATH = MCKF_DIR / "corpus_retrieval_index.json"
+CROSS_DOCUMENT_EDGES_PATH = MCKF_DIR / "cross_document_edges.jsonl"
+RDFOX_PILOT_MANIFEST_PATH = MCKF_DIR / "rdfox_pilot_manifest.json"
+RDFOX_PILOT_TRIPLES_PATH = MCKF_DIR / "rdfox_pilot_triples.nt"
+RDFOX_PILOT_RULES_PATH = MCKF_DIR / "rdfox_pilot_rules.dlog"
+MCKF_SHAPES_PATH = MCKF_DIR / "mckf_shapes.ttl"
+MCKF_VALIDATION_REPORT_PATH = MCKF_DIR / "validation_report.json"
+RUNTIME_BUILD_MANIFEST_PATH = MCKF_DIR / "runtime_build_manifest.json"
+FEEDBACK_LOG_PATH = Path(os.getenv("FEEDBACK_LOG_PATH", str(FEEDBACK_DIR / "dialogue_feedback.jsonl")))
+USAGE_LOG_PATH = Path(os.getenv("USAGE_LOG_PATH", str(ANALYTICS_DIR / "usage_events.jsonl")))
+CLARIFICATION_LOG_PATH = Path(os.getenv("CLARIFICATION_LOG_PATH", str(ANALYTICS_DIR / "clarification_events.jsonl")))
+ADMIN_EXAMPLES_PATH = Path(os.getenv("ADMIN_EXAMPLES_PATH", str(ADMIN_DIR / "example_questions.json")))
+
+LLM_PROVIDER = os.getenv("LLM_PROVIDER", "auto").strip().lower()
+HF_MODEL = os.getenv("HF_MODEL") or os.getenv("GEN_MODEL", "Qwen/Qwen2.5-7B-Instruct")
+HF_TOKEN = os.getenv("HF_TOKEN") or os.getenv("HUGGINGFACEHUB_API_TOKEN")
+
+GROQ_API_KEY = os.getenv("GROQ_API_KEY")
+# NOT: llama-3.3-70b-versatile, Groq tarafından 16 Ağustos 2026'da tamamen
+# kapatılıyor (bkz. https://console.groq.com/docs/deprecations). Groq'un
+# resmi önerisi openai/gpt-oss-120b veya qwen/qwen3.6-27b. gpt-oss-120b'yi
+# seçtik: daha büyük parametre sayısı + reasoning modu, katı JSON claim
+# şemamız (proof_bundle.py) için daha güvenilir talimat takibi sağlıyor,
+# ayrıca Groq'ta token başına daha ucuz ve daha hızlı (bkz. sohbet
+# geçmişindeki fiyat/hız karşılaştırması). Free tier'da TPM sınırı
+# llama-3.3-70b-versatile'a göre daha düşük (8K vs 12K) — demo öncesi
+# Groq konsolünden hesap tier'ını ve gerçek istek hacmini test et.
+GROQ_MODEL = os.getenv("GROQ_MODEL", "openai/gpt-oss-120b")
+
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+OPENAI_MODEL = os.getenv("OPENAI_MODEL", "gpt-4o-mini")
+
+# NOT: proof_bundle.py'deki synthesis claim mekanizması ve llm_claim_prompt
+# içindeki few-shot örnekler çıktı uzunluğunu artırdı; 1000 tokenlık eski
+# sınır, çok maddeli sentez cevaplarında JSON'un ortadan kesilip parse
+# hatası vermesine yol açabilirdi. 1500'e çıkarıldı — bu, girdi promptunun
+# değil yalnızca modelin ÜRETTİĞİ çıktının üst sınırıdır.
+MAX_NEW_TOKENS = int(os.getenv("MAX_NEW_TOKENS", "1500"))
+MAX_CONTEXT_CHARS = int(os.getenv("MAX_CONTEXT_CHARS", "3000"))
+CHATBOT_HEIGHT = int(os.getenv("CHATBOT_HEIGHT", "820"))
+EVAL_CONTEXT_MAX_CHARS = int(os.getenv("EVAL_CONTEXT_MAX_CHARS", "6000"))

conversation_intent.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from utils import normalize_for_search
+
+
+class ConversationIntent:
+    EMPTY = "empty"
+    GREETING = "greeting"
+    HELP = "help"
+    THANKS = "thanks"
+    OUT_OF_SCOPE = "out_of_scope"
+    LEGAL_QUERY = "legal_query"
+
+
+GREETING_ANSWER = (
+    "Merhaba. Ben MitrAnlil Yükseköğretim Mevzuatı AI Asistanıyım. "
+    "2547, 2914 ve 2809 sayılı kanunlara dayalı olarak kaynak gösterimli cevaplar üretirim. "
+    "YÖK, üniversiteler, akademik personel, öğrenciler, teşkilat, ödenekler, görevler, yetkiler ve ilgili hükümler hakkında soru sorabilirsiniz."
+)
+
+HELP_ANSWER = (
+    "Ben yükseköğretim mevzuatı için geliştirilmiş kaynak gösterimli bir mevzuat asistanıyım. "
+    "Sorunuzu kanundaki madde, alt hüküm ve kanıt parçalarıyla eşleştirerek cevaplamaya çalışırım. "
+    "Örneğin dekanın görevleri, YÖK'ün oluşumu, ek ders ücreti, üniversite ödeneği, teşkilat yapısı veya kurumların kuruluşu hakkında soru sorabilirsiniz."
+)
+
+THANKS_ANSWER = "Rica ederim. Yükseköğretim mevzuatı ile ilgili başka bir soru sorabilirsiniz."
+
+OUT_OF_SCOPE_ANSWER = (
+    "Bu pilot yükseköğretim mevzuatı kapsamında kaynak gösterimli cevap üretmek üzere tasarlanmıştır. "
+    "YÖK, üniversiteler, akademik personel, öğrenciler, diplomalar, teşkilat, ödenekler, görevler ve yetkiler gibi konularda soru sorabilirsiniz."
+)
+
+
+@dataclass(frozen=True)
+class ConversationIntentResult:
+    intent: str
+    answer: str = ""
+
+
+LEGAL_CUE_TERMS = {
+    "egitim", "uzaktan egitim", "yonetmelik", "yonerge", "tez", "savunma",
+    "tez savunmasi", "basvuru", "devam", "akademik takvim",
+    "2547", "2914", "2809", "kanun", "madde", "yok", "yök", "yuksekogretim", "yükseköğretim",
+    "universite", "üniversite", "rektor", "rektör", "dekan", "senato", "fakulte", "fakülte",
+    "enstitu", "enstitü", "yuksekokul", "yüksekokul", "meslek", "onlisans", "önlisans",
+    "on lisans", "ön lisans", "lisans", "diploma", "ogrenci", "öğrenci", "ogretim", "öğretim",
+    "profesor", "profesör", "docent", "doçent", "arastirma", "araştırma", "gorev", "görev",
+    "yetki", "sorumluluk", "atan", "atama", "kurul", "kurulus", "kuruluş", "disiplin",
+    "harc", "harç", "katki", "katkı", "ucret", "ücret", "denklik", "azami", "sure", "süre",
+    "ek ders", "ödenek", "odenek", "derece", "kademe", "teşkilat", "teskilat",
+    "faaliyete", "ek gösterge", "ek gosterge", "makam tazminatı", "makam tazminati",
+}
+
+OUT_OF_SCOPE_CUE_TERMS = {
+    "hava", "yemek", "tarif", "siir", "şiir", "hikaye", "futbol", "borsa", "kripto",
+    "film", "muzik", "müzik", "resim", "kod yaz", "mail yaz", "cevir", "çevir",
+}
+
+
+def detect_conversation_intent(message: str) -> ConversationIntentResult:
+    raw = (message or "").strip()
+    normalized = normalize_for_search(raw)
+    compact = normalized.replace(" ", "")
+
+    if not normalized:
+        return ConversationIntentResult(ConversationIntent.EMPTY, "Lütfen yükseköğretim mevzuatı ile ilgili bir soru yazın.")
+
+    if _is_greeting(normalized, compact):
+        return ConversationIntentResult(ConversationIntent.GREETING, GREETING_ANSWER)
+
+    if _is_thanks(normalized):
+        return ConversationIntentResult(ConversationIntent.THANKS, THANKS_ANSWER)
+
+    if _is_help_request(normalized):
+        return ConversationIntentResult(ConversationIntent.HELP, HELP_ANSWER)
+
+    if _has_legal_cue(normalized):
+        return ConversationIntentResult(ConversationIntent.LEGAL_QUERY, "")
+
+    if _has_out_of_scope_cue(normalized):
+        return ConversationIntentResult(ConversationIntent.OUT_OF_SCOPE, OUT_OF_SCOPE_ANSWER)
+
+    # Questions without legal cues should still reach the MCKF engine when they look
+    # like normative questions. This avoids blocking short queries such as "kim atar?"
+    # in follow-up-like usage while keeping pure greetings outside retrieval.
+    if any(term in normalized for term in ("nedir", "nasil", "nasıl", "kim", "hangi", "ne zaman", "kac", "kaç", "gerekir", "olur")):
+        return ConversationIntentResult(ConversationIntent.LEGAL_QUERY, "")
+
+    return ConversationIntentResult(ConversationIntent.OUT_OF_SCOPE, OUT_OF_SCOPE_ANSWER)
+
+
+def _is_greeting(normalized: str, compact: str) -> bool:
+    greetings = {
+        "merhaba", "selam", "selamlar", "gunaydin", "günaydın", "iyi gunler", "iyi günler",
+        "iyi aksamlar", "iyi akşamlar", "iyi geceler", "kolay gelsin", "mrb", "slm",
+    }
+    if normalized in greetings or compact in {g.replace(" ", "") for g in greetings}:
+        return True
+    if len(normalized.split()) <= 3 and any(g in normalized for g in greetings):
+        return True
+    return False
+
+
+def _is_thanks(normalized: str) -> bool:
+    return len(normalized.split()) <= 6 and any(term in normalized for term in ("tesekkur", "teşekkür", "sag ol", "sağ ol", "eyvallah", "tşk"))
+
+
+def _is_help_request(normalized: str) -> bool:
+    return any(phrase in normalized for phrase in (
+        "ne yapabilirsin", "neler yapabilirsin", "nasil calisiyorsun", "nasıl çalışıyorsun",
+        "bu sistem nedir", "yardim", "yardım", "hangi sorular", "ne sorabilirim",
+    ))
+
+
+def _has_legal_cue(normalized: str) -> bool:
+    return any(term in normalized for term in LEGAL_CUE_TERMS)
+
+
+def _has_out_of_scope_cue(normalized: str) -> bool:
+    return any(term in normalized for term in OUT_OF_SCOPE_CUE_TERMS)

data/mckf/cross_document_edges.jsonl

@@ -0,0 +1,16 @@
+{"edge_id": "2914_m1_refs_2547_teacher_definition", "source_document_id": "TR-KANUN-2914", "source_article_id": "Madde 1", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 3", "relation_type": "references_definition", "description": "2914, kapsamını 2547 sayılı Kanundaki öğretim elemanları tanımına bağlar."}
+{"edge_id": "2914_m11_details_2547_m36_ders_yuku", "source_document_id": "TR-KANUN-2914", "source_article_id": "Madde 11", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 36", "relation_type": "details_personnel_payment", "description": "2914 Madde 11 ek ders ücretini 2547 Madde 36 ders yükü bağlamıyla ilişkilendirir."}
+{"edge_id": "2809_m3_refs_2547_m7_unit_regulation", "source_document_id": "TR-KANUN-2809", "source_article_id": "Madde 3", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 7", "relation_type": "organizational_detail_regulated_by", "description": "2809 Madde 3, alt birimlerin teşkili ve işleyişinde 2547 Madde 7 uyarınca YÖK düzenlemesine atıf yapar."}
+{"edge_id": "tr_kanun_2914_madde_11_refs_2547_36", "source_document_id": "TR-KANUN-2914", "source_article_id": "Madde 11", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 36", "relation_type": "references_2547_article", "description": "2914 sayılı Yükseköğretim Personel Kanunu Madde 11, 2547 Madde 36 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2914_madde_16_refs_2547_34", "source_document_id": "TR-KANUN-2914", "source_article_id": "Madde 16", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 34", "relation_type": "references_2547_article", "description": "2914 sayılı Yükseköğretim Personel Kanunu Madde 16, 2547 Madde 34 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2914_ek_madde_1_refs_2547_33", "source_document_id": "TR-KANUN-2914", "source_article_id": "Ek Madde 1", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 33", "relation_type": "references_2547_article", "description": "2914 sayılı Yükseköğretim Personel Kanunu Ek Madde 1, 2547 Madde 33 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2914_geçici_madde_7_refs_2547_23", "source_document_id": "TR-KANUN-2914", "source_article_id": "Geçici Madde 7", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 23", "relation_type": "references_2547_article", "description": "2914 sayılı Yükseköğretim Personel Kanunu Geçici Madde 7, 2547 Madde 23 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2914_geçici_madde_9_refs_2547_5", "source_document_id": "TR-KANUN-2914", "source_article_id": "Geçici Madde 9", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 5", "relation_type": "references_2547_article", "description": "2914 sayılı Yükseköğretim Personel Kanunu Geçici Madde 9, 2547 Madde 5 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_madde_3_refs_2547_7", "source_document_id": "TR-KANUN-2809", "source_article_id": "Madde 3", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 7", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Madde 3, 2547 Madde 7 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_ek_madde_158_refs_2547_4", "source_document_id": "TR-KANUN-2809", "source_article_id": "Ek Madde 158", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 4", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Ek Madde 158, 2547 Madde 4 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_ek_madde_158_refs_2547_3", "source_document_id": "TR-KANUN-2809", "source_article_id": "Ek Madde 158", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 3", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Ek Madde 158, 2547 Madde 3 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_geçici_madde_1_refs_2547_3", "source_document_id": "TR-KANUN-2809", "source_article_id": "Geçici Madde 1", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 3", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Geçici Madde 1, 2547 Madde 3 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_geçici_madde_3_refs_2547_32", "source_document_id": "TR-KANUN-2809", "source_article_id": "Geçici Madde 3", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 32", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Geçici Madde 3, 2547 Madde 32 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_geçici_madde_3_refs_2547_16", "source_document_id": "TR-KANUN-2809", "source_article_id": "Geçici Madde 3", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 16", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Geçici Madde 3, 2547 Madde 16 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_geçici_madde_9_refs_2547_41", "source_document_id": "TR-KANUN-2809", "source_article_id": "Geçici Madde 9", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 41", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Geçici Madde 9, 2547 Madde 41 hükmüne atıf yapar."}
+{"edge_id": "tr_kanun_2809_geçici_madde_51_refs_2547_50", "source_document_id": "TR-KANUN-2809", "source_article_id": "Geçici Madde 51", "target_document_id": "TR-KANUN-2547", "target_article_id": "Madde 50", "relation_type": "references_2547_article", "description": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu Geçici Madde 51, 2547 Madde 50 hükmüne atıf yapar."}

data/mckf/mckf_shapes.ttl

@@ -0,0 +1,27 @@
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix mckf: <https://mitranlil.ai/mckf/> .
+
+mckf:DocumentShape
+    a sh:NodeShape ;
+    sh:targetClass mckf:Document ;
+    sh:property [ sh:path mckf:documentId ; sh:minCount 1 ; sh:maxCount 1 ] ;
+    sh:property [ sh:path mckf:title ; sh:minCount 1 ] .
+
+mckf:ConceptShape
+    a sh:NodeShape ;
+    sh:targetSubjectsOf mckf:conceptType ;
+    sh:property [ sh:path mckf:document ; sh:minCount 1 ; sh:nodeKind sh:IRI ] ;
+    sh:property [ sh:path mckf:articleId ; sh:minCount 1 ] ;
+    sh:property [ sh:path mckf:sourceLock ; sh:hasValue true ] ;
+    sh:property [ sh:path mckf:citationRequired ; sh:hasValue true ] .
+
+mckf:NormativeUnitShape
+    a sh:NodeShape ;
+    sh:targetSubjectsOf mckf:unitType ;
+    sh:property [ sh:path mckf:evidenceId ; sh:minCount 1 ; sh:maxCount 1 ] ;
+    sh:property [ sh:path mckf:document ; sh:minCount 1 ; sh:nodeKind sh:IRI ] ;
+    sh:property [ sh:path mckf:articleId ; sh:minCount 1 ] ;
+    sh:property [ sh:path mckf:parentClause ; sh:minCount 1 ; sh:nodeKind sh:IRI ] ;
+    sh:property [ sh:path mckf:sourceText ; sh:minCount 1 ] .

data/mckf/rdfox_pilot_manifest.json

@@ -0,0 +1,133 @@
+{
+  "schema": "MCKF-SemanticGraphRuntime-v1.0",
+  "status": "runtime_graph_and_shacl_enabled",
+  "goal": "find_the_right_provision_show_the_right_condition_answer_with_sources",
+  "mvp_core": [
+    "document_ingestion",
+    "semantic_normative_unit_parser",
+    "mckf_builder",
+    "hybrid_retrieval",
+    "evidence_sufficiency_gate",
+    "source_locked_generation",
+    "citation_renderer"
+  ],
+  "post_pilot": [
+    "full_rule_engine",
+    "wide_graph_traversal",
+    "exception_precedence_inference",
+    "strict_rdf_compliance",
+    "ontology_layer"
+  ],
+  "runtime_contract": {
+    "source_lock": true,
+    "citation_required": true,
+    "external_rdfox_required": false,
+    "runtime_graph_backend": "RDFLib SPARQL with RDFox-compatible exports",
+    "shacl_validation_required": true,
+    "rdfox_export_paths": [
+      "data/mckf/rdfox_pilot_manifest.json",
+      "data/mckf/rdfox_pilot_triples.nt",
+      "data/mckf/rdfox_pilot_rules.dlog"
+    ]
+  },
+  "data_contract": {
+    "MVPConcept": {
+      "source": "data/mckf/corpus_mckf_ontology.json::concepts",
+      "fields": [
+        "concept_id",
+        "document_id",
+        "article_id",
+        "concept_type",
+        "title",
+        "aliases",
+        "source_unit_ids",
+        "actors",
+        "actions",
+        "conditions",
+        "exceptions",
+        "temporal_constraints",
+        "related_articles",
+        "source_text",
+        "source_policy"
+      ]
+    },
+    "MVPSemanticNormativeUnit": {
+      "source": "data/mckf/corpus_mckf_ontology.json::evidence_spans",
+      "fields": [
+        "unit_id",
+        "document_id",
+        "article_id",
+        "clause_path",
+        "raw_text",
+        "normalized_text",
+        "unit_type",
+        "actors",
+        "actions",
+        "conditions",
+        "exceptions",
+        "temporal_constraints",
+        "cross_references",
+        "extraction_confidence"
+      ]
+    }
+  },
+  "retrieval_channels": [
+    "bm25",
+    "lsa_dense",
+    "semantic_frame",
+    "sparql_graph",
+    "exact_reference"
+  ],
+  "fusion": "weighted_reciprocal_rank_fusion",
+  "micro_rules": [
+    {
+      "rule_id": "deadline_priority",
+      "effect": "deadline units receive a retrieval bonus for duration/date questions"
+    },
+    {
+      "rule_id": "procedure_chain",
+      "effect": "procedure evidence is ordered by source span when procedure intent is detected"
+    },
+    {
+      "rule_id": "exception_warning",
+      "effect": "selected exception evidence adds a visible caution to the answer"
+    },
+    {
+      "rule_id": "cross_reference_follow",
+      "effect": "cross-document/article references are exported as RDF edges and scored as retrieval hints"
+    },
+    {
+      "rule_id": "definition_attach",
+      "effect": "definition units are boosted for term-definition questions"
+    }
+  ],
+  "stats": {
+    "document_count": 3,
+    "concept_count": 544,
+    "semantic_normative_unit_count": 4659,
+    "unit_type_counts": {
+      "condition": 242,
+      "deadline": 792,
+      "definition": 630,
+      "exception": 126,
+      "obligation": 2293,
+      "permission": 86,
+      "procedure": 477,
+      "prohibition": 13
+    },
+    "concept_type_counts": {
+      "deadline_rule": 482,
+      "exception_rule": 2,
+      "obligation_rule": 55,
+      "permission_rule": 2,
+      "procedure_rule": 3
+    },
+    "cross_document_edge_count": 16
+  },
+  "outputs": {
+    "manifest": "C:/Users/user/Desktop/MITRANLIL/2547_AI/mitranlil_mckf_v0_8_multidoc/hf_hermeneutic_YOK_Kanunlar/data/mckf/rdfox_pilot_manifest.json",
+    "triples": "C:/Users/user/Desktop/MITRANLIL/2547_AI/mitranlil_mckf_v0_8_multidoc/hf_hermeneutic_YOK_Kanunlar/data/mckf/rdfox_pilot_triples.nt",
+    "rules": "C:/Users/user/Desktop/MITRANLIL/2547_AI/mitranlil_mckf_v0_8_multidoc/hf_hermeneutic_YOK_Kanunlar/data/mckf/rdfox_pilot_rules.dlog",
+    "triple_count": 90194
+  }
+}

data/mckf/rdfox_pilot_rules.dlog

@@ -0,0 +1,26 @@
+# MCKF RDFox pilot micro-rules.
+# These rules are a portable MVP contract for RDFox/Datalog migration.
+# Runtime uses equivalent Python micro-rules in rdfox_pilot.py.
+
+PREFIX mckf: <https://mitranlil.ai/mckf/>
+PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
+
+# deadline_priority
+mckf:retrievalHint[?unit, "deadline_priority"] :-
+  ?unit rdf:type mckf:DeadlineUnit .
+
+# procedure_chain
+mckf:retrievalHint[?unit, "procedure_chain"] :-
+  ?unit rdf:type mckf:ProcedureUnit .
+
+# exception_warning
+mckf:answerWarning[?unit, "exception_warning"] :-
+  ?unit rdf:type mckf:ExceptionUnit .
+
+# cross_reference_follow
+mckf:followReference[?unit, ?target] :-
+  ?unit mckf:crossReferences ?target .
+
+# definition_attach
+mckf:retrievalHint[?unit, "definition_attach"] :-
+  ?unit rdf:type mckf:DefinitionUnit .

data/mckf/runtime_build_manifest.json

@@ -0,0 +1,41 @@
+{
+  "schema": "MCKF-RuntimeBuildManifest-v1.0",
+  "build_id": "mckf-27720ea50a2f1088f3a5",
+  "generated_at": "2026-07-17T11:29:16.439250+00:00",
+  "active_institution_id": "",
+  "validation_conforms": true,
+  "artifacts": {
+    "corpus_mckf_ontology.json": {
+      "sha256": "a5ec5332013fe235a92520185f912a37efb1bc5ddb2b4b63fe863b67c883babb",
+      "bytes": 154825466
+    },
+    "corpus_retrieval_index.json": {
+      "sha256": "17a5206ffdaa8ad90e81d12e2b8c4563e0eb29b5aed3d578ee225fec20be632a",
+      "bytes": 1903364
+    },
+    "corpus_semantic_frames.jsonl": {
+      "sha256": "24b484e36557d14ea6ba237c1a3dbf84c494b76fd025d9a8287f97960c7ce18f",
+      "bytes": 11525656
+    },
+    "cross_document_edges.jsonl": {
+      "sha256": "086fcb9df06fa9dad713fc10aed33016dbf66e3a507d31cc0688db30dcc0df37",
+      "bytes": 5916
+    },
+    "rdfox_pilot_triples.nt": {
+      "sha256": "eca8aa204e6bbde856dda3da19df41da5b5d714c43313d09a7d705f176404a56",
+      "bytes": 15653736
+    },
+    "rdfox_pilot_rules.dlog": {
+      "sha256": "1492b1fe5e31e7338c77af042e5449bd999f3613b6e086c55ccf5279c975f241",
+      "bytes": 831
+    },
+    "mckf_shapes.ttl": {
+      "sha256": "e98499cf16b894a2343bf9869b0d9928e63a1dbceba907ada64070386bb1d1ee",
+      "bytes": 1253
+    },
+    "validation_report.json": {
+      "sha256": "b1169f4bbe9310e8dd36917c44b817e2c4c6bb374f6ef3d6713e97c300d8f0d0",
+      "bytes": 488
+    }
+  }
+}

data/mckf/validation_report.json

@@ -0,0 +1,22 @@
+{
+  "schema": "MCKF-ValidationReport-v1.0",
+  "build_id": "mckf-27720ea50a2f1088f3a5",
+  "conforms": true,
+  "summary": {
+    "documents": 3,
+    "concepts": 544,
+    "clauses": 2551,
+    "evidence_spans": 4659,
+    "errors": 0,
+    "warnings": 0,
+    "low_confidence_evidence": 732
+  },
+  "issues": [],
+  "shacl": {
+    "status": "ok",
+    "conforms": true,
+    "triple_count": 90194,
+    "result_count": 2,
+    "message": "Validation Report\nConforms: True\n"
+  }
+}

data/normalized/2547_document.json

@@ -0,0 +1,11 @@
+{
+  "document_id": "TR-KANUN-2547",
+  "document_title": "2547 sayılı Yükseköğretim Kanunu",
+  "short_code": "2547",
+  "source_path": "data/source/2547_clean.txt",
+  "article_count": 207,
+  "raw_structural_clauses": 845,
+  "schedule_count": 0,
+  "source_sha256": "2a6faa2af2da269d8a132cb2870461a97a0dadf464fe5f94bc0ff66864655800",
+  "version_id": "TR-KANUN-2547@sha256:2a6faa2af2da269d"
+}

data/normalized/2809_document.json

@@ -0,0 +1,11 @@
+{
+  "document_id": "TR-KANUN-2809",
+  "document_title": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu",
+  "short_code": "2809",
+  "source_path": "data/source/2809_clean.txt",
+  "article_count": 298,
+  "raw_structural_clauses": 1654,
+  "schedule_count": 0,
+  "source_sha256": "46788726a86239d6ec0f3a03d45493329a763c6e2af2b50cc3bf889a8de42df5",
+  "version_id": "TR-KANUN-2809@sha256:46788726a86239d6"
+}

data/normalized/2914_document.json

@@ -0,0 +1,11 @@
+{
+  "document_id": "TR-KANUN-2914",
+  "document_title": "2914 sayılı Yükseköğretim Personel Kanunu",
+  "short_code": "2914",
+  "source_path": "data/source/2914_clean.txt",
+  "article_count": 37,
+  "raw_structural_clauses": 76,
+  "schedule_count": 2,
+  "source_sha256": "1788ed3dd28b01bdcc0f70df1a6dc69199d3250a2f6b0b67fd99ef8742957974",
+  "version_id": "TR-KANUN-2914@sha256:1788ed3dd28b01bd"
+}

data/registry/document_semantic_profiles.json

@@ -0,0 +1,502 @@
+{
+  "schema": "MCKF-DocumentSemanticProfiles-v1.0",
+  "documents": {
+    "TR-KANUN-2547": {
+      "domain_path": ["yükseköğretim", "kurumsal çerçeve"],
+      "semantic_dimensions": {
+        "kurumsal_aktör": {
+          "Yükseköğretim Kurulu": ["YÖK", "Yükseköğretim Kurulunca"],
+          "Üniversitelerarası Kurul": ["ÜAK", "Üniversitelerarası Kurulca"],
+          "rektör": ["rektörlük", "rektör tarafından"],
+          "senato": ["üniversite senatosu"],
+          "üniversite yönetim kurulu": ["yönetim kurulu"],
+          "dekan": ["dekanlık"],
+          "enstitü": ["enstitü müdürü", "enstitü kurulu", "enstitü yönetim kurulu"],
+          "öğretim elemanı": ["öğretim üyesi", "öğretim görevlisi", "araştırma görevlisi"],
+          "öğrenci": ["öğrenciler", "öğrencinin"]
+        },
+        "normatif_işlem": {
+          "atama": ["atanır", "atanması", "atamak"],
+          "seçim": ["seçilir", "seçimi", "seçmek"],
+          "görevlendirme": ["görevlendirilir", "görevlendirmek"],
+          "kuruluş": ["kurulur", "açılır", "teşkil edilir"],
+          "kayıt": ["kayıt yaptırmak", "kayıt yenilemek", "kaydının"],
+          "disiplin": ["disiplin cezası", "soruşturma"],
+          "izin": ["izinli", "izin verilir"],
+          "denetim": ["denetlemek", "gözetim", "kontrol"]
+        },
+        "eğitim_süreci": {
+          "ders": ["ders yükü", "ders kredisi", "teorik ders"],
+          "sınav": ["sınavlar", "sınav hakkı"],
+          "tez": ["tez çalışması", "tez danışmanı"],
+          "mezuniyet": ["mezun", "diploma almaya hak"],
+          "öğrenci kaydı": ["kayıt", "kayıt yenileme"],
+          "eğitim-öğretim": ["öğretim yılı", "akademik yıl"]
+        },
+        "hukuki_rol": {
+          "görev": ["görevleri", "görev yapmak"],
+          "yetki": ["yetkileri", "yetkilidir"],
+          "sorumluluk": ["sorumludur", "sorumlulukları"],
+          "hak": ["hakkı", "hak kazanır"],
+          "yükümlülük": ["yükümlüdür", "zorundadır"]
+        },
+        "zamansal_kısıt": {
+          "azami süre": ["azami süreler", "en fazla"],
+          "dönem": ["yarıyıl", "öğretim dönemi"],
+          "yıl": ["yıllık", "yıl için"],
+          "gün": ["gün içinde", "günlük"]
+        }
+      },
+      "article_overrides": {
+        "Ek Madde 1": {
+          "display_heading": "Süresi dolmadan rektör, dekan, müdür, yardımcı ve bölüm başkanını görevden alma",
+          "regulates": "Belirli üniversite yöneticilerinin kanuni görev süreleri dolmadan atamadaki usule göre görevden alınması",
+          "canonical_concepts": [
+            "üniversite yöneticisinin süresi dolmadan görevden alınması",
+            "rektör dekan müdür ve yardımcılarının görevden alınması",
+            "bölüm başkanının görevden alınması"
+          ],
+          "query_aliases": [
+            "rektör görev süresi dolmadan görevden alınabilir mi",
+            "dekan görevden nasıl alınır",
+            "enstitü müdürü görevden alma",
+            "yüksekokul müdürü görevden alma",
+            "rektör yardımcısı görevden alma",
+            "dekan yardımcısı görevden alma",
+            "bölüm başkanını görevden alma"
+          ],
+          "subject_classes": ["rector", "dean", "institute_director", "school_director", "deputy_manager", "department_head"],
+          "regulated_situations": [
+            "kanuni görev süresi dolmadan görevden alma",
+            "atamadaki usule uygun görevden alma"
+          ],
+          "legal_effect_types": ["termination_of_office", "authority_or_duty"],
+          "legal_operations": ["görevden alma"],
+          "competent_authorities": ["atamadaki usule göre yetkili makam"],
+          "operational_actors": [],
+          "exclusions": [
+            "öğretim üyesinin görevden alınması",
+            "profesörün görevden alınması",
+            "doçentin görevden alınması",
+            "doktor öğretim üyesinin görevden alınması",
+            "öğretim görevlisinin görevden alınması",
+            "araştırma görevlisinin görevden alınması",
+            "Yükseköğretim Kurulu Başkanının görevden alınması",
+            "Üniversitelerarası Kurul üyesinin görevden alınması",
+            "genel sekreterin görevden alınması"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Ek Madde 2": {
+          "display_heading": "Vakıfların yükseköğretim kurumu, bağlı birim veya bağımsız meslek yüksekokulu kurması",
+          "regulates": "Vakıfların yükseköğretim kurumu veya bağlı birim ile üniversiteye bağlı olmayan meslek yüksekokulu kurabilmesinin şartları",
+          "canonical_concepts": [
+            "vakıf yükseköğretim kurumu kurma",
+            "vakfın bağımsız meslek yüksekokulu kurması",
+            "vakıf üniversitesi veya bağlı birim kurma"
+          ],
+          "query_aliases": [
+            "vakıf üniversite kurabilir mi",
+            "vakıf yükseköğretim kurumu nasıl kurulur",
+            "vakıf bağımsız meslek yüksekokulu kurabilir mi",
+            "vakıfların yükseköğretim kurumu kurma şartları",
+            "üniversiteye bağlı olmayan meslek yüksekokulu"
+          ],
+          "subject_classes": ["foundation", "higher_education_institution", "vocational_school"],
+          "regulated_situations": [
+            "kazanç amacı bulunmadan yükseköğretim kurumu kurma",
+            "Cumhurbaşkanı kararıyla bağımsız meslek yüksekokulu kurma",
+            "mesleki ve teknik eğitim bölgesinde gereksinim bulunması"
+          ],
+          "legal_effect_types": ["establishment", "eligibility", "authority_or_duty"],
+          "legal_operations": ["yükseköğretim kurumu kurma", "bağlı birim kurma", "bağımsız meslek yüksekokulu kurma"],
+          "competent_authorities": ["vakıf", "Cumhurbaşkanı"],
+          "operational_actors": [],
+          "exclusions": [
+            "kazanç amaçlı yükseköğretim yapısı kurma",
+            "bağımsız fakülte kurma",
+            "bağımsız enstitü kurma",
+            "vakfın mali ve idari hususlarda serbest olması"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Ek Madde 3": {
+          "display_heading": "Vakıf yükseköğretim kurumu kuruluş başvurusunda sunulacak belgeler",
+          "regulates": "Vakıf yükseköğretim kurumu kurma başvurusunda Yükseköğretim Kurulu Başkanlığına sunulacak karar, olumlu yazı ve belgeler",
+          "canonical_concepts": [
+            "vakıf yükseköğretim kurumu kuruluş belgeleri",
+            "vakıf üniversitesi kuruluş başvurusu",
+            "tıp fakültesi kuruluşunda hastane şartı"
+          ],
+          "query_aliases": [
+            "vakıf üniversitesi kurmak için hangi belgeler gerekir",
+            "vakıf yükseköğretim kurumu kuruluş başvurusu",
+            "vakıf üniversitesi başvuru belgeleri",
+            "tıp fakültesi kurmak için hastane şartı",
+            "vakıf üniversitesi başvurusu nereye yapılır"
+          ],
+          "subject_classes": ["foundation", "higher_education_institution", "medical_faculty"],
+          "regulated_situations": [
+            "kuruluş kararının ve Vakıflar Genel Müdürlüğü olumlu yazısının sunulması",
+            "bina araç gereç ve mali kaynak belgelerinin sunulması",
+            "tıp fakültesi için hastane ön izin veya devir belgesi sunulması"
+          ],
+          "legal_effect_types": ["application_procedure", "document_obligation", "eligibility"],
+          "legal_operations": ["başvuru", "belge sunma", "belge inceleme"],
+          "competent_authorities": ["vakıf veya vakıflar", "Vakıflar Genel Müdürlüğü", "Yükseköğretim Kurulu Başkanlığı"],
+          "operational_actors": ["Sağlık Bakanlığı planlama birimleri"],
+          "exclusions": [
+            "vakıf yükseköğretim kurumunun kuruluş kararının verilmesi",
+            "tıp fakültesi dışındaki fakülteler için hastane şartı",
+            "her fakülte için iki yüz yatak şartı"
+          ],
+          "review_notes": [
+            "Millî Eğitim Bakanlığı aktif madde metninde açık görevli olarak yer almadığından yetkili listesine eklenmedi."
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Ek Madde 8": {
+          "display_heading": "Vakıf yükseköğretim kurumlarında akademik organlar, öğretim elemanı nitelikleri ve ücret tabanı",
+          "regulates": "Vakıf yükseköğretim kurumlarının akademik organlarını, öğretim elemanı nitelik ve istihdam sınırlarını ve devlet kurumlarındaki emsal ücrete bağlı asgari ücretini",
+          "canonical_concepts": [
+            "vakıf üniversitesi akademik organları",
+            "vakıf üniversitesi öğretim elemanı nitelikleri",
+            "vakıf üniversitesi öğretim elemanı asgari ücreti"
+          ],
+          "query_aliases": [
+            "vakıf üniversitesinde öğretim elemanı maaşı ne kadar olmalı",
+            "vakıf üniversitesi emsal ücret",
+            "vakıf üniversitesi akademik organları",
+            "disiplinle çıkarılan kişi vakıf üniversitesinde çalışabilir mi",
+            "vakıf üniversitesinde öğretim elemanı olma şartları"
+          ],
+          "subject_classes": ["foundation_higher_education_institution", "academic_staff"],
+          "regulated_situations": [
+            "akademik organların devlet yükseköğretim kurumları gibi düzenlenmesi",
+            "öğretim elemanı niteliklerinin eşitliği",
+            "disiplinle çıkarılmış kişilerin istihdam yasağı",
+            "devlet yükseköğretim kurumundaki emsal ücretin altında ödeme yasağı"
+          ],
+          "legal_effect_types": ["organization", "eligibility", "employment_prohibition", "payment_obligation"],
+          "legal_operations": ["akademik organ düzenleme", "istihdam yasağı uygulama", "asgari ücret ödeme"],
+          "competent_authorities": [],
+          "operational_actors": ["vakıf yükseköğretim kurumu"],
+          "exclusions": [
+            "öğretim elemanının izin hakkı",
+            "öğretim elemanının sigorta hakkı",
+            "disiplin soruşturmasının usulü",
+            "öğretim elemanı ücret tavanı",
+            "öğretim elemanı ek ödemeleri"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Ek Madde 9": {
+          "display_heading": "Vakıf yükseköğretim kurumlarında eğitim esasları, öğrenci hakları, ücret ve ücretsiz okutma oranı",
+          "regulates": "Vakıf yükseköğretim kurumlarında eğitim ve öğrenci hakları ile öğrenim ücretinin belirlenmesini ve belirli programlarda en az yüzde on beş ücretsiz okutma yükümlülüğünü",
+          "canonical_concepts": [
+            "vakıf üniversitesi öğrenim ücreti",
+            "vakıf üniversitesi ücretsiz öğrenci oranı",
+            "vakıf üniversitesinde öğrenci hakları"
+          ],
+          "query_aliases": [
+            "vakıf üniversitesi ücret artışı nasıl belirlenir",
+            "vakıf üniversitesi yüzde on beş ücretsiz öğrenci",
+            "vakıf üniversitesinde ücretsiz okutma zorunluluğu",
+            "vakıf üniversitesi öğrenim ücretini kim belirler",
+            "tezli yüksek lisans ücretsiz kontenjan"
+          ],
+          "subject_classes": ["foundation_higher_education_institution", "student"],
+          "regulated_situations": [
+            "mütevelli heyetin öğrenim ücretini belirlemesi",
+            "sonraki yılların ücret artış esaslarının Yükseköğretim Kurulunca belirlenmesi",
+            "ön lisans lisans tezli yüksek lisans ve doktorada en az yüzde on beş ücretsiz okutma"
+          ],
+          "legal_effect_types": ["payment_obligation", "authority_or_duty", "education_right"],
+          "legal_operations": ["öğrenim ücreti tespiti", "ücret artış esaslarını belirleme", "ücretsiz okutma"],
+          "competent_authorities": ["mütevelli heyet", "Yükseköğretim Kurulu"],
+          "operational_actors": ["vakıf yükseköğretim kurumu"],
+          "exclusions": [
+            "tezsiz yüksek lisans ücretsiz okutma zorunluluğu",
+            "hazırlık ve birinci sınıf ilk kayıt ücretine ÜFE TÜFE sınırlaması",
+            "ücretsiz okutma oranının en fazla yüzde on beş olması"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Ek Madde 11": {
+          "display_heading": "Vakıf yükseköğretim kurumlarının denetimi, faaliyet izni ve tasfiyesi",
+          "regulates": "Vakıf yükseköğretim kurumlarının denetimini, faaliyetinin durdurulmasını, faaliyet izninin kaldırılmasını, öğrenci naklini ve tasfiyesini",
+          "canonical_concepts": [
+            "vakıf üniversitesinin faaliyet izninin kaldırılması",
+            "vakıf üniversitesinin tasfiyesi",
+            "vakıf yükseköğretim kurumu denetimi",
+            "garantör üniversiteye öğrenci nakli"
+          ],
+          "query_aliases": [
+            "vakıf üniversitesi nasıl kapatılır",
+            "vakıf üniversitesinin faaliyet iznini kim kaldırır",
+            "vakıf üniversitesi faaliyet durdurma",
+            "kapanan vakıf üniversitesinin öğrencileri ne olur",
+            "vakıf üniversitesi tasfiye süreci",
+            "vakıf üniversitesine kayyım atanması"
+          ],
+          "subject_classes": ["foundation_higher_education_institution", "founding_foundation", "student"],
+          "regulated_situations": [
+            "eğitim düzeyi yetersizliğinde faaliyetin durdurulması",
+            "kaynak aktarımında düzeltici veya kısıtlayıcı tedbir uygulanması",
+            "Cumhurbaşkanı kararıyla faaliyet izninin kaldırılması",
+            "öğrencilerin garantör veya devlet üniversitesine nakli",
+            "malvarlığının resmî tasfiyesi",
+            "kurucu vakfa kayyım atanması"
+          ],
+          "legal_effect_types": ["supervision", "sanction", "licence_revocation", "liquidation", "student_transfer"],
+          "legal_operations": ["denetim", "uyarı", "faaliyeti durdurma", "faaliyet iznini kaldırma", "kayyım atama", "tasfiye", "öğrenci nakli"],
+          "competent_authorities": ["Yükseköğretim Kurulu", "Cumhurbaşkanı", "Millî Eğitim Bakanlığı", "yetkili mahkeme", "Hazine ve Maliye Bakanlığı", "Vakıflar Genel Müdürlüğü"],
+          "operational_actors": ["garantör üniversite", "belirlenecek devlet üniversitesi", "tasfiye memurları"],
+          "exclusions": [
+            "devlet yükseköğretim kurumunun denetimi",
+            "kurucu vakfın tüzel kişiliğinin sona ermesi",
+            "tasfiye memurunun cezai sorumluluktan muaf olması"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Geçici Madde 78": {
+          "display_heading": "2018 öğrenci affı ve ÖYP araştırma görevlilerinin yeniden atanması",
+          "regulates": "2018-2019 döneminde belirli istisnalar dışında ilişiği kesilen veya kayıt yaptırmayan öğrencilerin yeniden öğrenime başlamasını ve ÖYP araştırma görevlilerinin yeniden atanmasını",
+          "canonical_concepts": [
+            "2018 öğrenci affı",
+            "2018 üniversite affı",
+            "ÖYP araştırma görevlisinin yeniden atanması"
+          ],
+          "query_aliases": [
+            "2018 öğrenci affından kimler yararlanabilir",
+            "Geçici Madde 78 öğrenci affı",
+            "2018 ilişiği kesilen öğrencinin geri dönüşü",
+            "2018 kayıt yaptırmayan öğrencinin dönüşü",
+            "ÖYP araştırma görevlisi yeniden atama"
+          ],
+          "subject_classes": ["student", "former_student", "research_assistant"],
+          "regulated_situations": [
+            "dört ay içinde başvuruyla 2018-2019 yılında öğrenime yeniden başlama",
+            "askerlik erteleme ve terhis sonrası iki ay içinde başvuru",
+            "eşdeğer programa yatay geçiş",
+            "ÖYP araştırma görevlisinin bir ay içinde başvuruyla yeniden atanması"
+          ],
+          "legal_effect_types": ["status_restoration", "eligibility", "student_transfer", "appointment"],
+          "legal_operations": ["başvuru", "yeniden öğrenime başlama", "kayıt", "askerlik erteleme", "yatay geçiş", "yeniden atama"],
+          "competent_authorities": ["ilgili yükseköğretim kurumu", "Yükseköğretim Kurulu", "üniversite senatosu", "ilgili üniversite"],
+          "operational_actors": [],
+          "exclusions": [
+            "terör suçundan hüküm giyen öğrencinin 2018 affı",
+            "terör örgütü bağlantısı nedeniyle ilişiği kesilen öğrencinin 2018 affı",
+            "dört aylık başvuru süresi dışındaki öğrenci başvurusu",
+            "bir aylık süre dışındaki ÖYP yeniden atama başvurusu",
+            "2018-2019 dışındaki öğrenci affı"
+          ],
+          "review_status": "human_reviewed"
+        },
+        "Geçici Madde 83": {
+          "display_heading": "2022 öğrenci affı ve yeniden öğrenime başlama",
+          "regulates": "2022-2023 döneminde genişletilmiş suç ve terör bağlantısı istisnaları dışında ilişiği kesilen veya kayıt yaptırmayan öğrencilerin yeniden öğrenime başlaması",
+          "canonical_concepts": [
+            "2022 öğrenci affı",
+            "öğrenci affı",
+            "öğrenciliğe yeniden dönüş",
+            "öğrencilik hakkının yeniden kazanılması"
+          ],
+          "query_aliases": [
+            "öğrenci affı",
+            "af kanunu",
+            "üniversite affı",
+            "2022 üniversite affı",
+            "Geçici Madde 83 öğrenci affı",
+            "ilişiği kesilen öğrencinin geri dönüşü",
+            "kayıt hakkının geri verilmesi"
+          ],
+          "subject_classes": ["student", "former_student"],
+          "regulated_situations": [
+            "öğrencilik ilişiğinin kesilmesi",
+            "kazanılan programa kayıt yaptırmama",
+            "öğrenime yeniden başlama"
+          ],
+          "legal_effect_types": ["status_restoration", "eligibility", "student_transfer"],
+          "legal_operations": ["başvuru", "yeniden öğrenime başlama", "kayıt", "askerlik erteleme", "yatay geçiş"],
+          "competent_authorities": ["ilgili yükseköğretim kurumu", "Yükseköğretim Kurulu", "üniversite senatosu"],
+          "operational_actors": [],
+          "exclusions": [
+            "terör suçundan mahkûm öğrencinin 2022 affı",
+            "kasten öldürme suçundan mahkûm öğrencinin 2022 affı",
+            "işkence veya eziyet suçundan mahkûm öğrencinin 2022 affı",
+            "cinsel saldırı veya çocuk istismarı suçundan mahkûm öğrencinin 2022 affı",
+            "uyuşturucu imal ve ticareti suçundan mahkûm öğrencinin 2022 affı",
+            "sahte belge nedeniyle kaydı iptal edilen öğrencinin 2022 affı",
+            "FSEK 71 suçundan mahkûm öğrencinin 2022 affı",
+            "terör örgütü bağlantısı nedeniyle ilişiği kesilen öğrencinin 2022 affı",
+            "dört aylık başvuru süresi dışındaki 2022 affı başvurusu",
+            "2022-2023 dışındaki öğrenci affı"
+          ],
+          "review_status": "human_reviewed"
+        }
+      }
+    },
+    "TR-KANUN-2914": {
+      "domain_path": ["yükseköğretim", "akademik personel", "mali ve özlük hakları"],
+      "semantic_dimensions": {
+        "personel_unvanı": {
+          "profesör": ["profesörler"],
+          "doçent": ["doçentler"],
+          "doktor öğretim üyesi": ["yardımcı doçent"],
+          "öğretim görevlisi": ["öğretim görevlileri"],
+          "araştırma görevlisi": ["araştırma görevlileri", "asistan"],
+          "öğretim elemanı": ["öğretim elemanları"]
+        },
+        "mali_unsur": {
+          "aylık": ["görev aylığı", "kazanılmış hak aylığı"],
+          "ek gösterge": ["ek göstergeler"],
+          "üniversite ödeneği": ["ödenek"],
+          "idari görev ödeneği": ["idari görev"],
+          "geliştirme ödeneği": ["geliştirme ödeneğinden"],
+          "eğitim öğretim ödeneği": ["eğitim öğretim ödeneği"],
+          "akademik teşvik ödeneği": ["akademik teşvik"],
+          "ek ders ücreti": ["ek ders", "ders ücreti"],
+          "tazminat": ["makam tazminatı", "temsil tazminatı"]
+        },
+        "personel_statüsü": {
+          "kadrolu": ["kadro", "kadrosunda"],
+          "sözleşmeli": ["sözleşme ile", "sözleşmeli"],
+          "yabancı uyruklu": ["yabancı öğretim elemanı"],
+          "emekli": ["emeklilik", "emekliye"]
+        },
+        "özlük_unsuru": {
+          "derece": ["dereceler", "derecesi"],
+          "kademe": ["kademeler", "kademesi"],
+          "kıdem": ["kıdem aylığı", "kıdem yılı"],
+          "terfi": ["yükselme", "ilerleme"]
+        },
+        "çalışma_karşılığı": {
+          "ders yükü": ["haftalık ders yükü", "ders yükünün"],
+          "ek ders": ["ek ders saati", "ek ders ücreti"],
+          "idari görev": ["idari görevi", "yönetim görevi"]
+        }
+      },
+      "article_overrides": {
+        "Geçici Madde 2": {
+          "display_heading": "Üniversite ödeneğinde kazanılmış mali hakkın fark tazminatıyla korunması",
+          "regulates": "Yeni üniversite ödeneği eski iş güçlüğü, iş riski, temininde güçlük zammı ve tam gün ödeneği toplamından düşükse net farkın kesintisiz ödenmesini",
+          "canonical_concepts": [
+            "üniversite ödeneği fark tazminatı",
+            "kazanılmış mali hakların korunması",
+            "eski yan ödemeler ile üniversite ödeneği farkı"
+          ],
+          "query_aliases": [
+            "üniversite ödeneği eski ödemeden düşük kalırsa ne olur",
+            "üniversite ödeneği fark tazminatı",
+            "2914 Geçici Madde 2 mali hak",
+            "iş güçlüğü iş riski ve tam gün ödeneği farkı",
+            "üniversite ödeneği vergi ve kesinti"
+          ],
+          "subject_classes": ["academic_staff", "temporary_article_1_beneficiary"],
+          "regulated_situations": [
+            "yeni üniversite ödeneğinin eski yan ödeme toplamından düşük kalması",
+            "aradaki net farkın üniversite ödeneği eski tutara ulaşıncaya kadar ödenmesi",
+            "fark ödemesinin vergi ve kesintiye tabi tutulmaması"
+          ],
+          "legal_effect_types": ["payment_obligation", "acquired_financial_right"],
+          "legal_operations": ["ödenek karşılaştırması", "net fark hesaplama", "fark tazminatı ödeme"],
+          "competent_authorities": [],
+          "operational_actors": ["ilgili yükseköğretim kurumunun maaş ve tahakkuk birimleri"],
+          "exclusions": [
+            "üniversite ödeneği eski ödemelere eşit veya yüksek olan personelin fark tazminatı",
+            "geliştirme ödeneği farkı",
+            "makam tazminatı farkı",
+            "idari görev ödeneği farkı",
+            "Geçici Madde 1 kapsamı dışındaki idari personelin fark tazminatı"
+          ],
+          "review_notes": [
+            "Maddede açık bir yetkili makam sayılmıyor; maaş ve tahakkuk birimleri yalnızca insan denetimli operasyonel çıkarım olarak tutuluyor."
+          ],
+          "review_status": "human_reviewed"
+        }
+      }
+    },
+    "TR-KANUN-2809": {
+      "domain_path": ["yükseköğretim", "kurumsal teşkilat", "akademik birimler"],
+      "semantic_dimensions": {
+        "kurum_türü": {
+          "üniversite": ["üniversitesi", "üniversitesine"],
+          "yüksek teknoloji enstitüsü": ["yüksek teknoloji enstitüsü"],
+          "rektörlük": ["rektörlüğe", "rektörlüğü"]
+        },
+        "akademik_birim": {
+          "fakülte": ["fakültesi", "fakülteler"],
+          "enstitü": ["enstitüsü", "enstitüler"],
+          "yüksekokul": ["yüksekokulu", "yüksekokullar"],
+          "meslek yüksekokulu": ["meslek yüksekokulu"],
+          "konservatuvar": ["konservatuvarı"],
+          "araştırma ve uygulama merkezi": ["uygulama ve araştırma merkezi", "araştırma merkezi"]
+        },
+        "teşkilat_işlemi": {
+          "kuruluş": ["kurulmuştur", "kurulur"],
+          "bağlanma": ["bağlanmıştır", "bağlı", "bağlanır"],
+          "ad değişikliği": ["adı değiştirilmiştir", "adıyla"],
+          "birleşme": ["birleştirilmiştir", "birleşir"],
+          "dönüştürme": ["dönüştürülmüştür", "dönüştürülür"],
+          "kapatma": ["kapatılmıştır", "kaldırılmıştır"]
+        },
+        "teşkilat_ilişkisi": {
+          "bünyesinde": ["bünyesinde yer alan"],
+          "bağlı birim": ["bağlı olarak", "bağlanmıştır"],
+          "rektörlüğe bağlı": ["rektörlüğe bağlı"],
+          "üniversiteye bağlı": ["üniversitesine bağlı"]
+        },
+        "geçiş_hükmü": {
+          "öğrenci devri": ["öğrencileri", "öğrencilerin nakli"],
+          "personel devri": ["personeli", "kadrolarıyla birlikte"],
+          "malvarlığı devri": ["taşınır", "taşınmaz", "araç ve gereç"],
+          "hak ve yükümlülük devri": ["hak ve yükümlülükleri", "borçları"]
+        }
+      },
+      "article_overrides": {
+        "Ek Madde 30": {
+          "display_heading": "Üniversiteye bağlı fakülte, enstitü ve yüksekokulların kurulması ve değiştirilmesi",
+          "regulates": "Cumhurbaşkanının üniversitelere bağlı fakülte, enstitü ve yüksekokul kurma, birleştirme, kapatma, bağlantı ve isim değiştirme yetkisini ve bağlantı değişikliğinde malvarlığı devrini",
+          "canonical_concepts": [
+            "üniversiteye bağlı fakülte enstitü ve yüksekokul kurma",
+            "akademik birim bağlantı ve isim değişikliği",
+            "akademik birim kapatma ve birleştirme"
+          ],
+          "query_aliases": [
+            "üniversiteye bağlı enstitüyü kim kurar",
+            "fakülte enstitü yüksekokul nasıl kurulur",
+            "enstitü kapatma yetkisi",
+            "fakültenin bağlı olduğu üniversiteyi değiştirme",
+            "akademik birimin adını değiştirme",
+            "bağlantısı değişen birimin malları ne olur"
+          ],
+          "subject_classes": ["faculty", "institute", "school", "university"],
+          "regulated_situations": [
+            "Cumhurbaşkanının üniversiteye bağlı fakülte enstitü ve yüksekokul kurması",
+            "bu birimleri birleştirme kapatma ve adını değiştirme",
+            "birimin bağlı olduğu üniversiteyi değiştirme",
+            "kadro taşınmaz ve demirbaşların yeni üniversiteye aktarılması"
+          ],
+          "legal_effect_types": ["establishment", "authority_or_duty", "organizational_transfer"],
+          "legal_operations": ["kurma", "birleştirme", "kapatma", "bağlantı değiştirme", "isim değiştirme", "kadro ve malvarlığı devri"],
+          "competent_authorities": ["Cumhurbaşkanı"],
+          "operational_actors": [],
+          "exclusions": [
+            "yeni devlet üniversitesi kurma",
+            "yeni vakıf üniversitesi kurma",
+            "üniversiteyi kapatma",
+            "fakülte altında bölüm açma",
+            "anabilim dalı açma",
+            "uygulama ve araştırma merkezi kurma"
+          ],
+          "review_notes": [
+            "Mevcut kaynak metin fakülte, enstitü ve yüksekokulu açıkça sayıyor; konservatuvar, meslek yüksekokulu ve merkez kanonik kapsama kaynak desteği olmadan eklenmedi."
+          ],
+          "review_status": "human_reviewed"
+        }
+      }
+    }
+  }
+}

data/registry/legal_documents.json

@@ -0,0 +1,29 @@
+[
+  {
+    "document_id": "TR-KANUN-2547",
+    "short_code": "2547",
+    "title": "2547 sayılı Yükseköğretim Kanunu",
+    "document_type": "law",
+    "domain_tags": ["framework", "governance", "academic", "students", "institutions"],
+    "source_path": "data/source/2547_clean.txt",
+    "mckf_status": "indexed"
+  },
+  {
+    "document_id": "TR-KANUN-2914",
+    "short_code": "2914",
+    "title": "2914 sayılı Yükseköğretim Personel Kanunu",
+    "document_type": "law",
+    "domain_tags": ["personnel", "salary", "allowance", "academic_staff", "ek_ders", "degree", "kademe"],
+    "source_path": "data/source/2914_clean.txt",
+    "mckf_status": "indexed"
+  },
+  {
+    "document_id": "TR-KANUN-2809",
+    "short_code": "2809",
+    "title": "2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu",
+    "document_type": "law",
+    "domain_tags": ["organization", "institution", "university_structure", "faculty", "institute", "academic_unit"],
+    "source_path": "data/source/2809_clean.txt",
+    "mckf_status": "indexed"
+  }
+]

data/registry/normative_interpretation_families.json

@@ -0,0 +1,508 @@
+{
+  "schema": "MCKF-NormativeInterpretationFamilies-v1.1",
+  "language": "tr",
+  "description": "Kullanıcı dilindeki yakın ifadeleri hukuken farklı nesne ve işlem türlerine ayıran, belge ve madde numarasından bağımsız yorum aileleri.",
+  "families": [
+    {
+      "family_id": "academic_personnel_mobility",
+      "label": "Akademik personelin birimler arasındaki hareketi",
+      "priority": 100,
+      "enforce_fidelity": true,
+      "match_groups": [
+        ["öğretim üyesi", "öğretim elemanı", "akademik personel", "personel"],
+        ["fakülte", "birim", "üniversite"],
+        ["aktarmak", "aktarım", "taşımak", "nakil", "geçirmek", "görev yeri", "görevlendirme"]
+      ],
+      "clarification_prompt": "Burada günlük dilde birbirinin yerine kullanılan, fakat farklı hukuki sonuç doğuran işlemler var. Yanlış hükme gitmemek için corpus içinde açık dayanağı bulunan işlem türünü seçin.",
+      "mechanisms": [
+        {
+          "mechanism_id": "formal_staff_position_transfer",
+          "label": "Kadro/pozisyonun başka bir fakülteye aktarılması",
+          "definition": "Kadro cetvelindeki pozisyonun bir kurumsal birimden başka bir kurumsal birime aktarılması.",
+          "display_order": 1,
+          "terms": ["kadro", "pozisyon", "kadro cetveli", "kadro aktarımı", "naklen atama"],
+          "action_terms": ["aktarmak", "aktarım", "taşımak", "nakil", "devretmek", "intikal"],
+          "unambiguous_phrases": ["kadro cetveli", "kadro pozisyon aktarımı", "kadronun aktarılması"],
+          "clarify_when_top": true,
+          "evidence_patterns": ["kadro.{0,100}(aktar|devr|intikal|nakl)", "(aktar|devr|intikal|nakl).{0,100}kadro"],
+          "answer_policy": "corpus_gap",
+          "coverage_note": "İncelenen 2547, 2914 ve 2809 sayılı kanunlarda, aynı üniversite içinde rutin bir fakülteler arası kadro/pozisyon aktarımının genel usulü açıkça düzenlenmiyor. Görev yerinin değiştirilmesi veya görevlendirme, kadro aktarımıyla aynı işlem değildir."
+        },
+        {
+          "mechanism_id": "internal_duty_place_change",
+          "label": "Öğretim elemanının görev yerinin üniversite içinde değiştirilmesi",
+          "definition": "Kadro cetvelini aktarmadan, personelin üniversite içindeki görev yerinin değiştirilmesi veya kendisine yeni görev verilmesi.",
+          "display_order": 2,
+          "terms": ["görev yeri", "görev yerini değiştirmek", "yeni görev", "birimde görevlendirmek"],
+          "action_terms": ["değiştirmek", "taşımak", "geçirmek"],
+          "unambiguous_phrases": ["görev yeri", "görev yerinin değiştirilmesi", "yeni görev verilmesi"],
+          "commitment_phrases": ["işlem türü kesin olarak görev yeri değişikliğidir"],
+          "evidence_phrase_groups": [["görev yerlerini değiştirmek", "bunlara yeni görevler vermek"]],
+          "evidence_patterns": ["gorev yer.{0,60}degistir", "yeni gorev.{0,30}ver"],
+          "answer_policy": "retrieve",
+          "resolved_question": "İşlem türü kesin olarak görev yeri değişikliğidir. Aynı üniversite içinde bir fakültede görevli öğretim elemanlarının görev yerlerinin başka bir fakülte veya birime değiştirilmesi hangi makamın yetkisindedir ve 2547 sayılı Kanunda nasıl düzenlenmiştir? Kadro veya pozisyon aktarımı sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "intra_university_teaching_assignment",
+          "label": "Ders yükünü tamamlamak için başka birimde görevlendirme",
+          "definition": "Öğretim elemanının kadrosu ve asli görev yeri değişmeden, ders yükünü tamamlamak üzere başka bir birimde görevlendirilmesi.",
+          "display_order": 3,
+          "terms": ["görevlendirme", "görevlendirilmek", "ders yükü", "başka birimde ders"],
+          "action_terms": ["görevlendirmek", "ders vermek"],
+          "unambiguous_phrases": ["ders yükünü tamamlamak", "başka birimde görevlendirme", "geçici görevlendirme"],
+          "commitment_phrases": ["işlem türü kesin olarak ders yükünü tamamlamak amacıyla üniversite içinde görevlendirmedir"],
+          "evidence_phrase_groups": [["kendi üniversitelerinin diğer birimlerinde", "ders yükünü doldurmak üzere rektör tarafından görevlendirilebilirler"]],
+          "evidence_patterns": ["diger birim.{0,100}gorevlendir", "ders yuk.{0,100}gorevlendir"],
+          "answer_policy": "retrieve",
+          "resolved_question": "İşlem türü kesin olarak ders yükünü tamamlamak amacıyla üniversite içinde görevlendirmedir. Öğretim üyesi veya öğretim görevlisi kendi üniversitesinin başka biriminde hangi şartlarla ve hangi makam tarafından görevlendirilebilir? Kadro aktarımı ve sürekli görev yeri değişikliği sorulmamaktadır."
+        }
+      ]
+    },
+    {
+      "family_id": "institutional_structure_operation",
+      "label": "Yükseköğretim birimlerinin kuruluş ve yapı işlemleri",
+      "priority": 90,
+      "enforce_fidelity": true,
+      "commitment_entity_rules": [
+        {
+          "phrase": "kurumsal nesne kesin olarak üniversiteye bağlı bir enstitüdür",
+          "target_entities": ["enstitü"]
+        },
+        {
+          "phrase": "kurumsal nesne kesin olarak uygulama ve araştırma merkezidir",
+          "target_entities": ["uygulama ve araştırma merkezi"]
+        }
+      ],
+      "negative_terms": ["fakülte kurulu", "enstitü kurulu", "yüksekokul kurulu", "üniversite yönetim kurulu"],
+      "bypass_terms": ["birlikte nasıl okunur", "2547 ve 2809", "hangi 2547 maddesine bağlar", "arasındaki bağ", "nasıl bağlanır"],
+      "match_groups": [
+        ["yükseköğretim kurumu", "üniversite", "yüksek teknoloji enstitüsü", "fakülte", "enstitü", "yüksekokul", "bölüm", "anabilim dalı", "anasanat dalı", "bilim dalı", "araştırma merkezi", "alt birim", "birim"],
+        ["kurulması", "kurmak", "açılması", "açmak", "kapatılması", "kapatmak", "birleştirmek", "bağlantı değişikliği", "bağlamak", "isim değişikliği", "teşkil", "faaliyete geçirilmek"]
+      ],
+      "clarification_prompt": "Kurulacak veya değiştirilecek yapının düzeyi, yetkili makamı ve uygulanacak hükmü değiştirir. Hangi kurumsal nesneyi kastettiğinizi seçin.",
+      "terminology_ambiguities": [
+        {
+          "ambiguity_id": "research_institute_or_center",
+          "all_terms": ["araştırma", "enstitü"],
+          "exclude_phrases": ["yüksek teknoloji enstitüsü", "uygulama ve araştırma merkezi"],
+          "prompt": "“Araştırma enstitüsü” ifadesi corpus içindeki kanunlarda tek bir kanonik birim adı olarak kullanılmıyor. Yanlış hükme gitmemek için hangi kurumsal yapıyı kastettiğinizi seçin.",
+          "mechanism_ids": [
+            "principal_academic_unit_reorganization",
+            "academic_subunit_reorganization"
+          ],
+          "option_labels": {
+            "principal_academic_unit_reorganization": "Üniversiteye bağlı araştırma enstitüsü kurulması",
+            "academic_subunit_reorganization": "Uygulama ve araştırma merkezi açılması"
+          },
+          "resolved_questions": {
+            "principal_academic_unit_reorganization": "Kurumsal nesne kesin olarak üniversiteye bağlı bir enstitüdür. Üniversiteye bağlı bir enstitünün kurulmasına kim karar verir; yetkili makam ve usul nedir?",
+            "academic_subunit_reorganization": "Kurumsal nesne kesin olarak uygulama ve araştırma merkezidir. Bir uygulama ve araştırma merkezinin açılmasına kim karar verir; yetkili makam ve usul nedir?"
+          }
+        }
+      ],
+      "mechanisms": [
+        {
+          "mechanism_id": "foundation_higher_education_institution_establishment",
+          "label": "Vakıf yükseköğretim kurumu kurulması",
+          "definition": "Bir vakıf veya birden fazla vakıf tarafından yükseköğretim kurumu kurulmasına özgü karar, başvuru ve belge süreci.",
+          "display_order": 1,
+          "terms": ["vakıf yükseköğretim kurumu", "vakıf üniversitesi", "vakıflar tarafından kurulmak"],
+          "unambiguous_phrases": ["vakıf yükseköğretim kurumu nasıl kurulur", "vakıf üniversitesi nasıl kurulur"],
+          "commitment_phrases": ["kurumsal nesne kesin olarak vakıf yükseköğretim kurumudur"],
+          "evidence_phrase_groups": [["Vakıf veya birden fazla vakfın yetkili yönetim organlarının yükseköğretim kurumu kurma ile ilgili karar"]],
+          "evidence_patterns": ["vakif.{0,180}yuksekogretim kurumu kurma", "vakif.{0,220}kurulacak yuksekogretim kurum"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal nesne kesin olarak vakıf yükseköğretim kurumudur. Vakıf veya vakıflar bir yükseköğretim kurumu kurmak için hangi kararları almalı, hangi belgeleri hazırlamalı ve başvuruyu hangi makama sunmalıdır? Devlet üniversitesi ya da üniversiteye bağlı birim kurulması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "university_establishment",
+          "label": "Üniversite veya yüksek teknoloji enstitüsü kurulması",
+          "definition": "Yeni bir yükseköğretim kurumunun tüzel ve kurumsal olarak kurulması.",
+          "display_order": 1,
+          "terms": ["yükseköğretim kurumu kurmak", "üniversite kurmak", "üniversite kurulması", "yüksek teknoloji enstitüsü kurulması"],
+          "unambiguous_phrases": ["yükseköğretim kurumu nasıl kurulur", "yeni üniversite kurmak", "üniversite nasıl kurulur", "üniversite kurulması"],
+          "commitment_phrases": ["kurumsal nesne kesin olarak yeni bir üniversitedir"],
+          "evidence_phrase_groups": [["kanunla kurulur", "adıyla yeni bir üniversite kurulmuştur"]],
+          "evidence_patterns": ["universite.{0,280}kanunla kurulur", "adiyla yeni bir universite kurulmustur"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal nesne kesin olarak yeni bir üniversitedir. Üniversite veya yüksek teknoloji enstitüsü hangi hukuki işlem ve planlama çerçevesinde kurulur? Fakülte, bölüm veya alt birim açılması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "principal_academic_unit_reorganization",
+          "label": "Fakülte, enstitü veya yüksekokul kurma/kapatma",
+          "definition": "Üniversiteye bağlı ana akademik birimlerin kurulması, birleştirilmesi, kapatılması veya bağlantı ve adının değiştirilmesi.",
+          "display_order": 2,
+          "terms": ["fakülte", "enstitü", "yüksekokul", "bağlantı değişikliği", "isim değişikliği"],
+          "unambiguous_phrases": ["fakülte kurmak", "enstitü kurmak", "yüksekokul kurmak", "fakülte kapatmak", "enstitü kapatmak"],
+          "commitment_phrases": ["kurumsal nesne kesin olarak fakülte enstitü veya yüksekokuldur", "kurumsal nesne kesin olarak üniversiteye bağlı bir enstitüdür"],
+          "evidence_phrase_groups": [["Cumhurbaşkanı üniversitelere bağlı olarak fakülte, enstitü ve yüksekokul kurmaya", "bir üniversite içinde fakülte, enstitü ve yüksekokul açılmasına"]],
+          "evidence_patterns": ["(fakulte|enstitu|yuksekokul).{0,220}(kurul(?:ur|mas|acak)|kurma|acilma|birlestiril|kapatil|baglanti|isim degisik)", "cumhurbaskani.{0,100}(fakulte|enstitu|yuksekokul)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal nesne kesin olarak üniversiteye bağlı fakülte, enstitü veya yüksekokuldur. Bu ana akademik birimlerin kurulması, birleştirilmesi, kapatılması ya da bağlantı ve isim değişikliği hangi makam ve usulle yapılır? Üniversitenin kendisinin veya bölüm gibi alt birimlerin kurulması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "academic_subunit_reorganization",
+          "label": "Bölüm, anabilim/anasanat dalı veya araştırma merkezi açma/kapatma",
+          "definition": "Bir yükseköğretim kurumu içindeki bölüm ve uygulama-araştırma merkezi düzeyindeki alt birim işlemleri.",
+          "display_order": 3,
+          "terms": ["alt birim", "bölüm", "anabilim dalı", "anasanat dalı", "araştırma merkezi", "uygulama merkezi"],
+          "unambiguous_phrases": ["alt birimlerin teşkili", "bölüm açmak", "anabilim dalı açmak", "araştırma merkezi açmak", "bölüm kapatmak"],
+          "commitment_phrases": ["kurumsal nesne kesin olarak bölüm anabilim dalı anasanat dalı veya araştırma merkezidir", "kurumsal nesne kesin olarak uygulama ve araştırma merkezidir"],
+          "evidence_phrase_groups": [["bölüm, anabilim ve anasanat dalları ile uygulama ve araştırma merkezi açılması", "alt birimlerinin, anabilim dalı, anasanat dalı ve diğer ünitelerin teşkili"]],
+          "evidence_patterns": ["(bolum|anabilim|anasanat|arastirma merkezi).{0,180}(acil|birlestiril|kapatil)", "alt birim.{0,220}(teskil|birlestiril|kaldiril|isleyis)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal nesne kesin olarak bölüm, anabilim dalı, anasanat dalı veya uygulama ve araştırma merkezidir. Bu alt birimlerin açılması, birleştirilmesi veya kapatılması hangi makamın yetkisindedir? Fakülte ya da üniversite kurulması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "science_or_art_branch_reorganization",
+          "label": "Bilim veya sanat dalı kurulması/kaldırılması",
+          "definition": "Anabilim ya da anasanat dalı altındaki bilim ve sanat dalının kurulması veya kaldırılması.",
+          "display_order": 4,
+          "terms": ["bilim dalı", "sanat dalı"],
+          "unambiguous_phrases": ["bilim dalı kurmak", "sanat dalı kurmak", "bilim dalı kaldırmak"],
+          "commitment_phrases": ["kurumsal nesne kesin olarak bilim veya sanat dalıdır"],
+          "evidence_phrase_groups": [["Bilim dalı ve sanat dalı kurulması"]],
+          "evidence_patterns": ["(bilim dali|sanat dali).{0,100}(kurul|kaldir)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal nesne kesin olarak bilim veya sanat dalıdır. Bilim ve sanat dalının kurulması veya kaldırılması hangi makamların görüşü ve kararıyla yapılır? Bölüm, fakülte veya üniversite kurulması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "unit_activation",
+          "label": "Yeni kurulan birimin faaliyete geçirilmesi",
+          "definition": "Kanunla kurulan bir yükseköğretim biriminin eğitim ve öğretime fiilen başlatılması.",
+          "display_order": 5,
+          "terms": ["faaliyete geçirilmek", "yeni kurulan birim", "eğitim öğretime başlamak"],
+          "unambiguous_phrases": ["yeni kurulan birimler ne zaman faaliyete geçirilir", "birimi faaliyete geçirmek"],
+          "commitment_phrases": ["kurumsal işlem kesin olarak yeni kurulan birimin faaliyete geçirilmesidir"],
+          "evidence_phrase_groups": [["Yükseköğretim Kurulunun kararı ile faaliyete geçirilir"]],
+          "evidence_patterns": ["yeni kurulan birim.{0,520}faaliyete geciril"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Kurumsal işlem kesin olarak yeni kurulan birimin faaliyete geçirilmesidir. Kanunla kurulan yeni birim hangi hazırlıklar tamamlandıktan ve hangi makam karar verdikten sonra eğitim ve öğretime başlatılır? Birimin hukuken kurulması sorulmamaktadır."
+        }
+      ]
+    },
+    {
+      "family_id": "student_status_and_remedy",
+      "label": "Öğrenci kaydı, ilişik kesme ve telafi hakları",
+      "priority": 80,
+      "enforce_fidelity": true,
+      "negative_terms": ["itiraz", "uyarı", "uyarılmadı", "disiplin"],
+      "match_groups": [
+        ["öğrenci", "öğrencilik", "lisans", "lisansüstü", "üç sınav hakkı", "iki ek sınav hakkı", "sınırsız sınav hakkı"],
+        ["kayıt", "ilişik", "kaydı silmek", "af", "geri dönmek", "sınav hakkı", "azami süre", "tez dersi"]
+      ],
+      "clarification_prompt": "Kayıt, ilişik kesme, sınav hakkı ve yeniden öğrenime dönüş aynı hukuki sonuç değildir. Corpus içinde düzenlenen durumu seçin.",
+      "mechanisms": [
+        {
+          "mechanism_id": "course_registration_regulation",
+          "label": "Ders/tez kaydı ve devam kurallarının belirlenmesi",
+          "definition": "Ders, tez, devam ve kayıt içeriklerinin hangi düzenleme düzeyinde ve hangi organ tarafından belirleneceği.",
+          "display_order": 1,
+          "terms": ["ders kaydı", "tez dersi", "uzmanlık dersi", "devam", "kayıt kuralı"],
+          "unambiguous_phrases": ["tez dersi seçmek", "ders kaydı yapmak", "uzmanlık dersi seçmek"],
+          "commitment_phrases": ["öğrenci işlemi kesin olarak ders tez kaydı ve devam kurallarıdır"],
+          "evidence_phrase_groups": [["kayıt, devam, uygulama, tez ve teorik ders içerikleri"]],
+          "evidence_patterns": ["kayit.{0,80}devam.{0,80}tez", "tez.{0,100}(ders|icerik|devam)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Öğrenci işlemi kesin olarak ders, tez kaydı ve devam kurallarıdır. Kayıt, devam, tez ve teorik ders içerikleri hangi organ tarafından ve hangi üst ilkelere uygun olarak belirlenir? Öğrenci affı veya azami süre sonrası sınav hakkı sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "registration_nonrenewal_termination",
+          "label": "Kayıt yenilememe veya ücret ödememe nedeniyle ilişik kesme",
+          "definition": "Kayıt yenilenmemesi ya da katkı payı/öğrenim ücreti ödenmemesinin öğrencilik statüsüne etkisi.",
+          "display_order": 2,
+          "terms": ["kayıt yenilememek", "kayıt yenilenmemesi", "ücret ödememek", "katkı payı", "ilişik kesme", "kaydı silmek", "kaydı silinen"],
+          "unambiguous_phrases": ["kayıt yenilenmemesi nedeniyle", "ücret ödenmemesi nedeniyle", "dört yıl üst üste kayıt yenilememek"],
+          "commitment_phrases": ["öğrenci işlemi kesin olarak kayıt yenilememe veya ücret ödememe nedeniyle ilişik kesmedir"],
+          "evidence_phrase_groups": [["kayıt yenilenmemesi nedeniyle öğrencilerin ilişikleri kesilmez"]],
+          "evidence_patterns": ["kayit yenilenmemesi.{0,150}ilisik", "katki payi.{0,180}ilisik"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Öğrenci işlemi kesin olarak kayıt yenilememe veya katkı payı/öğrenim ücreti ödememe nedeniyle ilişik kesmedir. Bu sebepler hangi koşullarda öğrencinin ilişiğinin kesilmesine yol açabilir? Af veya sınav telafisi sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "maximum_duration_exam_remedy",
+          "label": "Azami süre veya başarısızlık sonrası ek sınav hakkı",
+          "definition": "Azami süresini dolduran ya da belirli sayıda dersten başarısız olan öğrenciye tanınan ek/sınırsız sınav hakları.",
+          "display_order": 3,
+          "terms": ["azami süre", "ek sınav", "üç sınav hakkı", "iki ek sınav", "sınırsız sınav", "başarısız ders"],
+          "unambiguous_phrases": ["üç sınav hakkı", "iki ek sınav hakkı", "sınırsız sınav hakkı", "azami süre sonrası sınav"],
+          "commitment_phrases": ["öğrenci işlemi kesin olarak azami süre veya başarısızlık sonrası sınav hakkıdır"],
+          "evidence_phrase_groups": [["iki ek sınav hakkı verilir", "üç yıl içinde kullanacakları üç sınav hakkı"]],
+          "evidence_patterns": ["(iki ek|uc).{0,60}sinav hakki", "sinirsiz.{0,30}sinav hakki"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Öğrenci işlemi kesin olarak azami süre veya başarısızlık sonrası ek sınav hakkıdır. 2547 sayılı Kanunda iki ek sınav, üç sınav veya sınırsız sınav hakları hangi öğrenci durumları için tanınmıştır? Öğrenci affı sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "temporary_student_status_restoration",
+          "label": "Geçici maddeyle öğrencilik statüsünün yeniden kazanılması",
+          "definition": "İlişiği kesilen veya kayıt hakkını kullanmayan kişilere belirli tarih ve başvuru koşullarıyla yeniden öğrenime başlama hakkı verilmesi.",
+          "display_order": 4,
+          "terms": ["öğrenci affı", "af", "yeniden kayıt", "geri dönmek", "öğrenciliğe dönüş", "yeniden öğrenime başlamak", "kaydı silinen", "ilişiği kesilen"],
+          "unambiguous_phrases": ["öğrenci affı", "öğrenciliğe geri dönmek", "yeniden öğrenime başlamak", "af kanunu"],
+          "do_not_clarify_phrases": ["Geçici Madde 83", "1 Temmuz 2022", "2022-2023 eğitim-öğretim yılı"],
+          "clarify_when_top": true,
+          "commitment_phrases": ["öğrenci işlemi kesin olarak geçici maddeyle öğrencilik statüsünün yeniden kazanılmasıdır"],
+          "evidence_phrase_groups": [["her ne sebeple olursa olsun ilişiği kesilenler", "öğrenimlerine başlayabilirler"]],
+          "evidence_patterns": ["hazirlik dahil butun siniflarda.{0,240}(ilisik|kayit)", "ilisigi kesilenler.{0,420}ogrenimlerine baslayabilir", "2022-2023.{0,100}ogrenimlerine baslayabilir"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Öğrenci işlemi kesin olarak geçici maddeyle öğrencilik statüsünün yeniden kazanılmasıdır. 1 Temmuz 2022 tarihli düzenlemede ilişiği kesilen veya kayıt hakkını kullanmayan öğrenciler hangi kapsam, istisna, başvuru süresi ve koşullarla 2022-2023 eğitim-öğretim yılında yeniden öğrenime başlayabilir? Önceki tarihli geçici öğrenci hakları sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "historical_student_amnesty_provisions",
+          "label": "Önceki tarihli öğrenci affı ve geçici sınav/kayıt hakları",
+          "definition": "Farklı tarihlerde ilişiği kesilmiş öğrencilere belirli dönemler için tanınmış tarihsel devam, sınav ve yeniden kayıt hakları.",
+          "display_order": 5,
+          "terms": ["öğrenci affı", "af", "aflar", "eski öğrenci affı", "geçmiş af düzenlemeleri", "ilişiği kesilen"],
+          "unambiguous_phrases": ["önceki öğrenci afları", "eski öğrenci affı", "tarihsel af düzenlemeleri"],
+          "clarify_when_top": true,
+          "commitment_phrases": ["öğrenci işlemi kesin olarak önceki tarihli geçici öğrenci haklarıdır"],
+          "evidence_phrase_groups": [["ilişikleri kesilmiş öğrencilere", "ilişiği kesilen öğrencilere"], ["sınav hakkı verilir", "yeniden kayıt hakkı verilir"]],
+          "evidence_patterns": ["ilisik.{0,80}kesilmis.{0,160}ogrenci.{0,300}sinav hakki", "kaydi silinenlere.{0,120}yeniden kayit hakki"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Öğrenci işlemi kesin olarak önceki tarihli geçici öğrenci haklarıdır. 2547 sayılı Kanunun geçmiş dönemlere ilişkin geçici maddelerinde ilişiği kesilen öğrencilere hangi devam, sınav ve yeniden kayıt hakları tanınmıştır? 1 Temmuz 2022 tarihli düzenleme tek başına sorulmamaktadır."
+        }
+      ]
+    },
+    {
+      "family_id": "financial_entitlement_type",
+      "label": "Akademik personelin mali ve sosyal hak türleri",
+      "priority": 70,
+      "enforce_fidelity": true,
+      "bypass_terms": ["daha doğrudan kaynak", "hangi kanun", "kanun mu"],
+      "match_groups": [
+        ["öğretim elemanı", "öğretim üyesi", "akademik personel", "personel", "rektör", "dekan"],
+        ["mali hak", "özlük hakkı", "sosyal hak", "ücret", "ödenek", "ödeme", "ek ders", "tazminat", "maaş"]
+      ],
+      "clarification_prompt": "Mali hak ifadesi birden çok ödeme ve yardım türünü kapsar. Hesaplama şartları farklı olduğundan aradığınız hak türünü seçin.",
+      "mechanisms": [
+        {
+          "mechanism_id": "social_rights_and_aid",
+          "label": "Sosyal hak ve yardımlar",
+          "definition": "Öğretim elemanlarının genel sosyal hak ve yardımlardan yararlanması.",
+          "display_order": 1,
+          "terms": ["sosyal hak", "sosyal yardım", "özlük hakkı"],
+          "unambiguous_phrases": ["sosyal hak ve yardımlar", "hangi sosyal haklardan yararlanır"],
+          "commitment_phrases": ["mali hak türü kesin olarak sosyal hak ve yardımlardır"],
+          "evidence_phrase_groups": [["sosyal hak ve yardımlardan faydalanırlar"]],
+          "evidence_patterns": ["sosyal hak.{0,60}yardim.{0,60}faydalan"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak sosyal hak ve yardımlardır. Öğretim elemanları hangi genel sosyal hak ve yardımlardan yararlanır ve doğrudan kaynak hangi kanundur? Ek ders ve özel ödenekler sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "extra_course_or_exam_payment",
+          "label": "Ek ders ve sınav ücreti",
+          "definition": "Zorunlu ders yükü dışındaki ders/faaliyet ve sınavlar için yapılan ödeme.",
+          "display_order": 2,
+          "terms": ["ek ders", "sınav ücreti", "ders ücreti", "ders yükü"],
+          "unambiguous_phrases": ["ek ders ücreti", "sınav ücreti", "ders yükü dışında"],
+          "commitment_phrases": ["mali hak türü kesin olarak ek ders veya sınav ücretidir"],
+          "evidence_phrase_groups": [["Ek ders ücreti, aşağıdaki göstergelerin", "sınav ücreti ödenir"]],
+          "evidence_patterns": ["ek ders ucreti", "sinav ucreti"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak ek ders veya sınav ücretidir. Öğretim elemanına hangi ders yükü, faaliyet ve sınav koşullarında ek ders ya da sınav ücreti ödenir? Diğer ödenekler sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "university_allowance",
+          "label": "Üniversite ödeneği",
+          "definition": "2914 sayılı Kanundaki unvan ve kadro esaslı üniversite ödeneği.",
+          "display_order": 3,
+          "terms": ["üniversite ödeneği"],
+          "unambiguous_phrases": ["üniversite ödeneği"],
+          "commitment_phrases": ["mali hak türü kesin olarak üniversite ödeneğidir"],
+          "evidence_phrase_groups": [["Üniversite Ödeneği"]],
+          "evidence_patterns": ["universite odenegi"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak üniversite ödeneğidir. Üniversite ödeneğinin kapsamı, oranı, istisnaları ve ödeme koşulları nelerdir? Diğer ödeme türleri sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "administrative_duty_allowance",
+          "label": "İdari görev ödeneği",
+          "definition": "Rektör, dekan, müdür ve diğer yöneticilere idari görev nedeniyle ödenen tutar.",
+          "display_order": 4,
+          "terms": ["idari görev ödeneği", "yönetici ödeneği", "rektör ödeneği", "dekan ödeneği"],
+          "unambiguous_phrases": ["idari görev ödeneği", "dekanın ödeneği", "rektörün ödeneği"],
+          "commitment_phrases": ["mali hak türü kesin olarak idari görev ödeneğidir"],
+          "evidence_phrase_groups": [["idari görev ödeneği olarak ayrıca ödenir"]],
+          "evidence_patterns": ["idari gorev odenegi"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak idari görev ödeneğidir. Hangi akademik yöneticilere hangi oranlarda idari görev ödeneği verilir ve birden fazla görevde hangi kural uygulanır? Diğer ödenekler sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "development_allowance",
+          "label": "Geliştirme ödeneği",
+          "definition": "Belirli yer veya kurumlarda görev yapan öğretim elemanlarına sağlanan geliştirme ödeneği.",
+          "display_order": 5,
+          "terms": ["geliştirme ödeneği", "az gelişmiş yer", "yeterli öğretim elemanı bulunmaması"],
+          "unambiguous_phrases": ["geliştirme ödeneği"],
+          "commitment_phrases": ["mali hak türü kesin olarak geliştirme ödeneğidir"],
+          "evidence_phrase_groups": [["geliştirme ödeneği ödenebilir"]],
+          "evidence_patterns": ["gelistirme odenegi"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak geliştirme ödeneğidir. Geliştirme ödeneği hangi kurum, yer ve personel koşullarında verilebilir ve ayrıntıları hangi işlemle belirlenir? Diğer ödenekler sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "education_teaching_allowance",
+          "label": "Eğitim öğretim ödeneği",
+          "definition": "Yükseköğretim kurumlarında görevli öğretim elemanlarına aylıklarla birlikte ödenen eğitim öğretim ödeneği.",
+          "display_order": 6,
+          "terms": ["eğitim öğretim ödeneği", "eğitim-öğretim ödeneği"],
+          "unambiguous_phrases": ["eğitim öğretim ödeneği", "eğitim-öğretim ödeneği"],
+          "commitment_phrases": ["mali hak türü kesin olarak eğitim öğretim ödeneğidir"],
+          "evidence_phrase_groups": [["Eğitim Öğretim Ödeneği olarak ödenir"]],
+          "evidence_patterns": ["egitim.?ogretim odenegi"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak eğitim öğretim ödeneğidir. Eğitim öğretim ödeneği kimlere, hangi istisnalarla ve nasıl ödenir? Diğer ödeme türleri sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "academic_incentive_allowance",
+          "label": "Akademik teşvik ödeneği",
+          "definition": "Bilimsel, teknolojik ve sanatsal faaliyet puanına dayalı akademik teşvik ödeneği.",
+          "display_order": 7,
+          "terms": ["akademik teşvik", "teşvik ödeneği", "teşvik puanı"],
+          "unambiguous_phrases": ["akademik teşvik ödeneği", "akademik teşvik puanı"],
+          "commitment_phrases": ["mali hak türü kesin olarak akademik teşvik ödeneğidir"],
+          "evidence_phrase_groups": [["Akademik teşvik ödeneği"]],
+          "evidence_patterns": ["akademik tesvik (odenegi|puani)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Mali hak türü kesin olarak akademik teşvik ödeneğidir. Akademik teşvik puanı hangi faaliyetlere göre hesaplanır ve ödeneğin temel koşulları nelerdir? Diğer ödenekler sorulmamaktadır."
+        }
+      ]
+    },
+    {
+      "family_id": "academic_personnel_status_action",
+      "label": "Akademik personelin atanma, yükseltilme ve görevlendirilmesi",
+      "priority": 60,
+      "enforce_fidelity": true,
+      "entity_terms": ["doktor öğretim üyesi", "araştırma görevlisi", "öğretim görevlisi", "profesör", "doçent", "öğretim üyesi", "öğretim elemanı", "akademik personel"],
+      "match_groups": [
+        ["öğretim üyesi", "öğretim elemanı", "öğretim görevlisi", "araştırma görevlisi", "doktor öğretim üyesi", "doçent", "profesör", "akademik personel"],
+        ["atanmak", "atama", "yükseltilmek", "unvan", "görevlendirilmek", "görevlendirme", "çalıştırmak", "sözleşmeli", "yabancı uyruklu"]
+      ],
+      "clarification_prompt": "Akademik unvan kazanma, bir kadroya atanma ve geçici görevlendirme farklı hukuki işlemlerdir. Aradığınız işlemi seçin.",
+      "mechanisms": [
+        {
+          "mechanism_id": "appointment_to_academic_position",
+          "label": "Akademik kadroya atanma",
+          "definition": "Belirli bir öğretim elemanı kadrosuna şart, öneri, görüş ve onay süreciyle atanma.",
+          "display_order": 1,
+          "selection_scope": "same_parent_clause",
+          "terms": ["kadroya atanmak", "atama", "atanma şartı", "öğretim üyesi kadrosu"],
+          "unambiguous_phrases": ["doktor öğretim üyesi ataması", "araştırma görevlisi ataması", "öğretim görevlisi ataması", "kadroya nasıl atanır", "atanma şartları", "öğretim üyesi kadrosuna atanmak"],
+          "commitment_phrases": ["personel işlemi kesin olarak akademik kadroya atanmadır"],
+          "evidence_phrase_groups": [["kadrolarına en çok üç yıl süre ile atanırlar", "kadrosuna atanabilmek için"]],
+          "evidence_patterns": ["kadro.{0,220}(atan|atama)", "(atan|atama).{0,220}kadro", "kadroya basvurabilmek"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Personel işlemi kesin olarak akademik kadroya atanmadır. İlgili akademik kadroya atanma için hangi şartlar, öneriler, görüşler ve onaylar aranır? Unvan kazanma veya geçici görevlendirme sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "academic_promotion_or_title",
+          "label": "Doçentlik/profesörlük unvanı ve yükseltilme",
+          "definition": "Akademik unvanın kazanılması veya üst akademik unvana yükseltilme süreci.",
+          "display_order": 2,
+          "selection_scope": "same_parent_clause",
+          "terms": ["doçentlik", "profesörlük", "yükseltilme", "unvan kazanmak", "akademik unvan"],
+          "unambiguous_phrases": ["profesörlüğe yükseltilme", "doçentlik unvanı", "profesör unvanı"],
+          "commitment_phrases": ["personel işlemi kesin olarak akademik unvan kazanma veya yükseltilmedir"],
+          "evidence_phrase_groups": [["doçentlik ve profesörlüğe yükseltilme ve atanma işlemleri", "profesörlüğe yükseltilerek atanabilmek"]],
+          "evidence_patterns": ["(docentlik|profesorluk).{0,120}(unvan|yukseltil|atan)", "profesor.{0,80}unvan"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Personel işlemi kesin olarak akademik unvan kazanma veya yükseltilmedir. Doçentlik ya da profesörlük unvanı ve yükseltilme bakımından hangi şart ve süreçler uygulanır? Geçici görevlendirme sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "temporary_academic_assignment",
+          "label": "Geçici veya kurumlar arası görevlendirme",
+          "definition": "Kadro ve unvan işlemi yapmadan akademik personelin başka bir kurum veya birimde süreli görevlendirilmesi.",
+          "display_order": 3,
+          "terms": ["geçici görevlendirme", "kurumlar arası görevlendirme", "başka üniversitede görevlendirme", "başka yerde çalıştırmak", "yurt dışında görevlendirme"],
+          "unambiguous_phrases": ["geçici görevlendirme", "başka üniversitede görevlendirilmek", "yurt dışında görevlendirilmek"],
+          "commitment_phrases": ["personel işlemi kesin olarak geçici veya kurumlar arası görevlendirmedir"],
+          "evidence_phrase_groups": [["görevlendirilebilirler", "görevlendirilen öğretim elemanları"]],
+          "evidence_patterns": ["ogretim (uyesi|eleman).{0,180}gorevlendir", "gorevlendirilen.{0,80}ogretim eleman"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Personel işlemi kesin olarak geçici veya kurumlar arası görevlendirmedir. Öğretim elemanı hangi şartlar, makamlar ve sürelerle başka kurum, üniversite veya birimde görevlendirilebilir? Kadroya atanma veya unvan yükseltilmesi sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "foreign_or_contracted_academic_employment",
+          "label": "Yabancı uyruklu veya sözleşmeli öğretim elemanı çalıştırma",
+          "definition": "Yabancı uyruklu ya da sözleşmeli akademik personelin özel istihdam usulü.",
+          "display_order": 4,
+          "terms": ["yabancı uyruklu", "sözleşmeli öğretim elemanı", "sözleşmeli personel"],
+          "unambiguous_phrases": ["yabancı uyruklu öğretim elemanı", "sözleşmeli öğretim elemanı"],
+          "commitment_phrases": ["personel işlemi kesin olarak yabancı uyruklu veya sözleşmeli akademik istihdamdır"],
+          "evidence_phrase_groups": [["yabancı uyruklu öğretim elemanları", "sözleşme ile çalıştırılabilirler"]],
+          "evidence_patterns": ["yabanci uyruklu.{0,100}ogretim eleman", "sozlesme.{0,80}calistirilabilir"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Personel işlemi kesin olarak yabancı uyruklu veya sözleşmeli akademik istihdamdır. Bu personel hangi usul, onay, sözleşme ve ücret esaslarıyla çalıştırılabilir? Genel kadro ataması sorulmamaktadır."
+        }
+      ]
+    },
+    {
+      "family_id": "governing_body_semantics",
+      "label": "Kurul ve akademik makamın oluşumu, atanması ve görevleri",
+      "priority": 50,
+      "enforce_fidelity": false,
+      "match_groups": [
+        ["Yükseköğretim Kurulu", "YÖK", "Üniversitelerarası Kurul", "rektör", "dekan", "senato", "üniversite yönetim kurulu", "fakülte kurulu", "fakülte yönetim kurulu", "enstitü müdürü"],
+        ["görev", "yetki", "sorumluluk", "rol", "işlev", "statü", "oluşur", "oluşumu", "üye", "kimlerden", "atanır", "atanma", "seçilir", "seçilme", "görev süresi"]
+      ],
+      "clarification_prompt": "Bir kurul veya makam için oluşum/üyelik, göreve gelme ve görev-yetki düzenlemeleri farklı hükümlerde bulunabilir. Aradığınız normatif yönü seçin.",
+      "mechanisms": [
+        {
+          "mechanism_id": "body_membership_and_composition",
+          "label": "Kurulun üyeleri, seçim biçimi ve oluşumu",
+          "definition": "Kurulun kimlerden oluştuğu, üye sayısı ve üyelerin seçilme/atanma biçimi.",
+          "display_order": 1,
+          "selection_scope": "same_parent_clause",
+          "terms": ["üyeleri", "kimlerden oluşur", "kaç kişiden oluşur", "üye seçimi", "üyeler nasıl seçilir"],
+          "unambiguous_phrases": ["kimlerden oluşur", "kaç kişiden oluşur", "üyeleri nasıl seçilir", "kurulun oluşumu"],
+          "commitment_phrases": ["normatif yön kesin olarak kurulun üyeleri ve oluşumudur"],
+          "evidence_phrase_groups": [["kişiden oluşur", "üyeler"]],
+          "evidence_patterns": ["(kisi|uye).{0,100}(olusur|secil|atan)"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Normatif yön kesin olarak kurulun üyeleri ve oluşumudur. İlgili kurul kimlerden ve kaç üyeden oluşur; üyeler hangi makamlarca nasıl seçilir veya atanır? Kurulun görevleri sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "office_holder_appointment",
+          "label": "Rektör, dekan veya müdürün göreve gelmesi",
+          "definition": "Tek kişilik akademik makam sahibinin seçilmesi/atanması ve görev süresi.",
+          "display_order": 2,
+          "selection_scope": "same_parent_clause",
+          "terms": ["rektör nasıl atanır", "dekan nasıl atanır", "müdür nasıl atanır", "atanma", "görev süresi"],
+          "unambiguous_phrases": ["rektör nasıl atanır", "dekan nasıl atanır", "müdür nasıl atanır", "rektörün atanması", "dekanın atanması"],
+          "commitment_phrases": ["normatif yön kesin olarak akademik makam sahibinin atanmasıdır"],
+          "evidence_phrase_groups": [["rektör atanır", "dekan atanır", "müdür atanır"]],
+          "evidence_patterns": ["(rektor|dekan|mudur).{0,100}atan"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Normatif yön kesin olarak akademik makam sahibinin atanmasıdır. İlgili rektör, dekan veya müdür hangi öneri, seçim veya atama süreciyle ve ne kadar süre için göreve gelir? Yardımcıların atanması ve görev-yetkiler sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "body_or_office_duties_and_powers",
+          "label": "Kurul veya makamın görev, yetki ve sorumlulukları",
+          "definition": "Kurulun ya da akademik yöneticinin yapabileceği ve yapmakla yükümlü olduğu işlemler.",
+          "display_order": 3,
+          "terms": ["görev", "yetki", "sorumluluk", "ne yapar", "görevleri nelerdir"],
+          "unambiguous_phrases": ["görev yetki ve sorumlulukları", "görevleri nelerdir", "yetkileri nelerdir", "ne yapar"],
+          "commitment_phrases": ["normatif yön kesin olarak görev yetki ve sorumluluklardır"],
+          "evidence_phrase_groups": [["görev, yetki ve sorumlulukları", "görevleri;"]],
+          "evidence_patterns": ["gorev.{0,40}(yetki|sorumluluk)", "gorevleri"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Normatif yön kesin olarak kurul veya makamın görev, yetki ve sorumluluklarıdır. İlgili kurul ya da akademik yöneticinin görev, yetki ve sorumlulukları nelerdir? Oluşumu veya atanması sorulmamaktadır."
+        },
+        {
+          "mechanism_id": "body_status_and_system_role",
+          "label": "Kurulun sistem içindeki statüsü ve yön verici rolü",
+          "definition": "Kurulun yükseköğretim sistemi içindeki hukuki konumu, düzenleme ve yön verme işlevi.",
+          "display_order": 4,
+          "enforce_fidelity": true,
+          "terms": ["sistemdeki rol", "nasıl bir rol", "işlev", "hukuki statü", "sistemde ne yapar"],
+          "unambiguous_phrases": ["sistemde nasıl bir rol oynar", "sistemdeki rolü", "hukuki statüsü", "temel işlevi"],
+          "commitment_phrases": ["normatif yön kesin olarak kurulun sistem içindeki statüsü ve yön verici rolüdür"],
+          "evidence_phrase_groups": [["tüm yüksek öğretimi düzenleyen", "faaliyetlerine yön veren"]],
+          "evidence_patterns": ["yuksekogretim kurulu.{0,160}tum yuksek ogretimi duzenleyen", "yuksekogretim kurulu.{0,220}faaliyetlerine yon veren", "yuksekogretim kurulu.{0,300}kamu tuzel kisiligine sahip"],
+          "answer_policy": "retrieve",
+          "resolved_question": "Normatif yön kesin olarak kurulun sistem içindeki hukuki statüsü ve yön verici rolüdür. İlgili kurul yükseköğretim sisteminde hangi konumda bulunur; hangi düzenleme, gözetim veya yön verme işlevini yerine getirir? Üye seçimi ve makam ataması sorulmamaktadır."
+        }
+      ]
+    }
+  ]
+}

data/source/2914_clean.txt

@@ -0,0 +1,227 @@
+YÜKSEKÖĞRETİM PERSONEL KANUNU
+
+Kanun Numarası: 2914
+Kabul Tarihi: 11/10/1983
+Yayımlandığı Resmî Gazete: Tarih: 13/10/1983 Sayı: 18190
+Yayımlandığı Düstur: Tertip: 5 Cilt: 22 Sayfa: 673
+
+Amaç:
+Madde 1 – Bu Kanunun amacı, 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununda yer alan öğretim elemanları tanımına giren personeli sınıflandırmak, aylıklarını ve ek göstergelerini düzenlemek, derece yükseltilmesi ve kademe ilerlemesinin şekil ve şartları ile, sosyal haklardan yararlanma, ek ders ücreti, üniversite, idari görev ve geliştirme ödeneklerinin miktarını tespit etmek, emekli ve yabancı öğretim elemanlarının sözleşmeli olarak çalıştırılma usul ve esaslarını belirlemektir.
+
+Kapsam:
+Madde 2 – Bu Kanun 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununa tabi üniversite öğretim elamanlarının aylık, ödenek ve sair özlük haklarını kapsar.
+
+Öğretim elemanlarının sınıflandırılması:
+Madde 3 – (Değişik: 22/2/2018-7100/13 md.)
+Bu Kanuna tabi öğretim elemanlarının sınıfları ile başlangıç dereceleri aşağıda gösterilmiştir.
+A) Öğretim üyeleri sınıfı:
+Bu sınıf; profesörler, doçentler ve doktor öğretim üyelerinden oluşur.
+a) Profesörler, profesör kadrosuna atandıkları tarihi izleyen aybaşından itibaren birinci derecenin,
+b) Doçentler, doçent kadrosuna atandıkları tarihi izleyen aybaşından itibaren üçüncü derecenin,
+c) Doktor öğretim üyeleri, doktor öğretim üyesi kadrosuna atandıkları tarihi izleyen aybaşından itibaren beşinci derecenin,
+ilk kademe aylığını alırlar.
+Yukarıdaki (a), (b) ve (c) bentlerine göre üst dereceye atananlar, bu dereceleri kazanılmış hak olarak aldıktan sonra geçirecekleri her yıl için bir kademe ilerlemesinden yararlanırlar.
+B) Öğretim görevlileri sınıfı:
+Bu sınıf, öğretim görevlilerinden oluşur.
+C) Araştırma görevlileri sınıfı:
+Bu sınıf, araştırma görevlilerinden oluşur.
+Öğretim görevlileri ve araştırma görevlilerinin giriş dereceleri (657 sayılı Devlet Memurları Kanununun değişik 36 ncı maddesinin “Ortak Hükümler”i ile getirilen kademe ilerlemesi ve derece yükselmesine ilişkin hükümleri hariç) Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre tespit edilecek kazanılmış hak aylık derece ve kademelerine iki derece eklenmek suretiyle belirlenir.
+
+Öğretim elemanlarının görev aylıkları:
+Madde 4 – Öğretim elemanlarının bu Kanunun 3 üncü maddesine göre tespit edilen görev aylıkları kazanılmış hak teşkil etmeyip, aylık ödemelerine esas tutulur ve bu Kanun kapsamından çıkmaları halinde dikkate alınmaz.
+Öğretim üyelerinden 3 üncü maddenin (A) bendinde gösterilen kadrolara atandıkları tarihte kazanılmış hak aylık dereceleri; unvanları için öngörülen giriş derecelerinin üzerinde olanlar ile, bu kadrolara derece yükselmesi suretiyle ulaşanlar hakkında 657 sayılı Devlet Memurları Kanununun değişik 161 inci maddesi uygulanır ve kazanılmış hak aylıkları başlangıç derecelerinin ileri kademelerine gelenlerin aylıkları, bu kademeler üzerinden ödenir. Bunların başarılı geçen hizmet süreleri, kazanılmış hak derecelerinde kademe ilerlemesi yapılmak suretiyle değerlendirilir.
+
+Gösterge tablosu ve ek göstergeler:
+Madde 5 – Üniversite öğretim elamanlarının aylıklarının hesaplanmasında, Devlet memurlarının aylıklarına esas olan gösterge tablosu ve katsayı dikkate alınır.
+(Değişik: 9/4/1990- KHK -418/28 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; yeniden düzenleme: 18/5/1994-KHK/527/20 md.) Aylıkların hesabında ayrıca, bu Kanuna ekli ek gösterge cetvelinde unvan ve derecelere göre belirlenen ek gösterge rakamları dikkate alınır.
+(Üçüncü fıkra mülga: 9/4/1990 - KHK - 418/28 md.)
+
+Doktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma:
+Madde 6 – Yükseköğrenimi tamamladıktan sonra, hizmete girmeden önce veya hizmet sırasında yüksek lisans veya yükseköğrenim üstü uzmanlık öğrenimi görenlere, bir kademe ilerlemesi; tıpta uzmanlık belgesi alanlara veya doktora yapanlara ve doçentlik unvanını alarak doçent kadrosuna atananlara bir derece yükselmesi uygulanır.
+
+Derece yükseltilmesi:
+Madde 7 – Öğretim elemanları;
+a) Yükselebilecekleri derecede aynı unvanla boş bir kadronun bulunması,
+b) Derecesi içinde en az üç yıl bulunmuş ve bu derecenin üçüncü kademe aylığını bir yıl fiilen almış olmaları,
+c) Bu süre içinde olumlu sicil almış bulunmaları,
+Şartıyla bir üst dereceye yükseltilebilirler.
+
+Kademe ilerlemesi:
+Madde 8 – Öğretim elemanlarının kademe ilerlemesi, bulundukları kademede en az bir yıl çalışmış ve olumlu sicil almış olmalarına ve aynı derecede ilerlenebilecek bir kademenin bulunmasına bağlıdır.
+Kademe ilerlemesi, ilgililerin hak kazandıkları tarihten geçerli olmak üzere yapılır.
+
+Derece yükseltilmesi ve kademe ilerlemesinde onay makamı:
+Madde 9 – Derece yükseltilmesi ve kademe ilerlemesi, üniversite rektörünün onayı ile yapılır.
+
+Haklardan yararlanma:
+Madde 10 – Öğretim elamanları, 657 sayılı Devlet Memurları Kanununun 187- 213 üncü maddeleri ile düzenlenen sosyal hak ve yardımlardan faydalanırlar.
+
+Ek ders ücreti:
+Madde 11 – (Değişik: 27/6/1989 - KHK - 375/17 md.)
+(Değişik birinci fıkra: 26/6/2001 - 4689/4 md.) 2547 Sayılı Yükseköğretim Kanununun 36 ncı maddesine göre haftalık okutulması mecburi ders yükü saati dışında, kısmi statüde bulunanlar dahil öğretim elamanlarına görev unvanlarına göre Maliye Bakanlığının görüşü üzerine Yükseköğretim Kurulu tarafından belirlenen mecburi ve isteğe bağlı dersler ve diğer faaliyetler için bu ders ve faaliyetlerin haftalık ders programında yer alması ve fiilen yapılması şartıyla en çok yirmi saate kadar, ikinci öğretimde ise en çok on saate kadar ek ders ücreti ödenir. Ders yüklerinin tamamlanmasında öncelikle normal örgün öğretimde verilen ders ve faaliyetler dikkate alınır.
+(Değişik: 26/6/2001 - 4689/4 md.) Öğretim elemanlarının teorik derslerle yaptırdıkları uygulama, yönettikleri tez, seminer ve doktora çalışmalarının ve ara sınavların ne ölçüde ders yükünden sayılacağı Yükseköğretim Kurulunca belirlenir. Ara sınavlar için Yükseköğretim Kurulunca öğrenci sayısı gözönünde bulundurulmak suretiyle tespit edilecek ders yükü beş saati, diğer faaliyetler için belirlenecek ders yükü ise bir saati geçemez. Teorik dersler dışındaki faaliyetlerin ders yükünün tamamlanmasından sonraki kısmı ek ders ücretinin hesabında dikkate alınır. Ancak mecburi ders yükünün tamamlanmasında ve ek ders ücretinin hesabında, teorik dersler dışındaki faaliyetlerin haftalık en fazla on saatlik kısmı dikkate alınır, kalan kısmı ise maaş karşılığı sayılır.
+(Değişik: 9/4/1990 - KHK - 418/29 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; Yeniden düzenleme: 18/5/1994-KHK/527/21 md.) Dersi veren öğretim elemanına her ders için ayrı ayrı olmak üzere yarı yıl ve yıl sonu dönemlerinde her 50 öğrenci için 300 gösterge rakamının Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımı sonucu bulunacak tutarda sınav ücreti ödenir. Öğrenci sayısının hesabında küsurlar tama iblağ edilir ve 500 öğrenciden fazlası dikkate alınmaz. Ara sınavlar ve bütünleme sınavları için sınav ücreti ödenmez.
+Ek ders ücreti, aşağıdaki göstergelerin Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımından oluşur.
+
+|Unvanı |Ek Ders Ücreti Göstergesi |
+|Profesör |300 |
+|Doçent |250 |
+|Doktor Öğretim Üyesi |200 |
+|Öğretim Görevlisi (…)4 |160 |
+
+(Beşinci fıkra mülga: 9/4/1990 - KHK - 418/29 md.)
+Yükseköğretim Kurumlarının kadrolarında olmayıp bu unvanları taşıyanlardan ders saati başına görevlendirilenlerin sosyal güvenlik kuruluşlarından almakta oldukları aylıklar bu şekilde görevlendirilmeleri nedeniyle kesilmez.
+Müfredat programları uyarınca normal çalışma günlerinde çalışma saatinin bitiminden ve saat 17.00'den sonra başlayan gece öğretimi ile hafta tatili, yarı yıl veya yaz tatillerinde yapılan öğretimde yukarıdaki şekilde hesaplanan ek ders ücretleri % 60 zamlı ödenir. Yaz ve yarı yıl tatillerinde yapılan öğretim için verilecek ek ders ücretinin hesabında ders yükü dikkate alınmaz.
+
+Üniversite Ödeneği:
+Madde 12 – (Değişik: 20/3/1997 - KHK - 570/4 md.)
+657 sayılı Devlet Memurları Kanununa tabi en yüksek Devlet memuru bürüt aylık (ek gösterge dahil) tutarının;
+
+|1) |Profesörlerden Rektör, Rektör Yardımcısı, Dekan, | |
+| |Dekan Yardımcısı, Yüksekokul Müdürü olanlar ile | |
+| |Profesör kadrosunda üç yılını tamamlamış bulunanlara |% 245'i, |
+|2) |Diğer Profesör kadrosunda bulunanlara |% 215'i, |
+|3) |Doçent kadrosunda bulunanlara |% 175'i, |
+|4) |(Değişik: 22/2/2018-7100/14 md.) Doktor öğretim üyesi kadrosunda bulunanlara |% 175 |
+|5); |Diğer Öğretim elemanlarından | |
+| |a) Birinci dereceden aylık alanlara |% 130'u, |
+| |b) İkinci dereceden aylık alanlara |% 117'si, |
+| |c) Üçüncü dereceden aylık alanlara |% 110'u, |
+| |d) Dördüncü ve beşinci dereceden aylık alanlara |% 104'ü, |
+| |e) Diğer derecelerden aylık alanlara |% 98'i, |
+|Her ay üniversite ödeneği olarak ödenir. |
+
+Bu ödenek damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve kısmi statüde görev yapanlara ödenmez.
+
+İdari görev ödeneği:
+Madde 13 – (Değişik birinci fıkra: 20/3/1997 - KHK - 570/5 md.) Almakta oldukları aylık gösterge ve ek gösterge brüt tutarının; Rektörlere %70'i, Rektör Yardımcıları ve Dekanlara %30'u, Dekan Yardımcıları, Enstitü ve Yüksekokul Müdürleri, Konservatuar Müdürleri ile Bölüm Başkanlarına %20'si, Enstitü, Yüksekokul ve Konservatuar Müdür Yardımcılarına %15 'i idari görev ödeneği olarak ayrıca ödenir. Birden fazla idari görevi bulunanlara İdari Görev Ödeneğinden en yüksek olanı verilir.
+Bu Kanuna tabi olmayan kişiler arasından tayin olunan rektörlere, 657 sayılı Devlet Memurları Kanununa göre birinci derece memur son kademe aylığı (en yüksek ek gösterge dahil) ile bunun bir katı tutarında ek ödemede bulunulur. Bu Kanunun 10 uncu maddesi hükümleri, bunlar hakkında da uygulanır. Bunlardan emekli iken atananların emekli aylıklarının ödenmesine devam olunur, diğerleri genel hükümlere göre T.C. Emekli Sandığı ile ilgilendirilir.
+
+Geliştirme ödeneği:
+Madde 14 – (Değişik: 3/4/1998 - 4359/15 md.)
+Diğer yükseköğretim kurumlarına göre sosyo-ekonomik açıdan daha az gelişmiş yerlerde öğretim yapan ve/veya yeterli sayıda öğretim elemanı sağlanamayan yükseköğretim kurumları ile bunların bölümlerinde görevli öğretim elemanlarına; almakta oldukları aylık gösterge ve ek gösterge toplamının 657 sayılı Devlet Memurları Kanunu uyarınca belirlenen aylık katsayı ile çarpımı sonucu bulunacak miktarın beş katına kadar geliştirme ödeneği ödenebilir.
+Geliştirme ödeneği verilecek yükseköğretim kurumları, ödeneğin verilmesine ilişkin usul ve esaslar ile oran veya miktarları, bu ödenekten yararlanma süresi ile yararlanamayacak olanlar ve diğer hususlar Cumhurbaşkanı Kararı ile tespit edilir.
+Bu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.
+
+Devlet konservatuvarlarının öğretim elemanları:
+Madde 15 – (Değişik: 22/8/1989 - KHK - 378/8 md.)6
+Yükseköğretim kurumlarının 657 sayılı Devlet Memurları Kanununun değişik ek geçici 16 ncı maddesinde unvanları belirtilen personeli, Yükseköğretim Kurulunun onayı ile sözleşmeli olarak istihdam edilebilir. Bu elemanların sözleşme esasları, bunlara ödenebilecek ücretin üst sınırları ve sağlanacak sosyal yardımlar ile diğer mali haklar; Cumhurbaşkanınca kararlaştırılır.
+
+Yabancı öğretim elemanlarına ödenecek ücretler:6
+Madde 16 – 2547 sayılı Yükseköğretim Kanununun 34 üncü maddesine göre sözleşmeli olarak çalıştırılacak yabancı uyruklu öğretim elemanlarına ödenecek ücret, Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulunca tespit edilir.
+
+Emekli öğretim elemanlarının sözleşmeli istihdamı:6
+Madde 17 – Üniversiteler, ihtiyaç duydukları dallarda 5434 sayılı T. C. Emekli Sandığı veya 506 sayılı Sosyal Sigortalar Kanununa göre 65 yaşını doldurmak suretiyle emekli olmuş öğretim elemanlarını emekli aylıkları kesilmeksizin ve yaş kaydı aranmaksızın sözleşme ile çalıştırabilirler. Bu gibilere ödenecek ücret Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulu tarafından tespit edilir.
+
+Geçici görev:
+Madde 18 – Öğretim elemanları ile tabi oldukları özel kanunlarda mani hüküm bulunmayan diğer kamu görevlileri, rektörün görüşü veya ilgili kuruluşun muvafakatı ile yükseköğretim üst kuruluşlarında her seferinde altı ayı geçmemek üzere geçici olarak görevlendirilebilirler.
+Diğer kurum mensuplarını ilgilendiren hükümler:
+Madde 19 – Bu Kanun hükümleri, 7163 sayılı Kanunla kurulan Türkiye ve Orta Doğu Amme İdaresi Enstitüsü kadrosunda çalışan profesörler, öğretim ve araştırma mütehassısları (doçentler gibi), öğretim görevlileri (…) ve asistanlar hakkında da uygulanır.
+Bu Enstitüde görevli asistanlar hakkında araştırma görevlisi gibi işlem yapılır.
+Bu Kanun hükümleri gereğince Yükseköğretim Kurulu, 2547 sayılı Yükseköğretim Kanunu gereğince de Üniversitelerarası Kurul tarafından alınan kararlar bu Enstitü mensuplarına da aynen uygulanır.
+
+Uygulanacak diğer kanun hükümleri:
+Madde 20 – Bu Kanunda hüküm bulunmayan hallerde 2547 sayılı Yükseköğretim Kanunu ile 657 sayılı Devlet Memurları Kanunu hükümleri uygulanır.
+
+Kaldırılan hükümler:
+Madde 21 – 25/6/1973 tarih ve 1765 sayılı Üniversite Personel Kanunu ile bu Kanunda değişiklik yapan diğer kanun hükümleri yürürlükten kaldırılmıştır.
+
+Eğitim Öğretim Ödeneği:
+Ek Madde 1 – (Ek: 24/11/1994 - 4048/4 md.; Değişik: 20/3/1997 - KHK-570/6 md.)
+4.11.1981 tarih ve 2547 sayılı Kanunun 33 üncü maddesi ve 39 uncu maddesinin ikinci fıkrası uyarınca yurtdışına gönderilenler ile anılan Kanunun 38 inci maddesine göre diğer kurum ve kuruluşlarda görevlendirilenlerden yüksek öğretim kurumlarındaki kadro görevini yapmayanlar hariç olmak üzere Yükseköğretim Kurumlarında görevli öğretim elemanlarına en yüksek Devlet memuru aylığı (ek gösterge dahil) brüt tutarının on ikide biri, her ay aylıklarla birlikte Eğitim Öğretim Ödeneği olarak ödenir. Bu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.
+
+Makam Tazminatı:
+Ek Madde 2 – (Ek: 20/3/1997 - KHK - 570/7 md.)
+Bu Kanuna ekli Makam Tazminatı Cetvelinde yazılı kadro ve görev unvanlarına atananlara hizalarında belirtilen gösterge rakamlarının memur aylıklarına uygulanan katsayı ile çarpımı sonucu bulunan miktarda Makam Tazminatı ödenir. Makam Tazminatı damga vergisi hariç herhangi bir vergiye tabi tutulmaz. Makam tazminatının hakedilmesinde ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu tazminattan yararlananlara ayrıca diğer kanunlarda belirtilen Yüksek Hakimlik Tazminatı ve Makam Tazminatı ödenmez.
+Yükseköğretim tazminatı:
+Ek Madde 3 – (Ek: 5/11/2014-6564/1 md.)
+Devlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;
+a) Profesör kadrosunda bulunanlara %100’ü,
+b) Doçent kadrosunda bulunanlara %100’ü,
+c) Doktor Öğretim Üyesi kadrosunda bulunanlara %100’ü,
+d) Araştırma Görevlisi kadrosunda bulunanlara %115’i,
+e) Öğretim Görevlisi (…)10 kadrosunda bulunanlara %115’i,
+f) (Mülga: 22/2/2018-7100/15 md.)
+oranında her ay yükseköğretim tazminatı ödenir.
+Bu tazminata hak kazanılmasında ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu maddeye göre ödenecek tazminat, damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve ilgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.
+
+Akademik teşvik ödeneği:
+Ek Madde 4 – (Ek: 5/11/2014-6564/2 md.)
+Her bir takvim yılı için, bir önceki yıl, bilim, teknoloji ve sanata katkı sağlayıcı nitelikte yurt içinde veya yurt dışında sonuçlandırılan proje, araştırma, yayın, tasarım, sergi, patent ile çalışmalarına yapılan atıflar, bilim kurulu bulunan uluslararası düzeydeki toplantılarda tebliğ sunma ve almış olduğu akademik ödüller esas alınarak öğretim elemanları için yüz puan üzerinden yıllık akademik teşvik puanı hesaplanır.
+Akademik teşvik puanı otuz ve üzerinde olanlara, Devlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;
+a) Profesör kadrosunda bulunanlar için %100’üne,
+b) Doçent kadrosunda bulunanlar için %90’ına,
+c) Doktor Öğretim Üyesi kadrosunda bulunanlar için %80’ine,
+d) Araştırma Görevlisi kadrosunda bulunanlar için %70’ine,
+e) Öğretim Görevlisi (…)12 kadrosunda bulunanlar için %70’ine,
+f) (Mülga: 22/2/2018-7100/15 md.)
+aldıkları akademik teşvik puanının yüze bölünmesi suretiyle bulunacak oranın uygulanması suretiyle hesaplanan tutarda akademik teşvik ödeneği verilir.
+Bu madde uyarınca yapılacak ödeme; bu Kanun uyarınca aylık ödendiği sürece ve kadrolarının bulunduğu yükseköğretim kurumları tarafından şubat ayının on beşinden itibaren on iki ay süreyle her ayın on beşinde yapılır, damga vergisi hariç herhangi bir vergiye tabi tutulmaz. İlgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.
+Bilim alanlarının özellikleri ve öğretim elemanlarının unvanlarına göre akademik teşvik puanlarının hesaplanmasında esas alınacak faaliyetlerin ayrıntılı özellikleri ve bu faaliyetlerin puan karşılıkları, akademik teşvik toplam puanının %30’unu geçmemek üzere her bir akademik faaliyet türünün toplam puanın hesaplanmasındaki ağırlıkları, akademik teşvik puanının hesaplanmasına ilişkin usul ve esaslar ile bu hesaplamaları yapacak komisyonun oluşumu ile diğer hususlar Cumhurbaşkanı tarafından yürürlüğe konulan yönetmelikle belirlenir.
+Bu madde hükümleri, Türk Silahlı Kuvvetleri kadrolarında bulunan öğretim elemanları hakkında da uygulanır.
+
+Geçici Madde 1 – 657 sayılı Devlet Memurları Kanununa tabi öğretmenlerden 28/3/1993 tarih ve 2809 sayılı Kanunun geçici 3 üncü maddesi ile aynı Kanun kapsamına alınanlardan yükseköğrenim kurumlarında istihdamına ihtiyaç duyulanların bu Kanun hükümlerine göre intibakları, 30/6/1984 tarihi itibariyle yapılır.
+
+Geçici Madde 2 – Öğretim elemanlarına ve geçici 1 inci madde kapsamına girenler bu Kanunun 12 inci maddesi uyarınca ödenecek Üniversite Ödeneğinin, 1765 sayılı Üniversite Personel Kanununun değişik 16 ncı maddesi uyarınca halen ödenmekte olan iş güçlüğü, iş riski, temininde güçlük zammı ile tamgün ödeneği tutarından az olması halinde aradaki net fark, üniversite ödeneği bu miktara ulaşıncaya kadar, hiçbir vergi ve kesintiye tabi tutulmaksızın ödenir.
+
+Geçici Madde 3 – Öğretim elemanlarına bu Kanunun 5 inci maddesine göre verilecek ek göstergeleri, 31/12/1983 tarihinde yararlanmakta oldukları ek göstergelerden düşük olamaz.
+
+Geçici Madde 4 – 1/1/1984 tarihinde yükseköğretim kurumlarında görev yapmakta olanlar ile bu kurumların kadroları ile ilişkileri devam eden, askerlik görevlerini yapmakta olan ve bu Kanun kapsamına giren öğretim elemanlarının intibakları, 657 sayılı Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre (657 sayılı Kanunun değişik 36 ncı maddesinin "Ortak Hükümleri" ile getirilen kademe ilerlemesi ve derece yükselmesi hariç) başlayabilecekleri derece ve kademe esas alınmak suretiyle bu Kanun ve Devlet Memurları Kanununa göre rektörlüklerce (Geçici 1 inci madde kapsamına girenler hariç) üç ay içinde yapılır.
+İntibak sonucunda kazanılmış hak aylık dereceleri kadro derecelerinin üzerinde olanlara, kazanılmış hak aylıkları esas alınarak ödemede bulunulur.
+
+Geçici Madde 5 – Geçici 4 üncü madde hükmü saklı kalmak üzere bu Kanunun yürürlüğe girdiği tarihten önce doçent kadrosuna atanmış bulunanların görev aylıkları, bir üst derecenin aynı kademesine yükseltilir.
+
+Geçici Madde 6 – 6/11/1981 tarihinde Boğaziçi Üniversitesi ile Orta Doğu Teknik Üniversitesinde 657 sayılı Devlet Memurları Kanunu hükümlerine tabi olmadan çalışan öğretim elemanları dışında kalan personelden 657 sayılı Kanuna göre intibaklarının yapılmasını istemeyerek, 1/1/1984 tarihinden itibaren 30 gün içinde müracaat edenlere, kıdem tazminatları ödenir ve kurumları ile ilişkileri kesilir.
+Bunlara ödenecek kıdem tazminatı, görevden ayrıldıkları tarihteki kazanılmış hakları dikkate alınarak hesaplanır. Ancak, bu şekilde hesaplanacak kıdem tazminatının miktarı 30/9/1982 tarihinde hak kazanabilecekleri kıdem tazminatından fazla olamaz.
+2547 sayılı Yükseköğretim Kanununun yürürlüğe girdiği 6/11/1981 tarihi ile bu Kanunun yürürlüğe girdiği tarih arasında görevden ayrılanlar hakkında da, görevden ayrıldıkları tarih dikkate alınarak yukarıdaki hükümler uygulanır.
+30/9/1982 tarihinden sonra görevden ayrılanların bu tarih ile görevden ayrıldıkları tarih arasında geçen hizmetleri, primlerinin ödenmesi kaydıyla 506 sayılı Sosyal Sigortalar Kanununa tabi olarak geçmiş sayılır.
+
+Geçici Madde 7 – 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununun 24/9/1982 tarih ve 2708 sayılı Kanun ile değişik geçici 23 üncü maddesinde belirtilen ve sözleşmeli olarak çalıştırılan öğretim elemanları ile idari personel 30/9/1984 tarihine kadar sahip oldukları statü içinde çalıştırılırlar. Bu tarihten sonra genel hükümlere tabi olurlar.
+
+Geçici Madde 8 – İlgili kanunda gerekli değişiklik yapılıncaya kadar, Yükseköğretim Kurulu üyeleri ile Yükseköğretim Denetleme Kurulu üyeleri, 657 sayılı Devlet Memurları Kanununun 187 - 213 üncü maddeleri ile düzenlenen sosyal haklardan yararlanırlar.
+Ancak, bu üyelerden T. C. Emekli Sandığı ile Sosyal Sigortalar Kurumundan emekli olanlar bu kuruluşlarca aynı sosyal haklardan ayrıca yararlandırılmazlar.
+(Ek: 26/6/1984 - KHK - 241/32 md.; Değişik: 24/11/1994 - 4048/5 md.)
+T. C. Emekli Sandığı iştirakçisi olan Yükseköğretim Kurulu Başkanı, Yükseköğretim Yürütme Kurulu Üyeleri ile Yükseköğretim Denetleme Kurulu üyelerinin emekli keseneklerinin hesabında aşağıdaki ek göstergeler esas alınır. Emekli İken Yükseköğretim Yürütme Kurulu veya Yükseköğretim Denetleme Kurulu Üyeliklerine geçirilenlerin emekli aylıklarının ödenmesinde de aynı göstergeler esas alınır.
+
+(Değişik:1/7/2022-7417/10 md.)
+|Unvanı |Derece |Ek Göstergeler |
+|Yükseköğretim Kurulu Başkanı |1 |8000 |
+|Yükseköğretim Kurulu Üyeleri |1 |7800 |
+|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |
+
+Geçici Madde 9 – (Ek: 14/1/1988 - KHK - 311/8 md.)
+2547 sayılı Yükseköğretim Kanunun yürürlüğe girmesinden önce Profesörlük unvanını almış olup da 78 sayılı Kanun Hükmünde Kararname ile ihdas edilen profesörlük kadrolarına atanamamış olanlar, bu Kanunun 5 inci maddesinde profesör kadrosunda bulunanlar için öngörülen ek göstergeler ile 241 sayılı Kanun Hükmünde Kararname'nin değişik 39 uncu maddesine göre profesör kadrosunda üç yılı tamamlamış olanlar için öngörülen makam tazminatından profesör kadrosuna atanma şartı aranmaksızın yararlandırılırlar.
+
+Geçici Madde 10 – (Ek: 5/11/2014-6564/3 md.)
+Ek 4 üncü maddede belirtilen yönetmelik dört ay içinde yürürlüğe konur. Ek 4 üncü maddenin birinci fıkrasına göre ilk defa akademik teşvik puanı hesaplanması, 2015 yılında yapılan faaliyetler esas alınmak suretiyle 2016 yılı için yapılır.
+
+Yürürlük:
+Madde 22 – Bu Kanunun;
+a) Geçici 7 nci maddesi hükümleri; 30/9/1983 tarihinden geçerli olmak üzere yayımı tarihinde,
+b) Geçici 8 inci maddesi ile atıfta bulunulan 657 sayılı Devlet Memurları Kanununun 208- 210 uncu maddelerine ilişkin hükümleri yayımı tarihinde,
+c) Diğer hükümleri 1/1/1984 tarihinde,
+Yürürlüğe girer.
+
+Yürütme:
+Madde 23 – Bu Kanun hükümlerini Bakanlar Kurulu yürütür.
+EK GÖSTERGE CETVELİ:
+
+(Ek:18/5/1994-KHK-527/19 md.) (Değişik:1/7/2022-7417/10 md.)
+
+|Kadro Unvanı |Derece |Ek Göstergeler |
+|a) Profesörlerden Rektör, Rektör Yardımcısı, Dekan, Dekan Yardımcısı, Yüksekokul Müdürü |1 |7000 |
+|olanlar ile Profesörlük kadrosunda dört yılını tamamlamış bulunanlar | | |
+|b) Profesörler |1 |5900 |
+|c) Doçentler |1-3 |5400 |
+|d) Doktor Öğretim Üyeleri |1-5 |4200 |
+|e) Öğretim Görevlisi ve Araştırma Görevlileri |1 |4200 |
+| |2 |3300 |
+| |3-7 |2900 |
+
+MAKAM TAZMİNATI CETVELİ (Ek: 20/3/1997-KHK-570/7 md.)
+
+|Sıra No |Kadro ve Görev Unvanı |Tazminat Göstergeleri |
+|1 |Rektörler |7.000 |
+|2 |Profesörler (Bu kadroda üç yılını tamamlamış olmak şartıyla) |6.000 |
+|3 |Profesörler |4.500 |
+|4 |Doçentler (Kazanılmış hak aylıkları birinci derece olmak şartıyla) |2.000 |

data/structural/2914_articles.jsonl

@@ -0,0 +1,37 @@
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 1", "article_type": "main", "title": "Amaç", "heading_path": [], "article_heading": "Amaç", "source_span": {"char_start": 192, "char_end": 692}, "source_text": "Madde 1 – Bu Kanunun amacı, 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununda yer alan öğretim elemanları tanımına giren personeli sınıflandırmak, aylıklarını ve ek göstergelerini düzenlemek, derece yükseltilmesi ve kademe ilerlemesinin şekil ve şartları ile, sosyal haklardan yararlanma, ek ders ücreti, üniversite, idari görev ve geliştirme ödeneklerinin miktarını tespit etmek, emekli ve yabancı öğretim elemanlarının sözleşmeli olarak çalıştırılma usul ve esaslarını belirlemektir.\n\nKapsam:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 2", "article_type": "main", "title": "Kapsam", "heading_path": [], "article_heading": "Kapsam", "source_span": {"char_start": 692, "char_end": 891}, "source_text": "Madde 2 – Bu Kanun 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununa tabi üniversite öğretim elamanlarının aylık, ödenek ve sair özlük haklarını kapsar.\n\nÖğretim elemanlarının sınıflandırılması:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "article_type": "main", "title": "Öğretim elemanlarının sınıflandırılması", "heading_path": [], "article_heading": "Öğretim elemanlarının sınıflandırılması", "source_span": {"char_start": 891, "char_end": 2263}, "source_text": "Madde 3 – (Değişik: 22/2/2018-7100/13 md.)\nBu Kanuna tabi öğretim elemanlarının sınıfları ile başlangıç dereceleri aşağıda gösterilmiştir.\nA) Öğretim üyeleri sınıfı:\nBu sınıf; profesörler, doçentler ve doktor öğretim üyelerinden oluşur.\na) Profesörler, profesör kadrosuna atandıkları tarihi izleyen aybaşından itibaren birinci derecenin,\nb) Doçentler, doçent kadrosuna atandıkları tarihi izleyen aybaşından itibaren üçüncü derecenin,\nc) Doktor öğretim üyeleri, doktor öğretim üyesi kadrosuna atandıkları tarihi izleyen aybaşından itibaren beşinci derecenin,\nilk kademe aylığını alırlar.\nYukarıdaki (a), (b) ve (c) bentlerine göre üst dereceye atananlar, bu dereceleri kazanılmış hak olarak aldıktan sonra geçirecekleri her yıl için bir kademe ilerlemesinden yararlanırlar.\nB) Öğretim görevlileri sınıfı:\nBu sınıf, öğretim görevlilerinden oluşur.\nC) Araştırma görevlileri sınıfı:\nBu sınıf, araştırma görevlilerinden oluşur.\nÖğretim görevlileri ve araştırma görevlilerinin giriş dereceleri (657 sayılı Devlet Memurları Kanununun değişik 36 ncı maddesinin “Ortak Hükümler”i ile getirilen kademe ilerlemesi ve derece yükselmesine ilişkin hükümleri hariç) Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre tespit edilecek kazanılmış hak aylık derece ve kademelerine iki derece eklenmek suretiyle belirlenir.\n\nÖğretim elemanlarının görev aylıkları:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 4", "article_type": "main", "title": "Öğretim elemanlarının görev aylıkları", "heading_path": [], "article_heading": "Öğretim elemanlarının görev aylıkları", "source_span": {"char_start": 2263, "char_end": 3087}, "source_text": "Madde 4 – Öğretim elemanlarının bu Kanunun 3 üncü maddesine göre tespit edilen görev aylıkları kazanılmış hak teşkil etmeyip, aylık ödemelerine esas tutulur ve bu Kanun kapsamından çıkmaları halinde dikkate alınmaz.\nÖğretim üyelerinden 3 üncü maddenin (A) bendinde gösterilen kadrolara atandıkları tarihte kazanılmış hak aylık dereceleri; unvanları için öngörülen giriş derecelerinin üzerinde olanlar ile, bu kadrolara derece yükselmesi suretiyle ulaşanlar hakkında 657 sayılı Devlet Memurları Kanununun değişik 161 inci maddesi uygulanır ve kazanılmış hak aylıkları başlangıç derecelerinin ileri kademelerine gelenlerin aylıkları, bu kademeler üzerinden ödenir. Bunların başarılı geçen hizmet süreleri, kazanılmış hak derecelerinde kademe ilerlemesi yapılmak suretiyle değerlendirilir.\n\nGösterge tablosu ve ek göstergeler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 5", "article_type": "main", "title": "Gösterge tablosu ve ek göstergeler", "heading_path": [], "article_heading": "Gösterge tablosu ve ek göstergeler", "source_span": {"char_start": 3087, "char_end": 3670}, "source_text": "Madde 5 – Üniversite öğretim elamanlarının aylıklarının hesaplanmasında, Devlet memurlarının aylıklarına esas olan gösterge tablosu ve katsayı dikkate alınır.\n(Değişik: 9/4/1990- KHK -418/28 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; yeniden düzenleme: 18/5/1994-KHK/527/20 md.) Aylıkların hesabında ayrıca, bu Kanuna ekli ek gösterge cetvelinde unvan ve derecelere göre belirlenen ek gösterge rakamları dikkate alınır.\n(Üçüncü fıkra mülga: 9/4/1990 - KHK - 418/28 md.)\n\nDoktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 6", "article_type": "main", "title": "Doktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma", "heading_path": [], "article_heading": "Doktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma", "source_span": {"char_start": 3670, "char_end": 4018}, "source_text": "Madde 6 – Yükseköğrenimi tamamladıktan sonra, hizmete girmeden önce veya hizmet sırasında yüksek lisans veya yükseköğrenim üstü uzmanlık öğrenimi görenlere, bir kademe ilerlemesi; tıpta uzmanlık belgesi alanlara veya doktora yapanlara ve doçentlik unvanını alarak doçent kadrosuna atananlara bir derece yükselmesi uygulanır.\n\nDerece yükseltilmesi:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 7", "article_type": "main", "title": "Öğretim elemanları", "heading_path": [], "article_heading": "Öğretim elemanları", "source_span": {"char_start": 4018, "char_end": 4347}, "source_text": "Madde 7 – Öğretim elemanları;\na) Yükselebilecekleri derecede aynı unvanla boş bir kadronun bulunması,\nb) Derecesi içinde en az üç yıl bulunmuş ve bu derecenin üçüncü kademe aylığını bir yıl fiilen almış olmaları,\nc) Bu süre içinde olumlu sicil almış bulunmaları,\nŞartıyla bir üst dereceye yükseltilebilirler.\n\nKademe ilerlemesi:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 8", "article_type": "main", "title": "Kademe ilerlemesi", "heading_path": [], "article_heading": "Kademe ilerlemesi", "source_span": {"char_start": 4347, "char_end": 4690}, "source_text": "Madde 8 – Öğretim elemanlarının kademe ilerlemesi, bulundukları kademede en az bir yıl çalışmış ve olumlu sicil almış olmalarına ve aynı derecede ilerlenebilecek bir kademenin bulunmasına bağlıdır.\nKademe ilerlemesi, ilgililerin hak kazandıkları tarihten geçerli olmak üzere yapılır.\n\nDerece yükseltilmesi ve kademe ilerlemesinde onay makamı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 9", "article_type": "main", "title": "Derece yükseltilmesi ve kademe ilerlemesinde onay makamı", "heading_path": [], "article_heading": "Derece yükseltilmesi ve kademe ilerlemesinde onay makamı", "source_span": {"char_start": 4690, "char_end": 4807}, "source_text": "Madde 9 – Derece yükseltilmesi ve kademe ilerlemesi, üniversite rektörünün onayı ile yapılır.\n\nHaklardan yararlanma:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 10", "article_type": "main", "title": "Haklardan yararlanma", "heading_path": [], "article_heading": "Haklardan yararlanma", "source_span": {"char_start": 4807, "char_end": 4974}, "source_text": "Madde 10 – Öğretim elamanları, 657 sayılı Devlet Memurları Kanununun 187- 213 üncü maddeleri ile düzenlenen sosyal hak ve yardımlardan faydalanırlar.\n\nEk ders ücreti:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 11", "article_type": "main", "title": "Ek ders ücreti", "heading_path": [], "article_heading": "Ek ders ücreti", "source_span": {"char_start": 4974, "char_end": 7986}, "source_text": "Madde 11 – (Değişik: 27/6/1989 - KHK - 375/17 md.)\n(Değişik birinci fıkra: 26/6/2001 - 4689/4 md.) 2547 Sayılı Yükseköğretim Kanununun 36 ncı maddesine göre haftalık okutulması mecburi ders yükü saati dışında, kısmi statüde bulunanlar dahil öğretim elamanlarına görev unvanlarına göre Maliye Bakanlığının görüşü üzerine Yükseköğretim Kurulu tarafından belirlenen mecburi ve isteğe bağlı dersler ve diğer faaliyetler için bu ders ve faaliyetlerin haftalık ders programında yer alması ve fiilen yapılması şartıyla en çok yirmi saate kadar, ikinci öğretimde ise en çok on saate kadar ek ders ücreti ödenir. Ders yüklerinin tamamlanmasında öncelikle normal örgün öğretimde verilen ders ve faaliyetler dikkate alınır.\n(Değişik: 26/6/2001 - 4689/4 md.) Öğretim elemanlarının teorik derslerle yaptırdıkları uygulama, yönettikleri tez, seminer ve doktora çalışmaların��n ve ara sınavların ne ölçüde ders yükünden sayılacağı Yükseköğretim Kurulunca belirlenir. Ara sınavlar için Yükseköğretim Kurulunca öğrenci sayısı gözönünde bulundurulmak suretiyle tespit edilecek ders yükü beş saati, diğer faaliyetler için belirlenecek ders yükü ise bir saati geçemez. Teorik dersler dışındaki faaliyetlerin ders yükünün tamamlanmasından sonraki kısmı ek ders ücretinin hesabında dikkate alınır. Ancak mecburi ders yükünün tamamlanmasında ve ek ders ücretinin hesabında, teorik dersler dışındaki faaliyetlerin haftalık en fazla on saatlik kısmı dikkate alınır, kalan kısmı ise maaş karşılığı sayılır.\n(Değişik: 9/4/1990 - KHK - 418/29 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; Yeniden düzenleme: 18/5/1994-KHK/527/21 md.) Dersi veren öğretim elemanına her ders için ayrı ayrı olmak üzere yarı yıl ve yıl sonu dönemlerinde her 50 öğrenci için 300 gösterge rakamının Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımı sonucu bulunacak tutarda sınav ücreti ödenir. Öğrenci sayısının hesabında küsurlar tama iblağ edilir ve 500 öğrenciden fazlası dikkate alınmaz. Ara sınavlar ve bütünleme sınavları için sınav ücreti ödenmez.\nEk ders ücreti, aşağıdaki göstergelerin Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımından oluşur.\n\n|Unvanı |Ek Ders Ücreti Göstergesi |\n|Profesör |300 |\n|Doçent |250 |\n|Doktor Öğretim Üyesi |200 |\n|Öğretim Görevlisi (…)4 |160 |\n\n(Beşinci fıkra mülga: 9/4/1990 - KHK - 418/29 md.)\nYükseköğretim Kurumlarının kadrolarında olmayıp bu unvanları taşıyanlardan ders saati başına görevlendirilenlerin sosyal güvenlik kuruluşlarından almakta oldukları aylıklar bu şekilde görevlendirilmeleri nedeniyle kesilmez.\nMüfredat programları uyarınca normal çalışma günlerinde çalışma saatinin bitiminden ve saat 17.00'den sonra başlayan gece öğretimi ile hafta tatili, yarı yıl veya yaz tatillerinde yapılan öğretimde yukarıdaki şekilde hesaplanan ek ders ücretleri % 60 zamlı ödenir. Yaz ve yarı yıl tatillerinde yapılan öğretim için verilecek ek ders ücretinin hesabında ders yükü dikkate alınmaz.\n\nÜniversite Ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "article_type": "main", "title": "Üniversite Ödeneği", "heading_path": [], "article_heading": "Üniversite Ödeneği", "source_span": {"char_start": 7986, "char_end": 8999}, "source_text": "Madde 12 – (Değişik: 20/3/1997 - KHK - 570/4 md.)\n657 sayılı Devlet Memurları Kanununa tabi en yüksek Devlet memuru bürüt aylık (ek gösterge dahil) tutarının;\n\n|1) |Profesörlerden Rektör, Rektör Yardımcısı, Dekan, | |\n| |Dekan Yardımcısı, Yüksekokul Müdürü olanlar ile | |\n| |Profesör kadrosunda üç yılını tamamlamış bulunanlara |% 245'i, |\n|2) |Diğer Profesör kadrosunda bulunanlara |% 215'i, |\n|3) |Doçent kadrosunda bulunanlara |% 175'i, |\n|4) |(Değişik: 22/2/2018-7100/14 md.) Doktor öğretim üyesi kadrosunda bulunanlara |% 175 |\n|5); |Diğer Öğretim elemanlarından | |\n| |a) Birinci dereceden aylık alanlara |% 130'u, |\n| |b) İkinci dereceden aylık alanlara |% 117'si, |\n| |c) Üçüncü dereceden aylık alanlara |% 110'u, |\n| |d) Dördüncü ve beşinci dereceden aylık alanlara |% 104'ü, |\n| |e) Diğer derecelerden aylık alanlara |% 98'i, |\n|Her ay üniversite ödeneği olarak ödenir. |\n\nBu ödenek damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve kısmi statüde görev yapanlara ödenmez.\n\nİdari görev ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 13", "article_type": "main", "title": "İdari görev ödeneği", "heading_path": [], "article_heading": "İdari görev ödeneği", "source_span": {"char_start": 8999, "char_end": 9952}, "source_text": "Madde 13 – (Değişik birinci fıkra: 20/3/1997 - KHK - 570/5 md.) Almakta oldukları aylık gösterge ve ek gösterge brüt tutarının; Rektörlere %70'i, Rektör Yardımcıları ve Dekanlara %30'u, Dekan Yardımcıları, Enstitü ve Yüksekokul Müdürleri, Konservatuar Müdürleri ile Bölüm Başkanlarına %20'si, Enstitü, Yüksekokul ve Konservatuar Müdür Yardımcılarına %15 'i idari görev ödeneği olarak ayrıca ödenir. Birden fazla idari görevi bulunanlara İdari Görev Ödeneğinden en yüksek olanı verilir.\nBu Kanuna tabi olmayan kişiler arasından tayin olunan rektörlere, 657 sayılı Devlet Memurları Kanununa göre birinci derece memur son kademe aylığı (en yüksek ek gösterge dahil) ile bunun bir katı tutarında ek ödemede bulunulur. Bu Kanunun 10 uncu maddesi hükümleri, bunlar hakkında da uygulanır. Bunlardan emekli iken atananların emekli aylıklarının ödenmesine devam olunur, diğerleri genel hükümlere göre T.C. Emekli Sandığı ile ilgilendirilir.\n\nGeliştirme ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 14", "article_type": "main", "title": "Geliştirme ödeneği", "heading_path": [], "article_heading": "Geliştirme ödeneği", "source_span": {"char_start": 9952, "char_end": 10811}, "source_text": "Madde 14 – (Değişik: 3/4/1998 - 4359/15 md.)\nDiğer yükseköğretim kurumlarına göre sosyo-ekonomik açıdan daha az gelişmiş yerlerde öğretim yapan ve/veya yeterli sayıda öğretim elemanı sağlanamayan yükseköğretim kurumları ile bunların bölümlerinde görevli öğretim elemanlarına; almakta oldukları aylık gösterge ve ek gösterge toplamının 657 sayılı Devlet Memurları Kanunu uyarınca belirlenen aylık katsayı ile çarpımı sonucu bulunacak miktarın beş katına kadar geliştirme ödeneği ödenebilir.\nGeliştirme ödeneği verilecek yükseköğretim kurumları, ödeneğin verilmesine ilişkin usul ve esaslar ile oran veya miktarları, bu ödenekten yararlanma süresi ile yararlanamayacak olanlar ve diğer hususlar Cumhurbaşkanı Kararı ile tespit edilir.\nBu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.\n\nDevlet konservatuvarlarının öğretim elemanları:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 15", "article_type": "main", "title": "Devlet konservatuvarlarının öğretim elemanları", "heading_path": [], "article_heading": "Devlet konservatuvarlarının öğretim elemanları", "source_span": {"char_start": 10811, "char_end": 11283}, "source_text": "Madde 15 – (Değişik: 22/8/1989 - KHK - 378/8 md.)6\nYükseköğretim kurumlarının 657 sayılı Devlet Memurları Kanununun değişik ek geçici 16 ncı maddesinde unvanları belirtilen personeli, Yükseköğretim Kurulunun onayı ile sözleşmeli olarak istihdam edilebilir. Bu elemanların sözleşme esasları, bunlara ödenebilecek ücretin üst sınırları ve sağlanacak sosyal yardımlar ile diğer mali haklar; Cumhurbaşkanınca kararlaştırılır.\n\nYabancı öğretim elemanlarına ödenecek ücretler:6", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 16", "article_type": "main", "title": "Yabancı öğretim elemanlarına ödenecek ücretler:6", "heading_path": [], "article_heading": "Yabancı öğretim elemanlarına ödenecek ücretler:6", "source_span": {"char_start": 11283, "char_end": 11579}, "source_text": "Madde 16 – 2547 sayılı Yükseköğretim Kanununun 34 üncü maddesine göre sözleşmeli olarak çalıştırılacak yabancı uyruklu öğretim elemanlarına ödenecek ücret, Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulunca tespit edilir.\n\nEmekli öğretim elemanlarının sözleşmeli istihdamı:6", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 17", "article_type": "main", "title": "Emekli öğretim elemanlarının sözleşmeli istihdamı:6", "heading_path": [], "article_heading": "Emekli öğretim elemanlarının sözleşmeli istihdamı:6", "source_span": {"char_start": 11579, "char_end": 12004}, "source_text": "Madde 17 – Üniversiteler, ihtiyaç duydukları dallarda 5434 sayılı T. C. Emekli Sandığı veya 506 sayılı Sosyal Sigortalar Kanununa göre 65 yaşını doldurmak suretiyle emekli olmuş öğretim elemanlarını emekli aylıkları kesilmeksizin ve yaş kaydı aranmaksızın sözleşme ile çalıştırabilirler. Bu gibilere ödenecek ücret Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulu tarafından tespit edilir.\n\nGeçici görev:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 18", "article_type": "main", "title": "Geçici görev", "heading_path": [], "article_heading": "Geçici görev", "source_span": {"char_start": 12004, "char_end": 12325}, "source_text": "Madde 18 – Öğretim elemanları ile tabi oldukları özel kanunlarda mani hüküm bulunmayan diğer kamu görevlileri, rektörün görüşü veya ilgili kuruluşun muvafakatı ile yükseköğretim üst kuruluşlarında her seferinde altı ayı geçmemek üzere geçici olarak görevlendirilebilirler.\nDiğer kurum mensuplarını ilgilendiren hükümler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 19", "article_type": "main", "title": "Diğer kurum mensuplarını ilgilendiren hükümler", "heading_path": [], "article_heading": "Diğer kurum mensuplarını ilgilendiren hükümler", "source_span": {"char_start": 12325, "char_end": 12885}, "source_text": "Madde 19 – Bu Kanun hükümleri, 7163 sayılı Kanunla kurulan Türkiye ve Orta Doğu Amme İdaresi Enstitüsü kadrosunda çalışan profesörler, öğretim ve araştırma mütehassısları (doçentler gibi), öğretim görevlileri (…) ve asistanlar hakkında da uygulanır.\nBu Enstitüde görevli asistanlar hakkında araştırma görevlisi gibi işlem yapılır.\nBu Kanun hükümleri gereğince Yükseköğretim Kurulu, 2547 sayılı Yükseköğretim Kanunu gereğince de Üniversitelerarası Kurul tarafından alınan kararlar bu Enstitü mensuplarına da aynen uygulanır.\n\nUygulanacak diğer kanun hükümleri:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 20", "article_type": "main", "title": "Uygulanacak diğer kanun hükümleri", "heading_path": [], "article_heading": "Uygulanacak diğer kanun hükümleri", "source_span": {"char_start": 12885, "char_end": 13048}, "source_text": "Madde 20 – Bu Kanunda hüküm bulunmayan hallerde 2547 sayılı Yükseköğretim Kanunu ile 657 sayılı Devlet Memurları Kanunu hükümleri uygulanır.\n\nKaldırılan hükümler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 21", "article_type": "main", "title": "Kaldırılan hükümler", "heading_path": [], "article_heading": "Kaldırılan hükümler", "source_span": {"char_start": 13048, "char_end": 13224}, "source_text": "Madde 21 – 25/6/1973 tarih ve 1765 sayılı Üniversite Personel Kanunu ile bu Kanunda değişiklik yapan diğer kanun hükümleri yürürlükten kaldırılmıştır.\n\nEğitim Öğretim Ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 1", "article_type": "additional", "title": "Eğitim Öğretim Ödeneği", "heading_path": [], "article_heading": "Eğitim Öğretim Ödeneği", "source_span": {"char_start": 13224, "char_end": 13893}, "source_text": "Ek Madde 1 – (Ek: 24/11/1994 - 4048/4 md.; Değişik: 20/3/1997 - KHK-570/6 md.)\n4.11.1981 tarih ve 2547 sayılı Kanunun 33 üncü maddesi ve 39 uncu maddesinin ikinci fıkrası uyarınca yurtdışına gönderilenler ile anılan Kanunun 38 inci maddesine göre diğer kurum ve kuruluşlarda görevlendirilenlerden yüksek öğretim kurumlarındaki kadro görevini yapmayanlar hariç olmak üzere Yükseköğretim Kurumlarında görevli öğretim elemanlarına en yüksek Devlet memuru aylığı (ek gösterge dahil) brüt tutarının on ikide biri, her ay aylıklarla birlikte Eğitim Öğretim Ödeneği olarak ödenir. Bu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.\n\nMakam Tazminatı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 2", "article_type": "additional", "title": "Makam Tazminatı", "heading_path": [], "article_heading": "Makam Tazminatı", "source_span": {"char_start": 13893, "char_end": 14471}, "source_text": "Ek Madde 2 – (Ek: 20/3/1997 - KHK - 570/7 md.)\nBu Kanuna ekli Makam Tazminatı Cetvelinde yazılı kadro ve görev unvanlarına atananlara hizalarında belirtilen gösterge rakamlarının memur aylıklarına uygulanan katsayı ile çarpımı sonucu bulunan miktarda Makam Tazminatı ödenir. Makam Tazminatı damga vergisi hariç herhangi bir vergiye tabi tutulmaz. Makam tazminatının hakedilmesinde ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu tazminattan yararlananlara ayrıca diğer kanunlarda belirtilen Yüksek Hakimlik Tazminatı ve Makam Tazminatı ödenmez.\nYükseköğretim tazminatı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "article_type": "additional", "title": "Yükseköğretim tazminatı", "heading_path": [], "article_heading": "Yükseköğretim tazminatı", "source_span": {"char_start": 14471, "char_end": 15338}, "source_text": "Ek Madde 3 – (Ek: 5/11/2014-6564/1 md.)\nDevlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;\na) Profesör kadrosunda bulunanlara %100’ü,\nb) Doçent kadrosunda bulunanlara %100’ü,\nc) Doktor Öğretim Üyesi kadrosunda bulunanlara %100’ü,\nd) Araştırma Görevlisi kadrosunda bulunanlara %115’i,\ne) Öğretim Görevlisi (…)10 kadrosunda bulunanlara %115’i,\nf) (Mülga: 22/2/2018-7100/15 md.)\noranında her ay yükseköğretim tazminatı ödenir.\nBu tazminata hak kazanılmasında ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu maddeye göre ödenecek tazminat, damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve ilgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.\n\nAkademik teşvik ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "article_type": "additional", "title": "Akademik teşvik ödeneği", "heading_path": [], "article_heading": "Akademik teşvik ödeneği", "source_span": {"char_start": 15338, "char_end": 17523}, "source_text": "Ek Madde 4 – (Ek: 5/11/2014-6564/2 md.)\nHer bir takvim yılı için, bir önceki yıl, bilim, teknoloji ve sanata katkı sağlayıcı nitelikte yurt içinde veya yurt dışında sonuçlandırılan proje, araştırma, yayın, tasarım, sergi, patent ile çalışmalarına yapılan atıflar, bilim kurulu bulunan uluslararası düzeydeki toplantılarda tebliğ sunma ve almış olduğu akademik ödüller esas alınarak öğretim elemanları için yüz puan üzerinden yıllık akademik teşvik puanı hesaplanır.\nAkademik teşvik puanı otuz ve üzerinde olanlara, Devlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;\na) Profesör kadrosunda bulunanlar için %100’üne,\nb) Doçent kadrosunda bulunanlar için %90’ına,\nc) Doktor Öğretim Üyesi kadrosunda bulunanlar için %80’ine,\nd) Araştırma Görevlisi kadrosunda bulunanlar için %70’ine,\ne) Öğretim Görevlisi (…)12 kadrosunda bulunanlar için %70’ine,\nf) (Mülga: 22/2/2018-7100/15 md.)\naldıkları akademik teşvik puanının yüze bölünmesi suretiyle bulunacak oranın uygulanması suretiyle hesaplanan tutarda akademik teşvik ödeneği verilir.\nBu madde uyarınca yapılacak ödeme; bu Kanun uyarınca aylık ödendiği sürece ve kadrolarının bulunduğu yükseköğretim kurumları tarafından şubat ayının on beşinden itibaren on iki ay süreyle her ayın on beşinde yapılır, damga vergisi hariç herhangi bir vergiye tabi tutulmaz. İlgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.\nBilim alanlarının özellikleri ve öğretim elemanlarının unvanlarına göre akademik teşvik puanlarının hesaplanmasında esas alınacak faaliyetlerin ayrıntılı özellikleri ve bu faaliyetlerin puan karşılıkları, akademik teşvik toplam puanının %30’unu geçmemek üzere her bir akademik faaliyet türünün toplam puanın hesaplanmasındaki ağırlıkları, akademik teşvik puanının hesaplanmasına ilişkin usul ve esaslar ile bu hesaplamaları yapacak komisyonun oluşumu ile diğer hususlar Cumhurbaşkanı tarafından yürürlüğe konulan yönetmelikle belirlenir.\nBu madde hükümleri, Türk Silahlı Kuvvetleri kadrolarında bulunan öğretim elemanları hakkında da uygulanır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 1", "article_type": "temporary", "title": "f) (Mülga: 22/2/2018-7100/15 md.)", "heading_path": [], "article_heading": "f) (Mülga: 22/2/2018-7100/15 md.)", "source_span": {"char_start": 17523, "char_end": 17833}, "source_text": "Geçici Madde 1 – 657 sayılı Devlet Memurları Kanununa tabi öğretmenlerden 28/3/1993 tarih ve 2809 sayılı Kanunun geçici 3 üncü maddesi ile aynı Kanun kapsamına alınanlardan yükseköğrenim kurumlarında istihdamına ihtiyaç duyulanların bu Kanun hükümlerine göre intibakları, 30/6/1984 tarihi itibariyle yapılır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 2", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 17833, "char_end": 18289}, "source_text": "Geçici Madde 2 – Öğretim elemanlarına ve geçici 1 inci madde kapsamına girenler bu Kanunun 12 inci maddesi uyarınca ödenecek Üniversite Ödeneğinin, 1765 sayılı Üniversite Personel Kanununun değişik 16 ncı maddesi uyarınca halen ödenmekte olan iş güçlüğü, iş riski, temininde güçlük zammı ile tamgün ödeneği tutarından az olması halinde aradaki net fark, üniversite ödeneği bu miktara ulaşıncaya kadar, hiçbir vergi ve kesintiye tabi tutulmaksızın ödenir.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 3", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 18289, "char_end": 18465}, "source_text": "Geçici Madde 3 – Öğretim elemanlarına bu Kanunun 5 inci maddesine göre verilecek ek göstergeleri, 31/12/1983 tarihinde yararlanmakta oldukları ek göstergelerden düşük olamaz.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 4", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 18465, "char_end": 19252}, "source_text": "Geçici Madde 4 – 1/1/1984 tarihinde yükseköğretim kurumlarında görev yapmakta olanlar ile bu kurumların kadroları ile ilişkileri devam eden, askerlik görevlerini yapmakta olan ve bu Kanun kapsamına giren öğretim elemanlarının intibakları, 657 sayılı Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre (657 sayılı Kanunun değişik 36 ncı maddesinin \"Ortak Hükümleri\" ile getirilen kademe ilerlemesi ve derece yükselmesi hariç) başlayabilecekleri derece ve kademe esas alınmak suretiyle bu Kanun ve Devlet Memurları Kanununa göre rektörlüklerce (Geçici 1 inci madde kapsamına girenler hariç) üç ay içinde yapılır.\nİntibak sonucunda kazanılmış hak aylık dereceleri kadro derecelerinin üzerinde olanlara, kazanılmış hak aylıkları esas alınarak ödemede bulunulur.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 5", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 19252, "char_end": 19460}, "source_text": "Geçici Madde 5 – Geçici 4 üncü madde hükmü saklı kalmak üzere bu Kanunun yürürlüğe girdiği tarihten önce doçent kadrosuna atanmış bulunanların görev aylıkları, bir üst derecenin aynı kademesine yükseltilir.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 6", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 19460, "char_end": 20547}, "source_text": "Geçici Madde 6 – 6/11/1981 tarihinde Boğaziçi Üniversitesi ile Orta Doğu Teknik Üniversitesinde 657 sayılı Devlet Memurları Kanunu hükümlerine tabi olmadan çalışan öğretim elemanları dışında kalan personelden 657 sayılı Kanuna göre intibaklarının yapılmasını istemeyerek, 1/1/1984 tarihinden itibaren 30 gün içinde müracaat edenlere, kıdem tazminatları ödenir ve kurumları ile ilişkileri kesilir.\nBunlara ödenecek kıdem tazminatı, görevden ayrıldıkları tarihteki kazanılmış hakları dikkate alınarak hesaplanır. Ancak, bu şekilde hesaplanacak kıdem tazminatının miktarı 30/9/1982 tarihinde hak kazanabilecekleri kıdem tazminatından fazla olamaz.\n2547 sayılı Yükseköğretim Kanununun yürürlüğe girdiği 6/11/1981 tarihi ile bu Kanunun yürürlüğe girdiği tarih arasında görevden ayrılanlar hakkında da, görevden ayrıldıkları tarih dikkate alınarak yukarıdaki hükümler uygulanır.\n30/9/1982 tarihinden sonra görevden ayrılanların bu tarih ile görevden ayrıldıkları tarih arasında geçen hizmetleri, primlerinin ödenmesi kaydıyla 506 sayılı Sosyal Sigortalar Kanununa tabi olarak geçmiş sayılır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 7", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 20547, "char_end": 20897}, "source_text": "Geçici Madde 7 – 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununun 24/9/1982 tarih ve 2708 sayılı Kanun ile değişik geçici 23 üncü maddesinde belirtilen ve sözleşmeli olarak çalıştırılan öğretim elemanları ile idari personel 30/9/1984 tarihine kadar sahip oldukları statü içinde çalıştırılırlar. Bu tarihten sonra genel hükümlere tabi olurlar.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "article_type": "temporary", "title": "", "heading_path": [], "article_heading": "", "source_span": {"char_start": 20897, "char_end": 21963}, "source_text": "Geçici Madde 8 – İlgili kanunda gerekli değişiklik yapılıncaya kadar, Yükseköğretim Kurulu üyeleri ile Yükseköğretim Denetleme Kurulu üyeleri, 657 sayılı Devlet Memurları Kanununun 187 - 213 üncü maddeleri ile düzenlenen sosyal haklardan yararlanırlar.\nAncak, bu üyelerden T. C. Emekli Sandığı ile Sosyal Sigortalar Kurumundan emekli olanlar bu kuruluşlarca aynı sosyal haklardan ayrıca yararlandırılmazlar.\n(Ek: 26/6/1984 - KHK - 241/32 md.; Değişik: 24/11/1994 - 4048/5 md.)\nT. C. Emekli Sandığı iştirakçisi olan Yükseköğretim Kurulu Başkanı, Yükseköğretim Yürütme Kurulu Üyeleri ile Yükseköğretim Denetleme Kurulu üyelerinin emekli keseneklerinin hesabında aşağıdaki ek göstergeler esas alınır. Emekli İken Yükseköğretim Yürütme Kurulu veya Yükseköğretim Denetleme Kurulu Üyeliklerine geçirilenlerin emekli aylıklarının ödenmesinde de aynı göstergeler esas alınır.\n\n(Değişik:1/7/2022-7417/10 md.)\n|Unvanı |Derece |Ek Göstergeler |\n|Yükseköğretim Kurulu Başkanı |1 |8000 |\n|Yükseköğretim Kurulu Üyeleri |1 |7800 |\n|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 9", "article_type": "temporary", "title": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "heading_path": [], "article_heading": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "source_span": {"char_start": 21963, "char_end": 22519}, "source_text": "Geçici Madde 9 – (Ek: 14/1/1988 - KHK - 311/8 md.)\n2547 sayılı Yükseköğretim Kanunun yürürlüğe girmesinden önce Profesörlük unvanını almış olup da 78 sayılı Kanun Hükmünde Kararname ile ihdas edilen profesörlük kadrolarına atanamamış olanlar, bu Kanunun 5 inci maddesinde profesör kadrosunda bulunanlar için öngörülen ek göstergeler ile 241 sayılı Kanun Hükmünde Kararname'nin değişik 39 uncu maddesine göre profesör kadrosunda üç yılı tamamlamış olanlar için öngörülen makam tazminatından profesör kadrosuna atanma şartı aranmaksızın yararlandırılırlar.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 10", "article_type": "temporary", "title": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "heading_path": [], "article_heading": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "source_span": {"char_start": 22519, "char_end": 22815}, "source_text": "Geçici Madde 10 – (Ek: 5/11/2014-6564/3 md.)\nEk 4 üncü maddede belirtilen yönetmelik dört ay içinde yürürlüğe konur. Ek 4 üncü maddenin birinci fıkrasına göre ilk defa akademik teşvik puanı hesaplanması, 2015 yılında yapılan faaliyetler esas alınmak suretiyle 2016 yılı için yapılır.\n\nYürürlük:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 22", "article_type": "main", "title": "Bu Kanunun", "heading_path": [], "article_heading": "Bu Kanunun", "source_span": {"char_start": 22815, "char_end": 23144}, "source_text": "Madde 22 – Bu Kanunun;\na) Geçici 7 nci maddesi hükümleri; 30/9/1983 tarihinden geçerli olmak üzere yayımı tarihinde,\nb) Geçici 8 inci maddesi ile atıfta bulunulan 657 sayılı Devlet Memurları Kanununun 208- 210 uncu maddelerine ilişkin hükümleri yayımı tarihinde,\nc) Diğer hükümleri 1/1/1984 tarihinde,\nYürürlüğe girer.\n\nYürütme:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 23", "article_type": "main", "title": "Yürütme", "heading_path": [], "article_heading": "Yürütme", "source_span": {"char_start": 23144, "char_end": 23201}, "source_text": "Madde 23 – Bu Kanun hükümlerini Bakanlar Kurulu yürütür.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}

data/structural/2914_clauses.jsonl

@@ -0,0 +1,76 @@
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 1", "clause_id": "madde_1__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 499, "document_char_start": 192, "document_char_end": 691}, "source_text": "Madde 1 – Bu Kanunun amacı, 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununda yer alan öğretim elemanları tanımına giren personeli sınıflandırmak, aylıklarını ve ek göstergelerini düzenlemek, derece yükseltilmesi ve kademe ilerlemesinin şekil ve şartları ile, sosyal haklardan yararlanma, ek ders ücreti, üniversite, idari görev ve geliştirme ödeneklerinin miktarını tespit etmek, emekli ve yabancı öğretim elemanlarının sözleşmeli olarak çalıştırılma usul ve esaslarını belirlemektir.\n\nKapsam:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Amaç"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 2", "clause_id": "madde_2__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 198, "document_char_start": 692, "document_char_end": 890}, "source_text": "Madde 2 – Bu Kanun 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununa tabi üniversite öğretim elamanlarının aylık, ödenek ve sair özlük haklarını kapsar.\n\nÖğretim elemanlarının sınıflandırılması:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Kapsam"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 139, "document_char_start": 891, "document_char_end": 1030}, "source_text": "Madde 3 – (Değişik: 22/2/2018-7100/13 md.)\nBu Kanuna tabi öğretim elemanlarının sınıfları ile başlangıç dereceleri aşağıda gösterilmiştir.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__002_a", "label": "A", "source_span": {"article_char_start": 139, "article_char_end": 237, "document_char_start": 1030, "document_char_end": 1128}, "source_text": "A) Öğretim üyeleri sınıfı:\nBu sınıf; profesörler, doçentler ve doktor öğretim üyelerinden oluşur.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__003_a", "label": "a", "source_span": {"article_char_start": 237, "article_char_end": 338, "document_char_start": 1128, "document_char_end": 1229}, "source_text": "a) Profesörler, profesör kadrosuna atandıkları tarihi izleyen aybaşından itibaren birinci derecenin,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__004_b", "label": "b", "source_span": {"article_char_start": 338, "article_char_end": 434, "document_char_start": 1229, "document_char_end": 1325}, "source_text": "b) Doçentler, doçent kadrosuna atandıkları tarihi izleyen aybaşından itibaren üçüncü derecenin,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__005_c", "label": "c", "source_span": {"article_char_start": 434, "article_char_end": 604, "document_char_start": 1325, "document_char_end": 1495}, "source_text": "c) Doktor öğretim üyeleri, doktor öğretim üyesi kadrosuna atandıkları tarihi izleyen aybaşından itibaren beşinci derecenin,\nilk kademe aylığını alırlar.\nYukarıdaki (a), (", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__006_b", "label": "b", "source_span": {"article_char_start": 604, "article_char_end": 611, "document_char_start": 1495, "document_char_end": 1502}, "source_text": "b) ve (", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__007_c", "label": "c", "source_span": {"article_char_start": 611, "article_char_end": 773, "document_char_start": 1502, "document_char_end": 1664}, "source_text": "c) bentlerine göre üst dereceye atananlar, bu dereceleri kazanılmış hak olarak aldıktan sonra geçirecekleri her yıl için bir kademe ilerlemesinden yararlanırlar.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__008_b", "label": "B", "source_span": {"article_char_start": 773, "article_char_end": 846, "document_char_start": 1664, "document_char_end": 1737}, "source_text": "B) Öğretim görevlileri sınıfı:\nBu sınıf, öğretim görevlilerinden oluşur.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 3", "clause_id": "madde_3__009_c", "label": "C", "source_span": {"article_char_start": 846, "article_char_end": 1371, "document_char_start": 1737, "document_char_end": 2262}, "source_text": "C) Araştırma görevlileri sınıfı:\nBu sınıf, araştırma görevlilerinden oluşur.\nÖğretim görevlileri ve araştırma görevlilerinin giriş dereceleri (657 sayılı Devlet Memurları Kanununun değişik 36 ncı maddesinin “Ortak Hükümler”i ile getirilen kademe ilerlemesi ve derece yükselmesine ilişkin hükümleri hariç) Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre tespit edilecek kazanılmış hak aylık derece ve kademelerine iki derece eklenmek suretiyle belirlenir.\n\nÖğretim elemanlarının görev aylıkları:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının sınıflandırılması"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 4", "clause_id": "madde_4__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 253, "document_char_start": 2263, "document_char_end": 2516}, "source_text": "Madde 4 – Öğretim elemanlarının bu Kanunun 3 üncü maddesine göre tespit edilen görev aylıkları kazanılmış hak teşkil etmeyip, aylık ödemelerine esas tutulur ve bu Kanun kapsamından çıkmaları halinde dikkate alınmaz.\nÖğretim üyelerinden 3 üncü maddenin (", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının görev aylıkları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 4", "clause_id": "madde_4__002_a", "label": "A", "source_span": {"article_char_start": 253, "article_char_end": 823, "document_char_start": 2516, "document_char_end": 3086}, "source_text": "A) bendinde gösterilen kadrolara atandıkları tarihte kazanılmış hak aylık dereceleri; unvanları için öngörülen giriş derecelerinin üzerinde olanlar ile, bu kadrolara derece yükselmesi suretiyle ulaşanlar hakkında 657 sayılı Devlet Memurları Kanununun değişik 161 inci maddesi uygulanır ve kazanılmış hak aylıkları başlangıç derecelerinin ileri kademelerine gelenlerin aylıkları, bu kademeler üzerinden ödenir. Bunların başarılı geçen hizmet süreleri, kazanılmış hak derecelerinde kademe ilerlemesi yapılmak suretiyle değerlendirilir.\n\nGösterge tablosu ve ek göstergeler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanlarının görev aylıkları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 5", "clause_id": "madde_5__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 582, "document_char_start": 3087, "document_char_end": 3669}, "source_text": "Madde 5 – Üniversite öğretim elamanlarının aylıklarının hesaplanmasında, Devlet memurlarının aylıklarına esas olan gösterge tablosu ve katsayı dikkate alınır.\n(Değişik: 9/4/1990- KHK -418/28 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; yeniden düzenleme: 18/5/1994-KHK/527/20 md.) Aylıkların hesabında ayrıca, bu Kanuna ekli ek gösterge cetvelinde unvan ve derecelere göre belirlenen ek gösterge rakamları dikkate alınır.\n(Üçüncü fıkra mülga: 9/4/1990 - KHK - 418/28 md.)\n\nDoktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Gösterge tablosu ve ek göstergeler"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 6", "clause_id": "madde_6__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 347, "document_char_start": 3670, "document_char_end": 4017}, "source_text": "Madde 6 – Yükseköğrenimi tamamladıktan sonra, hizmete girmeden önce veya hizmet sırasında yüksek lisans veya yükseköğrenim üstü uzmanlık öğrenimi görenlere, bir kademe ilerlemesi; tıpta uzmanlık belgesi alanlara veya doktora yapanlara ve doçentlik unvanını alarak doçent kadrosuna atananlara bir derece yükselmesi uygulanır.\n\nDerece yükseltilmesi:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Doktora veya tıpta uzmanlık öğrenimi, doçent kadrosuna atanma"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 7", "clause_id": "madde_7__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 30, "document_char_start": 4018, "document_char_end": 4048}, "source_text": "Madde 7 – Öğretim elemanları;", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 7", "clause_id": "madde_7__002_a", "label": "a", "source_span": {"article_char_start": 30, "article_char_end": 102, "document_char_start": 4048, "document_char_end": 4120}, "source_text": "a) Yükselebilecekleri derecede aynı unvanla boş bir kadronun bulunması,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 7", "clause_id": "madde_7__003_b", "label": "b", "source_span": {"article_char_start": 102, "article_char_end": 213, "document_char_start": 4120, "document_char_end": 4231}, "source_text": "b) Derecesi içinde en az üç yıl bulunmuş ve bu derecenin üçüncü kademe aylığını bir yıl fiilen almış olmaları,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 7", "clause_id": "madde_7__004_c", "label": "c", "source_span": {"article_char_start": 213, "article_char_end": 328, "document_char_start": 4231, "document_char_end": 4346}, "source_text": "c) Bu süre içinde olumlu sicil almış bulunmaları,\nŞartıyla bir üst dereceye yükseltilebilirler.\n\nKademe ilerlemesi:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Öğretim elemanları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 8", "clause_id": "madde_8__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 342, "document_char_start": 4347, "document_char_end": 4689}, "source_text": "Madde 8 – Öğretim elemanlarının kademe ilerlemesi, bulundukları kademede en az bir yıl çalışmış ve olumlu sicil almış olmalarına ve aynı derecede ilerlenebilecek bir kademenin bulunmasına bağlıdır.\nKademe ilerlemesi, ilgililerin hak kazandıkları tarihten geçerli olmak üzere yapılır.\n\nDerece yükseltilmesi ve kademe ilerlemesinde onay makamı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Kademe ilerlemesi"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 9", "clause_id": "madde_9__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 116, "document_char_start": 4690, "document_char_end": 4806}, "source_text": "Madde 9 – Derece yükseltilmesi ve kademe ilerlemesi, üniversite rektörünün onayı ile yapılır.\n\nHaklardan yararlanma:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Derece yükseltilmesi ve kademe ilerlemesinde onay makamı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 10", "clause_id": "madde_10__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 166, "document_char_start": 4807, "document_char_end": 4973}, "source_text": "Madde 10 – Öğretim elamanları, 657 sayılı Devlet Memurları Kanununun 187- 213 üncü maddeleri ile düzenlenen sosyal hak ve yardımlardan faydalanırlar.\n\nEk ders ücreti:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Haklardan yararlanma"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 11", "clause_id": "madde_11__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 3011, "document_char_start": 4974, "document_char_end": 7985}, "source_text": "Madde 11 – (Değişik: 27/6/1989 - KHK - 375/17 md.)\n(Değişik birinci fıkra: 26/6/2001 - 4689/4 md.) 2547 Sayılı Yükseköğretim Kanununun 36 ncı maddesine göre haftalık okutulması mecburi ders yükü saati dışında, kısmi statüde bulunanlar dahil öğretim elamanlarına görev unvanlarına göre Maliye Bakanlığının görüşü üzerine Yükseköğretim Kurulu tarafından belirlenen mecburi ve isteğe bağlı dersler ve diğer faaliyetler için bu ders ve faaliyetlerin haftalık ders programında yer alması ve fiilen yapılması şartıyla en çok yirmi saate kadar, ikinci öğretimde ise en çok on saate kadar ek ders ücreti ödenir. Ders yüklerinin tamamlanmasında öncelikle normal örgün öğretimde verilen ders ve faaliyetler dikkate alınır.\n(Değişik: 26/6/2001 - 4689/4 md.) Öğretim elemanlarının teorik derslerle yaptırdıkları uygulama, yönettikleri tez, seminer ve doktora çalışmalarının ve ara sınavların ne ölçüde ders yükünden sayılacağı Yükseköğretim Kurulunca belirlenir. Ara sınavlar için Yükseköğretim Kurulunca öğrenci sayısı gözönünde bulundurulmak suretiyle tespit edilecek ders yükü beş saati, diğer faaliyetler için belirlenecek ders yükü ise bir saati geçemez. Teorik dersler dışındaki faaliyetlerin ders yükünün tamamlanmasından sonraki kısmı ek ders ücretinin hesabında dikkate alınır. Ancak mecburi ders yükünün tamamlanmasında ve ek ders ücretinin hesabında, teorik dersler dışındaki faaliyetlerin haftalık en fazla on saatlik kısmı dikkate alınır, kalan kısmı ise maaş karşılığı sayılır.\n(Değişik: 9/4/1990 - KHK - 418/29 md.; İptal: Anayasa Mahkemesinin 5/2/1992 tarihli ve E.1990/22, K.1992/6 Sayılı Kararı ile; Yeniden düzenleme: 18/5/1994-KHK/527/21 md.) Dersi veren öğretim elemanına her ders için ayrı ayrı olmak üzere yarı yıl ve yıl sonu dönemlerinde her 50 öğrenci için 300 gösterge rakamının Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımı sonucu bulunacak tutarda sınav ücreti ödenir. Öğrenci sayısının hesabında küsurlar tama iblağ edilir ve 500 öğrenciden fazlası dikkate alınmaz. Ara sınavlar ve bütünleme sınavları için sınav ücreti ödenmez.\nEk ders ücreti, aşağıdaki göstergelerin Devlet Memurları Kanununa göre aylıklar için belirlenen katsayı ile çarpımından oluşur.\n\n|Unvanı |Ek Ders Ücreti Göstergesi |\n|Profesör |300 |\n|Doçent |250 |\n|Doktor Öğretim Üyesi |200 |\n|Öğretim Görevlisi (…)4 |160 |\n\n(Beşinci fıkra mülga: 9/4/1990 - KHK - 418/29 md.)\nYükseköğretim Kurumlarının kadrolarında olmayıp bu unvanları taşıyanlardan ders saati başına görevlendirilenlerin sosyal güvenlik kuruluşlarından almakta oldukları aylıklar bu şekilde görevlendirilmeleri nedeniyle kesilmez.\nMüfredat programları uyarınca normal çalışma günlerinde çalışma saatinin bitiminden ve saat 17.00'den sonra başlayan gece öğretimi ile hafta tatili, yarı yıl veya yaz tatillerinde yapılan öğretimde yukarıdaki şekilde hesaplanan ek ders ücretleri % 60 zamlı ödenir. Yaz ve yarı yıl tatillerinde yapılan öğretim için verilecek ek ders ücretinin hesabında ders yükü dikkate alınmaz.\n\nÜniversite Ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Ek ders ücreti"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 576, "document_char_start": 7986, "document_char_end": 8562}, "source_text": "Madde 12 – (Değişik: 20/3/1997 - KHK - 570/4 md.)\n657 sayılı Devlet Memurları Kanununa tabi en yüksek Devlet memuru bürüt aylık (ek gösterge dahil) tutarının;\n\n|1) |Profesörlerden Rektör, Rektör Yardımcısı, Dekan, | |\n| |Dekan Yardımcısı, Yüksekokul Müdürü olanlar ile | |\n| |Profesör kadrosunda üç yılını tamamlamış bulunanlara |% 245'i, |\n|2) |Diğer Profesör kadrosunda bulunanlara |% 215'i, |\n|3) |Doçent kadrosunda bulunanlara |% 175'i, |\n|4) |(Değişik: 22/2/2018-7100/14 md.) Doktor öğretim üyesi kadrosunda bulunanlara |% 175 |\n|5); |Diğer Öğretim elemanlarından | |\n| |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__002_a", "label": "a", "source_span": {"article_char_start": 576, "article_char_end": 627, "document_char_start": 8562, "document_char_end": 8613}, "source_text": "a) Birinci dereceden aylık alanlara |% 130'u, |\n| |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__003_b", "label": "b", "source_span": {"article_char_start": 627, "article_char_end": 678, "document_char_start": 8613, "document_char_end": 8664}, "source_text": "b) İkinci dereceden aylık alanlara |% 117'si, |\n| |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__004_c", "label": "c", "source_span": {"article_char_start": 678, "article_char_end": 728, "document_char_start": 8664, "document_char_end": 8714}, "source_text": "c) Üçüncü dereceden aylık alanlara |% 110'u, |\n| |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__005_d", "label": "d", "source_span": {"article_char_start": 728, "article_char_end": 791, "document_char_start": 8714, "document_char_end": 8777}, "source_text": "d) Dördüncü ve beşinci dereceden aylık alanlara |% 104'ü, |\n| |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 12", "clause_id": "madde_12__006_e", "label": "e", "source_span": {"article_char_start": 791, "article_char_end": 1012, "document_char_start": 8777, "document_char_end": 8998}, "source_text": "e) Diğer derecelerden aylık alanlara |% 98'i, |\n|Her ay üniversite ödeneği olarak ödenir. |\n\nBu ödenek damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve kısmi statüde görev yapanlara ödenmez.\n\nİdari görev ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Üniversite Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 13", "clause_id": "madde_13__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 894, "document_char_start": 8999, "document_char_end": 9893}, "source_text": "Madde 13 – (Değişik birinci fıkra: 20/3/1997 - KHK - 570/5 md.) Almakta oldukları aylık gösterge ve ek gösterge brüt tutarının; Rektörlere %70'i, Rektör Yardımcıları ve Dekanlara %30'u, Dekan Yardımcıları, Enstitü ve Yüksekokul Müdürleri, Konservatuar Müdürleri ile Bölüm Başkanlarına %20'si, Enstitü, Yüksekokul ve Konservatuar Müdür Yardımcılarına %15 'i idari görev ödeneği olarak ayrıca ödenir. Birden fazla idari görevi bulunanlara İdari Görev Ödeneğinden en yüksek olanı verilir.\nBu Kanuna tabi olmayan kişiler arasından tayin olunan rektörlere, 657 sayılı Devlet Memurları Kanununa göre birinci derece memur son kademe aylığı (en yüksek ek gösterge dahil) ile bunun bir katı tutarında ek ödemede bulunulur. Bu Kanunun 10 uncu maddesi hükümleri, bunlar hakkında da uygulanır. Bunlardan emekli iken atananların emekli aylıklarının ödenmesine devam olunur, diğerleri genel hükümlere göre T.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "İdari görev ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 13", "clause_id": "madde_13__002_c", "label": "C", "source_span": {"article_char_start": 894, "article_char_end": 952, "document_char_start": 9893, "document_char_end": 9951}, "source_text": "C. Emekli Sandığı ile ilgilendirilir.\n\nGeliştirme ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "İdari görev ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 14", "clause_id": "madde_14__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 858, "document_char_start": 9952, "document_char_end": 10810}, "source_text": "Madde 14 – (Değişik: 3/4/1998 - 4359/15 md.)\nDiğer yükseköğretim kurumlarına göre sosyo-ekonomik açıdan daha az gelişmiş yerlerde öğretim yapan ve/veya yeterli sayıda öğretim elemanı sağlanamayan yükseköğretim kurumları ile bunların bölümlerinde görevli öğretim elemanlarına; almakta oldukları aylık gösterge ve ek gösterge toplamının 657 sayılı Devlet Memurları Kanunu uyarınca belirlenen aylık katsayı ile çarpımı sonucu bulunacak miktarın beş katına kadar geliştirme ödeneği ödenebilir.\nGeliştirme ödeneği verilecek yükseköğretim kurumları, ödeneğin verilmesine ilişkin usul ve esaslar ile oran veya miktarları, bu ödenekten yararlanma süresi ile yararlanamayacak olanlar ve diğer hususlar Cumhurbaşkanı Kararı ile tespit edilir.\nBu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.\n\nDevlet konservatuvarlarının öğretim elemanları:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Geliştirme ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 15", "clause_id": "madde_15__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 471, "document_char_start": 10811, "document_char_end": 11282}, "source_text": "Madde 15 – (Değişik: 22/8/1989 - KHK - 378/8 md.)6\nYükseköğretim kurumlarının 657 sayılı Devlet Memurları Kanununun değişik ek geçici 16 ncı maddesinde unvanları belirtilen personeli, Yükseköğretim Kurulunun onayı ile sözleşmeli olarak istihdam edilebilir. Bu elemanların sözleşme esasları, bunlara ödenebilecek ücretin üst sınırları ve sağlanacak sosyal yardımlar ile diğer mali haklar; Cumhurbaşkanınca kararlaştırılır.\n\nYabancı öğretim elemanlarına ödenecek ücretler:6", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Devlet konservatuvarlarının öğretim elemanları"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 16", "clause_id": "madde_16__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 295, "document_char_start": 11283, "document_char_end": 11578}, "source_text": "Madde 16 – 2547 sayılı Yükseköğretim Kanununun 34 üncü maddesine göre sözleşmeli olarak çalıştırılacak yabancı uyruklu öğretim elemanlarına ödenecek ücret, Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulunca tespit edilir.\n\nEmekli öğretim elemanlarının sözleşmeli istihdamı:6", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yabancı öğretim elemanlarına ödenecek ücretler:6"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 17", "clause_id": "madde_17__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 66, "document_char_start": 11579, "document_char_end": 11645}, "source_text": "Madde 17 – Üniversiteler, ihtiyaç duydukları dallarda 5434 sayılı", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Emekli öğretim elemanlarının sözleşmeli istihdamı:6"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 17", "clause_id": "madde_17__002_t", "label": "T", "source_span": {"article_char_start": 66, "article_char_end": 69, "document_char_start": 11645, "document_char_end": 11648}, "source_text": "T.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Emekli öğretim elemanlarının sözleşmeli istihdamı:6"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 17", "clause_id": "madde_17__003_c", "label": "C", "source_span": {"article_char_start": 69, "article_char_end": 424, "document_char_start": 11648, "document_char_end": 12003}, "source_text": "C. Emekli Sandığı veya 506 sayılı Sosyal Sigortalar Kanununa göre 65 yaşını doldurmak suretiyle emekli olmuş öğretim elemanlarını emekli aylıkları kesilmeksizin ve yaş kaydı aranmaksızın sözleşme ile çalıştırabilirler. Bu gibilere ödenecek ücret Cumhurbaşkanınca belirlenecek esaslar dahilinde Yükseköğretim Kurulu tarafından tespit edilir.\n\nGeçici görev:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Emekli öğretim elemanlarının sözleşmeli istihdamı:6"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 18", "clause_id": "madde_18__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 320, "document_char_start": 12004, "document_char_end": 12324}, "source_text": "Madde 18 – Öğretim elemanları ile tabi oldukları özel kanunlarda mani hüküm bulunmayan diğer kamu görevlileri, rektörün görüşü veya ilgili kuruluşun muvafakatı ile yükseköğretim üst kuruluşlarında her seferinde altı ayı geçmemek üzere geçici olarak görevlendirilebilirler.\nDiğer kurum mensuplarını ilgilendiren hükümler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Geçici görev"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 19", "clause_id": "madde_19__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 559, "document_char_start": 12325, "document_char_end": 12884}, "source_text": "Madde 19 – Bu Kanun hükümleri, 7163 sayılı Kanunla kurulan Türkiye ve Orta Doğu Amme İdaresi Enstitüsü kadrosunda çalışan profesörler, öğretim ve araştırma mütehassısları (doçentler gibi), öğretim görevlileri (…) ve asistanlar hakkında da uygulanır.\nBu Enstitüde görevli asistanlar hakkında araştırma görevlisi gibi işlem yapılır.\nBu Kanun hükümleri gereğince Yükseköğretim Kurulu, 2547 sayılı Yükseköğretim Kanunu gereğince de Üniversitelerarası Kurul tarafından alınan kararlar bu Enstitü mensuplarına da aynen uygulanır.\n\nUygulanacak diğer kanun hükümleri:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Diğer kurum mensuplarını ilgilendiren hükümler"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 20", "clause_id": "madde_20__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 162, "document_char_start": 12885, "document_char_end": 13047}, "source_text": "Madde 20 – Bu Kanunda hüküm bulunmayan hallerde 2547 sayılı Yükseköğretim Kanunu ile 657 sayılı Devlet Memurları Kanunu hükümleri uygulanır.\n\nKaldırılan hükümler:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Uygulanacak diğer kanun hükümleri"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 21", "clause_id": "madde_21__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 175, "document_char_start": 13048, "document_char_end": 13223}, "source_text": "Madde 21 – 25/6/1973 tarih ve 1765 sayılı Üniversite Personel Kanunu ile bu Kanunda değişiklik yapan diğer kanun hükümleri yürürlükten kaldırılmıştır.\n\nEğitim Öğretim Ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Kaldırılan hükümler"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 1", "clause_id": "ek_madde_1__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 668, "document_char_start": 13224, "document_char_end": 13892}, "source_text": "Ek Madde 1 – (Ek: 24/11/1994 - 4048/4 md.; Değişik: 20/3/1997 - KHK-570/6 md.)\n4.11.1981 tarih ve 2547 sayılı Kanunun 33 üncü maddesi ve 39 uncu maddesinin ikinci fıkrası uyarınca yurtdışına gönderilenler ile anılan Kanunun 38 inci maddesine göre diğer kurum ve kuruluşlarda görevlendirilenlerden yüksek öğretim kurumlarındaki kadro görevini yapmayanlar hariç olmak üzere Yükseköğretim Kurumlarında görevli öğretim elemanlarına en yüksek Devlet memuru aylığı (ek gösterge dahil) brüt tutarının on ikide biri, her ay aylıklarla birlikte Eğitim Öğretim Ödeneği olarak ödenir. Bu ödenek damga vergisi hariç herhangi bir vergi ve kesintiye tabi tutulmaz.\n\nMakam Tazminatı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Eğitim Öğretim Ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 2", "clause_id": "ek_madde_2__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 577, "document_char_start": 13893, "document_char_end": 14470}, "source_text": "Ek Madde 2 – (Ek: 20/3/1997 - KHK - 570/7 md.)\nBu Kanuna ekli Makam Tazminatı Cetvelinde yazılı kadro ve görev unvanlarına atananlara hizalarında belirtilen gösterge rakamlarının memur aylıklarına uygulanan katsayı ile çarpımı sonucu bulunan miktarda Makam Tazminatı ödenir. Makam Tazminatı damga vergisi hariç herhangi bir vergiye tabi tutulmaz. Makam tazminatının hakedilmesinde ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu tazminattan yararlananlara ayrıca diğer kanunlarda belirtilen Yüksek Hakimlik Tazminatı ve Makam Tazminatı ödenmez.\nYükseköğretim tazminatı:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Makam Tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 137, "document_char_start": 14471, "document_char_end": 14608}, "source_text": "Ek Madde 3 – (Ek: 5/11/2014-6564/1 md.)\nDevlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__002_a", "label": "a", "source_span": {"article_char_start": 137, "article_char_end": 180, "document_char_start": 14608, "document_char_end": 14651}, "source_text": "a) Profesör kadrosunda bulunanlara %100’ü,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__003_b", "label": "b", "source_span": {"article_char_start": 180, "article_char_end": 221, "document_char_start": 14651, "document_char_end": 14692}, "source_text": "b) Doçent kadrosunda bulunanlara %100’ü,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__004_c", "label": "c", "source_span": {"article_char_start": 221, "article_char_end": 276, "document_char_start": 14692, "document_char_end": 14747}, "source_text": "c) Doktor Öğretim Üyesi kadrosunda bulunanlara %100’ü,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__005_d", "label": "d", "source_span": {"article_char_start": 276, "article_char_end": 330, "document_char_start": 14747, "document_char_end": 14801}, "source_text": "d) Araştırma Görevlisi kadrosunda bulunanlara %115’i,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__006_e", "label": "e", "source_span": {"article_char_start": 330, "article_char_end": 388, "document_char_start": 14801, "document_char_end": 14859}, "source_text": "e) Öğretim Görevlisi (…)10 kadrosunda bulunanlara %115’i,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 3", "clause_id": "ek_madde_3__007_f", "label": "f", "source_span": {"article_char_start": 388, "article_char_end": 866, "document_char_start": 14859, "document_char_end": 15337}, "source_text": "f) (Mülga: 22/2/2018-7100/15 md.)\noranında her ay yükseköğretim tazminatı ödenir.\nBu tazminata hak kazanılmasında ve ödenmesinde aylıklara ilişkin hükümler uygulanır. Bu maddeye göre ödenecek tazminat, damga vergisi hariç herhangi bir vergiye tabi tutulmaz ve ilgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.\n\nAkademik teşvik ödeneği:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yükseköğretim tazminatı"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 612, "document_char_start": 15338, "document_char_end": 15950}, "source_text": "Ek Madde 4 – (Ek: 5/11/2014-6564/2 md.)\nHer bir takvim yılı için, bir önceki yıl, bilim, teknoloji ve sanata katkı sağlayıcı nitelikte yurt içinde veya yurt dışında sonuçlandırılan proje, araştırma, yayın, tasarım, sergi, patent ile çalışmalarına yapılan atıflar, bilim kurulu bulunan uluslararası düzeydeki toplantılarda tebliğ sunma ve almış olduğu akademik ödüller esas alınarak öğretim elemanları için yüz puan üzerinden yıllık akademik teşvik puanı hesaplanır.\nAkademik teşvik puanı otuz ve üzerinde olanlara, Devlet Memurları Kanununa tabi en yüksek Devlet memuru brüt aylık (ek gösterge dâhil) tutarının;", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__002_a", "label": "a", "source_span": {"article_char_start": 612, "article_char_end": 661, "document_char_start": 15950, "document_char_end": 15999}, "source_text": "a) Profesör kadrosunda bulunanlar için %100’üne,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__003_b", "label": "b", "source_span": {"article_char_start": 661, "article_char_end": 707, "document_char_start": 15999, "document_char_end": 16045}, "source_text": "b) Doçent kadrosunda bulunanlar için %90’ına,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__004_c", "label": "c", "source_span": {"article_char_start": 707, "article_char_end": 767, "document_char_start": 16045, "document_char_end": 16105}, "source_text": "c) Doktor Öğretim Üyesi kadrosunda bulunanlar için %80’ine,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__005_d", "label": "d", "source_span": {"article_char_start": 767, "article_char_end": 826, "document_char_start": 16105, "document_char_end": 16164}, "source_text": "d) Araştırma Görevlisi kadrosunda bulunanlar için %70’ine,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__006_e", "label": "e", "source_span": {"article_char_start": 826, "article_char_end": 889, "document_char_start": 16164, "document_char_end": 16227}, "source_text": "e) Öğretim Görevlisi (…)12 kadrosunda bulunanlar için %70’ine,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Ek Madde 4", "clause_id": "ek_madde_4__007_f", "label": "f", "source_span": {"article_char_start": 889, "article_char_end": 2184, "document_char_start": 16227, "document_char_end": 17522}, "source_text": "f) (Mülga: 22/2/2018-7100/15 md.)\naldıkları akademik teşvik puanının yüze bölünmesi suretiyle bulunacak oranın uygulanması suretiyle hesaplanan tutarda akademik teşvik ödeneği verilir.\nBu madde uyarınca yapılacak ödeme; bu Kanun uyarınca aylık ödendiği sürece ve kadrolarının bulunduğu yükseköğretim kurumları tarafından şubat ayının on beşinden itibaren on iki ay süreyle her ayın on beşinde yapılır, damga vergisi hariç herhangi bir vergiye tabi tutulmaz. İlgili mevzuatı uyarınca ödenmekte olan zam, tazminat, ödenek, döner sermaye ek ödemesi, ikramiye, ücret ve her ne ad altında olursa olsun yapılan benzeri ödemelerin hesabında dikkate alınmaz.\nBilim alanlarının özellikleri ve öğretim elemanlarının unvanlarına göre akademik teşvik puanlarının hesaplanmasında esas alınacak faaliyetlerin ayrıntılı özellikleri ve bu faaliyetlerin puan karşılıkları, akademik teşvik toplam puanının %30’unu geçmemek üzere her bir akademik faaliyet türünün toplam puanın hesaplanmasındaki ağırlıkları, akademik teşvik puanının hesaplanmasına ilişkin usul ve esaslar ile bu hesaplamaları yapacak komisyonun oluşumu ile diğer hususlar Cumhurbaşkanı tarafından yürürlüğe konulan yönetmelikle belirlenir.\nBu madde hükümleri, Türk Silahlı Kuvvetleri kadrolarında bulunan öğretim elemanları hakkında da uygulanır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Akademik teşvik ödeneği"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 1", "clause_id": "geçici_madde_1__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 308, "document_char_start": 17523, "document_char_end": 17831}, "source_text": "Geçici Madde 1 – 657 sayılı Devlet Memurları Kanununa tabi öğretmenlerden 28/3/1993 tarih ve 2809 sayılı Kanunun geçici 3 üncü maddesi ile aynı Kanun kapsamına alınanlardan yükseköğrenim kurumlarında istihdamına ihtiyaç duyulanların bu Kanun hükümlerine göre intibakları, 30/6/1984 tarihi itibariyle yapılır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "f) (Mülga: 22/2/2018-7100/15 md.)"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 2", "clause_id": "geçici_madde_2__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 454, "document_char_start": 17833, "document_char_end": 18287}, "source_text": "Geçici Madde 2 – Öğretim elemanlarına ve geçici 1 inci madde kapsamına girenler bu Kanunun 12 inci maddesi uyarınca ödenecek Üniversite Ödeneğinin, 1765 sayılı Üniversite Personel Kanununun değişik 16 ncı maddesi uyarınca halen ödenmekte olan iş güçlüğü, iş riski, temininde güçlük zammı ile tamgün ödeneği tutarından az olması halinde aradaki net fark, üniversite ödeneği bu miktara ulaşıncaya kadar, hiçbir vergi ve kesintiye tabi tutulmaksızın ödenir.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 3", "clause_id": "geçici_madde_3__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 174, "document_char_start": 18289, "document_char_end": 18463}, "source_text": "Geçici Madde 3 – Öğretim elemanlarına bu Kanunun 5 inci maddesine göre verilecek ek göstergeleri, 31/12/1983 tarihinde yararlanmakta oldukları ek göstergelerden düşük olamaz.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 4", "clause_id": "geçici_madde_4__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 785, "document_char_start": 18465, "document_char_end": 19250}, "source_text": "Geçici Madde 4 – 1/1/1984 tarihinde yükseköğretim kurumlarında görev yapmakta olanlar ile bu kurumların kadroları ile ilişkileri devam eden, askerlik görevlerini yapmakta olan ve bu Kanun kapsamına giren öğretim elemanlarının intibakları, 657 sayılı Devlet Memurları Kanunu hükümleri uyarınca öğrenim niteliğine ve süresine göre (657 sayılı Kanunun değişik 36 ncı maddesinin \"Ortak Hükümleri\" ile getirilen kademe ilerlemesi ve derece yükselmesi hariç) başlayabilecekleri derece ve kademe esas alınmak suretiyle bu Kanun ve Devlet Memurları Kanununa göre rektörlüklerce (Geçici 1 inci madde kapsamına girenler hariç) üç ay içinde yapılır.\nİntibak sonucunda kazanılmış hak aylık dereceleri kadro derecelerinin üzerinde olanlara, kazanılmış hak aylıkları esas alınarak ödemede bulunulur.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 5", "clause_id": "geçici_madde_5__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 206, "document_char_start": 19252, "document_char_end": 19458}, "source_text": "Geçici Madde 5 – Geçici 4 üncü madde hükmü saklı kalmak üzere bu Kanunun yürürlüğe girdiği tarihten önce doçent kadrosuna atanmış bulunanların görev aylıkları, bir üst derecenin aynı kademesine yükseltilir.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 6", "clause_id": "geçici_madde_6__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 1085, "document_char_start": 19460, "document_char_end": 20545}, "source_text": "Geçici Madde 6 – 6/11/1981 tarihinde Boğaziçi Üniversitesi ile Orta Doğu Teknik Üniversitesinde 657 sayılı Devlet Memurları Kanunu hükümlerine tabi olmadan çalışan öğretim elemanları dışında kalan personelden 657 sayılı Kanuna göre intibaklarının yapılmasını istemeyerek, 1/1/1984 tarihinden itibaren 30 gün içinde müracaat edenlere, kıdem tazminatları ödenir ve kurumları ile ilişkileri kesilir.\nBunlara ödenecek kıdem tazminatı, görevden ayrıldıkları tarihteki kazanılmış hakları dikkate alınarak hesaplanır. Ancak, bu şekilde hesaplanacak kıdem tazminatının miktarı 30/9/1982 tarihinde hak kazanabilecekleri kıdem tazminatından fazla olamaz.\n2547 sayılı Yükseköğretim Kanununun yürürlüğe girdiği 6/11/1981 tarihi ile bu Kanunun yürürlüğe girdiği tarih arasında görevden ayrılanlar hakkında da, görevden ayrıldıkları tarih dikkate alınarak yukarıdaki hükümler uygulanır.\n30/9/1982 tarihinden sonra görevden ayrılanların bu tarih ile görevden ayrıldıkları tarih arasında geçen hizmetleri, primlerinin ödenmesi kaydıyla 506 sayılı Sosyal Sigortalar Kanununa tabi olarak geçmiş sayılır.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 7", "clause_id": "geçici_madde_7__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 348, "document_char_start": 20547, "document_char_end": 20895}, "source_text": "Geçici Madde 7 – 4/11/1981 tarih ve 2547 sayılı Yükseköğretim Kanununun 24/9/1982 tarih ve 2708 sayılı Kanun ile değişik geçici 23 üncü maddesinde belirtilen ve sözleşmeli olarak çalıştırılan öğretim elemanları ile idari personel 30/9/1984 tarihine kadar sahip oldukları statü içinde çalıştırılırlar. Bu tarihten sonra genel hükümlere tabi olurlar.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "clause_id": "geçici_madde_8__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 273, "document_char_start": 20897, "document_char_end": 21170}, "source_text": "Geçici Madde 8 – İlgili kanunda gerekli değişiklik yapılıncaya kadar, Yükseköğretim Kurulu üyeleri ile Yükseköğretim Denetleme Kurulu üyeleri, 657 sayılı Devlet Memurları Kanununun 187 - 213 üncü maddeleri ile düzenlenen sosyal haklardan yararlanırlar.\nAncak, bu üyelerden", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "clause_id": "geçici_madde_8__002_t", "label": "T", "source_span": {"article_char_start": 273, "article_char_end": 276, "document_char_start": 21170, "document_char_end": 21173}, "source_text": "T.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "clause_id": "geçici_madde_8__003_c", "label": "C", "source_span": {"article_char_start": 276, "article_char_end": 477, "document_char_start": 21173, "document_char_end": 21374}, "source_text": "C. Emekli Sandığı ile Sosyal Sigortalar Kurumundan emekli olanlar bu kuruluşlarca aynı sosyal haklardan ayrıca yararlandırılmazlar.\n(Ek: 26/6/1984 - KHK - 241/32 md.; Değişik: 24/11/1994 - 4048/5 md.)", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "clause_id": "geçici_madde_8__004_t", "label": "T", "source_span": {"article_char_start": 477, "article_char_end": 480, "document_char_start": 21374, "document_char_end": 21377}, "source_text": "T.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 8", "clause_id": "geçici_madde_8__005_c", "label": "C", "source_span": {"article_char_start": 480, "article_char_end": 1064, "document_char_start": 21377, "document_char_end": 21961}, "source_text": "C. Emekli Sandığ�� iştirakçisi olan Yükseköğretim Kurulu Başkanı, Yükseköğretim Yürütme Kurulu Üyeleri ile Yükseköğretim Denetleme Kurulu üyelerinin emekli keseneklerinin hesabında aşağıdaki ek göstergeler esas alınır. Emekli İken Yükseköğretim Yürütme Kurulu veya Yükseköğretim Denetleme Kurulu Üyeliklerine geçirilenlerin emekli aylıklarının ödenmesinde de aynı göstergeler esas alınır.\n\n(Değişik:1/7/2022-7417/10 md.)\n|Unvanı |Derece |Ek Göstergeler |\n|Yükseköğretim Kurulu Başkanı |1 |8000 |\n|Yükseköğretim Kurulu Üyeleri |1 |7800 |\n|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": ""}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 9", "clause_id": "geçici_madde_9__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 554, "document_char_start": 21963, "document_char_end": 22517}, "source_text": "Geçici Madde 9 – (Ek: 14/1/1988 - KHK - 311/8 md.)\n2547 sayılı Yükseköğretim Kanunun yürürlüğe girmesinden önce Profesörlük unvanını almış olup da 78 sayılı Kanun Hükmünde Kararname ile ihdas edilen profesörlük kadrolarına atanamamış olanlar, bu Kanunun 5 inci maddesinde profesör kadrosunda bulunanlar için öngörülen ek göstergeler ile 241 sayılı Kanun Hükmünde Kararname'nin değişik 39 uncu maddesine göre profesör kadrosunda üç yılı tamamlamış olanlar için öngörülen makam tazminatından profesör kadrosuna atanma şartı aranmaksızın yararlandırılırlar.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |"}
+{"document_id": "TR-KANUN-2914", "article_id": "Geçici Madde 10", "clause_id": "geçici_madde_10__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 294, "document_char_start": 22519, "document_char_end": 22813}, "source_text": "Geçici Madde 10 – (Ek: 5/11/2014-6564/3 md.)\nEk 4 üncü maddede belirtilen yönetmelik dört ay içinde yürürlüğe konur. Ek 4 üncü maddenin birinci fıkrasına göre ilk defa akademik teşvik puanı hesaplanması, 2015 yılında yapılan faaliyetler esas alınmak suretiyle 2016 yılı için yapılır.\n\nYürürlük:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "|Yükseköğretim Denetim Kurulu Üyeleri |1 |7800 |"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 22", "clause_id": "madde_22__001_preamble", "label": "preamble", "source_span": {"article_char_start": 0, "article_char_end": 23, "document_char_start": 22815, "document_char_end": 22838}, "source_text": "Madde 22 – Bu Kanunun;", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Bu Kanunun"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 22", "clause_id": "madde_22__002_a", "label": "a", "source_span": {"article_char_start": 23, "article_char_end": 117, "document_char_start": 22838, "document_char_end": 22932}, "source_text": "a) Geçici 7 nci maddesi hükümleri; 30/9/1983 tarihinden geçerli olmak üzere yayımı tarihinde,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Bu Kanunun"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 22", "clause_id": "madde_22__003_b", "label": "b", "source_span": {"article_char_start": 117, "article_char_end": 263, "document_char_start": 22932, "document_char_end": 23078}, "source_text": "b) Geçici 8 inci maddesi ile atıfta bulunulan 657 sayılı Devlet Memurları Kanununun 208- 210 uncu maddelerine ilişkin hükümleri yayımı tarihinde,", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Bu Kanunun"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 22", "clause_id": "madde_22__004_c", "label": "c", "source_span": {"article_char_start": 263, "article_char_end": 328, "document_char_start": 23078, "document_char_end": 23143}, "source_text": "c) Diğer hükümleri 1/1/1984 tarihinde,\nYürürlüğe girer.\n\nYürütme:", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Bu Kanunun"}
+{"document_id": "TR-KANUN-2914", "article_id": "Madde 23", "clause_id": "madde_23__001_article", "label": "article", "source_span": {"article_char_start": 0, "article_char_end": 56, "document_char_start": 23144, "document_char_end": 23200}, "source_text": "Madde 23 – Bu Kanun hükümlerini Bakanlar Kurulu yürütür.", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914", "article_title": "Yürütme"}

data/structural/2914_schedules.jsonl

@@ -0,0 +1,2 @@
+{"class": "ScheduleUnit", "document_id": "TR-KANUN-2914", "schedule_id": "TR-KANUN-2914__EK_GÖSTERGE_CETVELI", "article_id": "EK GÖSTERGE CETVELİ", "title": "EK GÖSTERGE CETVELİ", "source_span": {"char_start": 23201, "char_end": 23681}, "source_text": "EK GÖSTERGE CETVELİ:\n\n(Ek:18/5/1994-KHK-527/19 md.) (Değişik:1/7/2022-7417/10 md.)\n\n|Kadro Unvanı |Derece |Ek Göstergeler |\n|a) Profesörlerden Rektör, Rektör Yardımcısı, Dekan, Dekan Yardımcısı, Yüksekokul Müdürü |1 |7000 |\n|olanlar ile Profesörlük kadrosunda dört yılını tamamlamış bulunanlar | | |\n|b) Profesörler |1 |5900 |\n|c) Doçentler |1-3 |5400 |\n|d) Doktor Öğretim Üyeleri |1-5 |4200 |\n|e) Öğretim Görevlisi ve Araştırma Görevlileri |1 |4200 |\n| |2 |3300 |\n| |3-7 |2900 |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}
+{"class": "ScheduleUnit", "document_id": "TR-KANUN-2914", "schedule_id": "TR-KANUN-2914__MAKAM_TAZMI_NATI_CETVELI_EK_20_3_1997_KHK_570_7_MD", "article_id": "MAKAM TAZMİNATI CETVELİ (Ek: 20/3/1997-KHK-570/7 md.)", "title": "MAKAM TAZMİNATI CETVELİ (Ek: 20/3/1997-KHK-570/7 md.)", "source_span": {"char_start": 23681, "char_end": 23996}, "source_text": "MAKAM TAZMİNATI CETVELİ (Ek: 20/3/1997-KHK-570/7 md.)\n\n|Sıra No |Kadro ve Görev Unvanı |Tazminat Göstergeleri |\n|1 |Rektörler |7.000 |\n|2 |Profesörler (Bu kadroda üç yılını tamamlamış olmak şartıyla) |6.000 |\n|3 |Profesörler |4.500 |\n|4 |Doçentler (Kazanılmış hak aylıkları birinci derece olmak şartıyla) |2.000 |", "document_title": "2914 sayılı Yükseköğretim Personel Kanunu", "document_short_code": "2914"}

data/tests/golden_questions.jsonl

@@ -0,0 +1,65 @@
+{"question":"Dekan nasıl atanır?","expected_article":"Madde 16","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Dekanın görevleri nelerdir?","expected_article":"Madde 16","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"YÖK kaç üyeden oluşur?","expected_article":"Madde 6","expected_norm_type":"kurul_olusumu","expected_behavior":"answer"}
+{"question":"Yükseköğretim kurumu nasıl kurulur?","expected_article":"Madde 5","expected_norm_type":"kurulus","expected_behavior":"answer"}
+{"question":"Ön lisans diploması nedir?","expected_article":"Madde 3","expected_norm_type":"tanim","expected_behavior":"answer"}
+{"question":"Diploma almak için ne gerekir?","expected_article":"Madde 44","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Rektörün görevleri nelerdir?","expected_article":"Madde 13","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Üniversite senatosunun görevleri nelerdir?","expected_article":"Madde 14","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Yükseköğretim Kurulunun görevleri nelerdir?","expected_article":"Madde 7","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Yükseköğretim Denetleme Kurulunun görevleri nelerdir?","expected_article":"Madde 9","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Üniversitelerarası Kurul nedir?","expected_article":"Madde 11","expected_norm_type":"tanim","expected_behavior":"answer"}
+{"question":"Rektör nasıl atanır?","expected_article":"Madde 13","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Senatonun görevleri nelerdir?","expected_article":"Madde 14","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Üniversite Yönetim Kurulunun görevleri nelerdir?","expected_article":"Madde 15","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Fakülte Kurulunun görevleri nelerdir?","expected_article":"Madde 17","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Fakülte Yönetim Kurulu görevleri nelerdir?","expected_article":"Madde 18","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Doktor öğretim üyesi ataması nasıl yapılır?","expected_article":"Madde 23","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Doçentlik başvurusu nasıl yapılır?","expected_article":"Madde 24","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Profesörlüğe yükselme nasıl olur?","expected_article":"Madde 26","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Öğretim görevlileri nasıl atanır?","expected_article":"Madde 31","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Araştırma görevlileri nasıl atanır?","expected_article":"Madde 33","expected_norm_type":"atama","expected_behavior":"answer"}
+{"question":"Yabancı uyruklu öğretim elemanları nasıl çalıştırılır?","expected_article":"Madde 34","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Öğretim elemanı yetiştirme nasıl yapılır?","expected_article":"Madde 35","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Öğretim elemanlarının çalışma esasları nelerdir?","expected_article":"Madde 36","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Yurt içinde ve yurt dışında görevlendirme nasıl olur?","expected_article":"Madde 39","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Lisans düzeyinde öğretim nasıl düzenlenir?","expected_article":"Madde 43","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Yükseköğretime giriş ve yerleştirme nasıl yapılır?","expected_article":"Madde 45","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Öğrenci katkı payı ve öğrenim ücretleri nasıl belirlenir?","expected_article":"Madde 46","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Disiplin soruşturmasında savunma hakkı nedir?","expected_article":"Madde 53/A","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Disiplin cezası verme yetkisi kimdedir?","expected_article":"Madde 53/Ç","expected_norm_type":"yetki","expected_behavior":"answer"}
+{"question":"Disiplin cezalarına itiraz nasıl yapılır?","expected_article":"Madde 53/F","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Öğrencilerin disiplin işleri nasıl düzenlenir?","expected_article":"Madde 54","expected_norm_type":"yaptirim","expected_behavior":"answer"}
+{"question":"Vakıf yükseköğretim kurumu nasıl kurulur?","expected_article":"Ek Madde 3","expected_norm_type":"kurulus","expected_behavior":"answer"}
+{"question":"Madde 1 neyi düzenler?","expected_article":"Madde 1","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 2 neyi kapsar?","expected_article":"Madde 2","expected_norm_type":"kapsam","expected_behavior":"answer"}
+{"question":"Madde 4 ne hakkındadır?","expected_article":"Madde 4","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 5 ana ilkeleri nelerdir?","expected_article":"Madde 5","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 8 neyi düzenler?","expected_article":"Madde 8","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 10 ne hakkındadır?","expected_article":"Madde 10","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 12 ne hakkındadır?","expected_article":"Madde 12","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 21 bölüm hakkında ne düzenler?","expected_article":"Madde 21","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 22 öğretim üyeleri için ne düzenler?","expected_article":"Madde 22","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 49 yabancı dil hazırlık için ne düzenler?","expected_article":"Madde 49","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 50 lisansüstü öğretim için ne düzenler?","expected_article":"Madde 50","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 53/B neyi düzenler?","expected_article":"Madde 53/B","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 55 gelir kaynakları için ne düzenler?","expected_article":"Madde 55","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Madde 65 yönetmelikler için ne düzenler?","expected_article":"Madde 65","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Ek Madde 10 neyi düzenler?","expected_article":"Ek Madde 10","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Ek Madde 12 neyi düzenler?","expected_article":"Ek Madde 12","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Ek Madde 18 neyi düzenler?","expected_article":"Ek Madde 18","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Ek Madde 32 neyi düzenler?","expected_article":"Ek Madde 32","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Ek Madde 35 neyi düzenler?","expected_article":"Ek Madde 35","expected_norm_type":"","expected_behavior":"answer"}
+{"question":"Dekanlık makamı kanuna göre nasıl bir roldür?","expected_article":"Madde 16","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Rektörün üniversite içindeki sorumluluğu nasıl anlaşılmalı?","expected_article":"Madde 13","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"YÖK sistemde nasıl bir rol oynar?","expected_article":"Madde 6","expected_norm_type":"gorev","expected_behavior":"answer"}
+{"question":"Öğrenci disiplininde hukuki çerçeve nedir?","expected_article":"Madde 54","expected_norm_type":"tanim","expected_behavior":"answer"}
+{"question":"Vakıf yükseköğretim kurumları bakımından temel sınırlama nedir?","expected_article":"Ek Madde 3","expected_norm_type":"sart","expected_behavior":"answer"}
+{"question":"Kanunun temel ilkeleri neler?","expected_article":"Madde 5","expected_norm_type":"ilke","expected_behavior":"answer"}
+{"question":"2547 sayılı kanunun ana ilkeleri nelerdir?","expected_article":"Madde 5","expected_norm_type":"ilke","expected_behavior":"answer"}
+{"question":"Yükseköğretimin amacı nedir?","expected_article":"Madde 4","expected_norm_type":"amac","expected_behavior":"answer"}
+{"question":"Kanunun temel amaçları nelerdir?","expected_article":"Madde 1","expected_norm_type":"amac","expected_behavior":"answer"}
+{"question":"Yükseköğretim kanunun temel amacı nedir?","expected_article":"Madde 1","expected_norm_type":"amac","expected_behavior":"answer"}
+{"question":"Araştırma enstitüleri nasıl kurulur?","expected_article":"Madde 7","expected_norm_type":"kurulus","expected_behavior":"answer"}
+{"question":"Enstitüler nasıl kurulur?","expected_article":"Madde 5","expected_norm_type":"kurulus","expected_behavior":"answer"}
+{"question":"Uygulama ve araştırma merkezi nasıl açılır?","expected_article":"Madde 7","expected_norm_type":"kurulus","expected_behavior":"answer"}

data/tests/multidoc_golden_questions.jsonl

@@ -0,0 +1,76 @@
+{"id":"2547_dekan_atama_001","question":"Dekan nasil atanir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 16"],"expected_evidence_keywords":["dekan"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_dekan_gorev_002","question":"Dekanin gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 16"],"expected_evidence_keywords":["dekan"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_yok_olusum_003","question":"YOK kac uyeden olusur?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 6"],"expected_evidence_keywords":["yirmi bir"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_yok_gorev_004","question":"Yuksekogretim Kurulunun gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 7"],"expected_evidence_keywords":["Yükseköğretim Kurulunun görevleri"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_rektor_atama_005","question":"Rektor nasil atanir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 13"],"expected_evidence_keywords":["rektör"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_rektor_gorev_006","question":"Rektorun gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 13"],"expected_evidence_keywords":["rektör"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_senato_gorev_007","question":"Universite senatosunun gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 14"],"expected_evidence_keywords":["senato"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_univ_yk_gorev_008","question":"Universite Yonetim Kurulunun gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 15"],"expected_evidence_keywords":["Üniversite yönetim kurulu"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_fakulte_kurulu_009","question":"Fakulte Kurulunun gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 17"],"expected_evidence_keywords":["Fakülte kurulu"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_fakulte_yk_010","question":"Fakulte Yonetim Kurulu gorevleri nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 18"],"expected_evidence_keywords":["Fakülte yönetim kurulu"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_doktor_ogretim_011","question":"Doktor ogretim uyesi atamasi nasil yapilir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 23"],"expected_evidence_keywords":["doktor öğretim üyesi"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_docentlik_012","question":"Docentlik basvurusu nasil yapilir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 24"],"expected_evidence_keywords":["doçentlik"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_profesor_013","question":"Profesorlugu yukselme nasil olur?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 26"],"expected_evidence_keywords":["profesör"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_ogretim_gorevlisi_014","question":"Ogretim gorevlileri nasil atanir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 31"],"expected_evidence_keywords":["Öğretim görevlileri"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_arastirma_gorevlisi_015","question":"Arastirma gorevlileri nasil atanir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 33"],"expected_evidence_keywords":["Araştırma görevlileri"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_yabanci_016","question":"Yabanci uyruklu ogretim elemanlari nasil calistirilir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 34"],"expected_evidence_keywords":["Yabancı uyruklu"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_calisma_017","question":"Ogretim elemanlarinin calisma esaslari nelerdir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 36"],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_diploma_018","question":"Diploma almak icin ne gerekir?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 44"],"expected_evidence_keywords":["diploma"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_vakif_019","question":"Vakif yuksekogretim kurumu nasil kurulur?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Ek Madde 3"],"expected_evidence_keywords":["Vakıflar"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2547_enstitu_020","question":"Enstituler nasil kurulur?","expected_document_ids":["TR-KANUN-2547"],"expected_articles":["Madde 5"],"expected_evidence_keywords":["enstitü"],"forbidden_document_ids":["TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_ek_ders_001","question":"Ek ders ucreti nasil odenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 11"],"expected_evidence_keywords":["ek ders ücreti"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_ek_ders_002","question":"Ek ders ucreti hangi kanunda duzenlenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 11"],"expected_evidence_keywords":["ek ders ücreti"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_ek_ders_003","question":"Ek ders ucreti en cok kac saate kadar odenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 11"],"expected_evidence_keywords":["yirmi saate"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_sinav_004","question":"Sinav ucreti hangi gostergeye gore odenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 11"],"expected_evidence_keywords":["sınav ücreti"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_universite_odenegi_005","question":"Universite odenegi nedir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 12"],"expected_evidence_keywords":["üniversite ödeneği"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_universite_odenegi_006","question":"Universite odenegi kimlere odenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 12"],"expected_evidence_keywords":["en yüksek"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_idari_007","question":"Idari gorev odenegi kimlere odenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 13"],"expected_evidence_keywords":["idari görev ödeneği"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_idari_008","question":"Birden fazla idari gorevi olanlara hangi idari gorev odenegi verilir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 13"],"expected_evidence_keywords":["en yüksek olanı"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_gelistirme_009","question":"Gelistirme odenegi hangi maddede duzenlenir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 14"],"expected_evidence_keywords":["geliştirme ödeneği"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_egitim_010","question":"Egitim ogretim odenegi nedir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Ek Madde 1"],"expected_evidence_keywords":["eğitim öğretim ödeneği"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_derece_011","question":"Derece yukseltilmesi sartlari nelerdir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 7"],"expected_evidence_keywords":["Şartıyla"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_kademe_012","question":"Kademe ilerlemesi hangi sartlara baglidir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 8"],"expected_evidence_keywords":["kademe ilerlemesi"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_onay_013","question":"2914 Madde 9 onay makami kimdir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 9"],"expected_evidence_keywords":["rektör"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_sosyal_014","question":"Ogretim elemanlari hangi sosyal haklardan yararlanir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 10"],"expected_evidence_keywords":["sosyal hak"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_sozlesmeli_015","question":"Emekli ogretim elemanlari sozlesmeli calistirilabilir mi?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 16"],"expected_evidence_keywords":["sözleşmeli"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_yabanci_016","question":"Yabanci ogretim elemanlari hakkinda 2914 ne duzenler?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 16"],"expected_evidence_keywords":["yabancı"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_ek_gosterge_017","question":"Ek gosterge cetveli nedir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["EK GÖSTERGE CETVELİ"],"expected_evidence_keywords":["EK GÖSTERGE"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_makam_018","question":"Makam tazminati cetveli kimleri kapsar?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["MAKAM TAZMİNATI CETVELİ"],"expected_evidence_keywords":["MAKAM TAZMİNATI"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_amac_019","question":"2914 sayili Kanunun amaci nedir?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 1"],"expected_evidence_keywords":["Bu Kanunun amacı"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2914_kapsam_020","question":"2914 sayili Kanun kimleri kapsar?","expected_document_ids":["TR-KANUN-2914"],"expected_articles":["Madde 2"],"expected_evidence_keywords":["öğretim"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_amac_001","question":"2809 sayili Kanunun amaci nedir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 1"],"expected_evidence_keywords":["teşkilatlanmasını"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_kapsam_002","question":"2809 sayili Kanun neyi kapsar?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 2"],"expected_evidence_keywords":["teşkilatlanması"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_birim_003","question":"Universite hangi birimlerden olusur?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 3"],"expected_evidence_keywords":["fakülte"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_fakulte_004","question":"Bir universitede en az kac fakulte bulunmalidir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 3"],"expected_evidence_keywords":["en az üç fakülte"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_alt_birim_005","question":"Alt birimlerin teskili 2809'a gore nasil duzenlenir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 3"],"expected_evidence_keywords":["2547 sayılı Kanunun 7 nci maddesi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_faaliyet_006","question":"Yeni kurulan birimler ne zaman faaliyete gecirilir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 6"],"expected_evidence_keywords":["faaliyete geçirilir"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_hizmetici_007","question":"Universiteler hizmetici egitim kurslari acmakla yukumludur mu?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 5"],"expected_evidence_keywords":["hizmetiçi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_kamu_imkan_008","question":"Yuksekogretim kurumlari hangi kurum imkanlarindan yararlanir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 4"],"expected_evidence_keywords":["kamu kurum"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_ankara_009","question":"Ankara Universitesi hangi maddede duzenlenir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 7"],"expected_evidence_keywords":["Ankara Üniversitesi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_odtu_010","question":"Orta Dogu Teknik Universitesi hangi maddede duzenlenir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 8"],"expected_evidence_keywords":["Ortadoğu Teknik Üniversitesi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_hacettepe_011","question":"Hacettepe Universitesi hangi maddede duzenlenir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 9"],"expected_evidence_keywords":["Hacettepe Üniversitesi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_gazi_012","question":"Gazi Universitesi hangi maddede kurulmustur?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 10"],"expected_evidence_keywords":["Gazi Üniversitesi"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_cumhurbaskani_013","question":"Cumhurbaskani fakulteleri kurma ve kapatma konusunda hangi yetkiye sahiptir?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Ek Madde 30"],"expected_evidence_keywords":["Cumhurbaşkanı"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_yururluk_014","question":"2809 sayili Kanun ne zaman yururluge girer?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 36"],"expected_evidence_keywords":["yürürlüğe"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"2809_yurutme_015","question":"2809 sayili Kanunu kim yurutur?","expected_document_ids":["TR-KANUN-2809"],"expected_articles":["Madde 37"],"expected_evidence_keywords":["yürütür"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation"}
+{"id":"cross_2914_2547_001","question":"2914 Madde 1 ogretim elemani tanimini hangi 2547 maddesine baglar?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 1","Madde 3"],"expected_evidence_keywords":["2547 sayılı"],"expected_edge_ids":["2914_m1_refs_2547_teacher_definition"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_2914_2547_002","question":"Ek ders ucreti ile 2547 ders yuku arasindaki iliski nedir?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 11","Madde 36"],"expected_evidence_keywords":["ek ders"],"expected_edge_ids":["2914_m11_details_2547_m36_ders_yuku"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_2809_2547_003","question":"2809 Madde 3 alt birimleri hangi 2547 maddesine baglar?","expected_document_ids":["TR-KANUN-2809","TR-KANUN-2547"],"expected_articles":["Madde 3","Madde 7"],"expected_evidence_keywords":["2547 sayılı Kanunun 7 nci maddesi"],"expected_edge_ids":["2809_m3_refs_2547_m7_unit_regulation"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_universite_kurulus_004","question":"Universite nasil kurulur? 2547 ve 2809 birlikte nasil okunur?","expected_document_ids":["TR-KANUN-2547","TR-KANUN-2809"],"expected_articles":["Madde 7","Madde 3"],"expected_evidence_keywords":["üniversite"],"expected_edge_ids":["2809_m3_refs_2547_m7_unit_regulation"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_ders_yuku_005","question":"2914 ek ders ucreti 2547 Madde 36 ders yuku ile nasil baglantilidir?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 11","Madde 36"],"expected_evidence_keywords":["ders yükü"],"expected_edge_ids":["2914_m11_details_2547_m36_ders_yuku"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_ogretim_tanim_006","question":"2914 kapsamindaki ogretim elemani ifadesi 2547'deki hangi tanima dayanir?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 1","Madde 3"],"expected_evidence_keywords":["öğretim elemanları"],"expected_edge_ids":["2914_m1_refs_2547_teacher_definition"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_teskil_yok_007","question":"2809 alt birim teskili ile YOK'un 2547 Madde 7 yetkisi arasindaki bag nedir?","expected_document_ids":["TR-KANUN-2809","TR-KANUN-2547"],"expected_articles":["Madde 3","Madde 7"],"expected_evidence_keywords":[],"expected_edge_ids":["2809_m3_refs_2547_m7_unit_regulation"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_personel_kapsam_008","question":"2914 kapsam maddesi 2547'ye tabi universite ogretim elemanlarini nasil kullanir?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 2","Madde 3"],"expected_evidence_keywords":["2547"],"expected_edge_ids":["2914_m1_refs_2547_teacher_definition"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_kurum_birim_009","question":"Universitenin birimlerden olusmasi 2809'da, bunlarin duzenlenmesi 2547'de nasil baglanir?","expected_document_ids":["TR-KANUN-2809","TR-KANUN-2547"],"expected_articles":["Madde 3","Madde 7"],"expected_evidence_keywords":["alt birimlerinin"],"expected_edge_ids":["2809_m3_refs_2547_m7_unit_regulation"],"forbidden_document_ids":["TR-KANUN-2914"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"cross_personel_odeme_010","question":"Ek ders ucretinde 2914 odeme kuralini, 2547 hangi ders yuku baglamiyla tamamlar?","expected_document_ids":["TR-KANUN-2914","TR-KANUN-2547"],"expected_articles":["Madde 11","Madde 36"],"expected_evidence_keywords":["ek ders"],"expected_edge_ids":["2914_m11_details_2547_m36_ders_yuku"],"forbidden_document_ids":["TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"source_grounded_explanation","cross_document":true}
+{"id":"oos_001","question":"Bugun hava nasil?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_002","question":"Bana makarna tarifi verir misin?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_003","question":"Futbol maci kac kac bitti?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_004","question":"Borsa ne olur?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_005","question":"Bir siir yazar misin?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_006","question":"Python ile oyun kodlar misin?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_007","question":"Film onerisi verir misin?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_008","question":"Kripto para alayim mi?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_009","question":"Bir mail taslagi yazar misin?","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+{"id":"oos_010","question":"Muzik listesi hazirla","expected_document_ids":[],"expected_articles":[],"expected_evidence_keywords":[],"forbidden_document_ids":["TR-KANUN-2547","TR-KANUN-2914","TR-KANUN-2809"],"forbidden_articles":[],"answer_type":"out_of_scope"}
+

engine.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+import json
+
+from clause_retrieval import init_clause_retrieval, load_ontology
+from config import (
+    CORPUS_MCKF_ONTOLOGY_PATH,
+    MCKF_ONTOLOGY_PATH,
+    MCKF_VALIDATION_REPORT_PATH,
+    RUNTIME_BUILD_MANIFEST_PATH,
+)
+from normative_contract import file_sha256
+
+BOOTSTRAPPED = False
+RUNTIME_BUILD_INFO: dict = {}
+
+
+def bootstrap_once(force: bool = False) -> None:
+    """Load one validated, immutable runtime build as the knowledge source."""
+    global BOOTSTRAPPED, RUNTIME_BUILD_INFO
+    if BOOTSTRAPPED and not force:
+        return
+    ontology_path = CORPUS_MCKF_ONTOLOGY_PATH if CORPUS_MCKF_ONTOLOGY_PATH.exists() else MCKF_ONTOLOGY_PATH
+    manifest = _load_json(RUNTIME_BUILD_MANIFEST_PATH)
+    validation = _load_json(MCKF_VALIDATION_REPORT_PATH)
+    ontology = load_ontology(ontology_path)
+    if manifest:
+        expected_build = str(manifest.get("build_id", "") or "")
+        actual_build = str(ontology.get("build_id", "") or "")
+        if not expected_build or expected_build != actual_build:
+            raise RuntimeError("MCKF runtime build_id uyuşmazlığı: corpus ve manifest aynı pakete ait değil.")
+        expected_hash = str(
+            ((manifest.get("artifacts", {}) or {}).get(ontology_path.name, {}) or {}).get("sha256", "")
+        )
+        if expected_hash and file_sha256(ontology_path) != expected_hash:
+            raise RuntimeError("MCKF corpus dosya özeti manifest ile uyuşmuyor.")
+    if validation and validation.get("conforms") is not True:
+        raise RuntimeError("MCKF corpus doğrulama kapısından geçmedi; runtime başlatılmadı.")
+    init_clause_retrieval(ontology)
+    RUNTIME_BUILD_INFO = {
+        "build_id": ontology.get("build_id", "legacy-unversioned"),
+        "schema": ontology.get("schema", ""),
+        "manifest": bool(manifest),
+        "validation_conforms": validation.get("conforms") if validation else None,
+    }
+    BOOTSTRAPPED = True
+
+
+def reload_runtime() -> dict:
+    bootstrap_once(force=True)
+    return dict(RUNTIME_BUILD_INFO)
+
+
+def runtime_build_info() -> dict:
+    return dict(RUNTIME_BUILD_INFO)
+
+
+def _load_json(path) -> dict:
+    if not path.exists():
+        return {}
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except Exception:
+        return {}