Panduan Penggunaan | BankSoal Online

1 Sekilas & peran pengguna

BankSoal Online memiliki dua halaman utama: Materi (bahan belajar) dan Ujian (simulasi CBT). Apa yang bisa dilakukan seseorang ditentukan oleh perannya. Ada tiga peran pokok.

Peran	Untuk siapa	Yang bisa dilakukan
Administrator	Pengelola sistem	Semua fungsi guru, ditambah kelola pengguna, kurikulum, pengaturan email, pencadangan, dan log
Guru	Pengajar	Buat materi & soal, susun modul ujian, awasi & nilai ujian, kirim pengumuman
Siswa	Peserta didik	Baca materi, kerjakan ujian, lihat nilai & pembahasan, kirim pesan ke guru

Khusus guru, admin dapat mempersempit hak menjadi preset Kontributor (hanya menambah materi & membuat soal, boleh pakai AI) atau Editor (hanya mengedit materi & soal). Materi dan ujian yang tampil untuk siswa otomatis disaring menurut jenjang (SD/SMP/SMA) yang dipilih saat mendaftar.

2 Mendaftar & masuk

Halaman masuk ada di alamat aplikasi (mis. app.banksoal.online). Dari situ tersedia tautan Daftar akun baru dan Lupa kata sandi.

Mendaftar dengan email

Klik Daftar akun baru, lalu pilih Daftar Sebagai: Siswa atau Guru.
Pilih Jenjang (SD/SMP/SMA). Untuk siswa ini menentukan materi & ujian yang tampil; untuk guru, jenjang yang akan diajar.
Siswa: isi Asal Sekolah lalu Pilih Guru. Hanya guru dari sekolah yang sama (guru online) plus Guru Sistem yang muncul. Bila belum ada guru online yang cocok, siswa otomatis diarahkan ke Guru Sistem.
Isi nama, email, dan kata sandi (minimal 6 karakter), lalu klik Daftar.
Buka email Anda dan klik tautan aktivasi sebelum masuk.

Masuk dengan Google

Pada halaman masuk atau daftar, klik Masuk/Daftar dengan Google, pilih akun Google Anda, lalu lengkapi data (peran, jenjang, sekolah, guru). Email dari Google sudah terverifikasi sehingga akun langsung aktif tanpa email aktivasi. Jika email Google Anda sudah pernah terdaftar, akun lama otomatis ditautkan ke Google.

Catatan peran

Guru yang mendaftar online langsung berperan guru setelah email terverifikasi; saat pertama masuk ia diminta mengisi nama sekolah.
Siswa wajib terhubung ke satu guru agar bisa mulai belajar.

Lupa kata sandi

Klik Lupa kata sandi, masukkan email, lalu ikuti tautan reset yang dikirim (berlaku 30 menit). Akun Google yang ingin juga bisa login dengan sandi dapat memakai fitur ini untuk menyetel kata sandi.

3 Panduan Siswa

Setelah masuk, siswa langsung berada di halaman Materi. Semua yang tampil sudah disaring ke jenjang Anda.

Membaca materi

Buka menu Materi, pakai filter kelas/semester/mata pelajaran atau kotak pencarian, lalu klik sebuah modul untuk membacanya.

Mengikuti ujian (CBT)

Buka menu Ujian, cari modul yang ingin dikerjakan, lalu buka detailnya.
Bila ujian meminta token, masukkan token dari guru. Sebagian ujian hanya boleh dikerjakan satu kali.
Klik mulai. Timer berjalan bila ujian dibatasi waktu; jawaban tersimpan otomatis saat Anda mengerjakan.
Selesai menjawab, klik kirim/submit. Jika waktu habis, ujian terkirim sendiri.
Pilihan ganda dinilai otomatis. Soal esai menunggu dinilai guru sebelum nilai akhir keluar.

Riwayat & pembahasan

Menu Riwayat berisi ujian yang pernah Anda kerjakan beserta skornya; buka sebuah riwayat untuk melihat pembahasan jawaban.

Profil & guru

Lewat Profil Anda dapat mengganti guru atau asal sekolah. Jika pilihan guru belum ada atau tidak lagi valid, sistem akan meminta Anda memilih guru sebelum bisa melanjutkan.

Pesan

Siswa dapat mengirim pesan ke gurunya melalui fitur Pesan untuk bertanya seputar materi atau ujian.

4 Panduan Guru

Guru dan admin masuk ke area pengelolaan (admin). Menu yang muncul mengikuti hak akses masing-masing.

Dashboard

Ringkasan jumlah materi, soal, ujian, dan aktivitas terbaru sebagai titik awal.

Materi & soal

Tambah/edit materi lewat menu Materi: isi kelas, semester, mata pelajaran, dan topik, lalu tulis konten dengan editor (mendukung rumus & media).
Impor cepat: ekstrak teks dari file PDF, atau impor struktur kurikulum untuk mengisi kelas/mapel/topik sekaligus.
Soal dilampirkan pada materi/bank soal dan dipakai saat menyusun ujian.

