Panduan Penggunaan Aplikasi Ujian PurwaExam

Pendahuluan

PurwaExam adalah aplikasi ujian berbasis komputer (CBT) yang diakses melalui peramban, tanpa perlu memasang aplikasi tambahan, kecuali Safe Exam Browser bila sesi ujian mewajibkannya. Aplikasi ini dibangun dengan Laravel dan Filament untuk sebuah perguruan tinggi negeri. Nama institusi disamarkan atas permintaan pihak terkait.

Panduan ini mencakup seluruh fitur untuk setiap peran: Mahasiswa, Dosen, serta Operator Prodi dan Admin Pusat. Satu bab khusus menjelaskan mekanisme validasi Safe Exam Browser. Gambaran fitur secara umum ada di fitur wajib aplikasi ujian online untuk kampus.

Peran dan Panel

PurwaExam memiliki dua panel yang terpisah:

Panel	Alamat Akhir	Untuk
Peserta	`/ujian`	Mahasiswa
Admin	`/admin`	Admin Pusat, Operator Prodi, Dosen

Peran	Yang Dapat Dikerjakan
Admin Pusat	Semua fitur di semua program studi, termasuk pengguna staf, periode, log aktivitas, serta mengunci dan membuka kunci paket dan batch
Operator Prodi	Semua fitur untuk program studinya sendiri: struktur akademik, bank soal, kelas, paket Ujian Kompetensi, batch, rekap kelulusan, dan sertifikat
Dosen	Soal buatan sendiri, kelas yang diampu, paket Ujian Akhir kelasnya, dan penilaian uraian
Mahasiswa	Melihat ujian, mengerjakan, serta melihat dan mencetak hasil

Seorang pengguna dapat memiliki lebih dari satu peran, misalnya Admin Pusat sekaligus Dosen.

Jenis Ujian

Jenis	Cakupan	Dibuat Oleh	Peserta	Sesi
Ujian Kompetensi	Satu program studi	Admin Pusat atau Operator Prodi	Mahasiswa yang didaftarkan ke sebuah batch aktif	Banyak, mengikuti nomor sesi tiap rumpun mata kuliah
Ujian Akhir	Satu kelas mata kuliah	Dosen pengampu kelas atau Admin Pusat	Mahasiswa yang terdaftar di kelas	Satu

Perbandingan alurnya dibahas di ujian kompetensi vs ujian akhir.

Masuk

Buka alamat aplikasi dari panitia, lalu pilih Peserta (mahasiswa) atau Admin (staf dan dosen).
Isi Username dan Password. Username adalah NIM untuk mahasiswa, NIP untuk dosen, dan username khusus untuk staf. Login memakai username, bukan email.
Klik masuk.

Kebijakan password: minimal 8 karakter dengan kombinasi huruf dan angka.

Lupa Password

Bila akun memiliki email, gunakan fitur reset password lewat email.
Bila akun tidak memiliki email, hubungi admin. Dosen dapat direset lewat aksi Reset Password oleh Admin Pusat, dan password baru ditampilkan sekali.
Menu Profil memungkinkan pengguna mengganti data dan password sendiri.

Keluar

Klik Keluar di bagian bawah sidebar.

Fitur Role: Mahasiswa

Ujian Saya

Setelah login, halaman utama menampilkan satu kartu per paket ujian yang tersedia, lengkap dengan satu baris per sesi. Setiap baris menunjukkan judul sesi, durasi, jadwal bila ada, status, dan tombol yang sesuai. Di bagian bawah ada Riwayat Ujian.

Paket muncul bila:

Ujian Kompetensi: Anda terdaftar pada batch yang sedang aktif.
Ujian Akhir: paket berstatus aktif dan Anda terdaftar di kelasnya.

Memulai Ujian

Klik Mulai Ujian pada sesi yang diinginkan.
Bila sesi mewajibkan token, kolom Token muncul. Isi token yang diberikan pengawas.
Konfirmasi di dialog yang menyebut jumlah soal dan durasi, lalu klik Mulai Sekarang.
Bila sesi mewajibkan Safe Exam Browser, ujian harus dibuka lewat aplikasi itu.

Saat ujian dimulai, soal dibekukan untuk Anda. Memuat ulang halaman tidak mengubah soal, urutan soal, maupun urutan pilihan jawaban.

