Panduan Pengguna PintarRPH Web

Dokumen ini meliputi semua ciri PintarRPH Web — aplikasi web untuk merancang pengajaran berasaskan AI, menyokong KSSR (Tahun 1–6) dan KSSM (Tingkatan 1–5) dalam satu platform.

Baru bermula? Mulakan dengan QUICKSTART.md untuk panduan langkah demi langkah membuat RPH dan RPM pertama anda.

Kandungan

1. Akses dan Log Masuk
2. Pasang sebagai Aplikasi (PWA)
3. Tetapan Awal
4. Susun Atur Aplikasi
5. Aliran Khusus Prasekolah (PRA)
6. Tetapan Jadual Waktu Mengajar
7. Jana AI — RPT & RPH
8. AI Content Studio
9. Pentaksiran & PBD
10. PintarSekolah — Semakan RPH
11. Bar Atas — Peperiksaan & Bank Komuniti
12. Tetapan & Profil
13. Pertukaran Kurikulum SR/SM (BUNDLE)
14. Had Penjanaan Harian
15. Penyelesaian Masalah
16. Soalan Lazim

Akses dan Log Masuk

PintarRPH Web adalah aplikasi berasaskan pelayar. Tiada apa-apa untuk dipasang.

Cara log masuk:

1. Lawati pintarrph.com
2. Masukkan email & kata laluan (sama dengan portal lesen)
3. Lesen anda dipautkan automatik kepada akaun — tiada kunci untuk dimasukkan secara manual

Jenis lesen:
- PRA — KSPK sahaja (Prasekolah, Umur 4–6) — RM89/tahun
- SR — KSSR sahaja (Tahun 1–6) — RM119/tahun
- SM — KSSM sahaja (Tingkatan 1–5) — RM119/tahun
- BUNDLE — Kedua-dua SR & SM (boleh tukar) — lihat portal untuk harga

Lesen PRA adalah berasingan daripada BUNDLE — guru Prasekolah perlu lesen PRA khusus.

Pasang sebagai Aplikasi (PWA)

PintarRPH Web ialah Progressive Web App (PWA). Anda boleh pasang ke skrin utama telefon atau Start menu komputer untuk akses pantas, ikon tersendiri, dan caching offline asas.

Pada Telefon

Android (Chrome / Edge):
1. Buka pintarrph.com dalam Chrome
2. Tap menu 3 titik di sudut kanan atas
3. Pilih "Pasang aplikasi" atau "Tambah ke Skrin Utama"
4. Tap Pasang — ikon PintarRPH muncul pada skrin utama

iPhone / iPad (Safari — wajib Safari, bukan pelayar lain):
1. Buka pintarrph.com dalam Safari
2. Tap butang Kongsi (kotak dengan anak panah ke atas) di bar bawah
3. Skrol ke bawah dan tap "Tambah ke Skrin Utama" (Add to Home Screen)
4. Tap Tambah — PintarRPH kini berfungsi seperti aplikasi

Pada Komputer

Chrome / Edge (Windows, macOS, Linux):
1. Buka pintarrph.com
2. Klik ikon Pasang (komputer dengan anak panah ke bawah) di sebelah kanan bar URL
3. Atau pada Chrome: tekan Ctrl+Shift+A lalu pilih "Pasang PintarRPH"
4. Aplikasi terbuka dalam tetingkap berasingan tanpa pelayar chrome

Selepas Pasang

Tetapan Awal

Selepas log masuk pertama, anda akan melihat Senarai Semakan Onboarding di Papan Pemuka dengan 5 langkah:

1. Lengkapkan Profil — Nama dan nama sekolah
2. Tetapkan Kunci Gemini — Kunci API Google Gemini (pilihan — sistem ada LLM terbina)
3. Sediakan Jadual — Jadual waktu mengajar
4. Jana RPT Pertama — Rancangan Tahunan
5. Jana RPH Pertama — Rancangan Mingguan

Setiap langkah akan terbuka secara berurutan apabila langkah sebelumnya selesai. Boleh diabaikan dengan butang dismiss.

