Scola AI Agent Development Guidelines

Panduan untuk AI agent yang bekerja di codebase Scola.

🎯 SSOT (Single Source of Truth)

⚠️ WAJIB BACA PERTAMA: AI_AGENT_MASTER_GUIDE.md

Master Guide adalah SATU-SATUNYA rujukan utama yang harus dibaca sebelum memulai task. Dokumen di bawah ini adalah suplemen detail untuk topik spesifik.

Sub-docs (Referensi Detail)

Dokumen	Topik
Master Guide	SSOT - Wajib baca pertama
Development Guide	Workflow lengkap §4, §10
Workspace Governance	Permission matrix, repo boundaries
Architecture & API Rules	Same-origin proxy, CORS, API patterns
Documentation Governance	WAJIB: Aturan membuat/mengubah dokumentasi

Quick Rules

1. Baca docs dulu sebelum coding — mulai dari dokumen ini
2. Branch wajib: frontend/docs → develop; backend gcgscola → main (lihat Master Guide §3.1)
3. Jangan modifikasi Odoo core (odoo/, addons/) atau OpenEduCat (custom_addons/openeducat_*)
4. Same-origin proxy — Jangan set VITE_API_URL, gunakan relative /api
5. Test before push — npm run lint wajib pass
6. E2E lokal pakai baseline terbukti — localhost:5173 + E2E_ODOO_URL=https://be-dev.gcgscola.id
7. Dokumentasi tiered — publik: ./scripts/build-docs.sh public --install → docs.gcgscola.id; implementor: internal; dev/QA: developer
8. Jangan buat asumsi — Jika ragu, baca file terkait atau tanya

Permission Matrix

Path	Permission
scola-fe-v2/	✅ EDITABLE
scola-odoo-module/	✅ EDITABLE
custom_addons/openeducat_*	⚠️ REFERENCE ONLY
odoo/, addons/	❌ READ-ONLY