Quickstart

PintarRPH Web - Quick Start Guide

Welcome! Follow these simple steps to get started with PintarRPH Web.

IMPORTANT: You need TWO things to use this app:
1. License Key (purchase via PintarRPH User Portal -- see Step 1)
2. Google Gemini API Key (FREE -- see GEMINI_API_SETUP.md)

Register & Get Your License
Log In
Configure Gemini API Key
Setup Teaching Schedule
Generate Plans
Optional Setup
New Features Highlights
Troubleshooting

STEP 1: Register & Get Your License

Create an Account & Purchase

a) Visit https://rsautomation.name.my
b) Register an account (this is also your PintarRPH Web login)
c) Purchase a license and pay via ToyyibPay (FPX/card/e-wallet)
d) Payment processed automatically
e) License key appears in your portal dashboard (format: LIC-XXXXXXXX...)

Each purchase generates one unique license key.

License Types

License	Curriculum Access
SR	Sekolah Rendah (KSSR) -- Tahun 1--6
SM	Sekolah Menengah (KSSM) -- Tingkatan 1--5
BUNDLE	Both SR and SM -- switch freely in the app

License Details

1 license = 1 user, 1 year validity
Validity period starts from first activation (not purchase date)
Access PintarRPH Web from any device with a browser

Get Google Gemini API Key

REQUIRED FOR AI FEATURES -- do this before Step 3

See detailed guide: GEMINI_API_SETUP.md
Quick version:
- Go to: https://aistudio.google.com/app/apikey
- Sign in with Google account
- Click "Create API key in new project"
- Copy your API key
- Keep it safe!

It's FREE for most users (generous free tier). No credit card required for free tier.

STEP 2: Log In

Visit https://pintarrph.rsautomation.name.my
Enter your username and password (same account as the User Portal)
Click "Log In"

No installation needed -- PintarRPH Web runs entirely in your browser.

On first login: All DSKP and BukuText documents are pre-bundled and ready to use -- no uploads or extraction needed!

STEP 3: Configure Gemini API Key

CRITICAL: Without this, AI features won't work!

Go to Settings (Tetapan) in the sidebar
Click "Kunci API Gemini" (Gemini API Keys)
You will see 5 numbered key fields:
- Key 1 -- Jana RPH (required minimum; other empty fields fall back to this)
- Key 2 -- Jana RPH Custom
- Key 3 -- Jana RPT
- Key 4 -- Ekstrak Buku Teks & SK/SP
- Key 5 -- Muat Naik Kalendar
Paste your API key into Key 1 at minimum
Optionally add separate keys for other features to avoid quota sharing
Click "Simpan" (Save)

Test by generating a simple plan. See GEMINI_API_SETUP.md if you have issues.

STEP 4: Setup Teaching Schedule

This is the key setup step. Your teaching schedule determines which subjects you can generate RPT/RPH for, and automatically sets up your academic calendar.

Go to "Jadual" (Schedule) in the sidebar
Select Your Kumpulan (IMPORTANT!):
- Kumpulan A: Kedah, Kelantan, Terengganu (school days: Sunday--Thursday)
- Kumpulan B: All other states (school days: Monday--Friday)
Add your teaching slots:
- Select day of week
- Select subject (e.g., BM, MATE, SAINS)
- Select year level (Tahun/Tingkatan)
- Enter class name (e.g., 4A, 5 Bestari)
- Set slot order (period number)
Set your period times (morning/afternoon session start times)
Click "Simpan Jadual" (Save Schedule)

What happens automatically when you save:
- The system copies the shared academic calendar for your Kumpulan and current year
- Holidays are automatically synced (public holidays + Kumpulan-specific holidays)
- Your schedule determines which subjects appear in RPT/RPH generation forms

No calendar upload needed! The academic calendar is set up automatically based on your Kumpulan selection.

STEP 5: Generate Plans

Everything is ready! DSKP and BukuText content is pre-bundled, and your academic calendar was set up automatically with your schedule.

Generate RPT (Annual Plan) -- Do This First

Go to: RPT in the sidebar, then "Jana RPT" (Generate)
Select subject, year level, calendar year
Click "Jana RPT" (Generate RPT)
Wait 2--5 minutes (multi-agent system)
Automatic quality validation before export (FREE -- no API calls)
Download Word (V2 format -- cleaner 3-column layout) or JSON

For BI/PI/ARAB: Topic-based distributor assigns DSKP topic codes per week based on your schedule slots.

Generate RPH (Weekly Lesson Plan) -- Requires RPT First

