Shollu Bot
Bot absensi sholat otomatis untuk platform tracker sholat Shollu.com . Absen sholat 5 waktu + Tarawih secara otomatis tanpa perlu interaksi scan setiap waktu sholat.
Key Features
- Absen Otomatis Scheduler berbasis cron yang mengirim absensi tepat waktu untuk semua QR code yang terdaftar
- Multi QR Code Dukung banyak anggota/jamaah sekaligus dalam satu instance
- Jadwal Sholat Otomatis Pilih sumber waktu sholat: manual atau otomatis via API Aladhan
- Dukungan Tarawih Absen Tarawih via endpoint terpisah, bisa diaktifkan saat Ramadan
- Dashboard Web Antarmuka modern berbasis Next.js untuk monitoring dan konfigurasi
- Statistik Kehadiran Lacak streak, persentase kehadiran, dan riwayat per waktu sholat
- Export / Import Data Backup dan restore seluruh data (QR code, riwayat, pengaturan)
- Zona Waktu Fleksibel Mendukung WIB, WITA, dan WIT
- Auto Retry Login Otomatis re-login jika token kedaluwarsa saat mengirim absen
Background
Pada puasa Ramadhan 1447 Hijriah 2026 Masehi, Sekolah saya dan seluruh SMA/SMK sederajat mengadakan kegiatan Pesantren Ramadhan. Pada kegiatan tahun ini, Dinas Pendidikan Sumatera Barat bekerja sama dengan Shollu.com untuk memantau kegiatan sholat wajib serta Tarawih para murid menggunakan sebuah platform digital yaitu Shollu.com . Systemnya, Panitia didaftarkan pada setiap Masjid. Panitia dapat berupa Guru atau Pengurus Masjid. Masing-masing murid mendapatkan QR-code tersendiri yang nantinya akan di scan oleh Panitia ketika jam sholat telah usai. Dengan begitu, absen sholat murid akan otomatis masuk dan dapat di track di website Shollu.
Disini, saya melihat celah pada program ini. Saya mendapatkan informasi bahwa siapapun bisa mendaftar menjadi Panitia melalui website Shollu . Setelah mendapatkan celah ini, saya kemudian memulai projek ini dengan tujuan awal untuk pemakaian pribadi. Saya menggunakannya supaya saya tidak perlu capek-capek keliling mesjid untuk mencari Panitia untuk absen sholat. Dengan ini, saya bisa sholat dan langsung pulang tanpa perlu memikirkan absen sholat, karena absen sholat saya sudah di absenkan secara otomatis. Namun, seiring berjalannya waktu saya memutuskan untuk merilis projek ini untuk publik beserta source-code nya.
Shollu Bot tidak bertanggung jawab atas manipulasi data atau penyalahgunaan bot ini. Laksanakanlah sholat sesuai yang kamu atur di bot ini.
Dashboard View
Dashboard menampilkan
- Waktu sholat berikutnya + tombol Absen Sekarang
- Streak hari berturut-turut & persentase kehadiran 7 hari terakhir
- Jadwal sholat lengkap hari ini dengan status absensi
- Halaman Logs untuk melihat riwayat pengiriman absen
- Halaman Pengaturan untuk konfigurasi akun, jadwal, dan QR code
Tech Stack
| Komponen | Teknologi |
|---|---|
| Framework | Next.js 16 (App Router) |
| UI | MUI (Material UI) v7 + Emotion |
| Database | better-sqlite3 (SQLite) |
| Scheduler | node-cron |
| Package Manager | Bun |
| Runtime | Node.js |