Buat soal dengan AI

Menu Pembuat Soal membantu membuat butir soal secara otomatis dari topik/materi. Fitur ini perlu hak ai.questions (dimiliki guru penuh dan kontributor) dan konfigurasi API model AI oleh admin.

Menyusun modul ujian (menu Ujian)

Buat modul baru: isi judul, jenjang/kelas/mapel, durasi, nilai kelulusan (passing score), dan opsi seperti token akses atau sekali kerja.
Tambah soal lewat pencarian bank soal; unggah media (gambar) atau ekstrak soal dari PDF bila perlu.
Atur jenis ujian dan kop/kepala naskah, lalu publikasikan agar tampil ke siswa.
Cetak naskah (print sheet) bila butuh versi kertas.

Mengawasi & menilai (menu Pengawas/Monitor)

Pantau sesi ujian yang sedang berjalan, termasuk indikator kecurangan (pindah tab, salin/tempel).
Nilai soal esai: buka sebuah sesi, beri skor tiap jawaban esai (0 hingga 100 persen), lalu simpan agar nilai akhir siswa final. Guru yang dibatasi mapel hanya menilai sesi dalam mapelnya.

Pengumuman

Kirim pengumuman yang tampil untuk peran tertentu (mis. semua siswa) di halaman mereka.

5 Panduan Administrator

Admin memiliki semua hak guru ditambah menu pengelolaan sistem berikut.

Kelola pengguna (menu Pengguna)

Tambah pengguna, atur peran & hak akses per orang, aktif/nonaktifkan, atau hapus. Untuk guru yang mendaftar online, admin dapat menyetujui atau menolak permintaan, serta menentukan mata pelajaran dan jenjang yang boleh diajar.

Kurikulum (menu Kurikulum)

Kelola jenjang, kelas, mata pelajaran, dan topik yang menjadi acuan materi dan ujian. Tambah atau hapus item sesuai kebutuhan sekolah.

Pengaturan email (menu Pengaturan)

Atur pengirim email untuk aktivasi akun & reset kata sandi. Pilih driver mail() atau SMTP (mis. Gmail/cPanel), lalu gunakan tombol uji untuk memastikan email terkirim.

Pencadangan & pemulihan (menu Backup)

Buat cadangan, unduh, pulihkan dari cadangan, atau atur pencadangan terjadwal (cron). Berguna sebelum melakukan perubahan besar.

Log sistem (menu Log)

Catatan aktivitas penting (login, pendaftaran, pengiriman ujian, dll). Bisa diunduh atau dibersihkan. Membantu menelusuri masalah atau dugaan penyalahgunaan.

Catatan: hak kurikulum, pengguna, email, backup, dan log khusus admin. Guru biasa tidak melihat menu-menu ini.

6 Keamanan ujian (anti-contek)

Saat menyusun modul ujian, guru dapat mengaktifkan beberapa pengaman:

Token akses: siswa harus memasukkan token sebelum mulai, sehingga ujian hanya bisa dibuka saat diizinkan guru.
Sekali kerja (one attempt): setiap siswa hanya boleh mengerjakan satu kali.
Batas waktu: timer berjalan dan ujian terkirim otomatis saat waktu habis.

Selama siswa mengerjakan, sistem mencatat indikator kecurangan yang bisa dilihat guru di halaman Pengawas: jumlah perpindahan tab, serta aktivitas salin, tempel, dan klik kanan. Angka ini membantu guru menilai kejujuran pengerjaan, bukan untuk otomatis menggugurkan siswa.

Jawaban tersimpan otomatis selama pengerjaan, sehingga gangguan koneksi sesaat tidak langsung menghilangkan jawaban yang sudah diisi.

7 Tanya-jawab & pemecahan masalah

Masalah	Penyebab & solusi
Tidak menerima email aktivasi/reset	Cek folder spam. Bila tetap tidak ada, admin perlu memeriksa Pengaturan Email (driver/SMTP) dan menjalankan tombol uji.
Tombol "Masuk dengan Google" tidak muncul	Google OAuth belum dikonfigurasi admin (Client ID/Secret di .env kosong).
Google menolak: redirect_uri_mismatch	URL callback aplikasi belum didaftarkan persis di Google Console (Authorized redirect URIs).
"Koneksi database gagal"	Pengaturan database di .env tidak cocok (nama DB, user, sandi, atau host). Samakan dengan data di panel hosting.
Akun belum bisa masuk	Akun belum diaktivasi lewat email, atau dinonaktifkan admin.
Siswa tidak melihat ujian tertentu	Ujian berbeda jenjang dari siswa, atau belum dipublikasikan guru.
Siswa diminta memilih guru terus	Pilihan guru belum diisi atau tidak lagi valid; lengkapi lewat Profil.
Terlalu banyak percobaan gagal	Pembatas anti brute-force aktif; tunggu beberapa menit lalu coba lagi.

Untuk masalah yang tidak tercantum di sini, hubungi administrator sekolah Anda; admin dapat memeriksa menu Log untuk menelusuri kejadiannya.