Lewati ke isi

ADR-001 — Modular Monolith CBT Standalone

Status: Accepted; diperbarui 2026-09-12 berdasarkan D01 dan ADR-002. Keputusan awal 2026-09-11 tetap dipertahankan untuk stack; cakupan hasil/sertifikasi digantikan baseline OS-v1.0. Ini target arsitektur, bukan bukti bahwa seluruh komponen telah berjalan.

Konteks

Produk independent tidak boleh membutuhkan runtime Odoo, struktur sekolah atau database Scola. Target 500 active attempts harus dibuktikan lewat uji, bukan disimpulkan dari pilihan framework.

Keputusan stack

Komponen Stack/batas
Web Vue 3 + TypeScript + Vite; UI Bahasa Indonesia; canonical English identifiers
API FastAPI modular monolith; satu codebase dan transaksi domain yang jelas
ORM/migration SQLAlchemy + Alembic; PostgreSQL authoritative; versi tepat dikunci/dibuktikan pada I1
Async Celery/Redis + PostgreSQL transactional outbox; Redis tidak menyimpan satu-satunya accepted answer/official score
Storage Private object storage untuk question media, camera still evidence dan reports
Gateway Same-origin /api/v1; tanpa VITE_API_URL produksi
Secure client Signed C#/.NET Windows launcher + SEB, sesuai ADR-002; bukan custom browser
External proctoring Smartphone Zoom, room reference privat; tanpa live-video platform internal

Batas domain

Identity/tenant access; Competition/enrollment; Question/ExamDefinition; Runner; SecureEnvironment; Monitoring/Evidence; Scoring/Ranking; Audit/Reporting. Public interfaces/events antar modul; worker dari codebase yang sama. Directory structure adalah target, bukan alasan rename besar tanpa story.

Accepted answer + audit/idempotency/outbox yang relevan harus atomik sebelum ACK. Service layer memvalidasi enrollment, version, device dan clock pada transaksi. Monitoring hanya read model; presence tidak memodifikasi lifecycle. Report/evidence jobs tidak memblokir answer path.

Konsekuensi dan batas klaim

API/worker/Redis restart tidak boleh menghilangkan ACK; disaster loss diperlakukan berbeda menurut D09. Pool size/CPU/topology ditetapkan dari hasil load, bukan disamakan dengan 500 peserta. Tidak mengklaim PostgreSQL/async otomatis menjamin no-loss.

Certificate, live leaderboard, multi-select, mobile/tryout certification di luar v1. Scola connector API setelah pilot, database dan role tetap terpisah. Rujuk baseline aktif, ADR-002 dan data ownership.