Membuat Sistem Poin Tata Tertib Siswa di Google Apps Script: Hitung Poin Aman, Tingkat Pembinaan, dan Akses Orang Tua
Hampir semua sekolah menengah di Indonesia punya buku poin tata tertib. Masalahnya bukan aturannya, tapi pencatatannya: guru piket menulis di buku, wali kelas punya catatan sendiri, dan BK baru tahu seorang siswa bermasalah setelah poinnya menumpuk. Orang tua? Biasanya baru tahu saat dipanggil.
Aplikasi poin berbasis Google Apps Script bisa menyelesaikan ini tanpa biaya server. Berikut lima teknik inti yang membuatnya aman dan tidak merepotkan.
1. Jangan simpan kolom "total poin"
Godaan pertama adalah membuat kolom Total Poin di sheet Siswa lalu menambah-kurangi isinya. Jangan. Begitu ada satu catatan yang dibatalkan atau diubah, total itu langsung melenceng dan tidak ada cara memverifikasinya.
Simpan hanya kejadiannya, lalu hitung ulang saat dibaca:
function hitungPoin_(nis, catatan) {
var p = 0, q = 0, n = 0;
catatan.forEach(function (c) {
if (c.nis !== nis || c.status !== 'Aktif') return;
n++;
if (c.jenis === 'Prestasi') q += c.poin; else p += c.poin;
});
return { pelanggaran: p, prestasi: q, total: Math.max(0, p - q), jumlah: n };
}
Karena total selalu diturunkan dari riwayat, membatalkan satu catatan otomatis mengembalikan poin siswa. Tidak perlu kode khusus untuk "koreksi".
Kolom Status pada catatan punya tiga nilai: Aktif, Dibatalkan, dan Arsip. Yang dihitung hanya Aktif, tetapi Arsip tetap tampil di riwayat orang tua dengan label "semester lalu".
2. Poin diambil dari sheet, bukan dari browser
Panel guru hanya mengirim NIS dan kode aturan. Nilai poinnya dicari server sendiri, jadi tidak ada gunanya mengubah angka lewat DevTools:
function catat(token, nis, kode, keterangan) {
var g = cekPetugas_(token);
var s = bacaSiswa_().filter(function (x) { return x.nis === String(nis || '').trim(); })[0];
if (!s) throw new Error('Siswa tidak ditemukan.');
if (s.status !== 'Aktif') throw new Error(s.nama + ' berstatus ' + s.status + ', tidak bisa dicatat.');
var a = bacaAturan_().filter(function (x) { return x.kode === String(kode || '').toUpperCase(); })[0];
if (!a) throw new Error('Jenis pelanggaran/prestasi tidak ditemukan atau sudah tidak aktif.');
// ... simpan a.jenis dan a.poin, bukan nilai dari browser
}
Perhatikan juga bacaAturan_() tanpa argumen hanya mengembalikan aturan yang aktif. Begitu sekolah menonaktifkan satu jenis pelanggaran, guru langsung tidak bisa memakainya lagi, tanpa menghapus riwayat lama.
Satu masalah khas di lapangan: guru menekan tombol dua kali, atau dua guru mencatat kejadian yang sama. Tambahkan penangkal sederhana di dalam LockService:
var dobel = catatan.filter(function (c) {
return c.nis === s.nis && c.kode === a.kode && c.petugas === g.kode && c.status === 'Aktif' && umurJam_(c.waktu) < 0.17;
})[0];
if (dobel) throw new Error('Catatan yang sama baru saja dibuat (' + dobel.id + ').');
3. Tingkat pembinaan yang bisa diatur sekolah
Setiap sekolah punya ambang berbeda. Daripada menulis angka di dalam kode, baca dari sheet Pengaturan:
function tingkat_(cfg, total) {
var b = [1, 2, 3, 4].map(function (i) { return Math.max(1, Number(cfg['batas_' + i]) || i * 25); });
for (var i = 4; i >= 1; i--) {
if (total >= b[i - 1]) return { level: i, batas: b[i - 1], sanksi: cfg['sanksi_' + i] || 'Pembinaan', berikut: i < 4 ? b[i] : null };
}
return { level: 0, batas: 0, sanksi: 'Belum ada tindakan khusus. Pertahankan!', berikut: b[0] };
}
Nilai berikut dipakai halaman orang tua untuk menggambar meter "tinggal berapa poin lagi sebelum naik tingkat". Kalimat sanksinya pun diambil dari sheet, sehingga sekolah bisa menyalin persis bunyi buku tata tertibnya.
4. Akses orang tua: cukup NIS + tanggal lahir, tapi dibatasi
Memakai NIS saja berbahaya karena nomornya berurutan. Pasangkan dengan tanggal lahir, lalu batasi percobaannya dengan CacheService:
function cekPoin(nis, lahir) {
var cache = CacheService.getScriptCache(), kc = 'cek_' + nis.slice(0, 20), n = Number(cache.get(kc) || 0);
if (n >= 6) throw new Error('Terlalu banyak percobaan. Coba lagi 15 menit lagi.');
var s = bacaSiswa_().filter(function (x) { return x.nis === nis; })[0];
if (!s || !/^\d{4}-\d{2}-\d{2}$/.test(lahir) || s.lahir !== lahir) {
cache.put(kc, String(n + 1), 900);
throw new Error('NIS atau tanggal lahir tidak cocok dengan data sekolah.');
}
cache.remove(kc);
// ... kirim HANYA data anak ini
}
Sama pentingnya: yang dikirim balik hanya milik satu anak, dan nomor WhatsApp orang tua tidak ikut. Fungsi publik lain (getPublik) hanya mengirim daftar tata tertib dan statistik agregat seperti "persentase siswa tanpa pelanggaran", tidak pernah nama siswa.
Catatan soal tanggal: kolom tanggal lahir harus diformat teks (setNumberFormat('@')) sebelum ditulis. Kalau tidak, Sheets akan mengubahnya menjadi objek tanggal dan perbandingan string s.lahir !== lahir jadi gagal.
5. Wewenang berbeda untuk guru dan kesiswaan
Guru boleh salah input, tapi tidak boleh menghapus jejak. Karena itu guru hanya bisa membatalkan catatan miliknya sendiri, maksimal 24 jam:
if (c.petugas !== g.kode) throw new Error('Catatan ini dibuat guru lain. Minta bantuan bagian kesiswaan.');
if (c.status !== 'Aktif') throw new Error('Catatan ini sudah ' + c.status.toLowerCase() + '.');
if (umurJam_(c.waktu) >= 24) throw new Error('Catatan lebih dari 24 jam hanya bisa dibatalkan bagian kesiswaan.');
Kesiswaan memakai token terpisah (password di sheet) dan bisa menganulir catatan kapan saja sekaligus menulis tindak lanjut pembinaan. PIN guru disimpan sebagai HMAC, dan token sesinya ditandatangani memakai hash PIN itu:
var isi = 'guru.' + p.kode + '.' + (Date.now() + 12 * 3600000);
return isi + '.' + tanda_(isi, p.pin);
Efeknya: begitu PIN direset oleh kesiswaan, semua sesi lama guru tersebut otomatis tidak valid. Tidak perlu tabel sesi sama sekali.
Bonus: ganti semester tanpa kehilangan riwayat
Di akhir semester poin biasanya di-nol-kan. Alih-alih menghapus baris, ubah statusnya menjadi Arsip:
catatan.forEach(function (c) { if (c.status === 'Aktif') { sh.getRange(c.baris, 9).setValue('Arsip'); n++; } });
Poin semua siswa kembali nol karena hitungPoin_ hanya menjumlahkan yang Aktif, tetapi orang tua masih bisa membaca riwayat semester sebelumnya. Data untuk laporan BK akhir tahun pun tetap utuh.
Ringkasan
- Simpan kejadian, bukan total; hitung poin ulang dari riwayat setiap kali dibaca.
- Browser hanya mengirim NIS dan kode aturan; nilai poin diambil server dari sheet.
- Ambang tingkat pembinaan dan kalimat sanksi disimpan di Pengaturan agar cocok dengan buku tata tertib sekolah.
- Akses orang tua dikunci NIS + tanggal lahir dengan batas percobaan, dan hanya mengirim data satu anak.
- Guru boleh mengoreksi 24 jam, kesiswaan punya wewenang penuh; PIN HMAC membuat reset PIN langsung mengakhiri sesi.
Download source code lengkapnya
Source code lengkap, termasuk halaman orang tua, panel guru, panel kesiswaan, surat panggilan siap cetak, data contoh 144 siswa, dan panduan instalasi, bisa diunduh gratis:
Download Source Code Aplikasi Poin Tata Tertib Siswa di Papicode
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.