Pengaturan

Telegram Bot · Database Backend · Manajemen Data

Konfigurasi Telegram Bot

○ Belum dikonfigurasi

Cara Mendapatkan Token & Chat ID

Buka Telegram → cari @BotFather → kirim /newbot → ikuti instruksi → salin Bot Token

Tambahkan bot ke channel/grup sebagai Admin dengan izin kirim pesan

Kirim pesan ke channel → buka https://api.telegram.org/botTOKEN/getUpdates → salin chat.id

Isi form di bawah → klik Simpan & Test

Bot Token

Dari @BotFather — format: numberid:hash

Tambah Grup / Channel Tujuan

Untuk channel gunakan format @namaChannel atau chat ID negatif. Setiap grup ditambahkan akan langsung dites kirim pesan.

Grup Terhubung

Tentang Fitur Telegram

• Laporan dikirim dari halaman Dashboard menggunakan tombol Kirim Telegram

• Format pesan: rekap pencapaian harian per fase (Tilawah, Ziyadah, Murojaah)

• Pesan dapat difilter berdasarkan tanggal, angkatan, asrama, gender, dan fase

• Token tersimpan di hq_cfg di localStorage browser ini

Koneksi Database Backend (PostgreSQL)

○ Memeriksa...

📋 Cara Setup (lakukan sekali)

Pastikan PostgreSQL sudah berjalan di komputer Anda (buka pgAdmin 4 → pastikan server "PostgreSQL" hijau/connected)

Di pgAdmin 4: klik kanan Databases → Create → Database → ketik nama haqu_tracker → Save

Klik database haqu_tracker → Tools → Query Tool → buka file backend/schema.sql → jalankan (F5) untuk membuat semua tabel

Di folder backend/: salin file .env.example menjadi .env → isi password PostgreSQL Anda

Buka Command Prompt → masuk ke folder backend/ → jalankan: npm install lalu node server.js

Klik tombol Test Koneksi di bawah — jika muncul tanda ✅ hijau, backend siap!

URL Backend

Biarkan http://localhost:3000 jika backend berjalan di komputer yang sama

Cara Kerja Sistem Baru

• Database: Data tersimpan di PostgreSQL yang berjalan di komputer Anda — lebih andal dan bisa diakses banyak perangkat di jaringan yang sama

• Otomatis saat halaman dibuka: setiap halaman mengambil data terbaru dari PostgreSQL melalui backend server

• Otomatis saat simpan: setiap input setoran langsung dikirim ke PostgreSQL di background

• Offline fallback: jika backend tidak berjalan, app tetap bekerja dari localStorage browser

• Tabel database: santri, users, tl_log, hf_log, mr_log, kbm_config, master_config

Persyaratan

• Node.js versi 18 ke atas — unduh di nodejs.org

• PostgreSQL versi 13 ke atas — sudah terinstall jika Anda punya pgAdmin 4

• File backend/.env sudah diisi dengan password PostgreSQL yang benar

• backend/server.js harus berjalan terus selama menggunakan aplikasi (jangan tutup Command Prompt-nya)

Tanggal Libur Khusus

Tanggal yang ditambahkan di sini akan dianggap sebagai hari libur untuk semua fase KBM.

Pengaturan Santri Gelombang 2

Atur target dan posisi awal tilawah khusus untuk santri tertentu.

Santri

Gelombang

Mulai

Mulai Halaman

Target Per Hari

Keterangan

Santri Liburan

Atur target khusus untuk santri selama masa liburan.

Santri

Program

Mulai

Selesai

Target Liburan

Satuan Target

Keterangan

Daftar Entitas

Entitas digunakan sebagai afiliasi santri di seluruh aplikasi. Perubahan di sini berlaku segera.

Daftar Asrama

Asrama digunakan sebagai tempat tinggal santri. Perubahan di sini berlaku segera.

Daftar Angkatan

Angkatan santri digunakan sebagai filter dan pengelompokan. Perubahan di sini berlaku segera.

Sesi Aktif

Memuat info sesi...

Durasi Sesi & Timeout Tidak Aktif

Jika tidak ada aktivitas selama durasi ini, Anda akan otomatis logout. Durasi juga di-refresh setiap kali Anda berpindah halaman.

Durasi Sesi

Keluar

Logout akan menghapus sesi aktif. Anda perlu login kembali untuk mengakses aplikasi.