Panduan Pengguna SIPARAKAI

SIPARAKAI (Sistem Penilaian Langsung, Real Time, Akurat dan Terintegrasi) adalah platform manajemen sekolah digital yang dirancang khusus untuk membantu sekolah mengelola seluruh aspek akademik dan administratif dalam satu sistem terpadu.

Fitur utama meliputi: manajemen data siswa & guru, penilaian afektif, kognitif & psikomotorik, absensi (manual dan berbasis AI pengenalan wajah), pelanggaran & prestasi, tugas & jurnal kelas, ujian digital dengan AI grading, pesan orang tua-guru, jadwal pelajaran, rapor, leaderboard, dan sistem lisensi white-label.

Sistem memiliki 4 peran pengguna dengan hak akses berbeda:

Untuk menggunakan SIPARAKAI, pastikan perangkat memenuhi persyaratan berikut:

Langkah pertama adalah mengatur identitas sekolah agar semua halaman menampilkan nama dan logo yang benar.

1. 1

   Konfigurasi branding di file .env atau database

   Pengaturan branding (nama app, logo, identitas sekolah) dikelola oleh developer melalui konfigurasi server.

2. 2

   Isi bagian Branding

   Masukkan Nama Aplikasi (singkatan), Nama Lengkap Aplikasi, Nama Sekolah, Lokasi Sekolah, dan Nama Developer.

3. 3

   Upload Logo

   Klik tombol upload dan pilih file logo sekolah. Logo akan ditampilkan di navbar, sidebar, dan halaman login.

4. 4

   Simpan Konfigurasi

   Klik tombol Simpan. Perubahan langsung terlihat di semua halaman termasuk landing page.

Lokasi GPS sekolah digunakan untuk memverifikasi bahwa siswa benar-benar berada di area sekolah saat melakukan absensi wajah.

1. 1

   Login sebagai Admin

   Buka halaman login dan masuk dengan akun admin.

2. 2

   Buka Pengaturan

   Di sidebar, klik menu "Pengaturan".

3. 3

   Scroll ke bagian Lokasi Sekolah

   Masukkan Latitude, Longitude, dan Radius Absensi (dalam meter).

4. 4

   Simpan

   Klik tombol "Simpan Lokasi". Sistem akan memvalidasi format koordinat.

Batas waktu (cutoff) menentukan kapan absensi masuk dan pulang ditutup.

1. 1

   Buka Pengaturan

   Di sidebar, klik "Pengaturan".

2. 2

   Scroll ke bagian Waktu Absensi

   Atur Batas Waktu Masuk (misal: 10:00) dan Batas Waktu Pulang (misal: 17:00).

3. 3

   Simpan

   Klik tombol "Simpan Waktu". Jam masuk harus lebih awal dari jam pulang.

Informasi kontak sekolah ditampilkan di halaman landing page dan digunakan untuk komunikasi.

1. 1

   Buka Pengaturan

   Di sidebar, klik "Pengaturan".

2. 2

   Isi Kontak

   Masukkan Email sekolah, Nomor Telepon, dan Nomor WhatsApp (format: 628xxx tanpa + atau spasi).

3. 3

   Simpan

   Klik tombol "Simpan Kontak".

Tahun ajaran adalah dasar dari semua data akademik. Anda harus membuat dan mengaktifkan tahun ajaran sebelum bisa mencatat absensi, nilai, dan lainnya.

1. 1

   Buka menu Tahun Ajaran

   Di sidebar bagian Akademik, klik "Tahun Ajaran".

2. 2

   Klik "Tambah Tahun Ajaran"

   Isi: Nama (misal: 2024/2025), Semester (Ganjil/Genap), Tanggal Mulai, Tanggal Selesai.

3. 3

   Aktifkan Tahun Ajaran

   Centang "Aktif" atau klik tombol Aktifkan pada tahun ajaran yang baru dibuat.

Buat semua kelas yang ada di sekolah beserta tingkatannya (grade).

1. 1

   Buka menu Data Kelas

   Di sidebar, klik "Data Kelas".

2. 2

   Klik "Tambah Kelas"

   Isi Nama Kelas (misal: 7A) dan Tingkat/Grade (7, 8, atau 9).

3. 3

   Ulangi untuk semua kelas

   Buat semua kelas: 7A, 7B, 8A, 8B, 9A, 9B, dst.

Daftarkan semua mata pelajaran yang diajarkan.

1. 1

   Buka menu Mata Pelajaran

   Di sidebar, klik "Mata Pelajaran".

2. 2

   Klik "Tambah Mata Pelajaran"

   Isi nama mata pelajaran (misal: Matematika, Bahasa Indonesia, IPA, dll.).