Kad "Minggu Ini" pada Papan Pemuka memaparkan jadual minggu semasa dengan status RPH untuk setiap subjek/kelas:
- Sedia — RPH sudah dijana
- Jana — Klik untuk jana cepat (subjek & tahun auto-isi)
- Tiada RPT — RPT belum dijana

Susun Atur Aplikasi

Aplikasi disusun mengikut aliran kerja yang dicadangkan, dipaparkan dalam sidebar bernombor:

Penting: Senarai Murid berada di BAR ATAS, bukan dalam sidebar. Klik ikon kumpulan murid berlabel "Senarai Murid" di sebelah kanan bar atas.

Aliran Khusus Prasekolah (PRA)

Pengguna lesen PRA akan melihat antara muka yang disesuaikan untuk pendidikan prasekolah. PintarRPH mengenal pasti lesen anda secara automatik dan menukar antara muka mengikutnya.

Apa yang Berbeza

11 Fokus KP2026 yang Disokong

PintarRPH menggunakan kurikulum KP2026 dengan 11 fokus pembelajaran. Guru memilih fokus sebagai "subjek" dalam jadual mengajar:

Aliran Penggunaan Prasekolah

Aliran asas adalah sama dengan SR/SM:

1. Tetapkan Profil seperti biasa (Kunci Gemini adalah pilihan — sistem ada LLM terbina)
2. Tetapan Jadual — pilih Fokus KP2026 sebagai "subjek"
3. Jana RPT dan Jana RPH — sistem AI menyesuaikan diri untuk konteks prasekolah
4. Senarai Murid — tambah murid mengikut umur dan kelas
5. Rekod PBD Prasekolah — rekod tahap penguasaan murid mengikut deskriptor KSPK
6. RPM Prasekolah — matriks perkembangan murid prasekolah
7. Laporan Perkembangan — laporan format prasekolah untuk perjumpaan ibu bapa

Apa Yang Tidak Tersedia untuk PRA

• JSU, Soalan, Markah Ujian, Laporan Pentaksiran — disembunyikan kerana prasekolah tidak ada peperiksaan formal
• Pertukaran SR/SM — PRA adalah lesen tetap (tiada toggle)
• Mod Pilihan Tajuk — kandungan tunjang prasekolah dijana terus tanpa pemilihan tajuk manual

1. Tetapan Jadual Waktu Mengajar

Sidebar → 1 Jadual Waktu Mengajar → Tetapkan Jadual

Jadual ialah prasyarat utama — ia menentukan subjek mana yang muncul dalam borang Jana RPT/RPH dan secara automatik menyediakan kalendar akademik.

Pilih Kumpulan

Sistem akan secara automatik:
- Salin kalendar akademik bersama untuk Kumpulan anda
- Selaras cuti umum + cuti khusus Kumpulan
- Setkan hari sekolah dan hari hujung minggu

Tambah Slot Mengajar

Setiap slot mengandungi: hari, subjek (dropdown disahkan), tahun/tingkatan, nama kelas, nombor waktu.

Tetapan Pukal — salin templat jadual ke beberapa kelas sekaligus:
- Toggle antara sesi Pagi dan Petang
- Tukar Kumpulan A/B dari modal pukal
- Tajuk masa menunjukkan masa sebenar untuk setiap waktu

Tetapan Masa Waktu

Setkan masa mula untuk setiap waktu (Waktu 1, Waktu 2, …) untuk sesi pagi dan petang. Ini akan menentukan masa pelajaran yang muncul pada RPH.

Pintarsekolah Sync (Pilihan)

Jika sekolah anda dipautkan (PIN ditetapkan), jadual akan disegerakkan secara automatik ke PintarSekolah, membolehkan PintarJadual (timetabling pintar) dan urusan guru ganti.

2. Jana AI — RPT & RPH

Jana RPT (Rancangan Tahunan)

Sidebar → 2 Jana AI → Jana RPT

Prasyarat: Jadual mesti ditetapkan dengan subjek yang ingin dijana.