Mengerjakan Ujian

Layar ujian menampilkan:

Sisa Waktu di kanan atas, dihitung di server. Warnanya merah pada satu menit terakhir.
Soal dan kontrol jawaban, satu soal per layar, dengan tombol Sebelumnya dan Berikutnya.
Tombol Ragu-ragu untuk menandai soal yang ingin ditinjau ulang.
Panel navigasi berisi nomor soal berwarna: hijau terjawab, kuning ragu-ragu, abu-abu belum terjawab.

Kontrol jawaban berbeda menurut tipe soal:

Tipe Soal	Cara Menjawab
Pilihan Ganda	Pilih satu opsi
Pilihan Ganda Kompleks	Centang satu atau lebih opsi
Benar/Salah	Pilih Benar atau Salah
Menjodohkan	Pilih padanan dari daftar kanan untuk tiap item kiri
Uraian	Ketik jawaban pada kolom teks

Jawaban tersimpan otomatis setiap kali Anda mengubahnya.

Mengumpulkan Jawaban

Klik Selesai & Kumpulkan pada soal terakhir. Dialog konfirmasi menyebut jumlah soal yang belum terjawab dan yang ditandai ragu-ragu. Bila waktu habis, jawaban otomatis dikumpulkan.

Setelah Mengumpulkan

Tampilan	Arti
Skor sedang dihitung	Jawaban terkumpul dan sedang dinilai sistem. Halaman diperbarui otomatis
Menunggu dinilai dosen	Soal objektif sudah dinilai, masih ada jawaban uraian yang menunggu dosen. Skor sementara
Menunggu sesi lain	Sesi ini selesai dinilai, tetapi paket memiliki sesi lain yang belum selesai
Lulus atau Mengulang	Keputusan akhir paket, diambil setelah semua sesi dinilai
Hasil belum ditampilkan	Panitia memilih tidak menampilkan hasil kepada peserta

Bila hasil boleh ditampilkan, Anda melihat jumlah soal, jawaban benar, jawaban salah, dan skor. Ikon cetak di Riwayat Ujian menghasilkan PDF hasil Anda setelah penilaian selesai.

Berpindah Komputer

Bila komputer bermasalah saat ujian berjalan, Anda dapat melanjutkan di komputer lain dengan login yang sama dan memilih Lanjutkan Ujian. Waktu dihitung di server, dan jawaban yang sudah tersimpan tidak hilang. Pengawas juga dapat mengakhiri sesi login Anda dari panel admin bila diperlukan.

Hal yang Perlu Dihindari

Selama ujian, jangan berpindah tab atau aplikasi lain. Aplikasi mencatat kejadian seperti ini sebagai kejadian mencurigakan, dan dapat berakibat pada status ujian Anda. Pada sesi yang mewajibkan Safe Exam Browser, keluar dari aplikasi itu juga dicatat.

Fitur Role: Dosen

Dosen memakai panel Admin, dengan data yang dibatasi pada kelas dan soal miliknya.

Bank Soal

Menu Bank Soal menampilkan soal buatan Anda sendiri. Soal dari dosen lain tidak terlihat, demi kerahasiaan.

Membuat soal:

Klik tambah, lalu pilih Learning Outcome (LO) dari mata kuliah yang Anda ampu.
Pilih Tipe Soal. Isian di bawahnya menyesuaikan.
Isi Teks Soal dan, bila perlu, Gambar Soal (JPEG atau PNG, maksimal 2 MB).
Isi opsi dan kunci sesuai tipe. Pilihan ganda mendukung 2 sampai 6 opsi, dan pilihan ganda kompleks 2 sampai 8 opsi. Untuk uraian, isi kriteria rubrik beserta bobot (%) dan skor maksimum.

Impor dari Excel: gunakan tombol Unduh Contoh Template Soal lalu Import Template Excel. Aturan lengkapnya ada di bank soal ujian online.

Kelas dan Ujian Akhir

Buka menu Paket Ujian dan buat paket Ujian Akhir untuk kelas yang Anda ampu. Satu sesi terbentuk otomatis.
Buka sesi dan isi komponen soal: Learning Outcome, jumlah soal, dan bobot per soal. Aplikasi menunjukkan stok soal yang tersedia, yaitu soal buatan Anda untuk kelas itu.
Pastikan total bobot semua komponen sama dengan Target Skor Total paket.
Klik Aktifkan. Tombol ini baru dapat dipakai bila total bobot sudah sesuai.
Setelah ujian, ekspor hasil kelas ke Excel atau PDF dari halaman Kelas.

