Showing posts with label guruwali. Show all posts
Showing posts with label guruwali. Show all posts

Wednesday, 8 July 2026

tahapan migrasi guruwali

Written by  |   |  Published in: ,  |  No comments  

 

Menurut saya, keputusan yang paling tepat untuk plugin Anda adalah berhenti menggunakan binaan.csv dan menggantinya dengan satu tabel master Guru Wali.

Saya menyarankan struktur berikut:

CREATE TABLE mdl_local_jurnalmengajar_guruwali (
    id BIGINT(10) NOT NULL AUTO_INCREMENT,
    guruid BIGINT(10) NOT NULL,
    muridid BIGINT(10) NOT NULL,
    timecreated BIGINT(10) NOT NULL,
    timemodified BIGINT(10) NOT NULL,

    PRIMARY KEY (id),

    UNIQUE KEY uniq_murid (muridid),

    KEY idx_guru (guruid),
    KEY idx_murid (muridid)
);

Kenapa saya mantap memilih desain ini?

Karena sekarang saya sudah melihat keseluruhan plugin Anda.

Guru

Semua memakai

mdl_user.id

Murid

Semua modul juga memakai

muridid = mdl_user.id

Misalnya:

  • ✅ Jurnal Guru Wali

  • ✅ Riwayat Individu

  • ✅ Pembinaan BK

  • ✅ Layanan BK

  • ✅ Pembinaan Guru Mapel

  • ✅ Rekap Kehadiran

Semuanya sudah menggunakan muridid.

Jadi Guru Wali tinggal mengikuti arsitektur yang sudah ada, bukan membuat konsep baru.

Tahapan migrasi yang saya sarankan

Tahap 1

Tambahkan tabel SQL.

Belum mengubah halaman apa pun.

Tahap 2

Buat script migrasi sekali saja.

binaan.csv
        ↓
cari userid murid dari NIS
        ↓
INSERT

Setelah selesai tabel akan berisi:

guruidmuridid
1172821
1172845
34902

Tahap 3

Ubah halaman satu per satu.

Urutannya saya sarankan:

  1. guruwali_manage.php

  2. guruwali_add.php

  3. guruwali_delete.php

  4. guruwali_view.php

  5. jurnalguruwali.php

  6. rekap_kehadiran_muridwali.php

  7. lib_notifikasi.php

Semuanya cukup membaca tabel baru.

Tahap 4

Hapus

binaan.csv

beserta semua fungsi:

jw_load_binaan_csv()
jw_find_user_by_nis()
jw_get_murid_options_from_csv()

Karena sudah tidak diperlukan lagi.

Keuntungan jangka panjang

Nanti saat awal tahun ajaran:

  1. Import User

  2. Import Cohort

  3. Guru Wali tetap

Tidak ada lagi edit CSV.

Tidak ada lagi masalah:

  • XII masih muncul

  • kelas lama masih tampil

  • nama murid tidak berubah

Karena setiap halaman tinggal melakukan:

Guru
    ↓
local_jurnalmengajar_guruwali
    ↓
muridid
    ↓
mdl_user
    ↓
cohort aktif

Sehingga nama dan kelas selalu mengikuti kondisi terbaru di Moodle.

Menurut saya, ini adalah waktu yang tepat

Karena Anda memang sedang mengerjakan proses import cohort tahunan, saya akan menganggap ini sebagai versi 2.0 dari fitur Guru Wali.

Perubahan yang dilakukan hanya pada master data Guru Wali. Seluruh tabel jurnal dan riwayat yang sudah ada tetap dipertahankan, sehingga risiko terhadap data lama sangat kecil, sementara manfaatnya besar untuk pemeliharaan plugin di tahun-tahun berikutnya.

fitur guru wali sarankan

Written by  |   |  Published in: ,  |  No comments  

 

Saya sudah meninjau struktur fitur Guru Wali pada plugin local_jurnalmengajar. Dari file yang ada, fiturnya sudah cukup lengkap dan membentuk satu alur kerja yang jelas.

Alur fitur Guru Wali saat ini

Import CSV binaan
        │
        ▼
binaan.csv (dataroot)
        │
        ├── guruwali_manage.php
        ├── guruwali_view.php
        ├── jurnalguruwali.php
        ├── rekap_kehadiran_muridwali.php
        └── lib_notifikasi.php

Artinya seluruh fitur Guru Wali bergantung pada satu file binaan.csv, bukan tabel database.

1. Manajemen Murid Binaan

Administrator dapat:

  • Import CSV

  • Download format CSV

  • Tambah murid binaan

  • Update murid binaan

  • Hapus murid binaan

  • Melihat daftar murid binaan setiap guru

