Dashboard utama

HariMasaTempohKursusKelasPelajarJenisTindakan

Master template guna Microsoft Word

Edit template dalam Word seperti biasa, kemudian upload semula. Semua RPH yang dijana selepas itu akan mengikut template anda.

1Muat turun template

Fail Word (.docx) yang sudah lengkap dengan tag automatik.

2Edit dalam Word

Ubah susun atur, font, jadual, logo atau teks. Kekalkan tag seperti {{TOPIK}} di tempat data perlu masuk. Guna jadual untuk susun atur, dan simpan sebagai .docx.

3Muat naik template

Pilih fail .docx yang sudah diedit. Ia terus menjadi master template.

Senarai tag automatik

Klik tag untuk salin, kemudian tampal dalam Word. Tag berwarna hijau sudah ada dalam template semasa.

Pilih julat minggu mengajar

Sistem padankan jadual waktu dengan tarikh, kira minggu setiap kursus, kemudian tarik topik dan subtopik dari course outline.

Profil pengajar

Maklumat ini digunakan pada dashboard dan dimasukkan ke dalam setiap RPH.

Set semula semua data

Padam semua kursus, jadual, outline, template dan RPH, kemudian kembali ke keadaan asal.

Backup dan pemulihan sistem

Simpan salinan penuh database dan tetapan sistem dalam satu fail JSON. Guna fail ini untuk memulihkan sistem jika berlaku masalah pada masa akan datang, atau bila bertukar peranti.

Backup

Restore

Pilih fail backup. Sistem akan menyemak integriti fail dan menunjukkan kandungannya sebelum anda memilih apa yang mahu dipulihkan. Fail backup lama juga diterima.

Titik pemulihan automatik

Pangkalan data Google Sheets dan Drive

Data disimpan dalam Google Sheet milik anda, manakala template Word, RPH yang dijana dan backup harian disimpan dalam Google Drive anda.

Panduan setup langkah demi langkah (kali pertama sahaja)
  1. Dalam kad ini, tekan Jana untuk mendapatkan token, kemudian tekan Salin kod Apps Script. Token anda sudah dimasukkan dalam kod tersebut.
  2. Buka sheets.new di pelayar untuk mencipta Google Sheet kosong. Namakan ia e-RPH KV Auto DB.
  3. Dalam Sheet itu, pilih menu Extensions > Apps Script. Padam semua kod sedia ada, tampal kod tadi (Ctrl+V), dan tekan Ctrl+S untuk simpan.
  4. Di bahagian atas editor, pilih fungsi setup dan tekan Run. Google akan minta kebenaran: tekan Review permissions, pilih akaun, tekan Advanced, kemudian Go to ... (unsafe), dan Allow. Amaran ini biasa kerana skrip ini anda cipta sendiri. Tunggu sehingga log menunjukkan "Setup siap".
  5. Tekan Deploy > New deployment. Klik ikon gear di sebelah "Select type" dan pilih Web app. Tetapkan Execute as: Me dan Who has access: Anyone, kemudian tekan Deploy. Salin Web app URL.
  6. Tampal URL itu dalam ruangan di bawah dan tekan Uji sambungan. Jika berjaya, tekan Simpan ke cloud.
  7. Tandakan Auto-simpan supaya setiap perubahan disimpan ke Google secara automatik.
Penting: guna akaun Gmail peribadi jika pilihan "Anyone" tidak wujud. Akaun sekolah atau DELIMa kadang-kadang disekat oleh pentadbir. Jika anda mengedit kod skrip kemudian, pilih Deploy > Manage deployments > Edit > New version supaya perubahan berkuat kuasa.

Token dan URL hanya disimpan dalam pelayar ini dan tidak termasuk dalam backup JSON. Sesiapa yang mempunyai kedua-duanya boleh membaca dan menulis data anda, jadi jangan kongsikannya. Pada peranti lain, isi URL dan token yang sama, kemudian tekan "Muat dari cloud".

Refleksi automatik oleh AI

Bahagian Refleksi dalam setiap RPH ditulis oleh AI berdasarkan topik, aktiviti dan kelas. Anda tidak perlu menaip apa-apa.

Panduan setup langkah demi langkah

Prasyarat: kad Pangkalan data Google di atas sudah berfungsi (butang "Uji sambungan" berjaya). Kunci AI disimpan di Google, bukan dalam pelayar ini.

  1. Kemas kini kod: tekan Salin kod Apps Script dalam kad di atas. Dalam editor Apps Script, tekan Ctrl+A untuk pilih semua kod lama, tampal kod baharu, dan tekan Ctrl+S.
  2. Dapatkan kunci AI. Pilihan A (percuma, disyorkan untuk mula): buka aistudio.google.com/apikey, tekan Create API key dan salin kunci. Pilihan B (berbayar, sangat murah): buka console.anthropic.com, pergi ke API keys, cipta kunci, dan tambah kredit minimum USD 5.
  3. Letak kunci di Google: dalam editor Apps Script, klik ikon gear Project Settings di sebelah kiri. Skrol ke Script Properties, tekan Edit script properties dan Add script property. Isi Name AI_KEY dan Value ialah kunci anda. Jika anda memilih Claude (pilihan B), tambah satu lagi: Name AI_PROVIDER dan Value anthropic. Tekan Save script properties.
  4. Beri kebenaran: kembali ke Editor, pilih fungsi testAI dan tekan Run. Google minta kebenaran baharu ("connect to an external service"): tekan Review permissions, pilih akaun, Advanced, Go to ... (unsafe), dan Allow. Log akan memaparkan "AI berfungsi" beserta satu ayat contoh.
  5. Deploy versi baharu: Deploy > Manage deployments, klik ikon pensel, pada Version pilih New version, kemudian Deploy. URL Web App kekal sama.
  6. Uji dalam aplikasi: tekan Uji AI di bawah. Contoh refleksi akan muncul dan AI dihidupkan secara automatik.
  7. Guna: jana RPH seperti biasa dalam modul Jana RPH. Refleksi terisi sendiri. Untuk RPH sedia ada, tekan Jana refleksi AI dalam Preview.
Jika Gemini percuma tidak berfungsi (contohnya mesej lokasi tidak disokong, atau had kadar dicapai berulang kali), guna pilihan B. Pada tier percuma Gemini, Google mungkin menggunakan input dan output untuk menambah baik modelnya. Hanya maklumat RPH (kursus, topik, aktiviti, kelas) dihantar, tanpa nama pelajar. Nama model boleh ditukar dengan Script Property AI_MODEL jika model lalai sudah tidak wujud.

AI menulis refleksi berdasarkan maklumat RPH. Ia tidak tahu apa yang sebenarnya berlaku dalam kelas, jadi baca sekali imbas dan ubah jika sesi berjalan lain daripada biasa.