3. 3

   Ulangi untuk semua mapel

   Pastikan semua mata pelajaran yang dibutuhkan sudah terdaftar.

Daftarkan semua pengguna sistem: admin tambahan, guru, siswa, dan orang tua.

1. 1

   Buka Manajemen User

   Di sidebar, klik "Manajemen User".

2. 2

   Klik "Tambah User"

   Pilih peran (Admin/Guru/Siswa/Orang Tua) dan isi data yang diminta.

3. 3

   Untuk Siswa

   Isi NIS (unik), nama lengkap, jenis kelamin, No. HP Orang Tua (harus nomor WhatsApp aktif), dan data lainnya. Pilih kelas yang sudah dibuat.

4. 4

   Untuk Orang Tua

   Isi nama, lalu hubungkan dengan akun siswa (anak) yang sudah terdaftar.

5. 5

   Catat password default

   Setiap pengguna baru mendapat password default. Bagikan ke pengguna dan minta mereka mengubahnya.

Setiap kelas sebaiknya memiliki wali kelas (homeroom teacher) yang bertanggung jawab.

1. 1

   Buka Data Kelas

   Di sidebar, klik "Data Kelas".

2. 2

   Edit Kelas

   Klik tombol Edit pada kelas yang ingin di-assign.

3. 3

   Pilih Wali Kelas

   Di dropdown Wali Kelas, pilih guru yang sudah terdaftar.

4. 4

   Simpan

   Klik Simpan. Guru tersebut kini bisa melihat informasi kelas dan siswa perwaliannya.

Pastikan semua siswa sudah di-assign ke kelas masing-masing.

1. 1

   Buka Data Siswa

   Di sidebar, klik "Data Siswa".

2. 2

   Edit profil siswa

   Klik pada nama siswa yang belum memiliki kelas.

3. 3

   Pilih Kelas

   Di dropdown Kelas, pilih kelas yang sesuai (misal: 7A).

4. 4

   Simpan

   Klik Simpan.

Dashboard admin menampilkan ringkasan data sekolah: total siswa, guru, kelas, statistik kehadiran, grafik pelanggaran, dan aktivitas terkini.

Kelola semua akun pengguna sistem: tambah, edit, hapus, dan reset password.

1. 1

   Lihat Daftar User

   Filter berdasarkan peran (Admin/Guru/Siswa/Orang Tua). Gunakan search untuk mencari pengguna.

2. 2

   Tambah User Baru

   Klik "Tambah User", pilih peran, dan isi data lengkap.

3. 3

   Edit User

   Klik tombol Edit untuk mengubah data pengguna.

4. 4

   Hapus User

   Klik tombol Hapus. Data profil terkait (StudentProfile, TeacherProfile) juga akan dihapus.

Kelola tahun ajaran dan semester. Hanya satu tahun ajaran yang bisa aktif pada satu waktu.

Tambah, edit, atau hapus kelas. Setiap kelas memiliki nama, tingkat (7/8/9), dan opsional wali kelas.

Kelola daftar mata pelajaran yang diajarkan di sekolah.

Atur bobot (persentase) tiga komponen penilaian utama yang digunakan untuk menghitung nilai akhir di rapor: Afektif (sikap), Kognitif (pengetahuan), dan Psikomotorik (keterampilan).

1. 1

   Buka menu Bobot Nilai

   Di sidebar bagian Akademik, klik "Bobot Nilai".

2. 2

   Atur Persentase Komponen

   Tentukan bobot untuk Afektif, Kognitif, dan Psikomotorik. Total ketiga komponen harus 100%.

3. 3

   Simpan

   Klik Simpan. Bobot baru akan digunakan untuk menghitung nilai akhir rapor semua siswa.

Fitur untuk memindahkan siswa ke kelas berikutnya dan meluluskan siswa kelas 9 di akhir tahun ajaran.

1. 1

   Buat & aktifkan tahun ajaran baru

   Buka menu Tahun Ajaran, buat tahun ajaran baru (misal: 2025/2026 Ganjil), dan aktifkan.

2. 2

   Buka halaman Naik Kelas

   Di sidebar, klik "Naik Kelas". Sistem menampilkan semua kelas dan jumlah siswa.

3. 3

   Periksa mapping kelas

   Sistem otomatis menyarankan: 7A→8A, 7B→8B, 8A→9A, dst. Sesuaikan jika perlu.

4. 4

   Centang "Luluskan Kelas 9"

   Secara default tercentang. Siswa kelas 9 akan menjadi alumni.

5. 5

   Klik "Eksekusi Naik Kelas"

   Konfirmasi dialog akan muncul. Proses ini TIDAK DAPAT DIBATALKAN.

