Domain: CBT Independen — Olympiad Secure v1
Acuan aktif lintas fase untuk produk, spesifikasi, backlog, dan kelulusan pengembangan.
Baseline: OS-v1.0 — disetujui pengguna 12 September 2026.
Source audit baseline: 0dd9056e4151bc425a272c588850fd0dec562624; remediation R0/R1 berjalan pada tree kerja yang belum menjadi kandidat rilis.
Implementasi: belum tersertifikasi; tidak ada gate I0–I9 yang dinyatakan lulus dan tidak ada artefak release aktif yang sah.
Audit fungsional terbaru — 20 September 2026
Audit end-to-end pada source
45e16ba86cb35df5b8e36084c62237174790ee1c menghasilkan NO-GO PRODUCTION:
55 kelompok gap (40 P0, 15 P1 wajib v1), dengan reproduksi backend dan komponen UI.
Lanjutkan melalui register gap,
backlog gap CSV, dan
rekomendasi keputusan.
Audit ini memperbarui bukti implementasi, bukan persetujuan produk baru. Status story tetap pada implementation-backlog.csv; status gap CBT pada backlog gap. Nilai DEC/OP yang OPEN tetap memerlukan keputusan customer. Tabel baseline historis di bawah bukan status source terbaru; gunakan audit bertanggal untuk status implementasi. Tidak ada production promotion atau certification tersirat.
1. Visi dan batas produk
Satu produk CBT mandiri untuk penyelenggara olimpiade online: menyiapkan lomba, mengimpor peserta, menjalankan ujian aman, mengawasi secara manual, menilai, menerbitkan hasil yang dapat ditelusuri, dan menangani sengketa. Pilot satu organizer, tenant-ready, target pengujian 500 peserta aktif bersamaan. Tidak membutuhkan database, akun siswa, rombel, atau runtime Odoo.
Pilot: Windows + signed launcher C#/.NET + SEB; kamera laptop berupa preview dan still evidence; smartphone Zoom eksternal sebagai satu-satunya live feed. Human proctor mengambil keputusan, bukan mesin. Browser biasa bukan fallback otomatis untuk secure round. Zoom tidak menjadi prasyarat transaksi penyimpanan jawaban.
Jenis soal: PG satu jawaban, numerik bertoleransi, esai dengan blind grading dan reviewer berbeda. Hasil frozen/approved, shared rank tanpa speed tie-break. Sertifikat, multi-select, live leaderboard, tryout/mobile sebagai rilis tersertifikasi, payment/self-registration, AI/biometric proctoring, video recording/streaming internal, dan SaaS administration kompleks di luar v1.
Tidak ada klaim bebas kecurangan, dukungan perangkat universal, SLA produksi, atau kapasitas tersertifikasi sebelum evidence. Referensi teknis SEB dan media capture berada di review sumber; verifikasi ulang dokumentasi resmi untuk versi yang dipilih saat spike. Tidak menetapkan dasar hukum/retensi tanpa customer/privacy owner.
1.1 Keputusan yang telah disetujui
Persetujuan pengguna: “Setuju. Lanjutkan finalisasi spesifikasi dan backlog implementasi.” Ini menyetujui rekomendasi D01–D09 pada review sebelumnya, bukan menyatakan spike lulus, menutup parameter terbuka, atau mengizinkan production.
| ID | Keputusan OS-v1.0 |
|---|---|
| D01 | Vue 3/TypeScript/Vite + FastAPI + SQLAlchemy/Alembic + PostgreSQL; satu repo scola-assessment; tidak rewrite Next.js/NestJS/Prisma. |
| D02 | Pilot secure olympiad Windows; dual-view diadopsi dengan validation gate; tryout/mobile bukan cakupan sertifikasi v1. |
| D03 | PG satu jawaban + numerik + esai; multi-select ditunda. |
| D04 | Sertifikat ditunda; laporan hasil dan ekspor tetap wajib. Endpoint historis certificate harus dikeluarkan dari release surface, bukan dianggap fixed. |
| D05 | Standard competition ranking (contoh skor 95,95,90 menghasilkan rank 1,1,3); tidak memakai waktu submit sebagai pembeda; hasil hanya setelah freeze dan approval. |
| D06 | Strict deadline; tidak ada grace answer, pause atau penambahan waktu pada pilot. Recovery tidak mengubah deadline, termasuk saat gangguan massal. |
| D07 | 500 concurrent, RPO ≤5 menit/RTO ≤60 menit adalah target engineering; parameter kamera/operasi tetap memerlukan nilai approved. |
| D08 | Freeze versi paket/soal/rubrik/scoring sebelum publish/admission, lebih awal daripada first attempt. |
| D09 | Nol kehilangan ACK pada restart proses/worker/Redis; site disaster memakai RPO terpisah. Data loss pasca restore memerlukan keputusan incident/retest, bukan auto-resume. |
1.2 Register keputusan customer yang masih terbuka
APPROVED_SCOPE bukan APPROVED_VALUE. Kolom ini tidak boleh diisi agen dengan tebakan. Owner menunjuk nama penanggung jawab sebelum gate terkait.
| ID sumber | Status / nilai yang tersedia | Nilai/bukti yang masih diperlukan | Owner | Batas penyelesaian |
|---|---|---|---|---|
| DEC-01 | OPEN | Actual registered count, concurrent event count dan profile event | PO/customer | Sebelum OS-070 dan admission event |
| DEC-02 | APPROVED 2026-09-12 | Windows 10 22H2/Windows 11 22H2+, .NET 8 LTS, SEB pinned after spike, RAM 8 GB, webcam 720p, satu layar; dua perangkat per OS | Architect/customer | Bukti spike sebelum I4 |
| DEC-03 | OPEN | Points benar/salah/kosong per soal/event, numeric tolerance, precision/rounding, jadwal/round/category final | Customer/exam manager | Sebelum freeze OS-024; golden dataset OS-060 |
| DEC-04 | OPEN | Kapasitas grading/reviewer dan target tanggal hasil di OP-02 | Customer | Roster sebelum I7 |
| DEC-05 | APPROVED 2026-09-12 | Secure round Windows+launcher+SEB; accommodation ditetapkan sebelum admission; browser biasa hanya tryout non-secure | PO/customer | Rehearsal |
| DEC-06 | APPROVED 2026-09-12 | Nomor peserta + wajah still awal, notice/consent eksplisit; tanpa biometrik/face matching | Customer/privacy owner | Real capture |
| DEC-07 | APPROVED 2026-09-12 | Satu still awal, maksimum enam still/120 menit, JPEG ≤1 MB, timeout 15 dtk, retry maks. tiga | PO/security | Production policy OS-065 |
| DEC-08 | APPROVED 2026-09-12 | Object storage privat S3-compatible, SSE/TLS, retention 30 hari setelah dispute window, legal hold manual, lifecycle delete termasuk backup/version | Customer/privacy owner | Pilot evidence access |
| DEC-09 | APPROVED 2026-09-12 | Failure kamera/Zoom menjadi incident tanpa auto-extension; accommodation dan channel aman ditetapkan sebelum admission | Customer/exam manager | OS-066 |
| DEC-10 | APPROVED 2026-09-12 | Rasio awal 1 proctor:25, satu backup per 100; akun/room Zoom milik organizer | Operations/customer | OS-066/final load model |
| DEC-11 | APPROVED 2026-09-12 | Staging terisolasi, managed PostgreSQL PITR+WAL/Redis/Celery/object storage, event-only 24x7 alert roster, target RPO 5m/RTO 60m diuji | Platform/customer | Topology freeze OS-072 |
| DEC-12 | OPEN | Nama approver/publisher/penalty authority, visibility hasil, dispute window, retraction/retest procedure | Customer | Sebelum OS-061/073 |
| OP-01 | APPROVED 2026-09-12 | Launch authorization 5m, runner session 60m atau deadline, one-time SEB handoff, presigned upload 2m | Architect/security/ops | Kontrak slice terkait |
| OP-02 | OPEN | Grading duration, rubric calibration, 100% moderation workload, staffing dan jadwal pengumuman | Customer/grading lead | Sebelum rehearsal/UAT |
| OP-03 | OPEN | Penanganan errata/void item, regrade policy, fairness incident dan retest | Customer/exam manager | Sebelum freeze event/UAT |
Tidak semua DEC harus selesai untuk memulai foundation dengan data sintetis. Namun fitur yang bergantung pada nilai tersebut tidak boleh melewati build/policy/rehearsal gate masing-masing. Register ini adalah satu sumber status keputusan.
2. Arsitektur, data, capability dan API
| Area | Acuan aktif |
|---|---|
| Stack/batas modul | ADR-001, ADR-002 secure pilot |
| Entitas, invariants, migrasi | Data ownership |
| Peran dan otorisasi | Authorization matrix |
| Perilaku API lintas fase | API dan secure-proctoring contract |
| Kontrak machine-readable | OpenAPI: target contract work-in-progress; DTO lengkap dibekukan per slice sebelum coding |
| Acceptance dan traceability | Acceptance matrix, Backlog CSV, Finding ledger |
| Performa dan monitoring | Capacity, Observability |
| Operasi/pemulihan | Incident, DR, Grading capacity |
| Release/customer acceptance | Pilot checklist, UAT template |
Backend module target: Identity, Competition, Question/ExamDefinition, Runner, SecureEnvironment, Monitoring/Evidence, Scoring/Ranking, Audit/Reporting. Saat baseline sebagian besar logic masih ada di controllers; nama modul di dokumen bukan klaim folder/service sudah diimplementasikan.
Frontend mempertahankan views yang relevan tetapi mock harus diganti lewat vertical slice. Camera state tidak boleh mengubah accepted answer/timer. Endpoint browser same-origin /api/v1, tanpa VITE_API_URL production. Native launcher memerlukan token handoff khusus, bukan browser credential jangka panjang.
3. Fitur dan status implementasi
Source baseline: main @ 78e9e4689f912732e3495f78f2e2959f53eff0c7. Status berikut berdasarkan audit/review baseline, bukan tes ulang runtime dalam finalisasi dokumentasi.
| Fitur | Status | Syarat penyelesaian |
|---|---|---|
| Auth/tenant/runner admission | PARTIAL_UNSAFE | A01/A03/A06/A08; negative scope dan revocation |
| Authoring/form assembly | PARTIAL_UNSAFE | A02; persistent items dan frozen attempt snapshot |
| Runner/answer/submit | PARTIAL_UNSAFE | A07; lock/idempotency/deadline + real UI |
| UI organizer/runner/proctor/grading/results | MOCK_OR_PARTIAL | A04; E2E terhadap API/DB nyata |
| Esai/scoring/publication | PARTIAL_UNSAFE | A05/A09; bounded grading dan immutable publication |
| Outbox/storage/worker | PLACEHOLDER_OR_PARTIAL | A10; real side effects/retry/integrity |
| Windows launcher/SEB/dual-view | NOT_IMPLEMENTED | OS-001/004 dan I4/I5 |
| Load/DR/UAT certification | NOT_VERIFIED | A11/A12/A13 dan I7; tidak mengadopsi PASS template lama |
| Certificate | OUT_OF_SCOPE | Exclude melalui RM-011; jangan menghapus data/kode tanpa task |
| Scola connector | POST_PILOT | I9, API only, separate certification |
4. Gap analysis, backlog dan implementation plan
4.1 Cara membaca prioritas dan status
P0: integritas/security/foundation/gate release. P1: wajib v1 bila release_required=yes, bukan optional. DEFERRED: di luar v1. Semua backlog implementasi dimulai PLANNED; persetujuan spesifikasi tidak mengubahnya menjadi DONE.
Alur status: PLANNED → READY → IN_PROGRESS → REVIEW → VERIFIED → DONE. BLOCKED mencantumkan decision/dependency/owner/next action. DONE membutuhkan accepted review dan evidence pada exact source/candidate; pekerjaan dokumentasi dapat DONE tanpa mengklaim runtime pass. Daftar CSV adalah tracker operasional; tabel fase adalah summary, tidak menyimpan status story tandingan.
4.2 Implementation plan lintas fase
| Fase | Outcome, scope dan backlog | Dependency/owner utama | Exit gate |
|---|---|---|---|
| I0 — Scope dan feasibility | OS-000–004: keputusan, proof launcher→SEB, kamera, autosave/reconnect/deadline dalam prototype disposable | PO + architect/security; DEC-02 dan izin prototype | Bukti spike supported matrix, risk disposition dan approval; keputusan yang belum jatuh tempo tetap tercatat |
| I1 — Foundation dan akses | OS-010/011/012/020; RM-001/002/010: CI, migration-only, disposable tests, logs, outbox, auth/MFA/revocation, contract workflow, login UI nyata | I0 scope; platform + identity | Sample vertical slice + auth/tenant negatives; no default production secret; pipeline aman |
| I2 — Competition dan exam definition | OS-021–024; RM-003/007: hierarchy minimum, room/enrollment/import, media, versioned questions/rubric/form items, authoring UI | I1; competition/authoring | Prepare→validate→freeze rehearsal exam; wrong org/event/form/assignment blocked; legacy data excluded |
| I3 — Authoritative runner | OS-030–033; RM-004/005: runner context, snapshot, device lock, save/reconcile, submit/receipt, deadline sweep, participant UI | I2 + auth; runner | Real PostgreSQL race/idempotency + E2E: no foreign question, no late answer, one receipt, ACK survives process restart |
| I4 — Windows secure environment | OS-040–042: readiness, signed launcher/update/uninstall, expiring handoff, SEB context/version enforcement | I0 spike + I3 boundary; security/launcher | Actual Windows/SEB matrix dan direct/replay/expired-context negatives lulus |
| I5 — Dual-view dan proctor | OS-050/051/052/064/065/066; RM-008: realtime scoped rooms, camera lifecycle/evidence, private Zoom refs, manual incident workflow | I3/I4 + privacy decisions; proctor/platform/security | CAM-01–10 lulus; storage/camera failure tidak merusak jawaban; operational rehearsal lulus |
| I6 — Scoring dan publication | OS-060–063; RM-006/009/011: bound rubric, assigned grading + different reviewer, golden scores, immutable ranking/publication, exports, exclude certificate | I3; grading/results; dapat overlap I4/I5 bila contracts stabil | Reproducible results, all essay moderated, unauthorized publish denied, historical snapshots tetap utuh |
| I7 — Hardening dan UAT | OS-070–073; RM-012: complete-scope load/security/resilience, PITR/media restore, monitoring, UAT dan immutable release tooling | I1–I6; QA/platform/customer | Exact candidate full evidence; no open critical/high release-impact finding; signed UAT; seluruh DEC yang relevan resolved |
| I8 — Pilot dan stabilization | OS-080/090: authorized release, event ops, result/dispute closeout, postmortem | I7 + izin produksi tersendiri; operations/customer | Event closeout diterima, insiden integritas selesai, retention jobs/handover dan stabilization evidence |
| I9 — Connector Scola | SC-001/002/003: external identity mapping, roster import, results delivery/reconcile dan isolated joint UAT | I8; integration owner + izin fase | No DB sharing, duplicate/replay/cross-tenant negatives, Scola outage tidak mengganggu CBT, joint acceptance |
I9 memperjelas pekerjaan setelah I8 yang dulu disebut “Fase 5 integrasi Scola”. Phase 5 pada paket Astra adalah proctoring (I5), bukan connector. R0–R5 tetap dipetakan di CSV. Tidak renumber OS source IDs.
Urutan jalur kritis: I0 → I1 → I2 → I3 → I4/I5 dan I6 → I7 → I8 → I9. Foundation sintetis boleh dimulai setelah scope disetujui dan izin implementasi, sementara spike menunggu perangkat; secure architecture freeze tetap tidak boleh melewati spike. Tidak ada kalender pasti: estimasi person-days per slice setelah I0, review setiap gate. Solo + AI tidak menggantikan kebutuhan reviewer independen, proctor, grader atau customer approver.
4.3 Definition of Ready setiap story
- Requirement/AC ID, scope/non-goals, dependency dan keputusan yang jatuh tempo jelas.
- Current code/request path diinspeksi; allowed files dan satu pemilik migration/shared contract ditetapkan.
- DTO/API/error/idempotency/authorization dan perubahan data disepakati sebelum feature code.
- Test environment disposable sudah divalidasi; command tes bukan asumsi script tersedia.
- Migration impact, rollback/forward-fix, privacy dan operational impact tercatat.
- Owner dan reviewer ditunjuk; task implementasi memang diizinkan.
4.4 Definition of Done dan bukti
Setiap slice mencakup persistence, domain, API/client, UI nyata, auth/audit/outbox, unit/integration/contract/E2E, observability, migration dan dokumentasi. Perubahan kritis wajib negative/concurrency/failure tests, bukan happy path saja.
Evidence record wajib: story/AC/finding IDs; source commit/tree + dirty state; exact command dan working directory; environment/DB identity tersanitasi; time UTC; exit code; assertions/count/latency riil; artifact path/hash; reviewer/date; residual. Release evidence menambah FE/BE/migration/launcher/SEB config/storage policy identities. Jangan log secrets, foto, answer text, atau PII.
Tidak menutup gap dengan test skipped, fixture gagal, endpoint mock, UAT prefilled, atau hasil in-process untuk klaim kapasitas deployment. NOT_RUN/NOT_VERIFIED berbeda dari FAIL dan PASS. Gate kritis tanpa bukti tetap blocked.
4.5 Paket kerja untuk melanjutkan sesi agent
Salin sebagai task packet; isi nilai sebelum implementasi:
- Baseline: OS-v1.0 dan source HEAD aktual.
- Story/AC/finding: isi dari CSV dan acceptance matrix.
- Objective: satu outcome pengguna yang dapat diuji.
- Decisions/dependencies: resolved IDs dan open blockers.
- Allowed paths/non-goals: eksplisit; raw references read-only.
- Contract/migration: DTO, invariants, concurrency, privacy, forward-fix.
- Verification: exact commands setelah inspeksi tooling; expected assertions dan target disposable.
- Handoff: files changed, evidence, reviewer, residual, next story dan perubahan status CSV.
Awali setiap sesi dengan membaca halaman ini, workspace rules, story terkait dan current source; akhiri dengan memperbarui tracker/evidence. Jangan menganggap chat lama atau label “fase selesai” sebagai bukti.
4.6 Definisi aplikasi selesai
V1 standalone selesai setelah I0–I8: seluruh release_required=yes scope v1 DONE, A01–A13/N findings ditutup atau bagian out-of-scope punya disposition eksplisit, exact candidate certified, pilot/hasil/sengketa closeout diterima, operasional/backup/retention/support handover selesai. Sertifikat, tryout/mobile dan multi-select bukan syarat v1.
Program integrasi selesai setelah I9 diterima bersama Scola. Tidak menjadikan integrasi syarat kemampuan CBT beroperasi independen, dan tidak memasukkan hasil olympiad otomatis ke e-rapor.
5. Tata kelola sumber dan changelog
OS-v1.0 adalah baseline produk yang disetujui. Detail engineering baru di dokumen teknis adalah design baseline untuk review per slice; nilai customer OPEN tidak boleh disimpulkan dari persetujuan umum.
Raw ZIP/DOCX tidak diedit; provenance. Review Astra 12 September menjadi historical rationale, bukan tracker aktif. Existing ADR-001 tetap ID proyek; ADR-001 dalam ZIP hanya namespace sumber.
Perubahan aturan produk wajib decision log/ADR dan version bump. Perubahan DTO harus OpenAPI/generated client/contract tests bersama. Bukti status implementasi ditaruh pada story/ledger, bukan membuat PRD/plan baru per sesi.
Changelog 2026-09-12: D01–D09 disetujui; stack retained; secure pilot scoped; esai retained; certificates/multi-select/live modes deferred; strict deadline dan early freeze enforced pada spesifikasi; R/OS mapping + remediation + connector backlog aktif; SOP/UAT lama dikoreksi. Tidak ada aplikasi/runtime yang diubah.
Mode finalisasi: server, workspace /home/scola/odoo, repo scola-assessment. Panduan dibaca: AI_AGENT_MASTER_GUIDE, development-guide, workspace-governance, architecture-api, DOCUMENTATION_GOVERNANCE, release-environment-promotion, environment-isolation-and-promotion dan workspace-rules repo. Skill release-promotion diterapkan pada dokumen gate/DR saja; service/database/hostname Odoo tidak disalin sebagai target CBT.
5.1 Verifikasi paket dokumentasi
Pemeriksaan 2026-09-12: 51 story (36 OS asli + 12 remediasi RM + 3 connector SC), 38 acceptance cases, 25 findings A/N. CSV parse, ID uniqueness, dependency resolution/cycle detection, decision/AC/story cross-references, local Markdown links, whitespace, OpenAPI YAML parse/local schema references/path parameters dan byte-identical 39 raw archive members diperiksa. Hasil: PASS untuk pemeriksaan struktur dokumentasi tersebut.
Ini tidak mencakup full OpenAPI semantic/implementation parity certification, app tests, Windows spike, load, restore, UAT atau deployment; seluruh gate itu tetap mengikuti backlog. Perubahan finalisasi hanya dokumentasi, belum commit/push. Untuk mengulangi pemeriksaan struktur, baca CSV/YAML tanpa mengimpor backend app; jangan memicu create_all saat memeriksa kontrak.