Falak

Masalahnya

Setiap tahun, orang Indonesia menunggu kapan Ramadan, Syawal, dan Dzulhijjah dimulai. Kadang organisasi yang berbeda mengumumkan tanggal yang berbeda. Mereka memakai kriteria hisab yang berbeda untuk menentukan apakah hilal, bulan sabit muda, sudah bisa terlihat. Sidang isbat pemerintah menggabungkan perhitungan dengan laporan rukyat, tapi masyarakat hanya mendengar keputusannya.

Aplikasi konversi tanggal Hijriah yang ada biasanya berupa tabel tanpa perhitungan astronomi, atau alat resmi yang memberi jawaban tanpa menunjukkan alasannya. Saya membangun Falak untuk umat Muslim yang ingin memeriksa sendiri tanggal dan jadwal salat, untuk pengajar ilmu falak di madrasah dan pesantren, dan untuk developer yang ingin melihat implementasi yang terbuka.

Yang saya bangun

Posisi matahari dan bulan saya hitung sendiri

Saya mengimplementasikan model standar yang sudah dipublikasikan untuk posisi matahari dan bulan, tanpa layanan astronomi dari luar. Mesinnya tidak butuh API key dan bisa jalan offline. Setiap angka yang tampil bisa ditelusuri ke sebuah rumus di repositori. Setiap jawaban, misalnya apakah hilal terlihat, kapan Magrib, atau ke mana arah kiblat, disertai panel berisi angka mentahnya: ketinggian, elongasi, umur bulan, dan selisih waktu terbenam.

Tiga metode berdampingan

Saya mengimplementasikan tiga kriteria visibilitas hilal yang bersaing: Wujudul Hilal, MABIMS-2021, dan Odeh. Masing-masing dihitung terpisah, dan riwayat kriteria di halaman Awal Bulan menunjukkan kapan ketiganya sepakat dan kapan berbeda. Aplikasi ini tidak mengumumkan tanggal; aplikasi ini menunjukkan hasil hitungan setiap metode untuk malam dan tempat tertentu. Peta Indonesia memeriksa 3.255 titik di seluruh negeri, dan pada malam tertentu garis visibilitas memotong Sumatra dan Jawa, sehingga tanggal yang sama bisa menjadi hari Hijriah yang berbeda tergantung di mana Anda berada.

Mesinnya saya validasi sebelum membangun tampilan

Rencana build saya punya satu aturan: tidak ada fitur perhitungan yang dirilis tanpa validasi. Sebelum mengerjakan antarmuka, saya mencocokkan mesin ini dengan ephemeris DE440 dari JPL, rujukan setingkat riset, untuk 50 peristiwa bulan baru di masa lalu. Semuanya cocok dalam selisih lima menit. Pustaka rujukan itu hanya dipakai saat tes, tidak pernah di aplikasi. Halaman Kalender membandingkan setiap metode dengan pengumuman Kemenag di masa lalu, yang diisi hanya dari catatan bersumber.

Seluruh aplikasi pindah ke browser

Versi pertamanya memakai backend Django. Setiap endpoint hanya berisi perhitungan murni, database-nya cuma menyimpan cache hasil, dan mesinnya hanya memakai matematika standar, jadi sebenarnya tidak perlu server. Saya memindahkan mesinnya ke TypeScript dan menerbitkan situs statis di GitHub Pages. Biaya hosting-nya nol, dan server yang mati tidak bisa merusaknya. Peta 3.255 titik kini dibagi ke paling banyak delapan thread latar, bukan berjalan di satu thread saja.

Mesin asli memeriksa versi port-nya

Dua salinan mesin kalender keagamaan pasti akan berbeda kalau tidak ada yang menjaganya. Saya mempertahankan mesin Python sebagai rujukan dan membekukan jawabannya untuk 2.083 kasus uji, mencakup setiap jenis perhitungan yang dilakukan aplikasi ini. Proses build memutar ulang semuanya lewat port TypeScript dan menahan deploy kalau ada yang tidak cocok. Untuk membuktikan suite ini menangkap penyimpangan, saya merusak port-nya sebagai uji coba dengan tiga cara, membalik satu ambang batas, koefisien bulan yang keliru, dan pergeseran kecil pada waktu sideris, dan ketiganya gagal di suite.

Hasilnya

Falak sudah live dan gratis, dengan biaya hosting $0, membandingkan 3 kriteria hisab lewat peta visibilitas 3.255 titik di seluruh Indonesia, semuanya di browser. Isinya konversi Hijriah, visibilitas hilal, jadwal salat dengan jadwal bulanan yang bisa dicetak, dan arah kiblat berikut Rashdul Qibla, di lima destinasi ditambah satu instrumen beranda. Fitur awalnya selesai dalam sekitar tiga hari pada Juli 2026; pemindahan ke browser dan desain ulang berbahasa Indonesia menyusul dalam bulan-bulan setelahnya. Penyapuan validasi di bulan September menangkap bug yang bisa memulai sebagian bulan sehari lebih awal di salah satu kriteria, ditemukan di 28 malam historis dan kini ditutup dengan tes regresi. Mesinnya masih cocok dengan semua 50 bulan baru historis yang dicocokkan dengan ephemeris JPL.