Kelola data siswa yang sudah lulus (alumni). Data alumni otomatis terisi setelah proses kenaikan kelas.

1. 1

   Lihat Daftar Alumni

   Tabel menampilkan semua siswa yang sudah lulus: nama, NIS, tahun kelulusan, dan kelas terakhir.

2. 2

   Lihat Detail Alumni

   Klik nama alumni untuk melihat profil lengkap, riwayat kelas, dan prestasi.

3. 3

   Cleanup Manual

   Jika diperlukan, admin bisa membersihkan data wajah alumni yang tersisa melalui menu Registrasi Wajah → Cleanup Alumni.

Kelola daftar kegiatan ekstrakurikuler dan assign siswa ke ekskul yang diikuti.

Buat jadwal pelajaran mingguan untuk setiap kelas.

1. 1

   Pilih Kelas

   Pilih kelas yang ingin dibuatkan jadwal.

2. 2

   Isi Jadwal per Hari

   Untuk setiap hari (Senin-Sabtu), tambahkan slot: mata pelajaran, jam mulai, jam selesai, dan guru pengajar.

3. 3

   Simpan

   Jadwal yang tersimpan bisa dilihat oleh guru, siswa, dan orang tua.

Setup sistem pelanggaran terdiri dari dua tahap: buat kategori, lalu buat jenis pelanggaran.

1. 1

   Buat Kategori Pelanggaran

   Contoh: "Kehadiran", "Perilaku", "Seragam". Kategori mengelompokkan jenis pelanggaran.

2. 2

   Buat Jenis Pelanggaran

   Buka menu "Jenis Pelanggaran". Isi: nama pelanggaran, kategori, dan poin pelanggaran. Contoh: "Terlambat masuk sekolah" — Kategori: Kehadiran — Poin: 5.

3. 3

   Lihat Siswa Bermasalah

   Buka menu "Siswa Bermasalah" untuk melihat ranking siswa berdasarkan total poin pelanggaran.

Catat prestasi/penghargaan yang diraih siswa.

1. 1

   Klik "Tambah Prestasi"

   Pilih siswa, isi judul prestasi, tingkat (sekolah/kabupaten/provinsi/nasional), dan tanggal.

2. 2

   Simpan

   Prestasi akan tercatat di profil siswa dan bisa ditampilkan di rapor.

Lihat ringkasan kehadiran seluruh siswa dan export ke Excel atau PDF.

1. 1

   Filter Data

   Pilih kelas dan rentang tanggal untuk melihat rekap kehadiran.

2. 2

   Lihat Ringkasan

   Tabel menampilkan jumlah Hadir (H), Sakit (S), Izin (I), dan Alpha (A) per siswa.

3. 3

   Export

   Klik tombol "Export Excel" atau "Export PDF" untuk mengunduh data.

Lihat semua pengajuan izin yang diajukan orang tua.

Kelola data wajah yang terdaftar untuk absensi AI. Lihat siswa yang sudah dan belum terdaftar, serta hapus data wajah jika diperlukan.

Admin dapat memonitor dan mengelola semua ujian digital dari semua guru. Admin memiliki kontrol penuh: publish, tutup, atur jadwal, dan hapus ujian.

Leaderboard menampilkan peringkat siswa berdasarkan indeks prestasi akademik. Admin bisa mengaktifkan atau menonaktifkan tampilan leaderboard.

Halaman pengaturan admin berisi beberapa bagian:

Beberapa halaman memiliki tombol export untuk mengunduh data dalam format Excel atau PDF:

Dashboard guru menampilkan: kelas perwalian, jadwal mengajar hari ini, jumlah tugas aktif, dan notifikasi terbaru.

Catat kehadiran siswa per kelas untuk mata pelajaran tertentu.

1. 1

   Pilih Kelas dan Mata Pelajaran

   Pilih kelas yang akan diabsen dan mata pelajaran saat itu.

2. 2

   Tandai Status Kehadiran

   Untuk setiap siswa, pilih: Hadir (H), Sakit (S), Izin (I), atau Alpha (A).

3. 3

   Simpan Absensi

   Klik Simpan. Data tersimpan untuk tanggal hari ini.

Masukkan nilai kognitif (akademik) siswa berdasarkan komponen: Tugas, Kuis, UTS, dan UAS.

1. 1

   Pilih Kelas dan Mata Pelajaran

   Pilih kelas dan mapel yang ingin dinilai.

2. 2

   Input Nilai per Komponen

   Masukkan nilai untuk setiap komponen (Tugas, Kuis, UTS, UAS). Nilai rentang 0-100.

3. 3

   Simpan

   Sistem otomatis menghitung rata-rata berbobot sesuai konfigurasi bobot nilai.

