MESA Data · v0.1.0

Sorun Giderme

v0.1.0 kaynak: docs/SORUN_GIDERME.md

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.

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

Bu belge, MESA Legal Data kullanımı sırasında karşılaşabileceğiniz hata kodlarını ve çözüm yollarını içerir.


Veri Toplama Hataları#

HataSebepÇözüm
SOURCE_DISABLEDKaynak enabled: falseconfig/sources.yaml → ilgili kaynak → enabled: true yapın, sunucuyu yeniden başlatın
SOURCE_NOT_FOUNDSource ID sources.yaml'da tanımlı değilsources.yaml dosyasına kaynağı ekleyin
SOURCE_HOST_NOT_ALLOWEDURL alan adı allowed_hosts'ta yoksources.yaml → ilgili kaynak → allowed_hosts listesine alan adını ekleyin
SOURCE_CONTENT_TYPE_NOT_ALLOWEDDosyanın MIME türü izin listesinde yokallowed_content_types listesini kontrol edin; dosya formatını doğrulayın
SOURCE_FAMILY_NOT_ALLOWEDBelge ailesi bu kaynak için tanımlı değilfamilies listesini kontrol edin
FILE_TOO_LARGEDosya boyutu max_download_bytes sınırını aşıyorDaha küçük dosya kullanın veya sınırı artırın
URL scheme must be HTTPSHTTP kullanılmışURL'yi https:// ile başlatın
Access to private/local IP is forbiddenPrivate IP'ye erişim (SSRF koruması)Geçerli bir kamu IP'si olan URL kullanın
Non-standard port is forbidden443 dışı portStandart HTTPS portu (443) kullanın
Redirect loop detectedURL yönlendirme döngüsüne girdiURL'nin doğru olduğunu kontrol edin
Too many redirects3'ten fazla yönlendirmeNihai URL'yi doğrudan kullanın
HTTP connection failed after N retriesSunucu erişilemiyorİnternet bağlantınızı ve hedef sunucuyu kontrol edin
File is emptyBoş dosya yüklenmişGeçerli bir dosya yükleyin

Pipeline Hataları#