1. Pilih Subjek, Tahun/Tingkatan, Tahun Kalendar
2. Klik Jana RPT
3. Tunggu 2–5 minit (sistem 6 ejen LangChain):
   - WeekContentAgent — petakan kandungan ke minggu pengajaran
   - SKSPAgent — agih kod SK/SP per minggu
   - ElementLibraryAgent — bina perpustakaan elemen PAK21, KBAT, NILAI
   - ElementAssignmentAgent — agih elemen merentas minggu
   - ValidationAgent — sahkan kualiti (PERCUMA — guna logik Python)
   - RPTFormatterAgent — format ke standard KPM
4. Skor kualiti (0–100) dipaparkan dengan ralat/amaran boleh tindak
5. Muat turun Word (format V2 — susun atur 3 lajur, jadual berasingan per minggu) atau JSON

Pengagihan Berasaskan Tajuk (BI/PI/ARAB):
- Untuk subjek BI, PI, dan ARAB, sistem guna pengagih sedar-tajuk
- Tetapkan kod tajuk DSKP (kod_tajuk) ke setiap minggu mengikut slot jadual
- PI: Topik 1.0, 7.0, 8.0 TASMIK ditetapkan automatik setiap minggu
- BI (v2.48.2+): Setiap minggu RPT BI kini memaparkan Kemahiran Utama (Main Skill) dan Kemahiran Komplementari (Complementary Skill) mengikut pasangan DSKP — Listening↔Speaking, Reading↔Writing, Language Arts→Speaking. Paparan tersedia dalam jadual web, eksport Word (12 lajur), dan kad mudah alih.

Jana RPH (Rancangan Mingguan)

Sidebar → 2 Jana AI → Jana RPH

Prasyarat: RPT mesti dijana dahulu untuk subjek/tahun yang sama.

1. Pilih Subjek, Tahun/Tingkatan, Tahun Kalendar, Minggu
   - Sistem auto-pilih minggu mengajar berikutnya — jika hari ini cuti, ia pilih minggu seterusnya yang tersedia
2. Pilih Strategi PAK21 (WAJIB) — 15 strategi tersedia
   - Kaedah P&P unik akan ditetapkan untuk setiap hari dalam minggu
   - Untuk subjek SM: pilihan strategi berbeza mengikut jenis (Sains, Teknikal/Vokasional, Seni, atau standard)
3. Pilih Tarikh Mengajar:
   - Semua hari mengajar tersedia dipilih secara lalai
   - Tarikh cuti ditandakan dan tidak boleh dipilih
   - Butang Pilih Semua / Nyahpilih Semua untuk pemilihan pantas
4. Refleksi Guru (Pilihan) — kongsi maklum balas dari minggu sebelumnya
   - Contoh: "Murid kurang faham bahagian pecahan, perlu lebih aktiviti hands-on"
   - AI akan ambil kira dalam penjanaan minggu ini
5. Klik Jana
6. Tunggu 1–3 minit (7 ejen khusus):
   - WeekDataAgent — ekstrak/sahkan data minggu dari RPT
   - DateMapperAgent — petakan slot ke tarikh kalendar (handle cuti)
   - ContentPrepAgent — agih kod SP merentas hari mengajar
   - ActivityGenAgent — jana aktiviti pedagogi kreatif (multi-bahasa: BM, BI, ARAB, Jawi)
   - DifferentiationAgent — buat pembelajaran terbeza 3 tahap (Cemerlang, Sederhana, Perlu Perhatian)
   - RPHFormatterAgent — format JSON patuh KPM
   - ValidationAgent — sahkan kualiti (PERCUMA)
7. Muat turun Word atau JSON

Selepas RPH siap, ciri automatik:

