Configuration

Semua konfigurasi dilakukan melalui halaman Pengaturan di dashboard (/settings). Tidak perlu file .env untuk konfigurasi dasar, cukup buka browser dan atur dari sana.

Main Settings

Pengaturan	Keterangan
Username / Password	Akun Shollu yang digunakan untuk login
Event ID	ID event Shollu (default: `3`)
Mesin ID	ID mesin absensi (default: `12`)
Sumber Jadwal	`manual` (isi sendiri) atau `api` (otomatis dari Aladhan)
Metode Kalkulasi	Metode hisab untuk API Aladhan (default: `20` = Kemenag RI)
Zona Waktu	`Asia/Jakarta` (WIB), `Asia/Makassar` (WITA), `Asia/Jayapura` (WIT)
Delay Antar QR	Jeda (detik) antara pengiriman absen per QR code
Bot Aktif	Toggle untuk mengaktifkan/menonaktifkan seluruh scheduler

Prayer Times

Bot akan mengirim absen 5 menit setelah waktu sholat yang dikonfigurasi, sebagai safety margin agar portal Shollu sudah membuka sesi absen.

Waktu Sholat	Default
Subuh	04:35
Dzuhur	12:00
Ashar	15:15
Maghrib	18:00
Isya	19:15
Tarawih (Ramadan)	20:00

Environment Variables (Optional)

Buat file .env.local di root project jika ingin override pengaturan tertentu:

.env.local


# Override API key Shollu (opsional, default sudah tersedia)
SHOLLU_API_KEY=your_api_key_here

# Izinkan akses dari origin tertentu saat dev di balik reverse proxy
ALLOWED_DEV_ORIGINS=http://203.0.113.10,https://myapp.example.com

Security

Note

Bot ini dirancang untuk digunakan di server pribadi. Pastikan server Anda tidak dapat diakses publik secara sembarangan.

Kredensial Shollu (password) disimpan di database lokal dan tidak diekspos via API
Folder data/ (berisi database bot.db) sudah dikecualikan dari Git via .gitignore
Endpoint API dilindungi dengan autentikasi admin

Project Structure

- - page.js
- - db.js
  - attendance.js
  - scheduler.js
  - prayer-times.js
  - auth.js
  - admin-auth.js
  - theme.js
- instrumentation.js
- next.config.mjs
- package.json