myLRMP · Panduan Sistem & Persediaan Bengkel

Sistem Bersepadu Racun Makhluk Perosak

Prototaip berfungsi untuk BKRPB, Jabatan Pertanian Malaysia di bawah Akta Racun Makhluk Perosak 1974 (Akta 149). Satu panduan: cara guna prototaip, seni bina, aliran proses, apa yang sudah siap — dan soalan yang perlu dibawa ke bengkel BRS, SRS dan SDS.

Tender QT260000000005006 11 modul · 2 fasa 10/11 modul hidup 21 aliran demo 98 ujian · 291 penegasan
01

Sistem sekilas pandang

myLRMP menyatukan seluruh urusan kawalan racun perosak dalam satu gelung yang sama: pihak industri memohon melalui portal, pegawai jabatan menyemak dan memutuskan mengikut hierarki kelulusan, dan setiap kelulusan menjana dokumen PDF rasmi berkod QR yang boleh disahkan awam. Semua tindakan direkod dalam jejak audit, dan setiap keputusan mencetus notifikasi serta mesej integrasi (bayaran, sistem luaran) melalui corak outbox.

Gelung teras
01
Mohon
Industri isi borang berwizard / dinamik, no. rujukan automatik
pegawai
Semak
Peti masuk pegawai ikut kebenaran RBAC
pegawai
Putuskan
Lulus / tolak / perlukan semakan, dengan catatan
auto
Dokumen
Sijil / surat / lesen PDF berkod QR
auto
Notifikasi
e-Notify pemohon + invois fi (e-Pay)
auto
Integrasi
Mesej outbox → sistem luaran, balasan webhook

Kuning = keputusan manusia. Hijau = automatik selepas keputusan. Awam boleh sahkan sebarang dokumen di /semak tanpa log masuk.

Fasa 1 · Teras

Pendaftaran & makmal

e-Cert · e-Lab · e-Label · e-Tech · Admin — pendaftaran racun, ujian makmal, label, data teknikal, pentadbiran.

Fasa 2 · Operasi

Lesen & pemantauan

e-Iklan · e-Import · e-Lesen · i-Monitoring · i-Services · Mobile — pelesenan, penguatkuasaan, khidmat awam.

3 portal + awam

Satu identiti

Filament /admin, Portal Pegawai /pegawai, Portal Industri /industri, portal awam tanpa log masuk.

02

Cara guna prototaip

Cara terpantas memahami sistem: jalankan secara tempatan, log masuk sebagai setiap peranan, dan ikut aliran demo. Sistem sama berubah wajah mengikut siapa anda.

Akaun demo

Semua kata laluan: Password123!

PortalAkaunPeranan
/adminadmin@doa.gov.mySuper Admin (Pentadbir Sistem)
/pegawai/loginahmad.fadzillah@doa.gov.myPendaftar — pemutus akhir
/pegawai/loginketua.bahagian@doa.gov.myKetua Bahagian — tier kelulusan
/pegawai/loginaisyah.ali@doa.gov.myPegawai Pendaftaran — semakan kemasukan
/pegawai/loginhelpdesk@doa.gov.myHelp Desk — baca sahaja
/industri/logintan.ahkow@skpsb.com.myIndustri — pemohon
/Awam / petani, tanpa log masuk

Aliran demo utama (10 daripada 21 — senarai penuh dalam README)

01 · e-Cert

Pendaftaran racun hujung-ke-hujung

Industri hantar wizard → Pegawai Pendaftaran / Penilai / Pendaftar semak & lulus → sijil PDF dijana.

02 · Perkhidmatan modul

15 jenis, satu acuan maker-checker

Pilih perkhidmatan → borang dinamik → pegawai lulus → surat kelulusan PDF berkod QR.

03 · e-Exam

Peperiksaan PCO dalam talian

10 soalan rawak, 20 minit, lulus ≥70% → laluan terus mohon Lesen PCO. Pegawai urus bank soalan.

04 · e-Lesen

Kitaran hayat lesen

Kelulusan PCO/HTP keluarkan lesen 24 bulan automatik → pembaharuan dalam tetingkap 60 hari → peringatan luput berjadual.

05 · e-Pay

Invois fi & resit