HataSebepÇözüm
TRANSPORT_VERIFICATION_FAILEDSHA-256 veya boyut uyuşmazlığıDosyayı yeniden yükleyin
PARSING_FAILEDDosya ayrıştırılamadıPDF/HTML formatını doğrulayın; bozuk dosya değilse yeniden yükleyin
SCHEMA_VALIDATION_FAILEDCanonical kayıt şema doğrulamasından geçemediKaynak dosyanın yapısını kontrol edin
Parsed text is emptyAyrıştırma sonucu boş metinDosyanın metin içerdiğini doğrulayın (taranmış PDF'ler OCR gerektirebilir)

Otomatik Veri Toplama (Harvest) Hataları#

HataSebepÇözüm
Harvest DB bulunamadıharvest.sqlite oluşturulmamışuv run mesa-data harvest init çalıştırın
retry_waitGeçici kaynak veya HTTP hatasıBackoff süresi dolunca runner otomatik yeniden dener
failedKalıcı pipeline hatası veya max attempt aşıldıuv run mesa-data harvest failures ile hata kodunu inceleyin
LOW_DISK_SPACESerbest disk alanı güvenlik eşiğinin altındaDisk alanı açmadan runner'ı başlatmayın
TARGET_REACHEDGlobal veya kaynak ham veri hedefi dolduNormal durdurma durumudur; hedefi artırabilir veya mevcudu işleyebilirsiniz
DISCOVERY_STRUCTURE_CHANGEDResmî kaynak sayfası beklenen formatta değilKaynak sayfasının yapısını kontrol edin; fail-closed kuralı gereği cursor ilerlemez
NO_PUBLICATIONO tarihte yayımlanmış resmî gazete/sayı yokNormal durumdur; sistem o günü tamamlandı sayıp sonraki tarihe geçer

İnceleme Hataları#

HataSebepÇözüm
Blocker issue engeliBlocker düzeyinde açık sorun varİlgili sorunun kaynağını çözün; gerekirse yeni dosya yükleyin
Kayıt pending değilZaten onaylanmış veya reddedilmiş kayıtYalnız pending kayıtlar onaylanabilir/reddedilebilir

Release Hataları#

HataSebepÇözüm
Release directory already existsAynı release ID ile daha önce build yapılmışFarklı bir release ID kullanın
Open blocker issues existÇözülmemiş blocker sorunlar varSorunlar ekranından blocker'ları tespit edip çözün
RELEASE_NOT_FOUNDRelease ID veritabanında yokDoğru release ID kullandığınızı kontrol edin
Cannot publish: must be 'verified'Henüz verify yapılmamışÖnce release verify çalıştırın
RELEASE_NOT_PUBLISHEDImport için release henüz yayınlanmamışÖnce release publish çalıştırın
RELEASE_REVOKEDİptal edilmiş release import edilmeye çalışılıyorYeni release oluşturun
RELEASE_STATE_CHANGEDImport sırasında release durumu değişmişİşlemi tekrar deneyin
already_imported (uyarı)Aynı release aynı manifest ile tekrar import edildiBu normal; veri tekrar yazılmaz
Manifest SHA-256 collisionAynı ID farklı manifestFarklı release ID kullanın

Kimlik Doğrulama ve Güvenlik#

HataSebepÇözüm
UNAUTHORIZEDAdmin token eksik veya yanlışMESA_DATA_WEB_ADMIN_TOKEN ortam değişkenini kontrol edin
NON_LOOPBACK_DISABLEDDış ağa açık ama token yokToken ayarlayın veya --host 127.0.0.1 kullanın
CSRF_HEADER_MISSINGYazma isteğinde gerekli header eksikTarayıcıdan normal kullanın; özel istemcide X-MESA-Requested-With: web-admin ekleyin
RATE_LIMIT_EXCEEDEDÇok fazla istek (dakikada 30 yazma / 300 okuma)Birkaç saniye bekleyip tekrar deneyin
AUTH_RATE_LIMIT_EXCEEDEDÇok fazla hatalı token denemesiToken'ı doğrulayıp bekleyin

Sistem Hataları#

HataSebepÇözüm
WRITE_LOCK_CONFLICTBaşka bir yazma işlemi çalışıyorÖnceki işlemin tamamlanmasını bekleyin
OPERATION_TYPE_NOT_SUPPORTEDDesteklenmeyen operation türüYalnız filtered_export, release_build, integrity_audit desteklenir
FILE_NOT_FOUNDDosya disk üzerinde bulunamadıuv run mesa-data doctor ile eksik dosyaları tespit edin
HASH_MISMATCHSHA-256 uyuşmazlığıuv run mesa-data audit çalıştırın; bozuk dosyayı tespit edip yedekten geri yükleyin
PATH_TRAVERSAL_DENIEDData root dışına erişim girişimiNormal kullanımda bu hata oluşmamalıdır; dosya yollarını kontrol edin
SYMLINK_REJECTEDSembolik bağlantı dosyaya erişimData root içinde symlink kullanmayın
Catalog database not foundcatalog.sqlite mevcut değiluv run mesa-data init ve uv run mesa-data migrate çalıştırın
No write permission to data rootData root'a yazma izni yokDizin izinlerini kontrol edin: chmod -R u+rw $DATA_ROOT
Backup file not foundGeri yükleme sırasında yedek dosya bulunamadıDosya yolunun doğru olduğunu kontrol edin

Genel ipuçları#

  1. Herhangi bir sorunla karşılaştığınızda önce uv run mesa-data doctor çalıştırın.
  2. Veritabanı sorunlarında uv run mesa-data backup ile yedek alın, ardından uv run mesa-data restore ile son çalışan yedeğe dönün.
  3. Hata mesajlarındaki büyük harfli kodları (örn. SOURCE_DISABLED) bu tabloda arayın.