MESA Data · v0.1.0
İçe Aktarma Sözleşmesi
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.
1. Overview#
This document specifies the strict contract for importing release packages from mesa-legal-data into the MESA Staging Database.
2. Release Directory Structure#
data/releases/{release_id}/
├── release.json
├── manifest.json
├── data/
│ ├── legislation.jsonl
│ ├── articles.jsonl
│ ├── decisions.jsonl
│ └── citations.jsonl
└── schemas/
├── legislation.schema.json
├── article.schema.json
├── decision.schema.json
├── citation.schema.json
└── release.schema.json3. Pre-Import Verification Rules#
- Release status in catalog MUST be
publishedorverified. - The release package MUST contain a valid
manifest.json. - All bundled files MUST match their SHA-256 digest in
manifest.json. - Every JSONL record MUST pass Draft 2020-12 JSON Schema validation.
- Folder name MUST match
release_idinrelease.json.
4. MESA Staging Database Schema#
CREATE TABLE IF NOT EXISTS imported_releases (
release_id TEXT PRIMARY KEY,
manifest_sha256 TEXT NOT NULL,
imported_at TEXT NOT NULL,
status TEXT NOT NULL
);
CREATE TABLE IF NOT EXISTS staging_records (
release_id TEXT NOT NULL,
record_id TEXT NOT NULL,
record_type TEXT NOT NULL,
record_sha256 TEXT NOT NULL,
payload_json TEXT NOT NULL,
PRIMARY KEY (release_id, record_id),
FOREIGN KEY (release_id) REFERENCES imported_releases(release_id)
);
CREATE TABLE IF NOT EXISTS active_release (
singleton_id INTEGER PRIMARY KEY CHECK (singleton_id = 1),
release_id TEXT,
activated_at TEXT
);5. Idempotent Import Rules#
- Importing the same
release_idwith identicalmanifest_sha256MUST returnstatus: "already_imported"without raising errors or duplicating rows. - Importing the same
release_idwith a differentmanifest_sha256MUST fail with anImportRollbackErrordue to manifest collision. - Staging DB insertions MUST execute inside a single atomic transaction. Any error causes a full
ROLLBACK.
6. Rollback & Provenance Protocol#
- Active release pointer is tracked in
active_release(singleton rowsingleton_id = 1). mesa-data release rollback --release-id TARGET_IDswitches the active release pointer to a previously imported target release.- Provenance can be traced end-to-end via
mesa-data provenance RECORD_IDback to the raw artifact SHA-256 and source URL.
