İspanya yasalarını Git deposu olarak yöneten Legalize-es projesi

 (github.com/EnriqueLop)
2 puan yazan GN⁺ 2026-03-29 | 1 yorum | WhatsApp'ta paylaş
  • İspanya hükümetinin BOE açık API'si üzerinden toplanan, 1960'tan bu yana 8.600'den fazla yasayı Markdown dosyaları olarak yöneten depo
  • Her yasa, YAML meta verisi ile birlikte saklanır ve tüm değişiklik geçmişi Git commit'leriyle izlenir
  • Anayasa, organik yasalar, olağan yasalar, kanun hükmünde kraliyet kararnameleri gibi ulusal düzeydeki tüm konsolide mevzuatı içerir ve her commit'te resmî kaynak bağlantısı kaydedilir
  • Yasa metinleri kamu malı olarak sunulur; depo ise buna ek olarak yapılandırma, sürüm yönetimi ve karşılaştırma özellikleri sağlar
  • Projenin, Legalize.dev API ile entegre olarak mevzuat arama, sürüm karşılaştırma, değişiklik bildirimi gibi genişletilmiş özellikleri desteklemesi planlanıyor

Genel bakış

  • İspanya'daki tüm yasaları Git deposu biçiminde yöneten bir proje; her yasa bir Markdown dosyası olarak tutulur ve tüm değişiklik geçmişi commit'lerle kaydedilir
  • 1960'tan bu yana 8.600'den fazla yasa içerir ve veriler İspanya hükümetinin BOE (Boletín Oficial del Estado) açık API'sinden alınır
  • Bu depo, Legalize projesinin bir parçasıdır ve mevzuatın sürüm yönetimi, karşılaştırılması ve izlenmesini mümkün kılar
  • Yasa metinleri kamu malı olarak sunulur; depo ise yapılandırma, meta veri ve sürüm yönetimi özellikleri sağlar

Dosya yapısı

  • Tüm yasalar spain/ dizini altında Markdown dosyaları olarak saklanır
    • Örn: BOE-A-1978-31229.md İspanya Anayasası, BOE-A-1995-25444.md Ceza Kanunu, BOE-A-2015-11430.md İşçi Tüzüğü, BOE-A-2000-323.md ise Hukuk Muhakemeleri Kanunu
  • Her dosya, YAML biçiminde frontmatter meta verisi ile başlar
    • titulo, identificador, pais, rango, fecha_publicacion, ultima_actualizacion, estado, fuente gibi alanları içerir
    • Örnekte anayasa (Constitución Española) için yayımlanma tarihi, son güncelleme tarihi, durum (vigente) ve resmî kaynak URL'si belirtilir

Kapsanan mevzuat

  • BOE'de ulusal düzeyde sınıflandırılmış tüm konsolide mevzuatı içerir
    • Anayasa, organik yasalar (Leyes Orgánicas), olağan yasalar (Leyes ordinarias), kanun hükmünde kararnameler (Decretos-ley), yasama amaçlı kraliyet kararnameleri (Reales Decretos Legislativos)
  • Her değişiklik bağımsız bir commit olarak kaydedilir ve commit tarihi resmî yayımlanma tarihini yansıtır
  • Commit mesajlarında değişiklik tanımlayıcısı ve resmî kaynak bağlantısı bulunur

Kullanım örnekleri

  • Depoyu klonladıktan sonra belirli yasa maddelerini aramak veya değişiklik geçmişini incelemek mümkündür
    • Örn: anayasanın 135. maddesini grep komutuyla arama
    • İlgili maddenin değişiklik geçmişini git log ile inceleme
    • 2011 tarihli mali istikrar reformundaki somut değişiklikleri git diff ile karşılaştırma

Veri kaynağı ve lisans

  • Tüm veriler BOE'nin konsolide mevzuat API'sinden alınır
  • Yasa metinleri kamu malıdır; depo ise yalnızca yapılandırma ve sürüm yönetimi işlevleri ekler
  • Depo yapısı, meta veri ve araçlar MIT lisansı ile dağıtılır

API ve genişleme planları

  • Legalize API yakında legalize.dev adresinde sunulacak
    • Mevzuat arama, filtreleme, sürüm karşılaştırma ve değişiklik bildirimi özelliklerini desteklemesi planlanıyor

Katkı yöntemi

  • Konsolide metinlerde hata veya eksik değişiklikler varsa, yasa adı, madde ve resmî kaynakla birlikte bir issue açarak düzeltme önerilebilir

Hazırlayan

  • Proje Enrique Lopez tarafından geliştirildi
  • legalize.dev ile bağlantılı Legalize projesinin bir parçasıdır