Masukkan nilai keterampilan/psikomotorik siswa melalui kegiatan ekstrakurikuler.

1. 1

   Pilih Kelas

   Pilih kelas yang akan dinilai.

2. 2

   Pilih Jenis Penilaian

   Pilih kegiatan atau aspek psikomotorik.

3. 3

   Input Nilai

   Masukkan nilai untuk setiap siswa. Rentang 0-100.

4. 4

   Simpan

   Nilai psikomotorik akan muncul di rapor siswa.

Buat tugas, tetapkan deadline, dan berikan nilai pada submission siswa.

1. 1

   Buat Tugas Baru

   Klik "Tambah Tugas". Isi: judul, deskripsi, kelas, mata pelajaran, deadline, dan lampiran (opsional).

2. 2

   Siswa Mengerjakan

   Siswa akan melihat tugas di dashboard mereka dan bisa submit file jawaban.

3. 3

   Periksa & Nilai Submission

   Buka tugas, lihat daftar submission siswa. Klik untuk melihat file yang dikumpulkan.

4. 4

   Berikan Nilai & Feedback

   Masukkan nilai (0-100) dan catatan/feedback untuk setiap submission.

Buat ujian digital dengan soal Pilihan Ganda dan Essay. Soal bisa dibuat manual atau digenerate otomatis menggunakan AI.

1. 1

   Buat Ujian Baru

   Klik "Buat Ujian". Isi metadata: judul, tipe (Quiz/UH/UTS/UAS), mapel, kelas, durasi, dan kategori kognitif tujuan (opsional — default otomatis dari tipe ujian).

2. 2

   Tambah Soal

   Tambah soal PG atau Essay secara manual, klik "Generate AI" untuk membuat soal otomatis, atau klik "Import Soal" untuk upload file (Excel/PDF/DOCX/TXT).

3. 3

   Review & Simpan

   Review ringkasan ujian lalu simpan sebagai DRAFT.

4. 4

   Publish Ujian

   Klik "Publish" untuk membuka ujian. Siswa akan menerima notifikasi.

5. 5

   Penilaian

   Soal PG dinilai otomatis. Untuk essay, klik "Nilai dengan AI" untuk penilaian otomatis oleh AI.

6. 6

   Review (Opsional)

   Review jawaban per siswa dan sesuaikan nilai jika perlu. Nilai otomatis tersinkron ke Nilai Kognitif sesuai kategori yang dipilih saat membuat ujian.

Format File Import Soal

Selain membuat soal manual atau generate AI, guru bisa import soal dari file. Format yang didukung:

Format Excel (Rekomendasi)

Format Excel paling disarankan karena parsing langsung tanpa AI — hasilnya pasti akurat. Buat file Excel (.xlsx) dengan header di baris pertama:

Format PDF / DOCX / TXT

File teks akan diekstrak dan diproses oleh AI secara otomatis. Untuk hasil terbaik, tulis soal dengan format:

Catat aktivitas pembelajaran harian untuk setiap kelas yang diajar.

1. 1

   Pilih Kelas dan Tanggal

   Pilih kelas dan tanggal pencatatan.

2. 2

   Isi Jurnal

   Tulis materi yang diajarkan, kegiatan pembelajaran, dan catatan khusus.

3. 3

   Simpan

   Jurnal tersimpan dan bisa dilihat oleh admin.

Catat pelanggaran siswa berdasarkan kategori dan jenis yang sudah di-setup admin.

1. 1

   Klik "Tambah Pelanggaran"

   Pilih siswa, pilih jenis pelanggaran, isi deskripsi (opsional).

2. 2

   Simpan

   Poin pelanggaran otomatis ditambahkan ke total siswa. Orang tua bisa mendapat notifikasi.

Daftarkan wajah siswa untuk sistem absensi wajah AI.

Setujui atau tolak pengajuan izin dari orang tua siswa.

1. 1

   Lihat Daftar Izin Masuk

   Daftar pengajuan izin dari orang tua siswa di kelas Anda.

2. 2

   Klik Setujui atau Tolak

   Periksa alasan izin, lalu setujui atau tolak dengan catatan.

Kirim pesan langsung ke orang tua siswa di kelas perwalian Anda.

1. 1

   Pilih Orang Tua

   Pilih orang tua dari daftar siswa di kelas Anda.

2. 2

   Tulis Pesan

   Ketik pesan dan kirim. Pesan bisa berupa informasi, teguran, atau pemberitahuan.

Jika Anda ditunjuk sebagai wali kelas, Anda bisa melihat informasi kelas perwalian dan mengelola siswa di dalamnya.

