Cara Membuat Deskripsi Capaian Kompetensi Otomatis untuk Rapor Kurikulum Merdeka dengan PHP + MySQL
Setiap akhir semester, guru Kurikulum Merdeka harus menulis deskripsi capaian kompetensi untuk setiap siswa di setiap mapel. Satu guru Matematika yang mengajar 6 kelas berarti menulis hampir 170 paragraf. Wajar kalau akhirnya banyak rapor yang isinya disalin-tempel dan tidak menggambarkan kemampuan anak yang sebenarnya.
Kabar baiknya, deskripsi itu sebenarnya bisa disusun otomatis dari nilai per Tujuan Pembelajaran (TP). Di tutorial ini kita buat fungsinya dengan PHP murni dan MySQL. Contohnya diambil dari Aplikasi e-Rapor Kurikulum Merdeka yang bisa kamu download gratis di Papicode (link di akhir artikel).
1. Polanya: TP terbaik dan TP yang belum tercapai
Rapor Kurikulum Merdeka umumnya memakai dua kalimat:
- Menunjukkan penguasaan yang baik dalam ... (TP dengan nilai tertinggi yang sudah mencapai KKTP)
- Perlu bantuan dalam ... (TP yang nilainya masih di bawah KKTP)
KKTP (Kriteria Ketercapaian Tujuan Pembelajaran) adalah batas nilai sebuah TP dianggap tercapai, misalnya 75. Contoh nilai Aditya di Matematika:
| TP | Tujuan pembelajaran | Nilai |
|---|---|---|
| TP1 | Melakukan operasi hitung bilangan bulat dan pecahan | 69 |
| TP2 | Menyelesaikan persamaan dan pertidaksamaan linear satu variabel | 86 |
| TP3 | Menyajikan dan menafsirkan data dalam diagram batang dan lingkaran | 80 |
| TP4 | Menyelesaikan masalah perbandingan senilai dan berbalik nilai | 72 |
Dengan KKTP 75, hasilnya:
Menunjukkan penguasaan yang baik dalam menyelesaikan persamaan dan pertidaksamaan linear satu variabel dan menyajikan dan menafsirkan data dalam diagram batang dan lingkaran. Perlu bantuan dalam melakukan operasi hitung bilangan bulat dan pecahan dan menyelesaikan masalah perbandingan senilai dan berbalik nilai.
Kalimatnya spesifik untuk tiap anak, karena berasal dari nilainya sendiri.
2. Struktur tabel
CREATE TABLE tp (
id INT AUTO_INCREMENT PRIMARY KEY,
pembelajaran_id INT NOT NULL, -- satu mapel di satu kelas
kode VARCHAR(10) NOT NULL, -- TP1, TP2, ...
deskripsi VARCHAR(255) NOT NULL
);
CREATE TABLE nilai_tp (
tp_id INT NOT NULL,
siswa_id INT NOT NULL,
nilai TINYINT UNSIGNED NOT NULL,
PRIMARY KEY (tp_id, siswa_id) -- satu nilai per TP per siswa
);
CREATE TABLE nilai_sas (
pembelajaran_id INT NOT NULL,
siswa_id INT NOT NULL,
nilai TINYINT UNSIGNED NULL, -- Sumatif Akhir Semester
deskripsi TEXT NULL, -- diisi bila guru ingin menulis manual
PRIMARY KEY (pembelajaran_id, siswa_id)
);
Kolom deskripsi di nilai_sas sengaja disediakan supaya guru tetap bisa menulis sendiri untuk siswa tertentu. Kalau kosong, kita pakai deskripsi otomatis.
3. Fungsi deskripsi otomatis
function deskripsi_capaian(array $tp, int $kktp): string
{
// $tp = [['deskripsi' => '...', 'nilai' => 86], ...]
$tp = array_values(array_filter($tp, fn($t) => $t['nilai'] !== null));
if (!$tp) return '';
$atas = array_values(array_filter($tp, fn($t) => $t['nilai'] >= $kktp));
$bawah = array_values(array_filter($tp, fn($t) => $t['nilai'] < $kktp));
usort($atas, fn($a, $b) => $b['nilai'] <=> $a['nilai']); // tertinggi dulu
usort($bawah, fn($a, $b) => $a['nilai'] <=> []);
= [];
() {
[] =
. ((fn() => ([]), (, , ))) . ;
}
() {
[] =
. ((fn() => ([]), (, , ))) . ;
} (() > ) {
[] = . (()[]) . ;
}
(, );
}
Beberapa keputusan kecil yang membuat hasilnya enak dibaca:
- Maksimal 2 TP per kalimat. Kalau semua TP dimasukkan, deskripsi jadi sangat panjang dan rapor tidak muat satu halaman.
- Siswa yang semua TP-nya tercapai tetap mendapat kalimat kedua "Perlu peningkatan dalam ...", sehingga orang tua tahu apa yang bisa dikembangkan.
- TP yang belum dinilai (
null) diabaikan, jadi deskripsi tidak menyebut TP yang belum diajarkan.
4. Merangkai daftar dengan "dan"
function gabung(array $x): string
{
if (count($x) <= 1) return $x[0] ?? '';
return implode(', ', array_slice($x, 0, -1)) . ' dan ' . end($x);
}
['A'] menjadi A, ['A', 'B'] menjadi A dan B, dan ['A', 'B', 'C'] menjadi A, B dan C.
5. Huruf kecil di awal TP, tapi jangan semuanya
Deskripsi TP biasanya ditulis guru dengan huruf kapital di awal ("Menyelesaikan ..."). Saat masuk ke tengah kalimat, huruf pertamanya harus kecil. Tapi jangan asal lcfirst(), karena TP bisa diawali singkatan seperti IPA atau HOTS:
function lcfirst_id(string $s): string
{
$kata = strtok($s, ' ');
// Hanya kecilkan bila kata pertama berpola "Kapital + huruf kecil" (Menyelesaikan),
// singkatan seperti "IPA" atau "HOTS" dibiarkan
if ($kata !== false && preg_match('/^[A-Z][a-z]/', $kata)) {
return mb_strtolower(mb_substr($s, 0, 1)) . mb_substr($s, 1);
}
return $s;
}
6. Nilai akhir dari TP dan SAS
Nilai akhir di rapor menggabungkan rata-rata nilai TP (sumatif lingkup materi) dan nilai SAS dengan bobot yang bisa diatur sekolah:
function nilai_akhir(?float $rataTp, ?int $sas, int $bobotTp = 50): ?int
{
if ($rataTp === null || $sas === null) return null; // belum lengkap
return (int) round(($bobotTp * $rataTp + (100 - $bobotTp) * $sas) / 100);
}
Mengembalikan null saat nilai belum lengkap itu penting. Dengan begitu leger dan halaman progres bisa menunjukkan mapel mana yang belum selesai diisi, bukan diam-diam menganggap nilainya 0.
7. Hitung satu kelas sekaligus, bukan per siswa
Kesalahan yang sering membuat aplikasi rapor lambat adalah menjalankan query per siswa per mapel. Satu kelas dengan 28 siswa dan 13 mapel berarti ratusan query hanya untuk satu leger. Lebih baik ambil semuanya dalam beberapa query lalu olah di PHP:
// 1 query untuk semua TP di kelas ini
$tp = q("SELECT * FROM tp WHERE pembelajaran_id IN ($ids)")->fetchAll();
// 1 query untuk semua nilai TP, dikelompokkan [pembelajaran][siswa][tp]
$nilaiTp = [];
foreach (q("SELECT n.*, t.pembelajaran_id FROM nilai_tp n JOIN tp t ON t.id = n.tp_id
WHERE t.pembelajaran_id IN ($ids)")->fetchAll() as $n) {
$nilaiTp[$n['pembelajaran_id']][$n['siswa_id']][$n['tp_id']] = (int) $n['nilai'];
}
// 1 query untuk semua SAS & deskripsi manual
$sas = [];
foreach (q("SELECT * FROM nilai_sas WHERE pembelajaran_id IN ($ids)")->fetchAll() as $n) {
$sas[$n['pembelajaran_id']][$n['siswa_id']] = $n;
}
Setelah itu, nilai akhir dan deskripsi tiap siswa dihitung di memori. Hasil yang sama dipakai untuk lembar nilai guru, leger, dan cetak rapor satu kelas sekaligus.
8. Simpan lembar nilai: semua atau tidak sama sekali
Guru mengisi puluhan sel sekaligus. Kalau ada satu sel berisi 101 atau 8o, jangan simpan sebagian. Validasi semua dulu, lalu tulis dalam satu transaksi:
$err = [];
foreach ($siswaIds as $sid) {
foreach ($tpIds as $tid) {
$v = baca_nilai($_POST['tp'][$sid][$tid] ?? ''); // null = kosong, false = tidak valid
if ($v === false) { $err[] = "Nilai tidak valid untuk {$nama[$sid]}."; continue; }
// kumpulkan ke daftar simpan / hapus
}
}
if ($err) { /* tampilkan galat, tidak ada yang disimpan */ }
db()->beginTransaction();
// INSERT ... ON DUPLICATE KEY UPDATE untuk setiap nilai
db()->commit();
Dengan cara ini guru tidak pernah mendapat lembar nilai yang setengah tersimpan.
Ringkasan
- Simpan nilai per TP, bukan hanya nilai akhir. Dari situlah deskripsi bisa disusun.
- TP di atas KKTP masuk kalimat penguasaan baik, TP di bawah KKTP masuk kalimat perlu bantuan. Batasi 2 TP per kalimat.
- Sediakan kolom deskripsi manual untuk kasus khusus.
- Kembalikan
nulluntuk nilai yang belum lengkap, hitung satu kelas dalam beberapa query, dan simpan lembar nilai dalam satu transaksi.
Download source code lengkapnya
Semua logika di atas sudah dipakai di Aplikasi e-Rapor Kurikulum Merdeka PHP Native & MySQL: lembar nilai ala spreadsheet per TP + SAS, deskripsi otomatis, impor/ekspor nilai CSV, mapel agama per agama siswa, kehadiran & catatan wali kelas, ekstrakurikuler, kenaikan kelas, leger dengan peringkat, cetak rapor A4 satu kelas sekaligus, kunci nilai, dan portal siswa untuk melihat rapor dengan NISN. Gratis dan langsung jalan di XAMPP.
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.