MESA Data · v0.1.0
Genel Bakış
Bu rehberin Türkçe ve İngilizce sürümleri aynı konuyu açıklar. Bu sayfayla ilgili kaynak bölümleri en altta yer alır.
Bu belgenin kapsamı#
MESA Data, Türk hukuk kaynaklarını toplar, korur, ortak biçime dönüştürür ve doğrulayıp yayına hazırlar. Hazırlık ortamındaki başarı veya HTTP 202 yanıtı, verinin Core’a ulaştığını göstermez. Paket sürümü ile yayın etiketi de ayrı bilgilerdir.
Aşağıda özgün belgeyi, komutları ve varsa test kayıtlarını kendi dilinde okuyabilirsiniz. Sonuçlar yalnızca belgede belirtilen tarih ve koşullar için geçerlidir.
Kaynak belgedeki ilgili bölümler
Bu bölüm, kaynak belgenin bu sayfayla ilgili kısımlarını değiştirmeden gösterir. Kaynak içindeki bir bölüme giden bağlantıyı açtığınızda metin otomatik olarak görünür.
MESA Legal Data; resmî mevzuat, içtihat ve hukuki atıf verilerini otomatik toplayan, ham dosyaları değiştiremez biçimde saklayan, kanonikleştiren ve kalite kapılarından geçiren veri platformudur. Güvenli koşulları sağlayan sürümler otomatik onaylanabilir; istisnalar insan incelemesine gider. Gerçek MESA gönderimi yalnız insan başlatınca, otomatik oluşturulup doğrulanan immutable release paketinden yapılır. Yerel staging yalnız development aracıdır ve gerçek MESA değildir.
Katmanlı Mimari#
Resmî Kaynak (HTTPS / Manuel PDF)
├─ Manuel URL / Yerel Dosya (collect)
└─ Otomatik Keşif Kuyruğu (harvest discover → run)
↓
Ham Veri Deposu (raw/ — Değişmez Artifact + SHA-256 + Metadata)
↓
Ayrıştırma & Kanonikleştirme Pipeline'ı (parse → canonical JSONL)
↓
Kalite Kapıları + Gizlilik + Hukuki Metadata Doğrulaması
↓
Güvenli Otomatik Onay / İnsan İstisna İncelemesi
↓
Immutable Release (otomatik build → verify → frozen summary → insan onayı)
↓
Gerçek MESA Publisher (idempotent, yalnız COMMITTED başarı)
└─ Yerel Development Staging (ayrı, isteğe bağlı)Veri Dizin Yapısı (Workspace)#
Sistem tüm verilerini MESA_DATA_DATA_ROOT ortam değişkeninin gösterdiği dizinde saklar (Öncelik: Yapılandırılan MESA_DATA_DATA_ROOT → Varsayılan: /storage/mesa-legal-data/data → İzin hatasında yedek: ~/.mesa-data/data).
$DATA_ROOT/
raw/ # Değişmez ham artifact dosyaları (PDF, HTML)
canonical/ # Sürüm bazlı kanonik JSONL kayıtları
releases/ # Yayınlanan release paketleri (manifest.json + JSONL)
exports/ # Üretilen dışa aktarma dosyaları
backups/ # Katalog veritabanı yedekleri
harvest/ # Harvest veritabanı (harvest.sqlite) ve yedekleri
catalog.sqlite # Ana katalog veritabanıOtomatik Veri Toplama (Harvest)#
MESA Legal Data, tanımlı resmî kaynaklardan belge bağlantılarını keşfeden ve indirme kuyruğunu yöneten bir Harvest altsistemine sahiptir. Harvest, ana katalogdan bağımsız harvest.sqlite üzerinde çalışır.
Harvest Komutları#
uv run mesa-data harvest init
uv run mesa-data harvest config-check
uv run mesa-data harvest discover --source resmi_gazete
uv run mesa-data harvest status
uv run mesa-data harvest run --once --limit 25
uv run mesa-data harvest failures
uv run mesa-data harvest maintenanceGüvenlik & Politika#
- Keşif ve indirmeler yalnızca
config/sources.yamlveconfig/harvest.yamldosyalarında izin verilen resmi kaynaklarda çalışır. - İndirme işlemleri SSRF, MIME türü, boyut sınırı (~50 MB) ve hız sınırı denetimlerinden geçer.
- Yalnız sertifikalı kaynak/parser ve PASS kalite koşullarını sağlayan sürümler güvenli biçimde otomatik onaylanabilir; diğerleri insan incelemesine gider.
- MESA'ya gönderim hiçbir zaman otomatik başlamaz.
Web Yönetim Paneli (FastAPI + HTML/CSS/JS)#
MESA Legal Data, veri toplama, kalite/istisna incelemesi, immutable release ve insan başlatmalı gerçek MESA gönderimini yönetebileceğiniz web tabanlı bir arayüze sahiptir. Panel normal akışta kullanıcıdan release ID istemez; exact release ve manifest özetini otomatik hazırlar.
Web Panelini Başlatma#
uv run mesa-data web --host 127.0.0.1 --port 8765Tarayıcınızda http://127.0.0.1:8765 adresini açınız.
Güvenlik & Admin Token#
- Web paneli varsayılan olarak yalnızca yerel bilgisayardan (
127.0.0.1) erişilebilir durumdadır. - Sunucu dış ağa (
0.0.0.0) açılacağındaMESA_DATA_WEB_ADMIN_TOKENortam değişkeni zorunludur.
Hızlı Komut Akışı (CLI)#
1. Kurulum ve Başlatma#
# Bağımlılıkları yükleyin
uv sync --frozen
# Veri dizinlerini ve veritabanı şemasını hazırlayın
uv run mesa-data init
uv run mesa-data migrate2. Örnek Kullanım Akışı#
# A. Veri Ekleme (Manuel veya URL)
uv run mesa-data collect url \
--source mevzuat \
--url https://www.mevzuat.gov.tr/MevzuatMetin/1.5.2709.pdf \
--document-id tr:legislation:constitution:2709 \
--title "Türkiye Cumhuriyeti Anayasası"
# B. Pipeline Orkestrasyonu
uv run mesa-data pipeline run --artifact-id sha256:<ARTIFACT_HASH>
# C. İnceleme ve Onay
uv run mesa-data review list --status pending
uv run mesa-data review approve-version <VERSION_ID> --reviewer "[email protected]"
# D. Release Derleme ve Yayınlama
uv run mesa-data release build --release-id release-v1.0
uv run mesa-data release verify --release-id release-v1.0
uv run mesa-data release publish --release-id release-v1.0
# E. Yalnız geliştirme amaçlı yerel staging importu (gerçek MESA değildir)
uv run mesa-data release import --release-id release-v1.0
# F. İzlenebilirlik Sorgusu
uv run mesa-data provenance <RECORD_ID>3. Teşhis ve Sağlık Kontrolü#
# Sistem teşhisi ve bütünlük denetimi
uv run mesa-data doctor
# Raw artifact SHA-256 bütünlük kontrolü
uv run mesa-data audit
# Veritabanı yedeği alma
uv run mesa-data backupDokümantasyon#
- 🚀 **Hızlı Başlangıç Rehberi** — 5 dakikada kurulum ve ilk veri aktarımı.
- 📖 **Kullanım Kılavuzu** — Detaylı operasyon rehberi, Harvest altsistemi, arayüz tanıtımı ve CLI referansı.
- 📐 **MESA Import Sözleşmesi** — Staging DB aktarım kuralları ve veri modeli sözleşmesi.
- 🔒 **MVP Kapanış Raporu** — MVP freeze doğrulamaları ve TLS güvenlik mimarisi.
Sınırlar ve V2 Kapsamı#
Aşağıdaki özellikler MVP kapsamı dışında bırakılmış ve V2 sürümüne ertelenmiştir:
- Kayıt revizyon editörü (record revision UI)
- Web üzerinden kaynak yapılandırma editörü (
config/sources.yamlüzerinden yönetilir) - Otomatik sorun kapatma/waive mekanizması (sorunlar salt okunurdur)
- Çok kullanıcılı OAuth/OIDC yetkilendirmesi