Go to: RPH in the sidebar, then "Jana RPH" (Generate)
Select subject, year level, week number
Select PAK21 Strategy (REQUIRED -- choose from 15 strategies)
Select specific teaching dates (holidays auto-excluded)
Optional -- Add teacher reflection from previous week
Click "Jana" (Generate)
Wait 1--3 minutes (7 AI agents)
Automatic quality validation before export
Download Word or JSON

Generate RPH (Pilihan Tajuk Mode -- BI/PI/ARAB/PJPK)

PJPK must use this mode. Standard RPH generation does not support PJPK.

Go to: RPH then "Jana RPH (Pilihan Tajuk)"
Select subject (BI, PI, ARAB, or PJPK), year, week
For BI, PI, ARAB: Click "Muat Topik" then assign a DSKP topic code per teaching day
For PJPK: Each teaching slot shows a PJ / PK radio button -- select Pendidikan Jasmani or Pendidikan Kesihatan independently per slot
Select PAK21 Strategy and Teaching Dates
Click Generate
AI filters SP codes by your assigned topics / PJPK component
Download Word or JSON

Optional Setup

Setup Teacher Profile

Your info will appear on exported Word documents!

Go to Settings then "Profil Guru" (Teacher Profile)
Enter your teacher name (e.g., Encik Ahmad bin Abdullah)
Enter your school name (e.g., SEKOLAH KEBANGSAAN TAMAN SENTOSA)
Upload your school logo (JPG/PNG, optional)
Click "Simpan Profil" (Save Profile)

Choose Your Curriculum (BUNDLE License Only)

If you have a BUNDLE license, you can switch between SR and SM curricula:

Go to Settings then "Tukar Kurikulum" (Switch Curriculum)
Select SR (KSSR) or SM (KSSM)
The app will reload with the correct subjects, year labels, and content

Setting	SR (KSSR)	SM (KSSM)
Year label	Tahun 1--6	Tingkatan 1--5
Student term	murid	pelajar
Subjects	BM, BI, MATE, SAINS, etc.	BM, BI, MAT, MATH, ADDMATH, BIO, CHEM, etc.

Users with a single SR or SM license will see a fixed badge -- no switching needed.

New Features Highlights

Shared Resources -- No Extraction or Upload Needed

DSKP and BukuText are pre-bundled on the server for all supported subjects
Academic Calendar is automatically set up when you save your teaching schedule
No need to upload PDFs, run extractions, or install document packages
Just set up your schedule and start generating!

Multiple Gemini API Keys

Assign up to 5 separate API keys, one per feature group (RPH, RPH Custom, RPT, BukuText, Calendar)
Prevents quota sharing between features
Auto-fallback for RPH: if Key 1 hits quota, the system switches to another key automatically
Any empty field falls back to Key 1 -- only Key 1 is required

Smarter Week Selection

RPH generation now auto-selects the next upcoming teaching week
If today is a holiday, it picks the next available week

Pilihan Tajuk RPH Generation

For BI, PI, ARAB, and PJPK subjects
Manually assign DSKP topic codes per teaching day
PJPK: independently select PJ or PK per teaching slot

Topic-Based RPT Distribution

Smarter annual plan distribution for BI, PI, ARAB
Assigns topic codes to weeks based on your schedule slots
PI subjects: Topics 1.0, 7.0, 8.0 TASMIK automatically every week

SR/SM Curriculum Switching (BUNDLE License)

Switch between Sekolah Rendah and Sekolah Menengah from Settings
Subjects, year labels, and content update automatically
Single SR or SM license users see a fixed badge

Quality Validation System

ValidationAgent checks RPH and RPT quality automatically
Validates 20+ criteria (KPM compliance, SK/SP format, content quality)
Returns quality score (0-100) with actionable feedback
FREE -- No API calls required (uses Python logic)

Kumpulan A/B Support

Support for different school calendar groups (KPM system)
Kumpulan A (Kedah, Kelantan, Terengganu): Friday-Saturday weekend
Kumpulan B (other states): Saturday-Sunday weekend
Automatic weekend detection and Kumpulan-specific holidays
Calendar auto-configured when you set up your teaching schedule

RPT Format V2 (Default)

Clean 3-column layout (vs old 10-column)
Better SK-SP matching by code
Separate table per week for readability
Matches official KPM templates

Teacher Profile System

Set up your teacher name, school name, and school logo
Profile info appears automatically in exported Word documents

Bank Soalan & Bank Gambar (v2.7.0)

