Faraid Visualizer

Masalahnya

Pembagian warisan menurut hukum Islam (faraid) sering memicu sengketa keluarga di Indonesia. Hanya sedikit orang di luar kalangan santri dan ulama yang bisa menghitungnya sendiri. Kalkulator online yang ada terlalu menyederhanakan, diam-diam memilih satu mazhab, atau hanya mengeluarkan angka tanpa langkah hitungnya. Orang lebih mudah menerima hasil yang alasannya bisa mereka ikuti.

Di bawahnya ada masalah kedua. Kompilasi Hukum Islam (KHI, Inpres No. 1/1991) dan fikih Syafi'i klasik berbeda di beberapa titik yang mengubah hasil. Di antaranya ahli waris pengganti (KHI Pasal 185), ke mana sisa harta pergi kalau tidak ada lagi ahli waris yang berhak, dan pemotongan harta bersama sebelum harta warisan dibagi. Kebanyakan kalkulator mencampuradukkan keduanya.

Yang saya bangun

Setiap bagian menunjuk ke sumbernya

Saya menulis mesin hitungnya sebagai paket Python mandiri tanpa dependensi dari luar. Setiap hasil mencatat ahli waris, bagiannya, aturan yang dipakai, dan sumber aturan itu. Daftar rujukan saya susun sebelum logika apa pun: 35 sumber, termasuk 14 pasal KHI, rujukan kitab klasik, ayat Al-Qur'an, dan hadis. Al-Qur'an dan hadis disimpan sebagai rujukan, tidak pernah sebagai kutipan teks. Aturan tanpa sumber akan gagal di tes dan tidak bisa dirilis.

KHI dan Syafi'i adalah dua aturan terpisah

Saya memodelkan setiap mazhab sebagai aturan tersendiri, dengan pilihan dan rujukannya masing-masing. Keluarga yang sama bisa dihitung dengan keduanya secara berdampingan, jadi pengguna melihat persis di mana hasilnya berbeda. Misalnya, cucu dari anak yang meninggal lebih dulu mendapat warisan menurut KHI, tapi tidak menurut Syafi'i klasik. Aturan Hanafi, Maliki, dan Hanbali juga tersedia, dengan label Beta.

Kalau kasusnya belum tercakup, mesin mengatakannya

Beberapa susunan keluarga punya sub-kasus yang rumit, seperti sebagian kasus kakek bersama saudara, yang belum dicakup mesin. Di situ mesin berhenti dan menampilkan "susunan ini belum didukung". Mesin tidak pernah menebak dengan kasus yang paling mirip. Halaman menampilkannya sebagai jawaban biasa, dan situs ini menyatakan bahwa hasilnya bersifat edukatif, bukan putusan hukum. Pembulatan juga ditampilkan. Jumlah bagian bisa selisih satu sen dari harta warisan, dan memindahkan satu sen itu adalah keputusan fikih, jadi selisihnya ditunjukkan.

Mesin Python yang sama berjalan di browser

Versi pertamanya berupa situs Django dengan database. Data warisan termasuk data paling pribadi, jadi saya pindah ke situs statis yang tidak pernah menerimanya. Browser mengunduh runtime Python dan menjalankan paket yang sama dengan yang dipakai server. Tidak ada data yang keluar dari perangkat. Sebuah kasus bisa dibagikan karena seluruh isinya disimpan di tautan. Pemuatan pertama makan waktu sekitar 20 detik, jadi formulir sudah bisa diisi sementara mesin dimuat di latar. Sebuah pembaruan belakangan menambahkan pemilih pohon keluarga terpandu untuk mode Personal, menggambar hubungan di sekitar orang yang meninggal, bukan mengisi formulir, tapi mengirim data yang persis sama ke mesin.

Tes menentukan boleh rilis atau tidak

Proses deploy menjalankan bank validasi dan tes API. Proses itu juga memastikan tidak ada panggilan model AI di kode perhitungan, dan bahwa situs hasil build memuat mesinnya. Satu kegagalan saja menahan rilis. Setiap aturan baru masuk bersama sumber dan tesnya dalam perubahan yang sama.

Hasilnya

Faraid Visualizer sudah live dan gratis di GitHub Pages, tanpa backend dan tanpa akun. Aplikasi ini menunjukkan siapa yang terhalang dan oleh siapa, setiap bagian pasti, bagaimana sisa harta dibagi, dan setiap rujukannya, dalam bentuk teks dan diagram. KHI dan Syafi'i klasik lolos semua 61 contoh soal di bank validasi, ditambah satu set kasus terpisah tempat kedua mazhab berbeda pendapat. Mode Profesional mengekspor PDF lengkap dengan jejak rujukannya, dalam bahasa Indonesia atau Inggris, untuk notaris dan staf pengadilan agama. Saya membangunnya sendiri dalam dua tahap: mesin, perpindahan ke situs statis, dan ekspor PDF pada Juli hingga awal Agustus 2026. Pembaruan berikutnya pada September menambahkan pemilih pohon keluarga terpandu dan mendesain ulang tampilan derivasinya.