O
Orens Pro Dokumentasi Sistem
Masuk ke Sistem
Versi 1.0.0 Production Ready

Bagaimana Orens Pro Mengamankan & Mengelola Presensi Anda

Dokumentasi interaktif mengenai alur kerja, arsitektur, pembagian hak akses, sistem penilaian cerdas, serta teknologi pencegah manipulasi lokasi dan kode QR.

Apa itu Orens Pro?

Orens Pro adalah sistem manajemen kehadiran (presensi) bertingkat yang dirancang khusus untuk ekosistem sekolah / yayasan **Prestasi Prima** (SMK & SMA Prestasi Prima). Sistem ini memfasilitasi pencatatan kehadiran anggota kegiatan ekstrakurikuler (ekskul) dengan verifikasi ganda yang presisi guna meminimalkan manipulasi kehadiran (absen titip nama).

Dengan memadukan pembatasan domain email sekolah, koordinat global GPS (Geofencing), dan rotasi kode QR secara dinamis berbasis waktu, Orens Pro memastikan setiap kehadiran tercatat secara valid, aman, dan langsung (real-time).

0% Toleransi Titip Absen
30 Detik Rotasi Token QR Dinamis

Rotasi QR Token Dinamis

Menggunakan standar enkripsi industri (SHA256 HMAC) berbasis waktu jendela (window) 30 detik. Kode QR yang ditayangkan akan berubah secara berkala sehingga siswa tidak bisa membagikan screenshot kode QR ke temannya di luar lokasi.

GPS Geofencing Absolut

Titik absensi dipasang dengan radius toleransi tertentu (misal: 100 meter). Sistem membandingkan koordinat lokasi perangkat siswa secara real-time dengan titik lokasi resmi sesi absensi.

Log Audit & Transaksi Aman

Setiap aktivitas login, perubahan data absensi, ekspor laporan, dan manipulasi data pengguna dicatat lengkap dalam Log Audit demi akuntabilitas pengurus dan pembina.

Bagaimana Sistem Bekerja?

Alur lengkap dari inisiasi sesi absensi oleh pengurus hingga penyimpanan data kehadiran.

1

Pembuatan Sesi

Pembina atau Pengurus membuat sesi absensi di Dashboard. Sesi dikaitkan dengan ekstrakurikuler (ekskul), divisi, waktu mulai-selesai, koordinat latitude/longitude, dan radius aman.

2

Penayangan Kode QR

Pengurus menayangkan halaman QR Code di layar utama/proyektor kelas. Server memutar token QR setiap 30 detik menggunakan algoritma hashing hash_hmac SHA256.

3

Pemindaian & GPS

Member login menggunakan email sekolah, memindai QR, dan mengirimkan koordinat GPS perangkat mereka ke server untuk diverifikasi secara aman.

4

Pencatatan Kehadiran

Server memvalidasi kesesuaian waktu, validitas token QR, dan jarak geofencing. Jika semua lolos, status absen dicatat "Hadir" secara instan.

🛡️ Proteksi Anti-Cheat Singapore Enterprise Standard

Sistem membolehkan scan QR dengan token dari jendela waktu berjalan (Current Window) dan jendela waktu tepat sebelumnya (Previous Window). Toleransi ini disiapkan agar member yang memiliki koneksi internet agak lambat saat mengirim data ke server tidak gagal absen, namun tetap membatasi penyebaran screenshot QR di luar durasi 30-60 detik.

h7a8...9f2 Representasi Hash QR Berjalan

Hak Akses & Peran Pengguna (RBAC)

Orens Pro membagi izin akses pengguna ke dalam 4 tingkatan penting.

Level 4

Superadmin

Pemegang otoritas tertinggi sistem. Bertanggung jawab atas kesehatan aplikasi secara global.

  • Kelola Seluruh Organisasi
  • Kelola Divisi Global
  • Lihat Audit Log System
  • Manajemen Semua Akun
Level 3

Pembina

Penanggung jawab ekstrakurikuler tertentu (misalnya: Pembina Orens Solution).

  • Kelola Akun Member & Pengurus
  • Reset Periode Nilai Keaktifan
  • Ekspor Laporan Excel/PDF
  • Impor Data CSV Member
Level 2

Pengurus

Pengelola kegiatan di level divisi (misalnya: divisi Game atau Cyber Security).

  • Buat & Tayangkan Sesi Absensi
  • Pencatatan Kehadiran Manual
  • Lihat Sesi & Log Absen Divisi
  • Tidak Bisa Reset Grade
Level 1

Member

Anggota biasa / siswa yang mengikuti kegiatan ekstrakurikuler atau divisi terkait.

  • Melakukan Absen Mandiri (QR & GPS)
  • Melihat Riwayat Absensi Pribadi
  • Melihat Grade Kehadiran Aktif
  • Tidak Bisa Akses Panel Admin
A
Grade Utama Grade A

Mewakili keaktifan sangat baik. Member harus hadir minimal **4 kali** dalam periode berjalan.

B
Grade Menengah Grade B

Mewakili keaktifan cukup. Member harus hadir minimal **2 kali** dalam periode berjalan.

-
Tanpa Grade Grade Strip (-)

Kehadiran di bawah **2 kali** dalam periode absensi aktif.

Mekanisme Penilaian & Reset Periodik

Sistem akumulasi Orens Pro melacak seluruh riwayat absen "Hadir" yang dibuat **setelah tanggal reset terakhir**. Hal ini memudahkan Pembina untuk menetapkan periode penilaian per semester, per triwulan, atau bulanan secara fleksibel.

⚠️ Aturan Pengisian Sesi Kedaluwarsa

Setiap kali pengguna mengakses dashboard atau sistem melakukan pembersihan berkala, sesi yang telah melewati jam selesai (`end_time`) akan dinonaktifkan secara otomatis. Di saat yang bersamaan, seluruh member yang terdaftar di ekskul/divisi sesi tersebut namun tidak melakukan absen akan otomatis diisi statusnya sebagai Alpha untuk keadilan data.

Interactive Playground

Simulasi Proses Absen Mandiri

Uji coba simulasi logika validasi server untuk melihat bagaimana koordinat GPS dan token QR diperiksa.

1. Konfigurasi Simulasi

2. Respon Server (JSON API)

Menunggu input simulasi...
Pilih konfigurasi parameter di samping kiri lalu klik tombol kirim untuk melihat status respon dan logika yang memengaruhinya.