myAnsuran-KIK-JPPH-/src

MyAnsuran

Sistem demo Laravel untuk permohonan bayaran cukai harta secara ansuran bagi pembentangan KIK. Aplikasi ini dibina menggunakan Laravel, Blade, Bootstrap, jQuery dan Maatwebsite Excel, dengan aliran penuh untuk Admin, Staff, dan Pengguna Awam.

Ciri utama

• Pendaftaran dan login berasaskan role.
• Pengguna awam boleh:
  • lengkapkan profil
  • semak No_Akaun_Tunggakan
  • hantar permohonan ansuran 2 hingga 6 bulan
  • lihat jadual ansuran selepas staff sahkan
  • buat bayaran dummy JomPAY
• Staff boleh:
  • semak permohonan
  • lihat maklumat lengkap pemohon
  • masukkan amaun ansuran secara manual
  • rekod ulasan staff
  • cetak borang permohonan rasmi
  • import data akaun harta melalui Excel/CSV
• Admin boleh:
  • pantau dashboard penuh
  • urus pengguna, peranan dan data harta
  • lihat bayaran, tugasan, notifikasi, laporan dan audit trail

Teknologi

• Laravel 13
• Blade
• Bootstrap 5
• jQuery
• SQLite untuk demo tempatan
• Struktur migrasi serasi untuk MySQL
• Maatwebsite Excel

Setup cepat

composer install
php artisan key:generate
php artisan migrate:fresh --seed --force
php artisan serve

Aplikasi akan tersedia di:

http://127.0.0.1:8000

Akaun demo

• Admin: admin@myansuran.test
• Staff: staff@myansuran.test
• Pengguna Awam: user@myansuran.test
• Kata laluan semua akaun: password

Flow demo disyorkan

1. Pengguna awam

1. Log masuk sebagai user@myansuran.test
2. Buka profil dan semak maklumat pemohon
3. Pergi ke Permohonan Baharu
4. Semak No_Akaun_Tunggakan
5. Hantar permohonan ansuran
6. Lihat permohonan dan statusnya
7. Selepas staff sahkan, buka jadual ansuran
8. Klik bayaran dummy JomPAY dan simpan resit

2. Staff

1. Log masuk sebagai staff@myansuran.test
2. Buka Permohonan
3. Pilih permohonan untuk disemak
4. Semak seksyen Maklumat Pemohon
5. Masukkan amaun ansuran manual bagi setiap bulan
6. Isi Ulasan Staff / Pegawai Penyemak
7. Pilih tindakan Permohonan Diterima atau Permohonan Ditolak
8. Cetak borang permohonan
9. Buka modul Import Excel untuk demo import akaun harta

3. Admin

1. Log masuk sebagai admin@myansuran.test
2. Buka dashboard admin
3. Semak modul:
   • Pengurusan Pengguna
   • Pengurusan Peranan
   • Permohonan
   • Akaun Ansuran
   • Bayaran
   • Tugasan
   • Notifikasi & Emel
   • Data Harta
   • Tetapan Sistem
   • Laporan
   • Audit Trail

Data demo yang tersedia

• 10 akaun harta dengan kategori Kediaman, Industri, Perdagangan
• permohonan demo dengan status diproses, aktif, gagal, selesai
• jadual ansuran manual
• bayaran dummy
• notifikasi sistem
• email log dummy
• tugasan staff
• audit trail

Verifikasi

Command utama yang telah disahkan:

php artisan migrate:fresh --seed --force
php artisan route:list
php artisan test

Feature tests semasa meliputi:

• login semua role
• hantar permohonan pengguna awam
• sahkan permohonan oleh staff dengan jadual manual
• validasi mismatch jumlah jadual ansuran
• print borang staff dengan maklumat pemohon dan ulasan
• pembayaran dummy JomPAY
• import data akaun melalui service
• akses modul pemantauan admin

Limitasi semasa

• JomPAY masih dummy/mock
• email masih dummy log
• PDF sebenar belum diintegrasi, cetakan guna HTML print-friendly
• SMS/WhatsApp belum diintegrasi

Lokasi penting

• Routes: routes/web.php
• Services: app/Services
• Seeders: database/seeders/DatabaseSeeder.php
• Tests: tests/Feature/MyAnsuranFlowTest.php