1. 1

   Buka menu Wali Kelas

   Di sidebar, klik "Wali Kelas".

2. 2

   Lihat Daftar Siswa

   Halaman menampilkan semua siswa di kelas perwalian Anda beserta data ringkas.

3. 3

   Akses Fitur Terkait

   Dari sini Anda bisa melihat absensi kelas, jurnal, pelanggaran siswa, dan mengirim pesan ke orang tua.

Lihat jadwal mengajar Anda yang sudah diatur oleh admin.

Lihat rekap nilai seluruh siswa per kelas dan mata pelajaran, lalu export ke Excel.

1. 1

   Pilih Kelas dan Mata Pelajaran

   Filter untuk melihat rekap nilai.

2. 2

   Lihat Tabel Nilai

   Tabel menampilkan nilai per komponen dan rata-rata.

3. 3

   Export

   Klik "Export Excel" untuk mengunduh data nilai.

Ubah password dan informasi akun Anda.

1. 1

   Buka Pengaturan

   Di sidebar, klik "Pengaturan".

2. 2

   Ubah Password

   Masukkan password lama, password baru (minimal 6 karakter), dan konfirmasi password baru.

3. 3

   Simpan

   Klik "Ubah Password". Password baru langsung berlaku untuk login selanjutnya.

Dashboard siswa menampilkan: info kelas, jadwal hari ini, tugas yang perlu dikerjakan, dan notifikasi.

Lihat nilai rapor semester saat ini dan riwayat rapor semester sebelumnya.

Rapor menampilkan nilai afektif (sikap, dari poin pelanggaran & prestasi), nilai kognitif (per komponen: tugas, kuis, UTS, UAS), dan nilai psikomotorik (keterampilan/ekstrakurikuler) per mata pelajaran. Anda juga bisa melihat tren nilai di menu Riwayat Rapor.

Absen menggunakan pengenalan wajah AI. Wajah Anda harus sudah terdaftar oleh guru/admin.

1. 1

   Buka menu Absen Wajah

   Kamera otomatis aktif.

2. 2

   Posisikan wajah di depan kamera

   Pastikan wajah terlihat jelas, pencahayaan cukup, dan tidak tertutup masker.

3. 3

   Sistem memverifikasi identitas

   AI mendeteksi wajah, membandingkan dengan data yang terdaftar, dan memverifikasi lokasi GPS.

4. 4

   Absensi tercatat

   Jika berhasil, status kehadiran langsung tercatat (Masuk atau Pulang tergantung waktu).

Lihat riwayat kehadiran Anda selama semester berjalan.

Lihat daftar pelanggaran yang pernah dicatat beserta poin yang didapat.

Lihat jadwal pelajaran mingguan untuk kelas Anda.

Lihat tugas yang diberikan guru dan submit jawaban sebelum deadline.

1. 1

   Lihat Daftar Tugas

   Tugas ditampilkan dengan status: belum dikerjakan, sudah dikumpulkan, atau sudah dinilai.

2. 2

   Buka Detail Tugas

   Klik tugas untuk melihat instruksi dan lampiran dari guru.

3. 3

   Submit Jawaban

   Upload file jawaban (PDF, gambar, atau dokumen lain) sebelum deadline.

4. 4

   Lihat Nilai

   Setelah guru menilai, nilai dan feedback akan muncul.

Kerjakan ujian digital dari guru dengan sistem anti-kecurangan.

1. 1

   Buka Daftar Ujian

   Lihat ujian yang tersedia beserta status (belum mulai, sedang, selesai, dinilai).

2. 2

   Mulai Ujian

   Klik ujian untuk memulai. Layar akan masuk mode fullscreen dan timer mulai berjalan.

3. 3

   Jawab Soal

   Untuk PG klik pilihan jawaban. Untuk Essay ketik jawaban di kolom yang tersedia.

4. 4

   Kumpulkan

   Klik "Kumpulkan" sebelum waktu habis. Jika waktu habis, jawaban otomatis dikumpulkan.

5. 5

   Lihat Hasil

   Setelah guru menilai, Anda bisa melihat skor dan feedback per soal.

Lihat rapor semester-semester sebelumnya dan grafik tren perkembangan nilai.

1. 1

   Buka Riwayat Rapor

   Di sidebar, klik "Riwayat Rapor".

2. 2

   Pilih Semester

   Pilih semester yang ingin dilihat dari daftar yang tersedia.

3. 3

   Lihat Grafik Tren

   Grafik menunjukkan perkembangan nilai Anda dari semester ke semester. Gunakan ini untuk melihat mata pelajaran yang meningkat atau menurun.

Lihat peringkat Anda dibanding siswa lain berdasarkan indeks prestasi akademik.