Setiap penghantaran jana invois → Bayar Sekarang (simulasi FPX) → resit PDF berkod QR + mesej outbox eTerimaan.

06 · i-Monitoring

Penguatkuasaan

Pemeriksaan premis + kes serbuan/siasatan/pendakwaan dengan rantaian jagaan ekshibit.

07 · i-Services

Aduan awam

Awam hantar aduan di /aduan tanpa log masuk (ADU-…) → triaj pegawai → maklum balas.

08 · Semakan QR

Ketulenan dokumen

/semak — masukkan no. rujukan atau imbas QR pada PDF → verdict SAH / TIDAK DITEMUI.

09 · Admin

ACL, audit, integrasi

Matriks RBAC 52×9, peranan tersuai, log audit bertapis, pemantauan outbox MyDoaXchange.

10 · Tugasan Saya

Baris gilir peribadi pegawai

Permohonan menunggu, bayaran belum jelas, aduan baharu, kes saya, lesen hampir luput — ikut kebenaran.

03

Seni bina

Seni bina di bawah ialah seni bina sebenar prototaip (SDS draf) — kolum "Produksi" menunjukkan laluan naik taraf ke mandat tender.

LapisanPrototaip (kini)Produksi (mandat tender)
Rangka kerjaPHP 8.3 + LaravelPHP 8.3 + Laravel 11 LTS
FrontendLivewire + Blade + Filament 4 (selaras komitmen tender)Vue 3 + TypeScript
Mudah alihPWA boleh dipasangFlutter
Pangkalan dataSQLite (kueri portable)SQL Server 2022
Gilir / cacheSegerak / failRedis + RabbitMQ
HosTempatanMyGovCloud@PDSA (Docker/K8s, GitLab CI)
Prinsip 1

Rangka dipacu konfigurasi

Satu sumber kebenaran config/mylrmp-modules.php: 11 modul, sub-modul, fasa, kebenaran gerbang. Tambah modul = tambah konfigurasi + laluan, bukan ubah enjin.

Prinsip 2

Maker-checker generik

config/mylrmp-forms.php takrif 17 jenis perkhidmatan. Satu pasang pengawal + satu model ModuleApplication laksana semua jenis. Perkhidmatan baharu ikut acuan sama.

Prinsip 3

Outbox + webhook

Semua integrasi melalui mesej beridempotensi dua hala — boleh diuji tanpa sistem luaran, dan tiada mesej hilang senyap.

Aliran integrasi (7 sistem luaran)

Domain data teras
Identiti / ACLusers, roles, permissions, password_histories, companies
e-Certregistration_applications, application_reviews, certificates, products, active_ingredients
Generikmodule_applications (payload JSON — dinormalkan selepas BRS kunci medan)
Penguatkuasaaninspections, enforcement_cases, case_exhibits
Integrasioutbound_messages, inbound_messages
Auditactivity_log (spatie/activitylog — IP, agen, portal)
Keputusan reka bentuk (ADR)
  • D1 — Rangka dipacu konfigurasi, bukan enjin aliran generik: elak kerumitan runtime DSL.
  • D2 — Payload JSON untuk borang generik semasa prototaip; normalisasi selepas bengkel BRS.
  • D3 — Outbox + webhook bertandatangan untuk semua integrasi: idempotensi hujung-ke-hujung.
  • D4 — Livewire/Filament: komitmen prototaip tender "Laravel Livewire + data stub".
  • D5 — SQLite dengan kueri portable: migrasi ke SQL Server tanpa tulis semula.
Keselamatan sedia terbina

Dasar kata laluan 12+ aksara tanpa guna semula 12 terdahulu · sesi tamat 15 minit · throttle log masuk 5/minit · jejak audit penuh dengan IP & peranti · RBAC granular (spatie + Filament Shield) · webhook HMAC + anti-replay + idempotensi · MFA-sedia (penguatkuasaan produksi) · setiap PDF rasmi berkod QR boleh disahkan awam.

04

Aliran proses teras

Enam proses bisnes (BRS draf) sudah dilaksana dalam prototaip. Dua yang paling penting difahami sebelum bengkel:

BP-01 · Pendaftaran Racun (e-Cert) — 4 peringkat penilaian