Menilai Uraian

Bila sesi memiliki soal uraian, Anda menerima notifikasi Uraian Menunggu Dinilai.

Buka sesi, lalu klik Nilai Uraian.
Jawaban dikelompokkan per soal: satu soal tampil sekali dengan jawaban semua peserta di bawahnya.
Untuk setiap jawaban, isi nilai per kriteria rubrik, lalu simpan.
Koreksi nilai dapat dilakukan berulang kali. Skor peserta dihitung ulang setiap kali Anda menyimpan.

Peserta dengan uraian yang belum dinilai akan menunggu keputusan akhirnya. Setelah semua uraian dinilai, statusnya diperbarui.

Fitur Role: Operator Prodi dan Admin Pusat

Operator Prodi bekerja untuk program studinya sendiri. Admin Pusat dapat mengakses semuanya.

Struktur Akademik

Struktur dikelola berurutan: Institusi → Program Studi → Rumpun → Mata Kuliah → Learning Outcome. Rumpun memiliki nomor sesi yang menentukan di sesi mana rumpun itu muncul pada Ujian Kompetensi. Kode LO unik dalam satu mata kuliah.

Menu Periode (khusus Admin Pusat) dan Kelas menyimpan penyelenggaraan mata kuliah per semester, lengkap dengan dosen pengampu dan mahasiswa terdaftar.

Pengguna dan Impor

Admin Pusat mengelola staf, dosen, dan mahasiswa. Impor Excel tersedia untuk dosen, mahasiswa, mahasiswa ke kelas, dan peserta batch. Impor melaporkan kegagalan per baris tanpa membatalkan baris lain.

Paket Ujian

Isian paket: judul, cakupan (program studi atau kelas), Target Skor Total (bawaan 100), dan Nilai Minimum Kelulusan (bawaan 60). Setelah paket dibuat, sesinya terbentuk otomatis: satu sesi untuk Ujian Akhir, dan satu sesi per nomor sesi rumpun untuk Ujian Kompetensi.

Pengaturan Sesi

Isian	Keterangan
Durasi	5 sampai 300 menit
Jadwal Pelaksanaan	Dipakai untuk pengingat dan keterangan di dasbor
Wajib Token Akses	Peserta harus mengisi token saat mulai
Wajib Safe Exam Browser	Ujian hanya dapat dibuka lewat SEB
Acak Urutan Soal	Bawaan aktif
Acak Urutan Jawaban	Bawaan nonaktif
Tampilkan Hasil ke Peserta	Bawaan aktif
Kuota Peserta	Opsional, dihitung dari mahasiswa berbeda yang pernah memulai

Komponen soal menentukan isi sesi. Satu komponen terdiri dari Learning Outcome, jumlah soal, dan bobot per soal. Kolom Stok Cukup menunjukkan apakah bank soal memadai.

Penguncian. Setelah peserta pertama memulai, isian inti sesi dikunci agar tidak berubah di tengah ujian. Tombol Buka Kunci tersedia bila perlu, tetapi mengubah parameter setelah ada peserta yang mengerjakan dapat membuat hasil tidak konsisten, jadi gunakan dengan hati-hati.

Mengaktifkan Paket

Tombol Aktifkan baru dapat dipakai bila total bobot komponen seluruh sesi sama dengan Target Skor Total. Tabel paket menunjukkan Total Berjalan dan penanda Seimbang.

Batch Ujian Kompetensi

Batch adalah satu kali pelaksanaan paket Ujian Kompetensi, misalnya “Batch 1 - Ganjil 2025/2026”.

Buat batch dan pilih paketnya.
Tambahkan peserta satu per satu, atau impor dari CSV. Mahasiswa yang belum punya akun dapat dibuat otomatis.
Klik Aktifkan agar peserta dapat mulai mengerjakan.
Pantau tabel peserta dan hasil: jumlah soal, benar, salah, skor, dan status (Belum Mulai, Sedang Berjalan, Lulus, Mengulang).
Ekspor nilai ke CSV, Excel, atau PDF.
Setelah periode selesai, Admin Pusat dapat Kunci Batch sehingga data hanya dapat dibaca dan diekspor.