• Cadangan BBM dengan Gambar — bahan bantu mengajar yang relevan dengan pratonton imej dari Bank Gambar
• Impak Pembelajaran per objektif — pada setiap RPH harian (kecuali PRA / KSPK), satu jadual ringkas dengan tiga lajur: Menguasai (bilangan murid berjaya), Jumlah (bilangan murid dinilai), dan Objektif.
• Isi dua nombor per objektif, klik Simpan Impak
• Sistem auto-tulis refleksi profesional dalam Bahasa Melayu (cth: "Impak pembelajaran minggu ini: 28/30 (93%) cemerlang — Mengenal pasti tema cerita")
• Refleksi tersebut disuap ke penjanaan minggu hadapan untuk RPH adaptif (aktiviti pengayaan untuk objektif yang sudah dikuasai, pengukuhan/pemulihan untuk yang belum)
• Hantar untuk Semakan — submit RPH kepada Guru Besar melalui PintarSekolah (memerlukan sekolah dipautkan)

PRA (KSPK) kekal menggunakan format Refleksi sedia ada — objektif PRA disusun mengikut tiga domain (kognitif / afektif / psikomotor), tidak sesuai dengan jadual per-objektif rata.

Jana RPH (Pilihan Tajuk) — BI/PI/ARAB/PJPK

Sidebar → 2 Jana AI → Jana RPH (Pilihan Tajuk)

Mod ini membolehkan anda menetapkan kod tajuk DSKP secara manual untuk setiap hari mengajar, dan untuk PJPK, memilih komponen PJ atau PK per slot.

PJPK MESTI guna mod ini — penjanaan RPH standard tidak menyokong PJPK.

Bila guna:
- Mahu ajar tajuk tertentu pada hari tertentu
- Ulang tajuk sebelumnya
- Sesuaikan kelajuan untuk kelas
- PJPK (untuk pemilihan komponen per slot)

Cara guna:

1. Pilih Subjek (BI, PI, ARAB, atau PJPK), Tahun, Minggu
2. Untuk BI, PI, ARAB: Klik Muat Topik dan tetapkan kod tajuk DSKP per hari mengajar dari dropdown
3. Untuk PJPK: Setiap slot mengajar memaparkan radio PJ / PK:
   - Pendidikan Jasmani (PJ) untuk slot PJ
   - Pendidikan Kesihatan (PK) untuk slot PK
   - Boleh campuran dalam minggu yang sama (cth. PJ Isnin, PK Rabu)
   - Slot tidak berturutan dalam hari yang sama (cth. Waktu 1 dan Waktu 4) dikenal pasti sebagai kumpulan slot berasingan
4. Pilih Strategi PAK21 dan Tarikh Mengajar seperti biasa
5. Klik Jana
6. AI akan tapis kod SP berdasarkan tajuk yang anda tetapkan (atau komponen PJPK per slot)

3. AI Content Studio

Sidebar → 3 AI Content Studio

Antara muka sembang dengan AI untuk:
- Idea aktiviti pengajaran tambahan
- Penerangan konsep yang sukar
- Cadangan rubrik penilaian
- Soalan latihan tambahan
- Apa-apa idea pengajaran khusus subjek anda

Berbeza dengan Jana RPH/RPT yang berstruktur, Studio adalah bebas-bentuk — taipkan apa-apa soalan atau permintaan.

4. Pentaksiran & PBD

Aliran kerja: Senarai Murid → Rekod PBD → RPM → Pemulihan/Pengayaan

Senarai Murid

Bar Atas → Senarai Murid

Senarai Murid berada di bar atas (top bar), bukan sidebar utama.

Buat Senarai Baru:
1. Pilih Subjek, Tahun/Tingkatan, Nama Kelas
- Cadangan auto dari slot Jadual anda
2. Klik Buat Senarai

Tambah Murid (3 cara):

Medan murid:
- Nama Murid (wajib)
- No. IC / MyKid (pilihan tetapi disyorkan — membolehkan pautan silang dengan PintarSekolah & PintarPelajar)
- No. Pendaftaran (pilihan)

Padam Senarai:
- Klik ikon tong sampah pada kad — semua rekod PBD berkaitan akan turut dipadam

Rekod PBD (Pentaksiran Bilik Darjah)

Sidebar → 4 Pentaksiran & PBD → Rekod PBD

