Proyek Legalize-es yang mengelola hukum Spanyol sebagai repositori Git

 (github.com/EnriqueLop)
2 poin oleh GN⁺ 24 hari lalu | 1 komentar | Bagikan ke WhatsApp
  • Repositori yang mengelola lebih dari 8.600 undang-undang sejak 1960 yang dikumpulkan melalui API publik BOE milik pemerintah Spanyol dalam bentuk file Markdown
  • Setiap undang-undang disimpan bersama metadata YAML, dan seluruh riwayat revisi dilacak melalui commit Git
  • Mencakup seluruh kumpulan undang-undang terpadu tingkat nasional, termasuk konstitusi, undang-undang organik, undang-undang umum, dekret kerajaan berkekuatan hukum, dan lainnya, serta setiap commit mencatat tautan sumber resmi
  • Teks hukum disediakan sebagai domain publik, sementara repositori ini menambahkan struktur, kontrol versi, dan fitur perbandingan
  • Proyek ini akan terhubung dengan Legalize.dev API untuk mendukung fitur lanjutan seperti pencarian hukum, perbandingan versi, dan notifikasi perubahan

Gambaran umum

  • Proyek yang mengelola seluruh hukum Spanyol dalam bentuk repositori Git, dengan setiap undang-undang disusun sebagai file Markdown dan seluruh riwayat revisi dicatat sebagai commit
  • Mencakup lebih dari 8.600 undang-undang sejak 1960, dengan data yang diambil dari API publik BOE (Boletín Oficial del Estado) milik pemerintah Spanyol
  • Repositori ini merupakan bagian dari proyek Legalize, yang memungkinkan kontrol versi, perbandingan, dan pelacakan perubahan hukum
  • Teks hukum tersedia sebagai domain publik, dan repositori ini menyediakan struktur, metadata, dan fitur kontrol versi

Struktur file

  • Semua undang-undang disimpan sebagai file Markdown di bawah direktori spain/
    • Contoh: BOE-A-1978-31229.md adalah Konstitusi Spanyol, BOE-A-1995-25444.md adalah Kitab Undang-Undang Hukum Pidana, BOE-A-2015-11430.md adalah Statuta Pekerja, BOE-A-2000-323.md adalah Undang-Undang Acara Perdata
  • Setiap file diawali dengan metadata frontmatter berformat YAML
    • Mencakup item seperti titulo, identificador, pais, rango, fecha_publicacion, ultima_actualizacion, estado, fuente
    • Dalam contohnya, tercantum tanggal penerbitan konstitusi (Constitución Española), tanggal pembaruan terbaru, status (vigente), dan URL sumber resmi

Cakupan hukum yang disertakan

  • Mencakup seluruh undang-undang terpadu yang diklasifikasikan BOE pada tingkat nasional
    • Konstitusi, undang-undang organik (Leyes Orgánicas), undang-undang umum (Leyes ordinarias), dekret kerajaan berkekuatan hukum (Decretos-ley), dekret legislatif kerajaan (Reales Decretos Legislativos)
  • Setiap revisi disimpan sebagai commit terpisah, dan tanggal penulisan commit mencerminkan tanggal pengumuman resmi
  • Pesan commit mencakup identifikator revisi dan tautan sumber resmi

Contoh penggunaan

  • Setelah meng-clone repositori, pengguna dapat mencari pasal undang-undang tertentu atau memeriksa riwayat perubahannya
    • Contoh: mencari Pasal 135 Konstitusi dengan perintah grep
    • Memeriksa riwayat perubahan pasal tersebut dengan git log
    • Membandingkan perubahan spesifik dalam reformasi stabilitas fiskal tahun 2011 dengan git diff

Sumber data dan lisensi

  • Semua data diambil dari API legislasi terpadu BOE
  • Teks hukum merupakan domain publik, dan repositori ini hanya menambahkan struktur serta fitur kontrol versi
  • Struktur repositori, metadata, dan alat didistribusikan di bawah lisensi MIT

API dan rencana pengembangan

  • Legalize API akan segera tersedia di legalize.dev
    • Akan mendukung pencarian hukum, pemfilteran, perbandingan versi, dan notifikasi perubahan

Cara berkontribusi

  • Jika ada kesalahan pada teks terpadu atau revisi yang hilang, pengguna dapat membuka issue dengan menyertakan nama undang-undang, pasal, dan sumber resmi untuk mengusulkan perbaikan

