Lewati ke isi

Client Implementation Playbook — Professional Package

SOP go-live untuk implementator dan business support — paket Professional.

Last verified: 2026-06-11
Paket: SC-CORE + SC-LEARN + SC-ASSESS + SC-LIB

1. Prasyarat

  • [ ] Server Odoo 17 + PostgreSQL siap
  • [ ] Repo scola-fe-v2 dan gcgscola ter-deploy
  • [ ] SSL dan domain klien aktif
  • [ ] Akun implementor dengan akses admin Odoo + SSH server
  • [ ] Data awal sekolah: logo, nama, NPSN, jenjang, tahun ajaran aktif

2. Fase Provisioning (Hari 1)

2.1 Install bundle Professional

# Upgrade/install bundle
./odoo-bin -c odoo-app.conf -d <DB_KLIEN> \
  -i scola_bundle_core,scola_bundle_learning,scola_bundle_assessment,scola_bundle_library \
  --stop-after-init

2.2 Set entitlement tenant

python3 custom_addons_scola/gcgscola/scripts/modular/package_support.py transition \
  --tier professional \
  --addons SC-CORE,SC-LEARN,SC-ASSESS,SC-LIB

2.3 Verifikasi modul ter-install

Lihat professional-package-inventory.md §6.

2.4 Konfigurasi perusahaan dasar

Item Lokasi UI Wajib
Profil sekolah Settings → Company Ya
Timezone sekolah Settings → Company Ya
Tahun ajaran aktif Admin → Academic Year Ya
Role admin sekolah Admin → Users Ya

3. Fase Data Master (Hari 2–4)

Urutan dependency:

  1. Tahun ajaran & semester → configuration-guides/academic.md
  2. Jenjang & kurikulum → academic config guide
  3. Mata pelajaran & kelas → academic config guide
  4. Guru & teaching assignment → configuration-guides/user-data.md
  5. Siswa & orang tua → user-data config guide (impor CSV jika perlu)
  6. Jam pelajaran & jadwal → academic config guide
  7. Template SPP → configuration-guides/keuangan.md
  8. LMS settings → configuration-guides/lms.md
  9. CBT policy → configuration-guides/cbt.md
  10. Perpustakaan → configuration-guides/perpustakaan.md

Impor data

Lihat data-migration-guide.md untuk checklist lengkap.

  • Siswa: /students/import
  • Guru: /teachers/import
  • Ortu: Admin → Parents → Upload

Validasi post-impor: setiap siswa punya kelas, NISN unik, ortu terhubung.

4. Fase Konfigurasi Modul (Hari 5–7)

Domain Checklist Panduan
User & RBAC Admin, staff TU, guru, pustakawan dibuat user-data
Akademik & Rapor Kurikulum, KKTP, skala nilai academic
Absensi Mode absensi, jam masuk absensi
SPMB Periode, kuota, jalur (jika musim PPDB) spmb
SPP Template biaya, enrollment keuangan
LMS Bobot nilai, enrollment course lms
CBT Bank soal, kebijakan ujian cbt
Perpustakaan Kategori, kebijakan pinjam perpustakaan
Komunikasi Channel notifikasi, berita komunikasi

5. Fase UAT (Hari 8–10)

Gunakan uat-signoff-template.md dan skenario dari uat-matrix.md:

Skenario Fokus
Starter paths Login, siswa, absensi, rapor dasar, portal
Professional learning LMS enrollment, tugas, nilai
Professional assessment CBT create → runner → nilai
Professional library Sirkulasi pinjam/kembali

Jalankan smoke E2E jika tersedia:

cd scola-fe-v2
npm run test:e2e:smoke:professional

6. Fase Handover (Hari 11–12)

  • [ ] Training key users per role (lihat user-guide/README.md)
  • [ ] Serahkan kredensial admin sekolah
  • [ ] Publish panduan end user ke https://docs.gcgscola.id (./scripts/build-docs.sh --install — lihat docs-site-deployment.md)
  • [ ] Sign-off UAT ditandatangani
  • [ ] Escalation path support didokumentasikan

7. Troubleshooting Cepat

Gejala Cek Solusi
Fitur tidak muncul di menu Entitlement + role support-playbook.md
API feature_disabled Package tidak aktif package_support.py diagnose
Login gagal User aktif + role Reset password di Admin → Users
Nilai tidak masuk rapor Assessment bridge Cek domain academic audit

Index lengkap: support-troubleshooting-index.md

8. Post Go-Live