Skor sesi digabung hanya dalam batch yang sama. Mahasiswa yang perlu mengulang didaftarkan ke batch baru.

Token Akses

Pada sesi yang mewajibkan token, klik Generate Token dan pilih masa berlaku (5 menit sampai 24 jam). Token 6 karakter ditampilkan dengan waktu kedaluwarsanya. Bagikan token kepada peserta oleh pengawas tepat saat ujian dimulai. Jumlah percobaan token yang salah dibatasi.

Peserta dan Status

Setiap sesi memiliki tabel Peserta & Status (baca saja): nomor ujian, status, skor, jumlah kejadian mencurigakan, serta waktu mulai dan selesai. Aksi Lihat menampilkan rincian kejadian, dan Paksa Keluar Sesi mengakhiri semua sesi login peserta tersebut, misalnya saat ia perlu pindah komputer. Aksi ini tercatat.

Rekap Kelulusan dan Sertifikat

Menu Rekap Kelulusan (Admin Pusat dan Operator Prodi) menampilkan hasil per program studi. Pilih program studi lebih dulu, lalu ekspor ke CSV atau Excel. Satu baris mewakili satu keputusan gabungan, bukan satu sesi. Untuk peserta yang lulus tersedia sertifikat PDF. Mahasiswa tidak dapat mengunduh sertifikat sendiri.

Log Aktivitas

Admin Pusat dapat membuka log aktivitas (baca saja) yang mencatat perubahan pada entitas penting, termasuk perubahan peran dan aksi paksa keluar sesi.

Mekanisme Validasi Safe Exam Browser

Safe Exam Browser (SEB) mengunci perangkat peserta, tetapi aplikasi ujian harus memeriksa bahwa permintaan benar-benar berasal dari SEB yang sah. Bab ini menjelaskan cara PurwaExam melakukannya. Penjelasan konseptualnya ada di Safe Exam Browser: cara kerja dan cara memakainya.

Kapan Validasi Aktif

Validasi hanya berlaku pada sesi yang opsi Wajib Safe Exam Browser-nya dihidupkan. Bila opsi nonaktif, peserta dapat memakai peramban biasa.

Di Mana Validasi Diperiksa

Pemeriksaan dilakukan di tiga titik:

Saat peserta memulai ujian.
Saat halaman ujian dibuka atau dimuat ulang.
Setiap kali jawaban disimpan.

Cara Server Memvalidasi

SEB menambahkan header X-SafeExamBrowser-RequestHash pada setiap permintaan. Isinya adalah hash SHA-256 dari alamat lengkap permintaan digabung dengan Browser Exam Key. Server memvalidasi dengan langkah:

Mengambil alamat lengkap permintaan yang sedang diproses.
Menghitung SHA-256 dari alamat itu digabung Browser Exam Key yang berlaku untuk sesi tersebut.
Membandingkan hasilnya dengan nilai header menggunakan perbandingan yang aman terhadap serangan pengukuran waktu.
Bila cocok, permintaan diteruskan. Bila tidak cocok atau header tidak ada, permintaan tidak lolos.

Karena alamat ikut di-hash, nilai header untuk satu halaman tidak dapat dipakai untuk halaman lain.

Berkas `.seb`

Admin dapat mengunduh berkas konfigurasi .seb dari halaman sesi. Berkas ini hanya berisi alamat awal ujian (halaman dasbor peserta) dan hanya tersedia untuk sesi yang memakai SEB. Browser Exam Key tidak ditanam di dalamnya, sehingga kunci perlu disamakan secara manual antara SEB di laboratorium dan pengaturan aplikasi.

Menyiapkan SEB untuk Sesi

Seragamkan versi SEB di komputer ujian, karena Browser Exam Key bergantung pada build dan konfigurasi.
Hidupkan Wajib Safe Exam Browser pada sesi.
Unduh berkas .seb dari halaman sesi, lalu bagikan kepada panitia laboratorium.
Samakan Browser Exam Key antara SEB dan aplikasi sesuai prosedur panitia.
Uji di satu komputer: buka lewat SEB harus berhasil, dan buka lewat peramban biasa harus ditolak.

Pesan yang Dilihat Peserta

