Dokumentasi

Panduan lengkap instalasi dan penggunaan ZenCBT — dari setup database hingga pelaksanaan ujian.

Daftar Isi

🗄️ Tahap 1: Setup Database (PostgreSQL)⚡ Tahap 2: Instalasi & Menjalankan ZenCBT📦 Tahap 3: Manajemen Data & Soal🎯 Tahap 4: Pelaksanaan Ujian

🗄️ Tahap 1: Setup Database (PostgreSQL)

ZenCBT menggunakan PostgreSQL agar performa tetap cepat walau menampung ribuan koneksi ujian simultan.

Windows / Mac

  1. 1Unduh PostgreSQL: Buka situs resmi PostgreSQL dan pilih installer sesuai OS. Direkomendasikan versi 14 ke atas.
  2. 2Instalasi: Lakukan instalasi standar (Next-Next). Saat diminta membuat password untuk superuser postgres, gunakan password yang mudah diingat.
  3. 3Buat Database: Buka pgAdmin 4 (bawaan PostgreSQL), masuk dengan password Anda, lalu buat database baru bernama zencbt. Alternatif via Command Line: psql -U postgres -c "CREATE DATABASE zencbt;"
  4. 4Import Database: Import file init_db_zencbt_1.0.0.sql yang terdapat di dalam folder ZenCBT ke database zencbt yang baru dibuat.

Linux

  1. 1Install PostgreSQL: Jalankan sudo apt install postgresql postgresql-contrib
  2. 2Buat Database: Jalankan psql -U postgres -c "CREATE DATABASE zencbt;"
  3. 3Import Database: Import file init_db_zencbt_1.0.0.sql ke database zencbt.

⚡ Tahap 2: Instalasi & Menjalankan ZenCBT

Download, setting .env, dan langsung jalankan.

  1. 1Unduh & Ekstrak: Download file zip rilis ZenCBT terbaru. Letakkan dan ekstrak di satu folder tersendiri. Untuk windows, gunakan path tanpa spasi!
  2. 2Sambungkan Database: Buka file .env yang berada di dalam folder tersebut menggunakan Notepad. Cari tulisan DB_PASSWORD=... lalu ganti isinya dengan password PostgreSQL yang Anda buat pada Tahap 1.
  3. 3Jalankan Aplikasi: Klik ganda file zencbt.exe (Windows) atau ./zencbt (Linux). Sistem akan otomatis mendeteksi database dan melakukan auto-migration tabel.
  4. 4Login Admin: Buka browser (Chrome/Edge/Firefox) lalu akses http://localhost:8080 (atau http://IP_Server:8080 dari komputer lain di jaringan LAN). Gunakan Username dan Password bawaan yang ada di rilis versi.

📦 Tahap 3: Manajemen Data & Soal

Lengkapi master data, impor siswa, dan susun bank soal.

  1. 1Atur Identitas: Masukkan Logo Sekolah dan nama lembaga Anda di menu konfigurasi (Settings).
  2. 2Lengkapi Data Master: Isi data Program, Level, Group, dan Mata Pelajaran.
  3. 3Impor Data Siswa: Buka menu Master Data → Siswa, impor data peserta didik menggunakan Template Excel yang tersedia. Level, Group, dan Program mengikuti data yang sudah ada di template.
  4. 4Susun Bank Soal: Masuk ke menu Bank Soal, unggah berkas .docx (MS Word) rancangan Anda — selesai tanpa kendala ketik ulang gambar/tabel!

🎯 Tahap 4: Pelaksanaan Ujian

Rilis jadwal, pantau ruangan, dan cetak nilai.

  1. 1Rilis Jadwal: Pada menu Daftar Ujian, klik Tambah, pilih Bank Soal, tentukan Alokasi Waktu, kemudian terbitkan jadwal agar berstatus Aktif. Berikan Token Ujian kepada siswa yang masuk ruangan.
  2. 2Kendalikan Ruangan: Pantau siswa yang sudah online dan mengetik jawaban secara utuh dari meja Operator melalui layar monitoring.
  3. 3Cetak Nilai: Setelah timer peserta habis (diproses 100% via server, menutup peluang cheat time), beralih ke menu Hasil/Nilai, lalu unduh rekap Laporan Excel nilai untuk rapor hari itu juga.

Butuh bantuan lebih lanjut? Hubungi kami melalui:

Telegramadmin@hazenlabz.id