1. Pilih Senarai Murid dan Tarikh
2. Pilih Subjek
3. Klik lencana "Cadangan SP dari RPH" — auto-isi kod SP yang diajar pada hari itu (jika RPH wujud)
4. Untuk setiap murid, pilih Tahap Penguasaan (TP1–TP6) per kod SP
5. Rekod tersimpan automatik. Boleh kemaskini bila-bila masa.

Isi Pantas (Pro) — kalau ramai murid capai TP yang sama, tekan butang merah jambu "Isi Pantas" di sebelah Simpan. Pilih TP, pilih SP, dan satu senarai murid yang belum direkod untuk SP tersebut akan keluar. Pilih semua sekaligus atau cari nama tertentu, kemudian Simpan — semua TP dimasukkan dalam satu klik. Modal kekal terbuka dengan senarai dikemaskini secara automatik supaya cikgu boleh terus pergi ke TP/SP seterusnya. KSPK / PRA tiada butang ini kerana objektif PRA tidak guna TP.

RPM (Rekod Perkembangan Murid)

Sidebar → 4 Pentaksiran & PBD → RPM (Rekod Perkembangan)

Lihat data prestasi murid yang dikonsolidasi:

1. Pilih kelas dan tempoh laporan
2. Lihat matriks TP per murid × SP merentas subjek dan term
3. Eksport untuk:
   - Perjumpaan ibu bapa
   - Laporan sekolah
   - Hantar kepada Guru Besar untuk semakan

Profil Murid (klik nama murid):
- Senarai SP lemah (TP1–TP2) disorot
- Klik "Jana Cadangan AI" pada SP lemah → AI cadangkan aktiviti pemulihan khusus untuk setiap SP
- Guna cadangan untuk merancang aktiviti pemulihan disasarkan

Pemulihan & Pengayaan (BETA)

Sidebar → 4 Pentaksiran & PBD → Pemulihan & Pengayaan

Janakan lembaran kerja peribadi yang dipacu oleh data PBD/RPM murid anda.

1. Pilih Senarai Murid dan jenis: Pemulihan (remedial) atau Pengayaan (enrichment)
2. Pilih Subjek, Tahun/Tingkatan, dan kod SP untuk disasarkan
3. (Pilihan) Tambah arahan tersuai (cth. "fokus contoh simile")
4. Klik Jana Lembaran Kerja — sistem analisis tahap TP setiap murid dan jana lembaran sasaran
5. Muat turun DOCX untuk cetak atau kongsi

Had: 5 sehari (lesen berbayar), 2 seumur hidup (percuma). Memerlukan kunci API Gemini.

PintarSekolah — Semakan RPH

PintarRPH boleh dipautkan dengan PintarSekolah untuk membolehkan Guru Besar menyemak dan meluluskan RPH.

Pautkan ke Sekolah

Tetapan → Profil Guru → School PIN

Masukkan PIN sekolah yang diberikan oleh Pentadbir Sekolah. Sebaik dipautkan:
- Sekolah anda diperuntukkan automatik
- Guru Besar boleh lihat RPH yang dihantar untuk semakan
- Senarai murid boleh disegerakkan menggunakan No. IC/MyKid
- Jadual disegerakkan untuk PintarJadual (timetabling pintar)

Hantar RPH untuk Semakan

Selepas RPH dijana:
1. Klik Hantar untuk Semakan
2. Guru Besar akan menyemak melalui PintarSekolah
3. Status: Pending → Approved atau Returned dengan komen
4. Lihat status di Sidebar → PintarSekolah → Semakan RPH

Jemput Guru Besar

Sidebar → PintarSekolah → Jemput Guru Besar

Jana pautan jemputan untuk Guru Besar mendaftar PintarSekolah dan mendapatkan PIN. Hantar pautan ini melalui WhatsApp atau email.

Bar Atas — Peperiksaan & Bank Komuniti

Bar atas (kanan) memaparkan ciri tambahan:

Senarai Murid

Lihat bahagian Senarai Murid di atas.

Jana JSU (BETA)

Bar Atas → Jana JSU