İlgili okumalar

1 yorum

 
GN⁺ 2026-03-29
Hacker News görüşleri

  • Fransa'da yasalar yalnızca sürüm kontrolüne alınmakla kalmıyor, aynı zamanda biçimsel olarak da kanıtlanıyor (formally proved)
    Catala dili aracılığıyla yasalar kod gibi ele alınıyor
    Düzenleme: Fransız ekipten burada da epey kişi var. En az beş kişi Légifrance'ı anarak sürüm kontrolünden söz ediyor

    • Catala, hukuku “kanıtlayan” bir araç değil; yasaların mantıksal yapısını (default logic) olduğu gibi ifade edip hesaplanabilir bir biçime çeviren bir dil
      Vergi ya da sosyal yardım hesaplama mantığını uygularken, mevcut genel amaçlı dillere kıyasla bunun gerçek yasayla ne kadar örtüştüğünü çok daha doğru doğrulamayı sağlıyor
    • İspanyol hukukundan bahsedilirken “Catala” adının geçmesi bana ironik geldi
    • Bu konuda daha önce yapılmış bir önceki tartışma vardı
    • “Borbaqui est la volonté du peuple!” — Fransız usulü bir mizah gibi görünüyor

  • İspanya'nın tüm ulusal mevzuatını sürüm kontrollü bir Markdown deposuna dönüştüren bir pipeline oluşturdum
    Her yasa tek bir dosya ve her değişiklik gerçek tarih içeren bir git commit'i olarak kaydediliyor. Toplam 8.642 yasa ve 27.866 commit var
    Sonuçta hukuk bir “yama dizisi” olduğundan git'in zaten çözüm olduğunu düşünüyorum. “3. fıkrayı sil ve...” gibi cümleler yerine değişiklik geçmişini gerçek diff olarak görebiliyorsunuz
    Kaynak olarak İspanya Resmî Gazetesi'nin (BOE) birleştirilmiş mevzuat API'sini kullandım ve bunu Claude Code ile yaklaşık 4 saatte kurdum
    Şimdi bu veriyi temel alarak bunun bir hukuk API'sine ya da açık veri platformuna dönüşüp dönüşemeyeceğini araştırıyorum

    • Hukukun niyeti (intent) çoğu zaman içtihatla netleştiği için, yasa maddelerinin üzerine karar metinlerini zaman sırasıyla bindirmek çok değerli olabilir
      Hangi yasaların en sık atıf aldığını ve hangi ifadelerin tekrar tekrar yoruma ihtiyaç duyduğunu da analiz etmek mümkün olur
    • Resmî gazetenin yasaları hangi formatta sunduğunu merak ettim. Almanya'da hâlâ yalnızca PDF varmış; buna imrenildiği söyleniyor
      İspanya'daki gibi resmî bir API olsa çok daha verimli olurdu, ama Almanya'da özel kurumlar telif hakkı bile iddia ediyor
    • Roma-Napolyon hukuk sisteminde madde değişiklikleri izlenebilir, ama yasalar arası etkileşim hâlâ hâkim ve avukatların yorumuna bağlı
      Birleşik Krallık'ta ise legislation.gov.uk üzerinden tüm değişiklik geçmişi takip edilebiliyor
    • İspanya'da birleştirilmiş mevzuat her şeyi kapsamıyor ve asıl sorun karar metni verisinin yokluğu
      Büyük hukuk bürolarının kendi veritabanları olduğundan bunun ücretli hizmet olarak pazar değeri de düşük
    • ABD vergi kanunları da böyle Markdown olarak dump edilse, herkes kendi TurboTax'ini yapabilir gibi geliyor
      IRS vergi mevzuatı bağlantısı

  • Bu tür projeler hukuk verisinin şeffaflığını artırmak için harika bir yön
    Yapay zekanın hukuku anlayıp açıklayabilmesine bağlanan bir temel oluşturabilir
    Diğer ülkelerde de benzer girişimlerin ortaya çıkmasını umuyorum

  • Commit'in yazarı gerçekten değişiklikten sorumlu siyasetçi olsaydı daha da ilginç olurdu
    Böylece git blame ile o yasayı kimin yaptığını doğrudan görebilirdiniz

    • Buna bir de unit test kavramı eklemek güzel olurdu
      Boşlukları test case olarak koyup, yasa her değiştiğinde regresyon testi çalıştırarak sorun çıkıp çıkmadığını kontrol etmek gibi

  • Bence gerçekten harika bir fikir. Böyle bir sistem tüm ülkelerin yasalarına uygulanabilse keşke

    • Hukuk sektörü, bu tür verimlilik artışlarının kendi gelir modelini tehdit ettiğinin gayet farkında
      Vergi beyanını zor tutmak için lobi yapan örneklerde olduğu gibi, avukatlık sektörü de şeffaflığı ve verimliliği engellemeye çalışabilir
      İlgili haber
    • Bizim kâr amacı gütmeyen kuruluşumuz Open Law Library, hükümetlerle doğrudan çalışarak bu tür sistemler kuruyor
      Maryland eyaleti bunu regs.maryland.gov üzerinde zaten uygulamaya aldı ve
      GitHub deposu da açık durumda
      Her bölgenin kendi topluluğunun resmî hukuku GitHub'da yayımlamasına yardımcı oluyoruz
    • İngiliz tarzı hukuk belgeleri de temelde diff tabanlı yazılır; bu sadece teknoloji dünyasına özgü gizli bir teknik değil
    • Kesinlikle katılıyorum. Gerçekten mükemmel bir çalışma

  • Ben de Kaliforniya eyaletindeki yasa tasarıları için benzer bir şey geliştiriyorum
    Bu yaklaşımın standart yöntem olması gerektiğini düşünüyorum. Bu tür belgelerin asıllarının neden bir git deposunda olmadığını hep merak etmişimdir

    • Alaycı bir bakışla, hükümet halkın yasaları tamamen anlamasını istemiyor olabilir
      Daha cömert bir yorum ise hukuk alanında bu teknolojiyi anlayan ya da uygulayabilecek çok az insan olması olabilir

  • Harika bir proje. Franco dönemi yasalarının çoğu 1978'de yürürlükten kalktı, ama burada hâlâ 19. yüzyıl öncesi yasalar da yer alıyor
    Ancak kaynak, 1960'tan itibaren tek bir commit ile başlıyor; dolayısıyla ondan önceki değişiklik geçmişi yok
    BOE'nin 1600'lere kadar uzanan belgeleri taramış olması, arşiv koruma düzeyinin ne kadar etkileyici olduğunu gösteriyor

  • Git'in sınırlaması şu: “git blame” gerçekten çalışmıyor
    Kimin lehte ya da aleyhte oy verdiğini bilmek güzel olurdu, ama git işbirlikçi commit yapısına sahip değil

    • Commit log'una oy sonuçları ya da metadata eklenirse mümkün olabilir
      Her hâlükârda bütün bir ülkenin hukukunu git'e koymuş olmak başlı başına büyük bir başarı
    • Git işbirlikçi commit'ler için optimize edilmemiş olsa da, “Co-Authored-By” gibi topluluk teamülleri ile bu eksik kapatılabilir
      Bu yöntem Linux kernel geliştirmesinden geliyor
    • Ana yazar olarak tüm parlamentoyu gösterip, her partiyi ve oy sonuçlarını ortak yazar olarak eklemek de mümkün olabilir
    • Aslında bu bilgiler zaten kamuya açık; LLM de yanıt verebilir. İlla nerd'lerin git kullanmasına gerek yok diye şaka yapanlar da var
    • Birden fazla kişinin katkı verdiği PR'ları squash ederseniz ortak commit olarak görünür ve işbirliği izini bırakabilirsiniz

  • Yazar (OP) benim. Bunun bu kadar büyük ilgi göreceğini beklemiyordum
    Çok istek geldiği için kodu yayımladım → GitHub: legalize-dev
    Pipeline, çok ülkeli destek yapısıyla tasarlandı. Fransa (Légifrance verisi) zaten çalışıyor ve
    yeni bir ülke eklemek için yalnızca 4 Python arayüzünü uygulamak yeterli
    Katkı rehberi de yazdım
    Almanya, Portekiz, İsveç, Finlandiya, Hollanda, Brezilya gibi ülkelerden katkı ilgisi aldım
    Ülkelerin açık hukuk verisi kaynaklarını biliyorsanız PR göndererek yardımcı olmanız harika olur
    Ölçek büyüdükçe altyapı gerekeceği için Open Collective üzerinden fon hazırlıyorum
    Yasaları ve diff'leri gerçek zamanlı görebileceğiniz bir site de var
    Şimdilik kararsız ama büyük resmi hedefliyorum

  • Tebrikler! Gerçekten harika bir proje
    Daha önce benzer bir girişim olarak gitlaw vardı; Brezilya'da ise hukuk değişikliklerini teknik olarak ifade eden LexML standardı bulunuyor
    Oldukça karmaşık ama ilginç bir yaklaşım

    • “Yine mi XML” diye şaka yapıyor. İspanya da bir zamanlar LexML'ye katılmıştı ama şimdi başka bir formata geçmiş gibi görünüyor