BETA — INTERNAL GUIDE

🌻 Rakyat Complaint Portal — User Manual

How a complaint travels from a resident's phone all the way to a resolved SISPAA case · by Bersama volunteers, Kulai

📖 What this portal does

A no-login "easy SISPAA" for Kulai residents. Residents (rakyat) report a problem in one minute. Bersama volunteers triage it in a backend, submit it to the official government SISPAA system by hand, and follow up. Residents track progress with a courier-style report number — no account needed.

▸ The happy path (full route)

▸ Site addresses

▸ Beta login credentials

▸ Step 1 — Resident submits

▸ Step 2 — Volunteer registers & logs in

▸ Step 3 — Admin assigns

▸ Step 4 — Volunteer works the case

▸ Step 5 — Resident checks status

▸ Status lifecycle

🛤️ The happy path — full route

One complaint, five hand-offs. This is the exact flow we verified live end-to-end (worked example: report KUL-20260723-8Z7E).

👤 Rakyat
Submit complaint
Describe problem + name + phone → gets a report number
→
🙋 Volunteer
Register & log in
Join as volunteer, log in at the admin portal
→
🔑 Admin
Assign case
Pick a volunteer from the dropdown → status becomes Assigned
→
🙋 Volunteer
Work & update
Read → Contact → Submit to SISPAA → mark Done
→
👤 Rakyat
See status
Look up report number → sees Resolved

Status trail for the worked example: Submitted → Assigned → Read → Contacted → SISPAA Submitted → Resolved

🌐 Site addresses

WhoAddressFor
👤 Rakyatbersama.wenjyue.comSubmit a complaint & check status
🙋 Volunteer / 🔑 Adminbersama-admin.wenjyue.comBackend to triage & work complaints
🙋 New volunteerbersama.wenjyue.com/user.html?tab=volunteerRegister as a volunteer
📘 This guidebersama-manual.wenjyue.comYou are here

🔐 Beta login credentials

Beta only. These demo accounts are for testing during the beta. Change / remove them before public launch — do not reuse these passwords in production.
RoleUsernamePasswordNotes
🔑 Adminadminadmin123Sees everything, assigns volunteers, approves cancellations
🙋 Volunteer 1vol1vol123Ahmad Razif — sees only his assigned reports
🙋 Volunteer 2vol2vol123Lim Mei Ling
🙋 Volunteer 3vol3vol123Siti Nurhaliza
👤 Demo resident60123456789demo123Optional account login on the public site
The admin login page also has one-tap 🔑 Admin / 🙋 Vol 1 / 🙋 Vol 2 quick-login buttons — no typing needed during the demo.

1 Resident submits a complaint 👤 rakyat

  1. Go to bersama.wenjyue.com.
  2. Type the problem in “What’s the problem?” (e.g. “Lampu jalan di Taman Kulai Utama sudah rosak lebih 2 minggu…”).
  3. Enter Name and Phone. Phone can be typed as 0112223344 — the system normalises it to 60112223344.
  4. (Optional) tap + Add location, category, photos to add a category chip, GPS location, or a photo.
  5. Tick “I agree to the Privacy Policy” (required).
  6. Press Submit Report →.
✅ You get a green “Report Submitted!” screen with a report number like KUL-20260723-8Z7E. Tell residents to save this number — it’s how they track progress. Language selector (EN / BM / 中文 / தமிழ்) is at the top right.

2 Volunteer registers & logs in 🙋 volunteer

Register (first time)

  1. Go to the Join Volunteer page (or on the admin login page tap “Register here →”).
  2. Enter a Username (e.g. budi), a Password, and your Phone.
  3. Press Join as Volunteer → you’ll see “Registered! You can now log in at the Admin Portal.”

Log in

  1. Go to bersama-admin.wenjyue.com.
  2. Enter your username & password, press Log In →.
  3. First-time volunteers get a “Complete Your Profile” pop-up (name, phone, qualification) — fill it so the admin knows who you are, or tap Skip.
A volunteer only ever sees “My Assigned Reports” — the reports the admin gave them. They cannot see other volunteers’ cases or the full complaint list.

3 Admin assigns the complaint 🔑 admin

  1. Log in at bersama-admin.wenjyue.com as admin / admin123 (or tap 🔑 Admin).
  2. The Dashboard shows totals (Total / Today / Open / Urgent / Resolved) and the 5 most recent complaints.
  3. Open Complaints in the left menu. Find the new report (search by name / phone / report number if needed).
  4. In that row’s Assigned To dropdown, pick a volunteer (e.g. budi).
✅ The status flips from Submitted to Assigned automatically, and the case now appears in that volunteer’s list. Admins can also flag a case Urgent and send a WhatsApp alert to the volunteer.

4 Volunteer works the case 🙋 volunteer

Log in as the assigned volunteer, open Complaints → My Assigned Reports, and walk the case through its buttons (left to right):

  1. ✓ Read — you’ve read the complaint → status Read.
  2. 📞 Contact — you’ve phoned the resident → status Contacted. (The 📞 icon opens a WhatsApp/tel link.)
  3. 🏛 SISPAA — after you submit the case on the real government SISPAA site, click this. A pop-up asks for the SISPAA Reference Number (e.g. SISPAA-2026-KUL-0087). Type it and press Submit → status SISPAA Submitted and the ref is saved on the case. You can leave it blank to skip.
  4. ✅ Done — the issue is fixed → status Resolved.
The 📝 remark icon lets a volunteer add an internal note (not shown to the resident). If a resident asks to cancel, the volunteer taps X Cancel? and an admin approves it.

5 Resident checks the status 👤 rakyat

  1. Go to bersama.wenjyue.com and tap “Check Status” (or the “Check an existing report” link).
  2. Enter the report number (KUL-20260723-8Z7E) and press Semak / Check.
  3. The current status is shown — for our worked example: Resolved.
✅ No login required. Residents who registered an optional account also see all their past reports under “My Complaints” automatically.

🚦 Status lifecycle

StatusMeaningSet by
SubmittedResident filed it; waiting for triageSystem
AssignedGiven to a specific volunteerAdmin
ReadVolunteer has read itVolunteer
ContactedVolunteer phoned the residentVolunteer
SISPAA SubmittedFiled on the official SISPAA (ref saved)Volunteer
ResolvedIssue fixed / closedVolunteer
CancelledWithdrawn (needs admin approval)Admin