Aplikasi web sederhana untuk mencatat kehadiran guru di sekolah. Bisa diakses dari HP, laptop, atau komputer. Gratis dan mudah digunakan!
🎯 Setup 5 Menit | 📱 Multi Device | ☁️ Internet Access | 💾 Siap Pakai
Absen Guru adalah sistem untuk mencatat kehadiran guru di sekolah. Aplikasi ini dibuat khusus untuk:
- 🏫 Sekolah kecil sampai menengah yang butuh sistem absensi digital
- 👩🏫 Guru dan staff yang ingin absen lebih mudah dan modern
- 👨💼 Admin sekolah yang perlu laporan kehadiran otomatis
- 💰 Sekolah dengan budget terbatas - aplikasi ini gratis selamanya!
- ✅ Guru bisa absen dari HP atau komputer
- ⏰ Otomatis catat jam masuk dan pulang
- 📊 Status lengkap: Hadir, Sakit, Izin, Terlambat, Dinas Luar
- 🗓️ Lihat riwayat absensi per hari/bulan
- 👨🏫 Daftar semua guru dengan data lengkap
- 🔐 Login terpisah untuk Admin dan Guru
- 📝 Update profile dan data pribadi
- 🏷️ Berbagai jabatan dan status kepegawaian
- 📈 Rekap absensi harian, mingguan, bulanan
- 📋 Export ke Excel untuk keperluan administrasi
- 💰 Laporan TPP (Tunjangan Penambahan Penghasilan)
- 📤 Download backup database
- 📲 Bisa di-install di HP/laptop seperti aplikasi native
- 🔄 Auto-update service worker setiap rilis baru
- 📦 Aset utama (CSS/JS/icon) tersimpan aman untuk akses tanpa internet
- 📰 Halaman penting tetap bisa dibuka meskipun koneksi terputus (menampilkan offline fallback)
- Download aplikasi
- Double-click file
setup-windows.bat - Tunggu sampai selesai (5-10 menit)
- Buka browser, ketik:
http://localhost:3000 - Login dengan: admin / admin123
- Download aplikasi
- Jalankan:
./setup-linux.sh - Tunggu sampai selesai
- Buka browser, ketik:
http://localhost:3000 - Login dengan: admin / admin123
Lihat panduan lengkap: 📖 FIRST_INSTALL.md
Aplikasi punya launcher yang akan tanya mau dijalankan gimana:
launcher.bat./launcher.shMenu yang tersedia:
- [1] Local Development - Testing (localhost:5174)
- [2] Local Network - Akses dari HP/laptop dalam WiFi sama
- [3] PM2 Local - Production lokal dengan auto-restart
- [4] PM2 Network - Production 24/7 dengan akses jaringan
- [5] Cloudflare Tunnel - Interactive mode (debugging)
- [6] PM2 + Cloudflare - Background service untuk internet access
- [7] Setup Database - Install database saja
- [8] Reset Database - Mulai dari nol
- [9] PM2 Management - Status, logs, restart services
📖 Detail lengkap: LAUNCHER.md
Dalam WiFi yang sama (HP/Laptop):
- Pilih opsi [2] atau [4] → dapat IP:
http://192.168.1.100:3000
Dari Internet (dimanapun):
- Pilih opsi [5] atau [6] → dapat URL:
https://xxx.trycloudflare.com - Atau setup domain kustom:
https://absen.sekolah.sch.id
📖 Detail: NETWORK_SETUP.md | docs/CLOUDFLARE_TUNNEL.md
- Buka aplikasi lewat Chrome/Edge/Firefox (Android) atau Safari (iOS)
- Saat banner “Install App” muncul → pilih Add to Home Screen / Install
- Jika banner tidak muncul, buka menu browser → pilih Install / Add to Home Screen
- Setelah terpasang, aplikasi bisa dibuka full-screen tanpa address bar
ℹ️ Saat internet terputus, aplikasi tetap bisa dibuka dan menampilkan halaman offline khusus dengan instruksi untuk sinkronisasi ulang.
Setelah install, login dengan:
| Role | Username | Password |
|---|---|---|
| Admin | admin |
admin123 |
| Guru | guru1 |
guru123 |
⚠️ PENTING: Ganti password default setelah login pertama!
Lupa password admin? Lihat: docs/ADMIN_PASSWORD_RECOVERY.md
- 📖 FIRST_INSTALL.md - Install step-by-step
- 🚀 LAUNCHER.md - Cara menggunakan launcher
- 🌐 NETWORK_SETUP.md - Akses dari jaringan
- ✅ PRODUCTION_READY.md - Deploy untuk produksi
- ✅ PRODUCTION_READY.md - Siapkan untuk produksi
- ☁️ docs/CLOUDFLARE_TUNNEL.md - Setup akses internet
- 🔐 docs/ADMIN_PASSWORD_RECOVERY.md - Reset password admin
🤔 Apakah aplikasi ini gratis?
Ya, selamanya gratis! Aplikasi ini open source dengan lisensi MIT. Tidak ada biaya langganan atau fitur berbayar.
📱 Bisa diakses dari HP?
Bisa! Pilih mode network di launcher, nanti dapat IP address yang bisa dibuka di browser HP dalam WiFi yang sama.
🌐 Perlu internet?
Tidak perlu internet untuk operasional harian. Data tersimpan di komputer lokal. Internet hanya perlu saat install pertama kali.
📴 Apa yang terjadi kalau koneksi internet mati?
Aplikasi punya service worker yang menyimpan aset utama untuk mode offline. Saat jaringan putus, halaman offline khusus akan muncul dengan instruksi refresh. Begitu koneksi kembali, data otomatis tersinkronisasi ulang.
💾 Bagaimana backup data?
Login sebagai admin → Pengaturan → Export Database. File backup akan terdownload ke komputer.
🔧 Bagaimana update aplikasi?
Download versi terbaru, backup data dulu, lalu install ulang. Data bisa di-import kembali.
⚠️ Server error/tidak bisa diakses?
- Buka launcher → pilih [9] PM2 Management → [5] Restart All
- Atau jalankan ulang launcher → pilih mode yang sama
- Untuk tunnel: cek docs/CLOUDFLARE_TUNNEL.md
☁️ Cara akses dari internet?
Quick (mudah): Launcher → [6] PM2 + Cloudflare → [1] Quick Tunnel Custom domain: Setup sekali → [6] PM2 + Cloudflare → [2] Named Tunnel Detail lengkap: docs/CLOUDFLARE_TUNNEL.md
- 📋 Laporan Bug: GitHub Issues
- 📖 Dokumentasi: Lihat file
*.mddi repository ini - 💡 Saran Fitur: Buat issue dengan label "enhancement"
- OS: Windows 10+, Ubuntu 18+, macOS 10.15+
- RAM: 512MB available
- Storage: 100MB free space
- Node.js: v22+ (auto-install via launcher)
- Package Manager: pnpm (sudah termasuk di setup)
MIT License - Lihat LICENSE untuk detail lengkap.
Made with ❤️ for Indonesian Schools
⭐ Kalau aplikasi ini berguna, jangan lupa kasih star di GitHub!
