T1-A — Canonical Vocabulary Contract
| Metadata |
Nilai |
| Workstream |
T1-A Canonical Product Surface & Navigation Contract |
| Mode |
Server development · /home/scola/odoo |
| Tanggal |
2026-08-10 |
| Lingkup |
Kontrak istilah UI/navigasi Core V1 — bukan redesign copy luas |
| Locale primer |
id (Bahasa Indonesia) |
| Sumber |
01-product-contract.md, label fragmen app Core, UX-016 / STAB-040 (evidence istilah bentrok) |
| Status |
Kontrak kosakata untuk navigasi & page title; alias boleh di search, tidak boleh bersaing di menu |
1. Tujuan
Menetapkan satu istilah kanonis per konsep pada surface Core V1 agar launcher, breadcrumb, page title, dan help memakai bahasa yang sama.
Perubahan copy massal di luar istilah di bawah di luar scope T1-A Phase 1.
Aturan umum:
- Label menu / page title memakai istilah kanonis.
- Alias (Inggris, sinonim lokal, istilah legacy) boleh menjadi keyword search atau redirect, tetapi tidak ditampilkan sebagai label menu kedua yang bersaing.
- Istilah package optional mengikuti glossary domain SKU-nya; jangan mencampur istilah Core dengan istilah SKU di rail Core.
2. Istilah orang & peran (user-facing)
| Konsep |
Kanonis (ID) |
Jangan dipakai sebagai label menu bersaing |
Catatan |
| Peserta didik |
Siswa |
Murid (kecuali jenjang PAUD bila Product menutup DEC-013), Student |
Entity master & portal self-scope |
| Wali / caregiver |
Orang Tua |
Parent, Wali Murid (alias search OK), Guardian |
Portal: “Anak Saya”; master: “Data Orang Tua” |
| Pendidik mapel |
Guru |
Teacher, Faculty (kecuali path teknis /faculty/*) |
App: “Kelas Saya” |
| Guru yang memegang rombel |
Wali Kelas |
Homeroom (alias search) |
Section di teacher-portal, bukan app terpisah |
| Operator administrasi sekolah |
Admin Sekolah |
School Admin (teknis: school_admin) |
Jangan tampilkan technical role id di UI |
| Kepala administrasi TU |
Kepala TU |
head_admin di UI |
Role closure masih terbuka (IA-017) |
| Pimpinan satuan pendidikan |
Kepala Sekolah |
Principal |
Shell principal-exec belum Core |
| Operator platform Scola |
Operator Platform |
Platform Operator |
Control-plane saja; bukan launcher sekolah |
3. Istilah domain Core
| Konsep |
Kanonis (ID) |
App / route terkait |
Jangan dipakai sebagai label kanonis |
Catatan |
| Domain struktur & jadwal sekolah |
Akademik |
App academic · /academic-year, /schedule |
Academic (kecuali kode/API) |
Section: “Struktur Akademik”, “Jadwal & Kelas” |
| Domain master peserta didik |
Kesiswaan |
App student-affairs · /students, /parents |
Student Affairs (teknis) |
Core = data siswa/orang tua; “Pembinaan” = SC-STUDENT |
| Kehadiran peserta didik (domain) |
Kehadiran |
App attendance · /attendance/home |
Attendance (teknis), Absensi sebagai synonym menu |
App label kode: “Kehadiran” |
| Aksi/pencatatan kehadiran harian atau per sesi |
Presensi |
Leaf guru “Presensi Mapel”; hub siswa |
Absensi / Attendance Sheet sebagai label menu kedua |
UX-016: bedakan Kehadiran (domain/hub) vs Presensi (aksi/lembar) |
| Susunan waktu pelajaran |
Jadwal / Jadwal Pelajaran |
/schedule, mirror portal |
Timetable (teknis), Schedule sebagai label primer |
“Jam Pelajaran” = slot waktu; “Rombel” = study group |
| Publikasi resmi sekolah |
Berita |
/news, /admin/news |
News (teknis) |
Model kanonis: scola.news (W16) |
| Pemberitahuan singkat / legacy parallel |
(deprecated di Core) |
— |
Pengumuman sebagai entry kanonis |
Legacy /announcement & leaf “Pengumuman” parent → migrasi ke Berita; alias search saja |
| Kalender sekolah bersama |
Kalender |
/calendar |
Calendar |
Satu page identity lintas peran |
| Push / in-app alerts |
Notifikasi |
/notifications, kanal di settings |
Notification Channels boleh di settings |
Messaging/Chat = decision, bukan Core glossary wajib |
| Konfigurasi tenant |
Pengaturan |
App settings |
Settings (teknis) |
“Konfigurasi Sekolah”, “Kelola Pengguna” |
| Rumah kerja peran |
Beranda / Dashboard |
Portal homes |
Home (teknis) |
Portal guru/siswa/orang tua: “Beranda”; admin: “Dashboard” |
3.1 Kehadiran vs Presensi vs Absensi (kontrak ketat)
| Istilah |
Digunakan untuk |
Contoh label yang sah |
| Kehadiran |
Nama domain/app/hub, ringkasan status |
“Hub Kehadiran Siswa”, “Kehadiran” di portal siswa/orang tua |
| Presensi |
Aktivitas mencatat/mengisi kehadiran |
“Presensi Mapel”, “Presensi Pribadi” (employee — optional SKU) |
| Absensi |
Alias search / copy legasi saja |
Jangan jadi label menu baru yang berdampingan dengan Kehadiran/Presensi |
| Kedatangan & Kepulangan |
Sub-flow harian (bukan nama domain) |
Leaf di hub attendance |
Mutasi harian W05 tetap Controlled Pilot — kosakata di atas tidak melegalkan write GA.
3.2 Berita vs Pengumuman
| Istilah |
Status |
Perilaku navigasi Core |
| Berita |
Kanonis |
Satu-satunya entry publikasi di Communication Core |
| Pengumuman / Pengumuman Kelas |
Legacy / perlu normalisasi |
Jangan menambah entry launcher “Pengumuman”; arahkan ke Berita; “Pengumuman Kelas” (jika dipertahankan sementara) harus jelas scoped kelas + route news, bukan model announcement |
4. Nama tampilan shell Core (launcher)
| Application ID |
Label kanonis |
Bukan label kanonis |
admin-dashboard |
Dashboard |
Admin Home, Operations |
teacher-portal |
Kelas Saya |
Teacher Portal, Faculty |
student-portal |
Belajar Saya |
Student Portal |
parent-portal |
Anak Saya |
Parent Portal |
academic |
Akademik |
Academic App |
student-affairs |
Kesiswaan |
Student Affairs |
attendance |
Kehadiran |
Attendance, Absensi |
communication |
Komunikasi |
Communication |
settings |
Pengaturan |
Settings |
5. Istilah master data yang sering bentrok
| Konsep |
Kanonis |
Alias search saja |
| Tahun ajaran |
Tahun Ajaran |
Academic Year |
| Tingkat |
Tingkat Kelas |
Grade Level |
| Mata pelajaran |
Mata Pelajaran |
Subject |
| Ruang |
Ruang Kelas |
Classroom |
| Kelompok belajar |
Rombel |
Study Group, Batch |
| Penugasan guru–mapel–rombel |
Penugasan Mengajar |
Teacher Assignment |
| Data peserta didik (list) |
Data Siswa |
Student List |
| Data wali |
Data Orang Tua |
Parent List |
6. Istilah yang sengaja tidak dikunci sebagai Core copy di Phase 1
Masih boleh muncul di surface optional/pilot, tetapi bukan glossary baseline Core:
- E-Rapor / Rapor Digital → SC-REPORT
- LMS / Kelas LMS → SC-LEARN
- CBT / Ujian CBT → SC-ASSESS
- Tagihan / Pembayaran → SC-FEES
- RFID / Wajah Siswa → SC-ATTEND+
- Pembinaan / Konseling / Pelanggaran (operator) → SC-STUDENT
- Chat dengan Guru / Aduan Masyarakat → Requires Product Decision
7. Enforcement (T1-A, docs → nanti kode)
- Inventory / matrix peran memakai istilah kanonis di kolom
display_name / notes user-facing.
- Perubahan label menu Core harus merujuk baris glossary ini (atau amend dokumen ini dulu).
- Tidak ada sertifikasi W01/W02/W05 dari dokumen kosakata ini.
- Konflik label yang sudah terinventarisasi (UX-016, STAB-040, IA-010) ditutup di workstream copy/IA berikutnya — di sini hanya kontrak istilah.
8. Quick reference (satu layar)
| EN / teknis |
Kanonis ID |
| Student |
Siswa |
| Parent |
Orang Tua |
| Schedule / Timetable |
Jadwal (Pelajaran) |
| Attendance (domain) |
Kehadiran |
| Attendance take / sheet action |
Presensi |
| Academic |
Akademik |
| News |
Berita |
| Announcement (legacy) |
→ Berita (jangan kanonis) |
| Calendar |
Kalender |
| Settings |
Pengaturan |
| Homeroom |
Wali Kelas |
| Student Affairs (master) |
Kesiswaan |