Bila peserta membuka ujian tanpa SEB yang valid, muncul pesan bahwa ujian wajib dibuka lewat aplikasi Safe Exam Browser. Bila validasi gagal di tengah ujian, kejadian dicatat sebagai kejadian mencurigakan dan tampil di tabel Peserta & Status.

Troubleshooting SEB

Gejala	Kemungkinan Penyebab	Solusi
Semua peserta ditolak	Browser Exam Key belum disamakan, atau opsi SEB aktif tanpa kunci yang benar	Periksa kunci di aplikasi dan SEB
Sebagian peserta ditolak	Versi SEB berbeda antar komputer	Seragamkan versi SEB
Ditolak hanya pada jaringan tertentu	Proxy menulis ulang alamat atau membuang header	Periksa jalur jaringan antara SEB dan server
Ujian bisa dibuka di peramban biasa	Opsi SEB belum dihidupkan pada sesi	Hidupkan opsi pada sesi
Berkas `.seb` tidak bisa diunduh	Sesi tidak memakai SEB, atau akun tidak berhak	Periksa pengaturan sesi dan peran akun

Notifikasi

Notifikasi tampil di ikon lonceng pada kedua panel, dan dikirim lewat email bila penerima memiliki email.

Notifikasi	Penerima	Pemicu
Pengingat jadwal	Peserta yang belum memulai	Sekitar sehari sebelum jadwal sesi
Hasil keluar	Peserta	Setelah keputusan paket diambil, bila hasil boleh ditampilkan
Uraian menunggu dinilai	Dosen pengampu, atau pembuat paket untuk Ujian Kompetensi	Setelah jawaban uraian terkumpul

Troubleshooting

Masalah	Kemungkinan Penyebab	Solusi
Tidak bisa login	Username atau password salah, atau panel yang dipilih tidak sesuai peran	Periksa username dan pilih panel yang benar
Reset password tidak berhasil	Akun tidak memiliki email	Hubungi admin untuk reset
Paket tidak muncul di Ujian Saya	Batch belum aktif, atau paket belum aktif, atau Anda belum terdaftar	Hubungi panitia
Muncul pesan belum terdaftar di batch aktif	Anda tidak ada di batch yang sedang aktif	Hubungi panitia untuk didaftarkan
Muncul pesan paket sudah dikunci	Periode ujian sudah berakhir	Hubungi dosen atau admin
Muncul pesan kuota penuh	Kuota peserta sesi sudah terpenuhi	Hubungi panitia
Token ditolak	Token salah atau kedaluwarsa, atau terlalu banyak percobaan	Minta token baru dan tunggu sesuai pesan
Tombol Aktifkan tidak dapat diklik	Total bobot belum sama dengan target skor	Sesuaikan jumlah soal atau bobot komponen
Skor belum muncul setelah mengumpulkan	Penilaian sedang diproses, atau menunggu uraian dinilai	Tunggu, atau hubungi dosen untuk uraian
Sertifikat tidak bisa dicetak	Hanya untuk peserta berstatus lulus dan oleh staf berhak	Periksa status di Rekap Kelulusan
Peserta tidak muncul di Rekap Kelulusan	Belum menuntaskan semua sesi atau masih menunggu penilaian	Tunggu hingga penilaian selesai

Di Luar Cakupan Saat Ini

PurwaExam belum mencakup pengawasan kamera dan mikrofon, autentikasi dua langkah, analitik butir soal (tingkat kesulitan dan daya pembeda), API publik, dan aplikasi seluler.

Informasi Teknis

Aspek	Detail
Framework	Laravel dan Filament
Antarmuka	Dua panel: Admin dan Peserta
Basis data	MySQL
Hak akses	Peran dan izin berbasis paket Spatie dan Filament Shield
Penilaian	Objektif otomatis lewat antrean, uraian oleh dosen dengan rubrik
Dokumen	PDF hasil, sertifikat, dan ekspor Excel/CSV
Audit	Pencatatan aktivitas pada entitas penting
Tipe soal	Pilihan Ganda, Pilihan Ganda Kompleks, Benar/Salah, Menjodohkan, Uraian
Durasi sesi	5 sampai 300 menit
Token	6 karakter, masa berlaku 5 menit sampai 24 jam
Pengawasan	Token, Safe Exam Browser, pencatatan kejadian mencurigakan

Butuh website atau aplikasi?