industri
Wizard
Draf → hantar, dokumen sokongan
peg. pendaftaran
Semakan kemasukan
Kesempurnaan borang
penilai teknikal
Penilaian teknikal
Data efikasi / toksikologi
penilai label
Penilaian label
Pematuhan label
pendaftar
Keputusan
Lulus / tolak / perlukan semakan
auto
Sijil
PDF + no. pendaftaran

BP-02 · Perkhidmatan Modul Generik — acuan semua perkhidmatan baharu

industri
Pilih perkhidmatan
15+ jenis merentas 6 modul
auto
Borang dinamik
Medan ikut Lampiran A, no. rujukan automatik
pegawai
Peti masuk
Lulus / tolak dengan catatan
auto
Surat PDF + QR
Notifikasi pemohon
BP-03 · e-Exam

Peperiksaan PCO

10 soalan rawak · 20 minit · lulus ≥70% → laluan terus ke Lesen PCO. Prasyarat statutori (BR-04).

BP-04 · i-Monitoring

Penguatkuasaan

Pemeriksaan berjadual dengan senarai semak → laporan PDF. Kes: serbuan / siasatan / pendakwaan + rantaian jagaan ekshibit.

BP-05 · i-Services

Khidmat awam

Aduan tanpa log masuk (ADU-) → triaj → maklum balas. Rujukan harga. Semakan ketulenan /semak.

BP-06 · Admin

Pentadbiran

Pengguna, RBAC, peranan tersuai, konfigurasi, pengumuman, jejak audit, laporan CSV, pemantauan integrasi.

Peraturan bisnes terkunci (BR-01 … BR-08)

No. rujukan unik per modul · keputusan hanya oleh peranan berkebenaran · setiap kelulusan → PDF berkod QR · lulus e-Exam prasyarat Lesen PCO · permohonan diputuskan tidak boleh diubah · akaun digantung hilang akses serta-merta · kelulusan cetus notifikasi + mesej bayaran · semua tindakan diaudit (pengekalan 7 tahun — produksi).

05

Apa yang sudah ada

10 daripada 11 modul mempunyai fungsi hidup (Mobile melalui PWA). Setiap keperluan fungsian dalam SRS draf dipetakan ke skrin sebenar — bengkel hanya perlu meminda, bukan mencipta.

#ModulFasaStatusNota
1e-Cert — Pendaftaran Racun1AktifWizard 4 peringkat + sijil PDF; notifikasi pendaftaran belum
2e-Lab — Makmal1SeparaSampel piawai + cerakinan (2 jenis)
3e-Label — Label Produk1SeparaPek saiz + tukar label
4e-Tech — Data Teknikal1Separa7 sub-perkhidmatan (efikasi, tox, MRL, dll.)
5Admin — Pentadbiran1AktifPengguna, RBAC 52×9, konfigurasi, audit
6e-Iklan — Iklan Racun2SeparaPermohonan + pembaharuan; pemantauan belum
7e-Import — Import & Eksport2SeparaPermit R&D + surat sokongan eksport
8e-Lesen LRMP — Pelesenan2SeparaPCO + HTP; e-Exam, bank soalan & premis aktif
9i-Monitoring — Penguatkuasaan2AktifPemeriksaan, kes, ekshibit; e-PRM/Pewartaan/e-Baja belum
10i-Services — Perkhidmatan2SeparaAduan, harga, carian awam, kalkulator aktif; 6 sub lagi belum
11Mobile — Aplikasi Mudah Alih2Dlm PembangunanPrototaip: PWA boleh dipasang; produksi: Flutter
Dokumen kontrak

BRS · SRS · SDS draf siap

Dalam MyLRMP2/docs/ — berlabuh pada perisian berfungsi, setiap FR ada kolum bukti (laluan skrin).

Lampiran dijana

A · B · C daripada config/DB

Katalog borang 17 jenis (A), matriks RBAC 52 kebenaran × 9 peranan (B), inventori 11 modul (C).

Kualiti

98 ujian · 291 penegasan

ACL, polisi kata laluan, aliran permohonan, e-Exam, outbox, webhook (tandatangan/replay/idempotensi), laporan.

06

Belum dibina — skop kontrak

Perkara di bawah memang skop tender tetapi bukan skop prototaip M5 — dan kebanyakannya bergantung pada jawapan Jabatan dalam bengkel. Inilah punca senarai soalan di Seksyen 07.