Community-driven question and image bank:
- Bank Soalan -- Browse, search, and contribute exam questions by subject and year level
- Bank Gambar -- Browse, search, and share teaching images and visual aids
- No Gemini API key required

Prasekolah (PRA) Support (v2.7.0)

PRA curriculum now supported for SR license holders
Covers all six Tunjang (Komunikasi, Sains & Teknologi, Kemanusiaan, Keterampilan Diri, Fizikal & Estetika, Kerohanian)

PWA Offline Support (v2.7.0)

Install PintarRPH as an app on your device from the browser
Basic offline caching for previously loaded pages

Semakan RPH & PintarSekolah Integration (v2.9.0)

Semakan RPH -- Submit RPH for headmaster review and track approval status
BBM Suggestions -- AI-powered teaching aid suggestions with images after RPH generation
Excel/CSV Roster Import -- Bulk import student rosters from Excel or CSV
IC Number / MyKid -- Optional student IC field for cross-product linking
Batch Schedule Assignment -- Copy schedule templates across multiple classes
Soalan with Images -- Exam paper DOCX exports now include embedded images
PintarSekolah Integration -- Link to your school via School PIN

Assessment Pipeline -- Pentaksiran & PBD (v2.2.0)

New sidebar section for KPM assessment workflow:
- Senarai Murid -- Manage class student rosters for PBD (supports Excel/CSV import)
- Rekod PBD -- Record TP1--TP6 performance levels per student
- RPM -- View consolidated student performance across subjects
- Jana JSU -- AI-generated exam blueprints (requires Gemini API key, 5/day limit)
- Jana Soalan -- AI-generated exam papers with marking schemes and images (requires Gemini API key, 3/day limit)
- Markah Ujian -- Record exam scores per student
- Laporan Pentaksiran -- Generate PPT assessment reports

Troubleshooting

Can't log in?

Check internet connection
Verify username and password (same as User Portal at rsautomation.name.my)
Try resetting your password on the User Portal

License not active?

Log in to https://rsautomation.name.my and check your license status
Ensure your license key has been activated
Contact support if issue persists

AI generation is slow?

Normal: 1--3 minutes for RPH, 2--5 minutes for RPT
Check internet connection
Wait up to 10 minutes, then retry if needed

RPT says "prerequisites not met"?

Make sure your teaching schedule is set up (Step 4)
The schedule must include the subject you want to generate RPT for
Your Kumpulan must be selected so the calendar is configured

API key errors?

Go to Settings then Kunci API Gemini
Verify your key is entered correctly (starts with "AIza")
Make sure Key 1 is filled in at minimum

System Requirements

Browser: Any modern browser (Chrome, Firefox, Safari, Edge)
Internet: Required at all times (cloud-based application)

No installation. No downloads. Just visit https://pintarrph.rsautomation.name.my and log in.

Supported Subjects

SR (KSSR) -- Tahun 1--6

Full support (Latin-script):
BM, BI, MATE, SAINS, SEJ, MORAL, PJPK, PSV, MUZIK, RBT, PRA (Prasekolah)

Full support (Non-Latin -- pre-bundled):
ARAB (Bahasa Arab), PI (Pendidikan Islam -- Jawi)

SM (KSSM) -- Tingkatan 1--5

Full support (Latin-script -- F1--F3):
BM, BI, MAT, MATH, SAINS, SCI, SEJ, GEO, MORAL, RBT, ASK, PSV, MUZIK, PJPK, SSEM_*, TASAWWUR, KEUSAHAWANAN

Full support (Latin-script -- F4--F5):
BM, MATH, ADDMATH, ADDSCI, BIO, CHEM, FIZIK, SEJ, GEO, MORAL, MAT, PSV, MUZIK, PJPK, KESUS_BM, KESUS_BI, LK, PKE, PKM, KEUSAHAWANAN, MPV_* (22 vocational subjects)

Full support (Non-Latin -- pre-bundled):
ARAB, PI, HIFZ, MAHARAT, ALSYARIAH, USULUDIN, ALLUGHAH, PQAS, PSI, PI_AK

NOT supported (OCR limitations):
CINA, TAMIL, IBAN, KADAZAN, SEMAI

See LIMITATIONS.md for details and workarounds.

Need Help?

Email: [email protected]

Include:
- Description of the issue
- Screenshots if applicable

Thank you for choosing PintarRPH!

HAPPY TEACHING!

Last Updated: March 2026
Platform: Web (https://pintarrph.rsautomation.name.my)
PintarRPH Desktop Version: 2.28.4