Dashboard orang tua menampilkan ringkasan data anak: kehadiran, nilai terkini, dan pemberitahuan.

Pantau kehadiran anak di sekolah secara real-time.

Halaman ini menampilkan riwayat kehadiran anak: tanggal, status (Hadir/Sakit/Izin/Alpha), dan waktu absen.

Lihat riwayat absen wajah anak termasuk waktu dan bukti foto.

Ajukan izin ketidakhadiran untuk anak Anda.

1. 1

   Klik "Ajukan Izin"

   Pilih tanggal izin dan alasan (Sakit/Izin).

2. 2

   Isi Keterangan

   Berikan penjelasan detail mengapa anak tidak bisa hadir.

3. 3

   Submit

   Pengajuan dikirim ke wali kelas untuk disetujui.

4. 4

   Pantau Status

   Lihat status pengajuan: Menunggu, Disetujui, atau Ditolak.

Lihat nilai rapor anak semester ini dan riwayat semester sebelumnya.

Rapor menampilkan nilai per mata pelajaran dan grafik tren perkembangan antar semester.

Kirim dan terima pesan dari wali kelas anak Anda.

1. 1

   Buka menu Pesan

   Daftar percakapan dengan wali kelas ditampilkan.

2. 2

   Tulis Pesan

   Ketik pesan dan kirim. Bisa bertanya tentang perkembangan anak, informasi sekolah, dll.

Lihat peringkat anak Anda dibanding siswa lain di kelasnya.

Kelola informasi akun orang tua Anda.

Ganti Password

1. 1

   Buka Pengaturan

   Klik ikon profil di pojok kanan atas → pilih "Pengaturan".

2. 2

   Isi form ganti password

   Masukkan password lama, password baru, dan konfirmasi password baru.

3. 3

   Simpan

   Klik "Ubah Password". Anda akan diminta login ulang dengan password baru.

SIPARAKAI menggunakan teknologi AI pengenalan wajah untuk mencatat kehadiran siswa secara otomatis dan aman.

Cara Kerja

Setup (Admin)

1. 1

   Aktifkan fitur absensi wajah

   Pastikan fitur "faceAttendance" sudah diaktifkan di konfigurasi server oleh developer.

2. 2

   Atur lokasi sekolah

   Admin → Pengaturan → Lokasi Sekolah. Masukkan koordinat GPS dan radius.

3. 3

   Atur jam absensi

   Admin → Pengaturan → Waktu Absensi. Atur batas jam masuk dan pulang.

Registrasi Wajah (Guru/Admin)

1. 1

   Buka menu Registrasi Wajah

   Guru: Sidebar → Registrasi Wajah. Admin: Sidebar → Registrasi Wajah.

2. 2

   Pilih siswa yang belum terdaftar

   Daftar siswa yang belum memiliki data wajah ditampilkan.

3. 3

   Ambil foto wajah

   Kamera aktif — pastikan wajah siswa terlihat jelas, pencahayaan baik, tanpa masker/kacamata hitam.

4. 4

   Konfirmasi & simpan

   Sistem memproses foto: deteksi wajah, ekstrak embedding, dan simpan ke database.

Keamanan 3 Lapis

Sistem ujian digital menggunakan AI untuk tiga fungsi utama: generate soal otomatis, penilaian essay otomatis, dan impor soal dari dokumen. AI dapat dikonfigurasi oleh Admin melalui menu Pengaturan.

Fungsi AI dalam Ujian

Perbandingan Model AI & Estimasi Biaya

Berikut perbandingan model AI yang didukung beserta estimasi biaya untuk skenario 1000 siswa × 10 soal essay = 10.000 API call per ujian (~2,5 juta token):

Cara Setup AI

1. 1

   Dapatkan API Key

   Untuk Gemini: buka aistudio.google.com/apikey → Login dengan akun Google → Klik "Create API Key" → Copy key (format: AIza...). Untuk provider lain, lihat tabel di bawah.

2. 2

   Buka Pengaturan

   Login sebagai Admin, buka halaman Pengaturan, scroll ke bagian "Konfigurasi AI".

3. 3

   Isi Konfigurasi

   Pilih Provider (klik tombol provider), lalu pilih Model dari daftar yang tersedia. Base URL otomatis terisi. Model bertanda "Vision" mendukung penilaian jawaban foto. Masukkan API Key, lalu Simpan.

4. 4

   Simpan & Test

   Klik "Simpan Konfigurasi AI". Lalu login sebagai guru, buat ujian baru, dan coba "Generate Soal dengan AI" untuk memastikan konfigurasi berhasil.

Konfigurasi per Provider

Cara Generate Soal dengan AI

