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.