Overview

Yellow Bank Soal adalah backend bank soal adaptif yang menyatukan tiga hal yang biasanya terpisah:

1. Kompatibilitas penuh dengan workflow Excel klasik (CTT — Classical Test Theory).
2. Modernisasi bertahap ke IRT (Item Response Theory, model Rasch 1PL) dan CAT (Computer Adaptive Testing).
3. Pembuatan soal varian otomatis lewat AI (OpenRouter: Qwen, Llama, Mistral).

Sistem ini dirancang sebagai backend terpusat yang melayani banyak situs WordPress (multi-tenant) dan terintegrasi dengan plugin Sejoli Tryout untuk pembelian, autentikasi, dan manajemen quota.

Filosofi Desain

flowchart LR
    A["Workflow Excel Klien"] --> B["yellow-bank-soal"]
    B --> C["CTT 100 persen kompatibel"]
    B --> D["IRT adaptif (CAT)"]
    B --> E["AI variant generation"]
    C --> F["Non-disruptive: tambahan, bukan pengganti"]
    D --> F
    E --> F

Tiga prinsip yang membentuk setiap keputusan teknis:

• Non-destructive — semua fitur baru bersifat additive. Workflow Excel klien tetap jalan, IRT/CAT adalah opsi yang bisa diaktifkan bertahap.
• Kompatibel 100% — skor CTT (p, Bobot, NM, NN) harus identik dengan Excel klien sampai 4 desimal.
• Modernisasi bertahap — tidak ada "big bang migration". Admin bisa mulai dari ctt + static, lalu naik ke hybrid saat data kalibrasi cukup.

Untuk Siapa?

Masalah yang Diselesaikan

Fitur Utama

Skoring Ganda (CTT + IRT)

• CTT — p, Bobot, NM, NN (kompatibel Excel klien).
• IRT — Rasch 1PL: theta (kemampuan), b (kesulitan), SE (presisi).
• Hybrid — keduanya dihitung paralel, admin pilih primary.

Computer Adaptive Testing (CAT)

Pemilihan soal adaptif berdasarkan estimasi theta siswa, dengan terminasi otomatis saat presisi sudah cukup (SE < 0.5 setelah minimal 15 soal).

AI Question Generation

Varian soal Mudah/Sulit dibuat otomatis dari basis Sedang via OpenRouter, dengan caching per user untuk efisiensi biaya.

Multi-Tenant WordPress

Satu backend melayani banyak situs WordPress, isolasi data via website_id + header X-Website-ID.

Integrasi Sejoli Tryout (planned)

Plugin Sejoli jadi source of truth untuk pembelian & quota; app yellow-bank-soal urus pengiriman soal, scoring, dan hasil. Lihat Integrasi → Sejoli Tryout.

Roadmap Singkat

Migrasi dari CTT ke IRT dilakukan bertahap (detail di Roadmap):

1. Minggu 1 — Impor data Excel eksisting, mode ctt + static.
2. Minggu 2-4 — Kumpulkan data kalibrasi (minimal 100 respon per soal).
3. Minggu 5 — Aktifkan dynamic normalization.
4. Minggu 6+ — Aktifkan irt + adaptive (CAT penuh).

Bacaan Lanjutan

• Arsitektur — komponen sistem & alur data
• Tech Stack — teknologi & versi minimum
• Konsep → Variabel & Rumus — definisi p, Bobot, NM, NN, theta, b
• Konsep → Alur & Algoritma — 8 diagram alur lengkap