Lewati ke isi

Portal Panduan Pengoperasian Aplikasi Scola Assessment CBT (OS-v1.0)

Selamat datang di Portal Panduan Pengoperasian Resmi Scola Assessment Standalone CBT (Baseline OS-v1.0).

Dokumentasi ini disusun secara komprehensif untuk memandu seluruh pemangku kepentingan (peserta, pengawas, penilai, penyelenggara, dan operator sistem) dalam mengoperasikan aplikasi ujian berbasis komputer (CBT) mandiri bersertifikasi olimpiade.

1. Peta Peran & Matriks Akses (RBAC)

Aplikasi Scola Assessment memisahkan hak akses dan tanggung jawab secara ketat berdasarkan prinsip Least Privilege dan Separation of Duties:

Peran (Role) Tanggung Jawab Utama Akses URL Utama Buku Panduan
Peserta Ujian (Participant) Menjalankan pemeriksaan kesiapan perangkat, menghubungkan kamera dual-view Zoom, mengerjakan soal, memantau autosave, dan mengumpulkan ujian. /readiness
/runner/:session_id		 📘 Manual Peserta
Pengawas Ujian (Proctor) Memantau kehadiran peserta secara live, verifikasi foto webcam, meminta tantangan foto acak, mencatat tindakan beralasan (reasoned actions), dan mendampingi koneksi Zoom. /login
/proctor/:session_id		 🛡️ Manual Pengawas
Penilai Esai (Grader) Menilai jawaban esai pada antrean tertutup tanpa mengetahui identitas peserta (blind grading / PII masked) menggunakan rubrik analitik berbobot. /login
/grading/:session_id		 ⚖️ Manual Penilai & Reviewer
Pemoderasi Nilai (Reviewer) Memverifikasi dan memoderasi 100% skor esai (two-person rule): menyetujui skor atau merevisi dengan justifikasi wajib sebelum hasil dipublikasikan. /login
/grading/:session_id		 ⚖️ Manual Penilai & Reviewer
Penyelenggara (Organizer / Exam Manager) Mengelola event, sesi, ruangan, membuat soal KaTeX math, impor massal Excel/CSV, impor peserta & distribusi kode akses, serta membekukan hasil peringkat resmi. /login
/organizer
/organizer/events
/organizer/questions
/organizer/participants
/organizer/results/:session_id		 🗓️ Manual Penyelenggara
Operator Sistem (Platform Operator / Sysadmin) Menjalankan pre-flight release guard, memantau telemetri Command Center, menangani insiden teknis (AC-27), menjalankan deadline sweeper, audit closeout, dan retensi data. /login
/health
/api/v1/health/metrics
CLI Shell		 ⚡ Manual Operator Sistem

2. Struktur Buku Panduan Operasional

Klik tautan di bawah ini untuk membuka buku panduan spesifik sesuai peran Anda:

  1. 📘 Buku Panduan 01: Peserta Ujian (Participant Manual)
  2. Persiapan perangkat lunak: Unduh & instalasi Scola Launcher + Safe Exam Browser (SEB 3.7.0) All-in-One.
  3. Prosedur pemeriksaan kesiapan di /readiness dan penanganan kode bantuan (support code).
  4. Penyiapan sudut kamera smartphone 45° untuk Zoom Dual-View.
  5. Pengerjaan ujian di /runner/:session_id: navigasi soal, status simpan autosave, input jawaban PG, numerik, dan esai.

  6. Penyerahan jawaban atomik dan penyimpanan nomor tanda terima unik durabel.

  7. 🛡️ Buku Panduan 02: Pengawas Ujian (Proctor Command Center Manual)

  8. Login pengawas dan pemilihan ruangan ujian.
  9. Kredensial Zoom proctoring dan pengawasan dual-view.
  10. Pemantauan 5 metrik kehadiran: Aktif, Rekoneksi, Perhatian, Terputus, Telah Dikumpulkan.
  11. Peninjauan bukti foto webcam peserta dan pengiriman tantangan foto acak (instant random capture challenge).
  12. Eksekusi tindakan pengawas beralasan (reasoned action contract): Peringatan, Reset Kunci Perangkat, Jeda, dan Lanjut Ujian.

  13. Audit rekaman kronologis pada Modal Lini Masa (Audit Timeline).

  14. ⚖️ Buku Panduan 03: Penilai & Pemoderasi Esai (Grader & Reviewer Manual)

  15. Prinsip objektivitas penilaian buta (Blind Essay Grading): penyamaran ketat PII dan isolasi bukti foto kamera (CAM-08).
  16. Alur kerja Penilai (Grader): penilaian rubrik multi-kriteria bertingkat, perhitungan total skor, dan catatan evaluasi kualitatif.
  17. Alur kerja Peninjau (Reviewer - Two-Person Rule): opsi persetujuan penuh (Approve) atau revisi skor (Revise) dengan justifikasi wajib.

  18. Pembekuan nilai moderasi sebagai prasyarat publikasi hasil.

  19. 🗓️ Buku Panduan 04: Penyelenggara Ujian (Organizer & Backoffice Manual)

  20. Pusat kendali dashboard operasional di /organizer.
  21. Pembuatan event dan sesi pengerjaan berdurasi ketat di /organizer/events.
  22. Manajemen bank soal di /organizer/questions: manual authoring KaTeX math, impor massal spreadsheet Excel/CSV (Dry-Run & Commit), dan revisi versi soal (version bump).
  23. Impor peserta massal dan distribusi kredensial unik (slug URL & kode akses) di /organizer/participants.
  24. Pembekuan hasil ujian dan penentuan peringkat standar olimpiade (1, 1, 3 tanpa speed tie-break) di /organizer/results/:session_id.

  25. Unduh berkas rekap nilai, presensi, dan log insiden terlindungi injeksi formula (CSV Formula Injection Defense).

  26. ⚡ Buku Panduan 05: Operator Sistem & Sysadmin (Platform Ops Manual)

  27. Prosedur Pre-Flight T-60: verifikasi immutable release manifest, isolasi Odoo, dan pemberlakuan change freeze.
  28. Pemantauan telemetri real-time Command Center (pilot_telemetry_monitor.py): koneksi PostgreSQL, lock contention, antrean outbox, dan error upload storage.
  29. Prosedur force-majeure: penegakan batas waktu server (AC-27: larangan auto-extension pada crash/restart).
  30. Penutupan event pilot terotomasi (pilot_event_closeout.py / OS-080).
  31. Pembersihan retensi data kamera dan proteksi status penahanan sengketa (retention_lifecycle_sweep.py / OS-090).