1. 1

   Buat Ujian Baru

   Login sebagai guru, buka menu Ujian Digital, klik "Buat Ujian". Isi metadata: judul, tipe, mapel, kelas, dan durasi.

2. 2

   Klik "Generate Soal AI"

   Pada form soal, klik tombol "Generate AI".

3. 3

   Isi Parameter

   Masukkan: materi/topik, jumlah soal MCQ (maks 50), jumlah soal Essay (maks 20), dan tingkat kesulitan (mudah/sedang/sulit).

4. 4

   Tunggu Proses

   AI akan membuat soal dalam 10-30 detik. Setiap soal MCQ dilengkapi 4 opsi dan kunci jawaban, soal Essay dilengkapi kunci jawaban untuk panduan penilaian.

5. 5

   Review & Edit

   Periksa soal yang dihasilkan. Edit, hapus, atau tambah soal manual jika perlu sebelum menyimpan ujian.

Cara Kerja Penilaian Otomatis (Auto-Grading)

1. 1

   Siswa Submit Jawaban

   Setelah siswa selesai mengerjakan ujian, jawaban MCQ langsung dinilai otomatis (cocokkan kunci jawaban) tanpa AI. Nilai otomatis masuk ke Kognitif.

2. 2

   Klik "Nilai dengan AI"

   Di halaman detail ujian, klik tombol "Nilai dengan AI" untuk menilai semua jawaban essay yang belum dinilai.

3. 3

   Proses Batch

   AI menilai secara batch (5 jawaban paralel). Setiap jawaban diberi skor (0 s/d poin maksimal) dan feedback singkat dalam Bahasa Indonesia.

4. 4

   Auto-Sync ke Kognitif

   Setelah penilaian AI selesai, skor otomatis tersinkron ke Nilai Kognitif sesuai kategori yang ditentukan saat membuat ujian.

5. 5

   Review (Opsional)

   Guru dapat melihat nilai dan feedback per siswa per soal. Skor bisa dikoreksi — perubahan otomatis ter-sync ulang ke Kognitif.

Pengaturan Penilaian AI (Essay)

Saat membuat ujian yang mengandung soal essay, guru dapat mengatur dua parameter yang mempengaruhi bagaimana AI menilai jawaban essay siswa. Pengaturan ini muncul di tahap 1 (metadata) form pembuatan ujian, bagian "Pengaturan Penilaian AI (Essay)".

Cara Import Soal dari File

Mendukung 4 format file: Excel (XLSX/XLS), PDF, DOCX, dan TXT. Batas ukuran: 10 MB.

1. 1

   Siapkan File Soal

   Untuk Excel: buat file .xlsx dengan kolom Soal, A, B, C, D, Jawaban. Untuk PDF/DOCX/TXT: tulis soal bernomor, opsi A-D, dan kunci jawaban. Lihat format detail di Panduan Guru → Ujian Digital.

2. 2

   Klik "Import Soal"

   Pada form buat ujian, klik tombol "Import Soal" lalu upload file.

3. 3

   Parsing Otomatis

   File Excel langsung di-parse berdasarkan kolom (tanpa AI). File PDF/DOCX/TXT diekstrak lalu diproses AI untuk mengenali soal.

4. 4

   Review Hasil Import

   Periksa soal yang diimpor. Edit teks, koreksi kunci jawaban, atau hapus soal yang tidak sesuai.

Alur Lengkap Ujian Digital

Sistem mendukung dua jalur notifikasi untuk memastikan informasi penting sampai ke pengguna secara real-time: Push Notification (Firebase) dan WhatsApp (Wablas).

Push Notification (Firebase Cloud Messaging)

Notifikasi push dikirim langsung ke perangkat melalui Firebase Cloud Messaging (FCM). Notifikasi muncul di panel notifikasi HP meskipun aplikasi tidak sedang dibuka.

Setup Firebase (Push Notification)

Agar push notification berfungsi, Anda perlu membuat project Firebase dan mengisi konfigurasi di file .env server.

1. 1

   Buat project di Firebase Console

   Buka https://console.firebase.google.com → klik "Add project" → ikuti wizard pembuatan project.

2. 2

   Buat Service Account

   Buka Project Settings → tab "Service Accounts" → klik "Generate New Private Key" → download file JSON.

3. 3

   Isi variabel environment

   Buka file .env di server dan isi 3 variabel berikut dari file JSON yang didownload.

Troubleshooting Push Notification

Notifikasi WhatsApp (Wablas)

Notifikasi WhatsApp dikirim otomatis ke nomor HP orang tua menggunakan layanan Wablas — platform API WhatsApp pihak ketiga.

Setup Wablas (WhatsApp)