Jana Jadual Spesifikasi Ujian menggunakan AI mengikut format rasmi KPM.

1. Pilih subjek, tahun, dan skop (kod SP)
2. Untuk UASA/UPSA — format kertas, markah, dan tempoh dimuatkan automatik dari spesifikasi KPM
3. Subjek pelbagai kertas (BM dan BI di SM) — pilih kertas
4. Subjek hanya-PBD — disekat (tiada ujian formal)
5. Markah lalai: 50 (sebelum ini 40), Tempoh: 75 minit (sebelum ini 60)
6. AI petakan kod SP merentas Bloom's Taxonomy (Mengingat, Memahami, Mengaplikasi, Menganalisis, Menilai, Mencipta)

Had: 5 sehari. Memerlukan kunci API Gemini.

Jana Soalan (BETA)

Bar Atas → Jana Soalan

Jana kertas peperiksaan AI dengan skema markah dan gambar terbenam:
1. Pilih subjek, tahun, dan blueprint JSU
2. AI jana soalan objektif dan subjektif dengan skema
3. Imej dari Bank Gambar dimasukkan automatik untuk soalan rajah/carta
4. Semak, edit, muat turun

Had: 3 sehari, 20 sebulan. Memerlukan kunci API Gemini.

Markah Ujian (BETA)

Bar Atas → Markah Ujian

Rekod markah ujian per murid per subjek. Tersedia untuk laporan pentaksiran.

Laporan Pentaksiran (BETA)

Bar Atas → Laporan Pentaksiran

Janakan laporan Pentaksiran Pusat Tingkatan (PPT) dari rekod PBD dan markah ujian.

Bank Soalan

Bar Atas → Bank Soalan

Layari, cari, dan sumbang soalan peperiksaan komuniti, ditapis mengikut subjek dan tahun. Tiada kunci API diperlukan.

• Tambah Soalan — cipta soalan sendiri (objektif, struktur, esei)

Bank Gambar

Bar Atas → Bank Gambar

Layari, cari, dan kongsi imej pengajaran dan bahan visual. Sistem boleh auto-padan imej untuk subjek dan tahun anda.

Jadual Lengkap & Kalendar Lengkap

Pandangan baca-sahaja untuk jadual penuh anda dan kalendar akademik dengan cuti.

Katalog Buku Teks / DSKP Prasekolah

Senarai semua DSKP dan buku teks yang dibundle untuk subjek anda.

Tetapan & Profil

Tetapan boleh diakses melalui menu pengguna di sudut kanan atas.

Profil Guru

• Nama Guru dan Nama Sekolah — muncul pada eksport Word
• Logo Sekolah — JPG/PNG (optional)
• School PIN — pautkan dengan PintarSekolah
• Jana Fail Meja — janakan dokumen Fail Meja format KPM (lihat di bawah)

Kunci API Gemini

5 slot kunci yang boleh ditetapkan secara berasingan:

Sandaran automatik untuk RPH: Jika Slot 1 mencapai had (Error 429), sistem akan cuba Slot 2, 3, 4, 5 secara automatik tanpa gangguan.

Kosongkan untuk fallback: Mana-mana slot yang dikosongkan akan secara automatik menggunakan Slot 1.

Klik butang Sahkan sebelah setiap kunci untuk menguji.

Fail Meja

Tetapan → Profil Guru → Jana Fail Meja

Janakan dokumen Fail Meja KPM sebagai Word:
1. Klik Jana Fail Meja
2. Tunggu pemprosesan (tiada panggilan AI)
3. Muat turun DOCX

Kandungan:
- Mukasurat hadapan
- Maklumat guru
- Jadual mengajar
- Senarai subjek/kelas
- Status penjanaan RPT
- Ringkasan PBD

Pertukaran Kurikulum (BUNDLE)

Hanya untuk pemegang lesen BUNDLE — lihat bahagian seterusnya.

Pertukaran Kurikulum SR/SM (BUNDLE)

Lesen anda menentukan kurikulum yang boleh diakses:

Cara tukar (BUNDLE):

