Lewati ke isi

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

  1. Bukan Addon Odoo:
  2. Repositori scola-assessment adalah produk mandiri (modular monolith) dan TIDAK ditempatkan di dalam direktori addons/, custom_addons/, atau custom_addons_scola/.
  3. Repositori ini memiliki .git independen dan dependencies terpisah (requirements.txt, package.json). Pipeline CI dan database/role terisolasi adalah requirement yang harus dibuktikan, bukan diasumsikan dari dokumen.

  4. Isolasi Database:

  5. 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.
  6. 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.

  7. Branching Strategy:

  8. Branch default: main.
  9. Feature branches: feat/*, fix/*, chore/*.
  10. 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

  1. Workspace /home/scola/odoo:
  2. Repositori scola-fe-v2 dan custom_addons_scola/gcgscola tetap utuh.
  3. Modifikasi aktif pada modul attendance (scola_attendance, PickupLobby.vue, pickupDisplayFormat.js) wajib dipertahankan dan tidak disentuh selama pengembangan CBT standalone.
  4. Odoo core (odoo/, addons/) dan OpenEduCat (custom_addons/) tetap READ-ONLY.