3. Alur Siklus Hidup Ujian Terpadu (End-to-End Lifecycle)

Pelaksanaan ujian CBT mandiri mengikuti 3 fase terpadu:

flowchart TD
    subgraph PraUjian["1. FASE PRA-UJIAN (T-60 s.d. T-0)"]
        A1[Operator: Pre-Flight Checklist & Release Guard Verify] --> A2[Penyelenggara: Impor Peserta & Bank Soal KaTeX Freeze]
        A2 --> A3[Peserta: Download Scola Launcher & Cek Kesiapan di /readiness]
        A3 --> A4[Pengawas: Buka Ruang Zoom & Siapkan Command Center]
    end

    subgraph Pelaksanaan["2. FASE PELAKSANAAN UJIAN (T-0 s.d. Selesai)"]
        B1[Peserta: Masuk /runner/:session_id & Kunci Perangkat] --> B2[Peserta: Mengerjakan Soal, Autosave Monotonik & Preview Webcam]
        B2 --> B3[Pengawas: Pantau Kehadiran, Review Bukti Kamera & Reasoned Action]
        B3 --> B4[Peserta: Kumpul Ujian Atomik & Terima Tanda Terima Durabel]
        B4 --> B5[Operator: Eksekusi Deadline Sweeper untuk Attempt Kedaluwarsa]
    end

    subgraph PascaUjian["3. FASE PASCA-UJIAN & PENUTUPAN"]
        C1[Penilai: Koreksi Esai Buta Tanpa PII di /grading] --> C2[Reviewer: Moderasi Skor Two-Person Rule 100%]
        C2 --> C3[Operator: Eksekusi Audit Penutupan Event pilot_event_closeout.py]
        C3 --> C4[Penyelenggara: Bekukan Peringkat 1,1,3 & Ekspor CSV Aman di /results]
        C4 --> C5[Operator: Pembersihan Retensi Data Kamera & Preservasi Legal Hold]
    end

    PraUjian --> Pelaksanaan
    Pelaksanaan --> PascaUjian

4. Glosarium Istilah Kunci CBT

  • Safe Exam Browser (SEB): Aplikasi browser terproteksi yang mengunci lingkungan komputer peserta (mematikan pintasan tombol sistem, monitor eksternal, dan aplikasi pihak ketiga).
  • Scola Launcher: Aplikasi bootstrapper Windows (.NET 8 WPF) yang memverifikasi integritas sistem sebelum meluncurkan SEB.
  • Dual-View Proctoring: Metode pengawasan ganda menggunakan webcam depan laptop (tangkapan wajah berkala) dan smartphone via Zoom dari sudut 45 derajat (menyorot meja kerja, tangan, dan layar).
  • Bulkhead Storage Isolation: Arsitektur perlindungan di mana kegagalan penyimpanan media/foto kamera di latar belakang tidak pernah membatalkan, mengganggu, atau memperlambat penyimpanan jawaban ujian peserta.
  • Reasoned Action: Kebijakan di mana setiap tindakan pengawas (peringatan, reset sesi, jeda) wajib disertai alasan tertulis yang dapat diaudit, melarang diskualifikasi sepihak secara otomatis.
  • Blind Essay Grading: Penilaian esai di mana seluruh identitas peserta (nama, sekolah, nomor pendaftaran, dan foto) disamarkan secara total dari penilai demi menjaga objektivitas.
  • Two-Person Rule: Kebijakan integritas di mana setiap nilai esai yang diberikan oleh penilai pertama (grader) wajib dimoderasi dan disahkan oleh peninjau kedua (reviewer).
  • Standard Competition Ranking: Metode pemeringkatan olimpiade di mana skor yang sama memperoleh peringkat yang sama, dan peringkat berikutnya dilewati sesuai jumlah peserta seri (contoh: skor 95, 95, 90 menghasilkan peringkat 1, 1, 3). Waktu pengumpulan ujian dilarang dijadikan penentu peringkat (no speed tie-break).
  • Formula Injection Defense: Mekanisme pembersihan karakter berisiko (=, +, -, @) saat mengekspor data CSV agar tidak dieksekusi sebagai formula berbahaya oleh Microsoft Excel.