1. Cari toggle SR / SM dalam sidebar (atas) atau bar atas (mudah alih)
2. Klik untuk tukar
3. Antara muka akan menyesuaikan diri:
   - Mod SR: Tahun 1–6, "murid", senarai subjek SR
   - Mod SM: Tingkatan 1–5, "pelajar", senarai subjek SM
4. Pilihan disimpan dalam sesi anda

Had Penjanaan Harian

PintarRPH Web mempunyai had harian untuk memastikan operasi mampan dan akses adil.

• Had ditetap per akaun pengguna
• Reset pada tengah malam (12:00 pagi MYT)
• Kuota tidak terpakai tidak dibawa ke depan
• ValidationAgent PERCUMA — tidak dikira dalam had
• Lihat plan, eksport, urus jadual, rekod PBD — tiada had

Aplikasi memaparkan kuota harian semasa pada halaman penjanaan (cth. "X/20 RPT dijana hari ini").

Polisi penuh: FAIR_USAGE_POLICY.md

Penyelesaian Masalah

Tidak boleh log masuk

1. Sahkan kredensial — sama dengan portal di rsautomation.my
2. Reset kata laluan di portal jika perlu
3. Semak status lesen di portal
4. Cuba pelayar lain atau kosongkan cache

Sesi tamat / Log keluar tiba-tiba

Sesi disimpan di Redis pelayan. Jika log keluar tidak dijangka:
1. Log masuk semula — data anda (RPH, jadual, kalendar) terpelihara di pelayan
2. Pastikan pelayar tidak menyekat cookies untuk domain
3. VPN/proxy yang tukar IP kerap boleh menyebabkan log keluar

Penjanaan AI lambat

Masa biasa:
- RPH: 1–3 minit
- RPT: 2–5 minit
- Ekstrak SK/SP: 2–4 minit

Jika lebih lama:
1. Semak kelajuan internet
2. Gemini API mungkin sibuk — tunggu beberapa minit
3. Jika Error 429 (kuota habis) — sistem cuba sandaran automatik untuk RPH; untuk ciri lain, tunggu reset atau guna kunci lain

Penjanaan gagal

Subjek tiada dalam senarai Jana

Subjek ditapis berdasarkan jadual:
1. Pergi ke Jadual dan sahkan slot termasuk subjek itu
2. Untuk lesen BUNDLE — sahkan kurikulum (SR/SM) yang dipilih betul
3. Simpan jadual semula

Senarai Murid hilang

Senarai Murid berada di BAR ATAS (top bar) sebelah kanan, bukan sidebar. Klik ikon kumpulan murid berlabel "Senarai Murid".

Eksport Word bermasalah

1. Word .docx boleh dimuat turun dari mana-mana peranti
2. Untuk lihat/edit, perlukan Microsoft Word, Google Docs, atau LibreOffice Writer
3. Jika muat turun gagal, pastikan pelayar tidak menyekat muat turun dari domain

Soalan Lazim

Adakah ada had harian RPT/RPH?

Ya. 20 RPT dan 20 RPH per pengguna sehari. Selaras dengan kuota Gemini percuma. Reset tengah malam.

Perlu pasang apa-apa?

Tidak. Aplikasi web 100% — buka pelayar dan log masuk.

Boleh guna offline?

Tidak. Internet diperlukan untuk semua ciri. PWA caching membolehkan lihat halaman yang pernah dimuat tetapi tidak penjanaan AI.

Cara log masuk?

Akaun portal lesen sama (rsautomation.my). Tiada skrin pengaktifan lesen berasingan, tiada kunci untuk dimasukkan.

Saya BUNDLE — cara tukar SR/SM?

Klik toggle SR/SM dalam sidebar atas atau bar atas mudah alih. Antara muka menyesuaikan automatik.

Perlu muat naik DSKP atau buku teks?

Tidak. Untuk semua subjek yang disokong, kandungan sudah dibundle di pelayan.

Boleh guna ARAB / Jawi?