Teknikal produksi
  • SQL Server 2022 — mandat tender (prototaip SQLite, kueri portable)
  • Vue 3 + TypeScript frontend produksi
  • Flutter — aplikasi mudah alih (pegawai lapangan + awam)
  • Redis + RabbitMQ — gilir produksi
  • MyGovCloud@PDSA — Docker/K8s + GitLab CI
  • MFA sebenar (OTP/FIDO2), SSO OAuth2/OIDC, PKI tandatangan digital
  • PDPA — penyamaran data ikut peranan; WCAG 2.1 AA penuh
Fungsian & data
  • 7 integrasi sebenar — MyDoaXchange, eTerimaan, e-Lesen LRMP, MyToxinSign, myMRL, iLatihan, Reslab (kini corak outbox/webhook + adapter stub)
  • 8 migrasi data legasi
  • Sub-modul belum dibina — e-PRM, e-Baja, Pewartaan, myMesyuarat, myRepositori, myFile, e-Consult, e-Directory penuh, bayaran dalam talian sebenar
  • Saluran e-mel / SMS untuk notifikasi
  • Delegasi & eskalasi hierarki kelulusan boleh konfigurasi
  • Pengekalan audit 7 tahun — dasar arkib produksi
07

Soalan untuk bengkel BRS · SRS · SDS

Struktur bengkel: 2 sesi × 2 hari (Sesi 1: Fasa 1 — e-Cert · e-Lab · e-Label · e-Tech · Admin; Sesi 2: Fasa 2), minimum 30 peserta, 1 Champion per modul dari BRS hingga UAT. Strategi kita: tunjuk skrin prototaip, minta champion sahkan atau pinda — jangan mula dari kertas kosong. Setiap keputusan bengkel muktamad; perubahan selepas sign-off melalui CR rasmi.

BRS · Keperluan Bisnes

Sahkan proses, kunci medan

Sasaran: champion sahkan/pinda apa yang sudah wujud dalam prototaip. Bawa Lampiran A, B, C bercetak.

  1. Aliran e-Cert 4 peringkat (kemasukan → teknikal → label → keputusan) — tepat? Ada peringkat mesyuarat / Lembaga LRMP yang tidak dimodelkan? Siapa pemutus sebenar setiap peringkat?
  2. Hierarki kelulusan Penilai → Ketua Bahagian → Pengarah → Ketua Pengarah — modul mana perlu berapa tier? Peraturan delegasi semasa cuti & eskalasi tertunggak?
  3. Medan borang (Lampiran A) — bagi setiap 17 jenis: medan wajib/pilihan, dokumen sokongan & format, sahkan atau pinda satu persatu.
  4. Format no. rujukan — LAB-/LBL-/TEK-/IKL-/IMP-/LSN-/ADU-/KES-tahun-siri boleh diterima, atau ada format rasmi jabatan sedia ada yang wajib dikekalkan?
  5. Fi & bayaran — jadual fi rasmi setiap perkhidmatan? Dikutip semasa hantar atau selepas lulus? Pengecualian (agensi kerajaan, R&D)?
  6. SLA / piagam pelanggan — tempoh sasaran (hari bekerja) setiap proses, untuk papan pemuka & peringatan.
  7. Tempoh sah dokumen — sijil pendaftaran, lesen PCO 24 bulan & tetingkap pembaharuan 60 hari — sahkan ikut Akta 149 / peraturan semasa.
  8. e-Exam — 10 soalan / 20 minit / lulus 70%: sahkan. Berapa kali boleh ulang? Yuran ulangan? Sah keputusan berapa lama?
  9. Kes tepi — rayuan selepas tolak, tarik balik permohonan, pindah milik pendaftaran, pembatalan / penggantungan sijil & lesen.
  10. Sub-modul belum dibina (e-PRM, e-Baja, Pewartaan, myMesyuarat, myRepositori, myFile, e-Consult) — proses As-Is, borang sebenar, siapa pemilik proses, volum transaksi setahun.
SRS · Keperluan Perisian

Kunci spesifikasi ⬜ yang belum dibina