Agar notifikasi WhatsApp berfungsi, Anda perlu mendaftar akun Wablas dan mengisi konfigurasi di file .env server.

1. 1

   Daftar akun Wablas

   Buka https://wablas.com dan buat akun. Pilih paket sesuai kebutuhan (ada paket gratis untuk trial).

2. 2

   Pilih server

   Saat registrasi, pilih server terdekat: jogja.wablas.com atau solo.wablas.com.

3. 3

   Generate API Token

   Setelah login ke dashboard Wablas, buka menu API → salin Token dan Secret.

4. 4

   Isi variabel environment

   Buka file .env di server dan isi 3 variabel berikut.

1. 1

   Restart server

   Setelah mengisi variabel .env, restart server agar konfigurasi terbaca.

2. 2

   Pastikan nomor WhatsApp orang tua terisi

   Data nomor HP orang tua harus terisi di profil siswa (field "No. HP Orang Tua") dan harus berupa nomor WhatsApp aktif.

Format Nomor HP

Sistem otomatis mengkonversi format nomor HP Indonesia:

Troubleshooting WhatsApp

Fitur Pengumuman digunakan oleh Admin sekolah untuk menyebarkan informasi penting kepada seluruh pengguna (Guru, Siswa, dan Orang Tua) secara serentak.

Manajemen Pengumuman (Admin)

1. 1

   Buat Pengumuman Baru

   Klik tombol "Tambah Pengumuman". Isi judul dan konten informasi yang ingin disampaikan.

2. 2

   Publikasi & Notifikasi

   Saat disimpan, sistem otomatis mengirimkan Push Notification ke seluruh perangkat pengguna yang terdaftar.

3. 3

   Hapus Pengumuman

   Admin dapat menghapus pengumuman jika sudah tidak relevan.

Akses Pengguna (Guru/Siswa/Orang Tua)

Pengguna dapat melihat daftar pengumuman melalui menu Pengumuman di sidebar atau dashboard. Klik pada kartu pengumuman untuk melihat detail lengkap informasi.

Siklus Hidup Pengumuman

SIPARAKAI tersedia dalam dua format: Progressive Web App (PWA) untuk semua perangkat dan aplikasi Android native (.apk).

PWA (Progressive Web App)

PWA memungkinkan Anda menginstal SIPARAKAI di perangkat seperti aplikasi native tanpa perlu download dari Play Store.

1. 1

   Buka di browser

   Akses URL SIPARAKAI (misalnya siparakai.sekolah.sch.id) menggunakan Chrome.

2. 2

   Instal PWA

   Klik ikon "Install" di address bar (desktop) atau pilih menu ⋮ → "Add to Home Screen" (mobile).

3. 3

   Buka dari home screen

   Setelah terinstal, buka SIPARAKAI langsung dari ikon di home screen — tampil seperti aplikasi native.

Aplikasi Android (APK)

Untuk pengguna yang menginginkan pengalaman aplikasi native lengkap, tersedia file APK yang bisa diinstal di perangkat Android.

1. 1

   Download APK

   Download file APK dari halaman login SIPARAKAI atau minta file dari admin sekolah.

2. 2

   Izinkan sumber tidak dikenal

   Di pengaturan HP → Keamanan → aktifkan "Sumber Tidak Dikenal" atau "Install unknown apps".

3. 3

   Instal APK

   Buka file APK yang sudah didownload dan ikuti proses instalasi.

4. 4

   Konfigurasi server

   Saat pertama kali membuka aplikasi, masukkan URL server SIPARAKAI di halaman login.

SIPARAKAI menggunakan sistem lisensi berbasis JWT untuk mengontrol akses fitur premium.

Bagaimana Lisensi Bekerja

Cara Aktivasi Lisensi

1. 1

   Dapatkan License Key

   Hubungi developer untuk mendapatkan license key.

2. 2

   Buka Pengaturan

   Masuk sebagai Admin, buka halaman Pengaturan.

3. 3

   Paste License Key

   Pada bagian Lisensi, paste key ke kolom input lalu klik "Aktivasi Lisensi".

4. 4

   Cek Status

   Setelah diaktifkan, status lisensi berubah hijau. Fitur premium akan terbuka. License key tidak akan ditampilkan lagi setelah disimpan.

Memahami kapan data dihapus dan dipertahankan penting agar tidak kehilangan informasi secara tidak sengaja.

Saat Mengaktifkan Tahun Ajaran Baru

Semester cleanup otomatis berjalan. Berikut data yang terpengaruh:

Saat Kenaikan Kelas

Data yang terhapus hanya milik siswa alumni (kelas 9 yang lulus):

Retensi Otomatis