Pembuat

  • Proyek ini dibuat oleh Enrique Lopez
  • Merupakan bagian dari proyek Legalize dan terhubung dengan legalize.dev

Bacaan terkait

1 komentar

 
GN⁺ 24 hari lalu
Komentar Hacker News

  • Di Prancis, hukum tidak hanya sekadar dikelola dengan version control, tetapi juga dibuktikan secara formal (formally proved)
    Melalui bahasa Catala, hukum diperlakukan seperti kode
    Edit: Ternyata cukup banyak orang Prancis juga ada di sini. Setidaknya lima orang membahas version control sambil mengutip Légifrance

    • Catala bukan alat untuk "membuktikan" hukum, melainkan bahasa yang menerjemahkan hukum ke bentuk yang dapat dihitung sambil mempertahankan struktur logikanya (default logic) apa adanya
      Saat mengimplementasikan logika perhitungan pajak atau tunjangan, ini memungkinkan verifikasi yang jauh lebih akurat apakah hasilnya benar-benar sesuai dengan hukum dibanding bahasa umum yang ada
    • Rasanya ironis melihat nama “Catala” muncul saat membahas hukum Spanyol
    • Dulu pernah ada diskusi sebelumnya tentang topik ini
    • “Borbaqui est la volonté du peuple!” — kelihatannya humor khas Prancis

  • Saya membuat pipeline yang mengubah seluruh peraturan nasional Spanyol menjadi repositori Markdown berversi
    Setiap hukum menjadi satu file, dan setiap amendemen dicatat sebagai git commit dengan tanggal aslinya. Total ada 8.642 hukum dan 27.866 commit
    Hukum pada akhirnya adalah ‘rangkaian patch’, jadi menurut saya git memang sudah merupakan solusinya. Daripada kalimat seperti “hapus ayat 3 dan…”, kita bisa melihat perubahan sebenarnya lewat diff
    Sumbernya memakai API consolidated legislation dari gazette resmi Spanyol (BOE), dan dibuat dalam sekitar 4 jam dengan Claude Code
    Saya sedang mengeksplorasi apakah data ini bisa dikembangkan menjadi API hukum atau platform open data

    • Maksud (intent) suatu hukum sering kali menjadi lebih jelas lewat putusan pengadilan, jadi akan sangat bernilai jika putusan bisa dilapiskan di atas pasal hukum secara kronologis
      Kita juga bisa menganalisis hukum mana yang paling sering dikutip, dan frasa mana yang berulang kali membutuhkan interpretasi
    • Saya penasaran dalam format apa gazette itu menyediakan hukum. Di Jerman katanya masih hanya PDF, jadi membuat iri
      Jika ada API resmi seperti di Spanyol, semuanya akan jauh lebih efisien, tetapi di Jerman bahkan ada lembaga swasta yang mengklaim hak cipta
    • Dalam sistem hukum Romawi-Napoleon, perubahan pada pasal bisa dilacak, tetapi interaksi antaruhukum tetap bergantung pada interpretasi hakim dan pengacara
      Di Inggris, misalnya, legislation.gov.uk memungkinkan pelacakan seluruh riwayat amendemen
    • Di Spanyol, consolidated legislation tidak mencakup semuanya, dan masalah sebenarnya adalah tidak adanya data putusan pengadilan
      Firma hukum besar punya basis data sendiri, sehingga sebagai layanan berbayar pasar ini kurang menarik
    • Kalau hukum pajak AS juga di-dump ke Markdown seperti ini, semua orang mungkin bisa membuat TurboTax versi mereka sendiri
      Lihat tautan hukum pajak IRS

  • Proyek seperti ini adalah arah yang sangat bagus untuk meningkatkan transparansi data hukum
    Ini bisa menjadi fondasi untuk menghubungkan AI agar dapat memahami dan menjelaskan hukum
    Semoga ada upaya serupa di negara lain

  • Akan lebih menarik jika penulis commit adalah politisi yang benar-benar bertanggung jawab atas amendemennya
    Jadi kita bisa langsung tahu siapa yang membuat hukum itu lewat git blame

    • Akan bagus juga jika ditambah konsep unit test
      Misalnya celah hukum dijadikan test case, lalu setiap kali hukum berubah dijalankan regression test untuk memastikan tidak ada masalah

  • Menurut saya ini ide yang sangat keren. Akan bagus jika sistem seperti ini diterapkan pada hukum di semua negara

    • Industri hukum sangat paham bahwa efisiensi seperti ini mengancam struktur pendapatan mereka
      Seperti kasus lobi untuk mempertahankan pelaporan pajak tetap rumit, profesi pengacara pun bisa saja menghalangi transparansi dan efisiensi
      Lihat artikel terkait
    • Organisasi nirlaba kami, Open Law Library, sedang membangun sistem seperti ini dengan bekerja langsung bersama pemerintah
      Negara bagian Maryland sudah menerapkannya di regs.maryland.gov,
      dan repositori GitHub juga dibuka untuk publik
      Kami membantu komunitas lokal menerbitkan hukum resmi mereka ke GitHub
    • Dokumen hukum gaya Inggris pada dasarnya juga disusun berbasis diff, jadi ini bukan teknik rahasia milik industri teknologi saja
    • Sangat setuju. Ini pekerjaan yang benar-benar luar biasa

  • Saya juga sedang mengerjakan hal serupa untuk rancangan undang-undang negara bagian California
    Saya rasa pendekatan seperti ini seharusnya menjadi cara standar. Saya selalu bertanya-tanya kenapa versi autentik dokumen seperti ini tidak ada di repositori git

    • Kalau sinis, mungkin pemerintah memang tidak ingin warganya memahami hukum sepenuhnya
      Kalau lebih dermawan, mungkin karena hampir tidak ada orang di bidang hukum yang paham atau mampu mengimplementasikan teknologi seperti ini

  • Proyek yang luar biasa. Sebagian besar hukum era Franco memang dicabut pada 1978, tetapi masih ada juga hukum dari sebelum abad ke-19
    Namun sumbernya dimulai dari 1960 sebagai satu commit, jadi tidak ada riwayat perubahan sebelum itu
    BOE bahkan telah memindai dokumen sampai abad ke-17, jadi tingkat pelestarian arsipnya mengagumkan

  • Keterbatasan Git adalah “git blame” tidak benar-benar bekerja
    Akan bagus jika kita bisa tahu siapa yang mendukung atau menolak, tetapi git bukan struktur commit kolaboratif

    • Mungkin bisa jika log commit menyertakan hasil pemungutan suara atau metadata
      Bagaimanapun, hanya dengan memasukkan seluruh hukum satu negara ke git saja sudah merupakan pencapaian besar
    • Git memang tidak dioptimalkan untuk commit kolaboratif, tetapi bisa dilengkapi dengan konvensi komunitas seperti “Co-Authored-By”
      Cara ini berasal dari pengembangan kernel Linux
    • Bisa juga seluruh parlemen dicatat sebagai penulis utama, lalu tiap partai dan hasil voting dimasukkan sebagai penulis bersama
    • Sebenarnya informasi seperti ini sudah terbuka, jadi LLM pun mungkin bisa menjawabnya. Ada juga candaan bahwa para nerd tidak perlu repot memakai git
    • Jika PR yang melibatkan banyak orang di-squash, itu bisa ditampilkan sebagai commit bersama, sehingga jejak kolaborasi tetap ada

  • Saya penulisnya (OP). Saya tidak menyangka responsnya akan sebesar ini
    Karena banyak permintaan, saya sudah membuka kodenya → GitHub: legalize-dev
    Pipeline ini dirancang dengan struktur dukungan multinegara. Prancis (data Légifrance) sudah berjalan,
    dan untuk menambahkan negara baru cukup mengimplementasikan 4 interface Python
    Saya juga sudah menulis panduan kontribusi
    Saya sudah menerima minat kontribusi dari Jerman, Portugal, Swedia, Finlandia, Belanda, Brasil, dan lainnya
    Jika Anda tahu sumber data hukum terbuka dari negara masing-masing, akan sangat membantu jika bisa ikut lewat PR
    Seiring proyek ini membesar, infrastrukturnya juga perlu berkembang, jadi saya sedang menyiapkan pendanaan lewat Open Collective
    Ada juga situs untuk melihat hukum dan diff secara real-time
    Masih belum stabil, tetapi visi besarnya sudah ada

  • Selamat! Proyek yang sangat keren
    Dulu pernah ada upaya serupa bernama gitlaw, dan di Brasil ada standar LexML yang mengekspresikan perubahan hukum secara teknis
    Pendekatannya cukup kompleks tetapi menarik

    • Ada yang bercanda, “XML lagi ya”. Spanyol juga sempat ikut LexML, tetapi sekarang tampaknya sudah beralih ke format lain