Sasaran: tukar setiap item "skop kontrak" kepada keperluan boleh-bina dengan pemilik & spesifikasi.

  1. MFA — kaedah rasmi (OTP SMS / apl authenticator / FIDO2)? Wajib untuk peranan mana? Sesiapa yang kecuali?
  2. SSO — pegawai guna identiti sedia ada (HRMIS / myGovID)? Protokol OIDC atau SAML, siapa IdP, siapa luluskan pendaftaran aplikasi?
  3. 7 integrasi — bagi SETIAP sistem (MyDoaXchange, eTerimaan, e-Lesen LRMP, MyToxinSign, myMRL, iLatihan, Reslab): pemilik & pegawai perhubungan, spesifikasi API (REST/SOAP) + auth, format mesej, persekitaran sandbox, SLA respons. Tanpa ini, integrasi kekal stub.
  4. 8 migrasi data legasi — sistem sumber & format (DB/Excel/kertas?), anggaran volum rekod, kualiti data, siapa pemilik, strategi cutover & tempoh dwi-sistem.
  5. Notifikasi — gerbang SMS jabatan? SMTP / e-mel rasmi .gov.my? Templat surat rasmi berkepala jabatan?
  6. PDPA — medan peribadi mana perlu penyamaran, peranan mana boleh lihat penuh, tempoh simpanan data pemohon.
  7. Laporan rasmi — laporan bulanan / tahunan / parlimen yang wajib: format, penerima, kekerapan (melebihi CSV sedia ada?).
  8. Pengekalan audit 7 tahun — media arkib, siapa boleh capai, prosedur pelupusan.
  9. Bahasa — BM sahaja atau dwibahasa BM/EN (portal industri ada syarikat multinasional)?
  10. Data awam — skop tepat data yang didedahkan tanpa log masuk (/semak, direktori PCO, e-Warta, harga) — sahkan tiada isu pendedahan.
SDS · Reka Bentuk & Infrastruktur

Kunci persekitaran produksi

Sasaran: setiap item infrastruktur ada pemilik, spesifikasi dan tarikh sedia. Kebanyakan jawapan di tangan Jabatan / PDSA.

  1. SQL Server 2022 — siapa sedia lesen & server? On-prem atau MyGovCloud? Sizing (CPU/RAM/storan) & HA (Always On?)?
  2. MyGovCloud@PDSA — spesifikasi persekitaran (VM / K8s), proses onboarding & tempoh, akses GitLab CI, sekatan rangkaian keluar.
  3. Persekitaran — topologi dev / staging / prod, akses VPN pasukan pembangunan, dasar data ujian (boleh guna data sebenar?).
  4. Pematuhan keselamatan — ujian penembusan mandatori (siapa lantik?), keperluan RAKKSSA / ISMS, proses kelulusan sebelum go-live.
  5. PKI tandatangan digital — CA mana (Pos Digicert / MSC Trustgate)? Dokumen mana wajib ditandatangani secara digital vs QR sahaja?
  6. Vue 3 + TypeScript — sahkan peralihan frontend; ada design system jabatan / MYDS yang wajib dipatuhi?
  7. Flutter — skop luar talian pegawai lapangan (pemeriksaan tanpa liputan?), saluran agihan (Play Store / AppGallery / MDM jabatan)?
  8. Redis + RabbitMQ — disedia oleh siapa, perlukan HA, siapa memantau?
  9. Sandaran & DR — sasaran RPO/RTO, lokasi DR, kekerapan latihan pemulihan.
  10. Domain & e-mel — subdomain .gov.my rasmi, siapa urus DNS & sijil SSL, alamat penghantar e-mel rasmi.
Taktik bengkel

Setiap soalan dijawab terus pada skrin prototaip — "ini yang sistem buat sekarang, betul atau pinda?" Keputusan direkod dalam minit dan Lampiran A/B/C dikemas kini, kemudian medan JSON module_applications dinormalkan mengikut apa yang dikunci (ADR D2). Champion wajib bawa SOP, borang kertas dan seksyen Akta berkaitan (ground rule bengkel).

myLRMP — Sistem Bersepadu Racun Makhluk Perosak · BKRPB, Jabatan Pertanian Malaysia · Tender QT260000000005006 (Milestone M5).

Sumber: MyLRMP2/README.md, docs/BRS-draf.md · SRS-draf.md · SDS-draf.md, Lampiran A/B/C, agenda & SOP bengkel BRS.