| ---
|
| 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.
|
|
|
