Workspace & Governance Rules: scola-assessment
Dokumen ini mendefinisikan aturan tata kelola, isolasi workspace, dan struktur repositori mandiri untuk scola-assessment.
Baseline aktif sejak 2026-09-12: OS-v1.0 dan implementation plan. Mulai setiap fase dari baseline, CSV backlog, acceptance matrix dan finding ledger; jangan memakai raw reference prompts sebagai instruksi root. Struktur di bawah adalah target, bukan klaim semua folder/CI sudah tersedia. I9 connector adalah Fase 5 lama; Astra phase 5 berarti proctoring I5.
1. Kemandirian Repositori & Lokasi Workspace
- Bukan Addon Odoo:
- Repositori
scola-assessmentadalah produk mandiri (modular monolith) dan TIDAK ditempatkan di dalam direktoriaddons/,custom_addons/, ataucustom_addons_scola/. -
Repositori ini memiliki
.gitindependen dan dependencies terpisah (requirements.txt,package.json). Pipeline CI dan database/role terisolasi adalah requirement yang harus dibuktikan, bukan diasumsikan dari dokumen. -
Isolasi Database:
- Database CBT mandiri wajib tidak berbagi tabel, role, atau skema dengan database Odoo. Nama database/service/port aktual harus diinspeksi sebelum operasi; nama contoh bukan target operasional.
-
Tidak ada koneksi langsung dari CBT backend ke tabel Odoo. Seluruh interaksi masa depan (I9, Fase 5 lama) hanya melalui connector API setelah pilot stabil.
-
Branching Strategy:
- Branch default:
main. - Feature branches:
feat/*,fix/*,chore/*. - Semua perubahan melalui code review dan pull request yang lulus automated checks.
2. Struktur Direktori Repositori
scola-assessment/
├── docs/
│ ├── architecture/ # ADRs, domain boundaries, data ownership
│ ├── specs/ # OpenAPI v1, acceptance matrix, capacity profile
│ └── runbooks/ # Disaster recovery, incident, grading capacity
├── backend/ # FastAPI Modular Monolith
│ ├── app/
│ │ ├── core/ # Config, database, security, tenancy, outbox
│ │ ├── modules/ # Domain modules (organizer, authoring, runner, grading, results)
│ │ └── workers/ # Celery background tasks
│ ├── alembic/ # Database migrations
│ └── tests/ # Unit, integration, and contract tests
├── frontend/ # Vue 3 + TypeScript SPA
│ ├── src/
│ │ ├── views/ # Organizer backoffice, participant runner, grading UI
│ │ ├── components/ # Reusable UI components
│ │ └── services/ # OpenAPI generated API client
│ └── tests/ # Vitest & Playwright tests
├── tests/
│ ├── fixtures/ # Olympiad, tryout, rubric, and auth fixtures
│ └── load/ # k6 scripts for 500 concurrent participants
└── Makefile / docker-compose.yml
3. Preservasi Repositori Scola Terkait
- Workspace
/home/scola/odoo: - Repositori
scola-fe-v2dancustom_addons_scola/gcgscolatetap utuh. - Modifikasi aktif pada modul attendance (
scola_attendance,PickupLobby.vue,pickupDisplayFormat.js) wajib dipertahankan dan tidak disentuh selama pengembangan CBT standalone. - Odoo core (
odoo/,addons/) dan OpenEduCat (custom_addons/) tetap READ-ONLY.