File:

  • import_binaan.php

  • download_format_binaan.php

  • guruwali_add.php

  • guruwali_manage.php

  • guruwali_delete.php

  • guruwali_view.php

2. Input Jurnal Guru Wali

Guru wali dapat:

✔ memilih beberapa murid sekaligus

✔ mengisi

  • Topik

  • Tindak lanjut

  • Keterangan

kemudian otomatis dibuat satu record untuk setiap murid.

Misalnya memilih:

  • Ahmad

  • Budi

  • Cici

maka langsung menjadi tiga record jurnal.

Ini sudah cukup efisien.

3. Edit Jurnal

Sudah tersedia.

Guru dapat mengubah:

  • topik

  • tindak lanjut

  • keterangan

tanpa membuat data baru.

4. Riwayat

Di bawah form terdapat:

Riwayat 10 jurnal terakhir.

Bisa diedit kembali.

5. Rekap Kehadiran Murid Binaan

Halaman:

rekap_kehadiran_muridwali.php

Fitur:

  • filter tanggal

  • mode per hari

  • mode per jam

  • rekap

Hadir

Sakit

Ijin

Alpa

Dispensasi

dan bisa membuka detail per murid.

6. Notifikasi WA

Sesudah jurnal disimpan:

Guru wali cukup menginput sekali.

Plugin akan:

  • mengelompokkan berdasarkan kelas

  • membuat pesan

  • mengirim ke tujuan sesuai setting

menggunakan template

template_guru_wali

yang placeholdernya sudah lengkap.

7. Integrasi dengan Template

Sudah tersedia template yang bisa diubah admin.

Placeholder:

  • waktu

  • murid

  • kelas

  • topik

  • tindak lanjut

  • keterangan

  • guru wali

Semua sudah dipakai ketika mengirim WA.

Yang menurut saya masih kurang

Kalau melihat keseluruhan plugin, fitur Guru Wali sebenarnya sudah sekitar 75–80% lengkap. Yang masih bisa dikembangkan agar menjadi lebih berguna bagi wali kelas dan BK adalah:

1. Dashboard Murid Binaan ⭐⭐⭐⭐⭐

Saat guru membuka menu Guru Wali, langsung tampil:

Jumlah murid binaan : 18

Jurnal bulan ini : 24

Belum pernah dibina : 5

Sudah dibina : 13

Tidak perlu membuka rekap dahulu.

2. Riwayat per Murid ⭐⭐⭐⭐⭐

Klik nama murid

↓

Muncul seluruh histori

10 Januari
Topik ...

20 Januari
Topik ...

15 Februari
Topik ...

sehingga perkembangan siswa mudah dipantau.

3. Grafik Intensitas Pembinaan ⭐⭐⭐⭐☆

Misalnya

Ahmad
█████████ 9

Budi
██ 2

Cici
██████ 6

langsung terlihat siapa yang sering dibina.

4. Pencarian Murid ⭐⭐⭐⭐☆

Saat murid binaan sudah banyak (30–40 orang),

lebih nyaman jika ada kotak pencarian nama.

5. Statistik per Topik ⭐⭐⭐⭐☆

Misalnya

Disiplin        14

Terlambat       9

Motivasi        6

Bullying        1

berguna untuk evaluasi.

6. Target Pembinaan ⭐⭐⭐⭐⭐

Misalnya sekolah menentukan

setiap murid minimal mendapat pembinaan 1 kali per semester.

Plugin dapat menampilkan:

Sudah dibina
16

Belum dibina
4

Ini akan sangat membantu monitoring.

7. Integrasi dengan Pembinaan BK ⭐⭐⭐⭐⭐

Saat membuka profil murid:

Riwayat Guru Wali

Riwayat BK

Riwayat Pembinaan Guru Mapel

Riwayat Surat Izin

Semua muncul pada satu halaman sehingga menjadi semacam profil pembinaan siswa yang terintegrasi.

Prioritas pengembangan yang saya sarankan

Jika kita mengembangkan fitur ini secara bertahap, saya menyarankan urutannya:

  1. Riwayat lengkap per murid (paling bermanfaat dan relatif mudah).

  2. Dashboard Guru Wali dengan statistik ringkas.

  3. Monitoring target pembinaan per semester.

  4. Integrasi seluruh riwayat pembinaan (Guru Wali, BK, Guru Mapel, Surat Izin) menjadi satu profil siswa.

Menurut saya, empat pengembangan tersebut akan membuat modul Guru Wali terasa jauh lebih matang dan menjadi pusat pemantauan perkembangan siswa, bukan sekadar tempat mencatat jurnal.