Ya. ARAB (Bahasa Arab) dan PI (Pendidikan Islam, Jawi) disokong sepenuhnya menggunakan Google DocumentAI. Eksport Word render arah kanan-ke-kiri dengan betul.

Boleh guna beberapa kunci Gemini?

Ya. 5 slot, satu per ciri. Slot kosong fallback ke Slot 1. Untuk RPH, sandaran automatik antara semua slot jika kuota habis.

Apa itu Pilihan Tajuk?

Mod tersuai untuk BI/PI/ARAB/PJPK — tetapkan kod tajuk DSKP per hari secara manual. PJPK mesti guna mod ini untuk pilih komponen PJ/PK per slot.

Apa itu PAK21 dan kenapa wajib?

Strategi Pembelajaran Abad Ke-21 (PAK21) adalah pendekatan pengajaran KPM. 15 strategi tersedia, Kaedah P&P unik per hari. Setiap RPH termasuk Induksi 5-minit dan Penutup 5-minit.

Apa itu ValidationAgent?

100% PERCUMA — tiada panggilan AI. Mengesahkan RPH/RPT terhadap 20+ kriteria kualiti (medan KPM, format SK/SP, kedalaman aktiviti, peruntukan masa, BBM, pembezaan 3-tahap, deskriptor TP1-TP6). Skor 0–100 dengan ralat boleh tindak.

Apa itu Kumpulan A/B?

KSSR/KSSM ada dua jadual hujung minggu:
- A (Kedah, Kelantan, Terengganu) — Jumaat–Sabtu
- B (negeri lain) — Sabtu–Ahad

Sistem auto-konfigurasi kalendar berdasarkan pilihan anda di Jadual.

Apa beza RPT V1 dan V2?

V2 (lalai) — susun atur 3 lajur, jadual berasingan per minggu, padan templat KPM rasmi.
V1 (legasi) — 10 lajur, kekal untuk keserasian.

Boleh eksport data?

Ya. Semua RPT/RPH boleh dieksport sebagai Word (.docx) dengan profil guru auto-cap.

Berapa peranti boleh guna?

PintarRPH Web boleh diakses dari mana-mana peranti. Lesen mengurus satu sesi aktif pada satu masa. Tiada had peranti untuk web.

Selamat jika kosongkan pelayar?

Ya. Semua data (RPH, jadual, kalendar, profil) di pelayan. Kosongkan pelayar hanya keluarkan cookie sesi — log masuk semula.

Adakah PintarSekolah wajib?

Tidak wajib. PintarRPH boleh digunakan tanpa PintarSekolah. Pautkan hanya jika sekolah anda menggunakan PintarSekolah dan Guru Besar mahu menyemak RPH.

Dokumentasi Berkaitan

• QUICKSTART.md — Panduan permulaan ringkas
• GEMINI_API_SETUP.md — Cara dapatkan kunci Gemini percuma
• GEMINI_API_USAGE.md — Penggunaan API & anggaran kos
• FAIR_USAGE_POLICY.md — Polisi penggunaan adil
• LICENSE_ACTIVATION.md — Pengurusan lesen
• LIMITATIONS.md — Subjek disokong & had teknikal
• BUNDLED_DOCUMENTS.md — Senarai DSKP & BukuText terbina
• DSKP_AUDIT_REPORT.md — Liputan DSKP & jaminan ketepatan

Pautan Pantas

Tetapan Penting

• PintarRPH Web: pintarrph.com
• Portal Lesen: rsautomation.my
• Kunci Gemini: aistudio.google.com/app/apikey

Sokongan

• Email: [email protected]
• Telegram Sokongan: @PintarRPH_SupportBot
• Saluran Kemas Kini: @PintarRPH_Updates

Maklum Balas

Ada cadangan untuk panduan ini? Email kami di [email protected].

Terima kasih kerana memilih PintarRPH! Selamat mengajar!

Last Updated: May 2026
Platform: Web (https://pintarrph.com)
Curricula: KSSR (Tahun 1–6) dan KSSM (Tingkatan 1–5)
PintarRPH Desktop Version: 2.48.3