Lewati ke isi

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.