DOKUMEN SPESIFIKASI & PANDUAN PENGGUNA

e-PANTAU INOVASI

Sistem Pemantauan & Pelaporan Eksekutif Projek Inovasi Geran Penyelidikan TVET

Manual komprehensif merangkumi spesifikasi fungsian sistem, senibina pangkalan data, matriks peranan pengguna, panduan operasi papan pemuka eksekutif, pengurusan 10 modul data, serta tatacara penjanaan laporan rasmi geran penyelidikan POLIMAS dan JPPKK.

Nama Sistem:	e-Pantau Inovasi (Versi 2.0)
Projek Rujukan:	SMART-BARISTA XPRO (Kod: SBX-001)
Institusi Pelaksana:	Politeknik Sultan Abdul Halim Mu'adzam Shah (POLIMAS)
Agensi Pemilik:	Jabatan Pendidikan Politeknik dan Kolej Komuniti (JPPKK)
Tindanan Teknologi:	PHP 8.x, MySQL / SQLite Fallback, Vanilla JS, CSS3 Modern Glass
Status & Penafian:	SISTEM INI MASIH DALAM PENGUJIAN · DATA BUKAN RASMI (PROTOTAIP RINTIS)

Diterbitkan oleh: Pusat Penyelidikan dan Inovasi JPPKK & Unit Penyelidikan POLIMAS Tarikh Penerbitan: September 2026 · Versi Dokumen: 2.0-FINAL

Sejarah Pindaan Dokumen

Senarai Kandungan Eksekutif

1 Pengenalan & Objektif Sistem

1.1 Latar Belakang Sistem

e-Pantau Inovasi merupakan sebuah platform pemantauan digital berpusat yang dibangunkan khusus untuk menyelia, mengukur, dan melaporkan kemajuan fizikal serta kewangan bagi projek-projek inovasi penyelidikan yang menerima geran di bawah Jabatan Pendidikan Politeknik dan Kolej Komuniti (JPPKK), Kementerian Pendidikan Tinggi (KPT) Malaysia.

Sebelum pembangunan sistem ini, pemantauan status geran penyelidikan institusi TVET sering dilaksanakan menggunakan pelaporan manual berasaskan fail hamparan elektronik (Microsoft Excel) atau dokumen bercetak yang dihantar secara berkala. Kaedah tradisional ini menimbulkan pelbagai kekangan seperti kelewatan integrasi data kemajuan, risiko ralat pengiraan formula kewangan, ketiadaan jejak audit aktiviti, dan kesukaran pihak pengurusan atasan JPPKK untuk menilai status kesiapsiagaan inovasi secara langsung (real-time).

1.2 Projek Rujukan: SMART-BARISTA XPRO

Sebagai projek rujukan penanda aras (benchmark project), sistem ini mengkonfigurasi pelaksanaan penuh bagi projek inovasi SMART-BARISTA XPRO (Kod Geran: SBX-001), iaitu sebuah inisiatif penyelidikan teknologi imersif yang diterajui oleh Politeknik Sultan Abdul Halim Mu'adzam Shah (POLIMAS) dengan peruntukan geran berjumlah RM34,000.00. Projek ini merangkumi integrasi simulasi Realiti Maya (VR), pembangunan model 3D mesin espresso komersial, algoritma pemarkahan kecerdasan buatan (*Smart Scoring*), kolaborasi bersama Universiti Malaysia Perlis (UniMAP) dan rakan industri Hanna Cookies, serta pemfailan paten rasmi di Perbadanan Harta Intelek Malaysia (MyIPO).

1.3 Objektif Pembangunan Sistem

• Pemantauan Prestasi Masa Nyata: Menyediakan visualisasi KPI eksekutif, ring kemajuan peratusan, dan status fasa pembangunan yang dikemas kini secara automatik sejurus data baharu dimasukkan.
• Ketelusan & Integriti Penggunaan Dana Geran: Merekod setiap perbelanjaan bulanan, mengira baki peruntukan secara automatik, dan memaparkan nisbah perbelanjaan melalui carta donat interaktif.
• Penjejakan Aliran Harta Intelek (MyIPO Pipeline): Menyediakan senarai semak visual 7 fasa pendaftaran paten bermula dari carian kebaharuan (Novelty Search) sehingga penyerahan rasmi kepada MyIPO.
• Penjanaan Laporan Eksekutif Terus Cetak (Print-Ready): Menjana lembaran laporan rasmi berformat dokumen kerajaan lengkap dengan kepala surat institusi, data kewangan, dan ruang tandatangan perakuan rasmi Ketua Penyelidik serta Pengarah.
• Jejak Audit Keselamatan Penuh: Menyimpan rekod sejarah setiap pengubahan data (siapa, bila, alamat IP, nilai lama vs nilai baharu) bagi tujuan kepatuhan tata kelola integriti penyelidikan.

1.4 Perbandingan: Sistem e-Pantau vs Pelaporan Konvensional

2 Spesifikasi Senibina & Pangkalan Data

2.1 Tindanan Teknologi Perisian (Technology Stack)

2.2 Struktur Rajah Hubungan Entiti (ERD) & Skema Pangkalan Data

Pangkalan data epantau terdiri daripada 7 jadual relasi berstruktur bagi memastikan integriti data geran, pengasingan capaian pengguna mengikut projek, serta jejak audit keselamatan:

2.3 Kamus Data Jadual-Jadual Utama

A. Jadual: records (Tunjang Modul Data & Key-in)

B. Jadual: audit_logs (Jejak Keselamatan Forensik)

2.4 Ciri-Ciri Keselamatan Aplikasi (Security Controls)

• Perlindungan Token CSRF: Setiap borang POST dilindungi dengan token anti-pemalsuan kriptografi verify_csrf() bagi menghalang serangan *Cross-Site Request Forgery*.
• Penyulitan Kata Laluan: Semua kata laluan disulitkan menggunakan algoritma piawai password_hash(..., PASSWORD_DEFAULT) (Bcrypt) dengan penjanaan *salt* automatik.
• Pencegahan Serangan *Session Fixation*: Sistem menjana semula ID sesi secara automatik (session_regenerate_id(true)) sebaik sahaja pengguna berjaya disahkan.
• Perlindungan Suntikan SQL (SQL Injection Prevention): 100% interaksi pangkalan data menggunakan mekanisme PDO *Prepared Statements* dengan pembolehubah terikat (bound parameters).
• Penapisan XSS (Cross-Site Scripting): Fungsi penapisan tersuai e() (menggunakan htmlspecialchars dengan ENT_QUOTES) melindungi semua paparan output data pengguna.
• Pengesahan Muat Naik Selamat: Muat naik fail diperiksa had saiz (maksimum 10MB) serta jenis fail dibenarkan (PDF, JPG, JPEG, PNG sahaja) bagi menyekat ancaman fail berniat jahat.

3 Model Peranan & Hak Capaian

3.1 Definisi Peranan Pengguna

Sistem e-Pantau Inovasi mengamalkan kawalan capaian berasaskan peranan (*Role-Based Access Control - RBAC*) yang membahagikan pengguna kepada dua (2) kategori utama:

3.2 Matriks Hak Capaian Modul (CRUD Permissions Matrix)

4 Panduan Log Masuk & Pengesahan

4.1 Antara Muka Halaman Log Masuk

Halaman log masuk e-Pantau dibina dengan susun atur terbahagi dua (*Split-Screen Layout*) berprestij yang mengambil inspirasi daripada portal rasmi e-CAPS JPPKK:

• Bahagian Kiri (Panel Jenama): Memaparkan imej latar belakang mercu Kementerian Pendidikan Tinggi berserta kapsul logo rasmi KPT, JPPKK, dan POLYCC. Turut memuatkan 4 kad ciri utama sistem (Pemantauan Sasaran Utama, Kewangan Geran, Pengujian Sistem, dan Senarai Semak Paten MyIPO).
• Bahagian Kanan (Kad Borang Log Masuk): Borang pengesahan pengguna dengan perlindungan CSRF, medan ID Pengguna, Kata Laluan, serta bahagian Kad Log Masuk Pantas 1-Klik untuk kemudahan demonstrasi.

4.2 Akaun Pengguna Sedia Ada untuk Pengujian Sistem

Sistem didatangkan dengan akaun sedia ada yang telah dikonfigurasikan mengikut peranan:

4.3 Tatacara Log Masuk Langkah Demi Langkah

1. Buka pelayar web moden (Google Chrome / Microsoft Edge / Mozilla Firefox).
2. Layari alamat sistem: http://localhost/epantau/ (atau domain hosting rasmi pelayan).
3. Kaedah 1 (Log Masuk Biasa): Masukkan ID Pengguna dan Kata Laluan anda pada ruang isian, kemudian klik butang "Log Masuk ke e-Pantau".
4. Kaedah 2 (Log Masuk Pantas 1-Klik Demo): Pada bahagian bawah borang, klik salah satu kad akaun pantas (cth: "Pentadbir JPPKK" atau "Pegawai Data POLIMAS"). Sistem akan mengisi maklumat dan memasukkan anda ke dalam sistem secara serta-merta tanpa perlu menaip kata laluan.

4.4 Prosedur Log Keluar Selamat

Bagi mematuhi tatacara keselamatan data, pengguna disarankan untuk sentiasa log keluar setelah selesai menggunakan sistem:

1. Pada bar atas (topbar) sebelah kanan, klik butang merah "Log Keluar".
2. Sistem akan menukar status pengguna dalam jadual active_sessions kepada *offline* (0), merekodkan operasi LOGOUT ke dalam Jejak Audit forensik, memusnahkan kuki sesi pelayar web, dan mengembalikan pengguna ke halaman log masuk.

5 Panduan Papan Pemuka Eksekutif

5.1 Susun Atur Papan Pemuka Utama

Halaman Papan Pemuka Eksekutif (?page=dashboard) merupakan pusat kawalan visual menyeluruh yang menghimpunkan 11 modul pemantauan utama projek penyelidikan:

5.2 Penjelasan Terperinci 11 Bahagian Papan Pemuka

1. Header Induk & Penapis Tahun Geran (Dynamic Year Filter)

Memaparkan nama projek terpilih (SMART-BARISTA XPRO), kod rujukan geran (SBX-001), nama institusi pelaksana, dan lencana status semasa. Turut dilengkapi dengan menu lungsur "Tahun Geran" yang membolehkan penapisan rekod merentas tahun pelaksanaan (2025, 2026, 2027 atau Semua Tahun).

2. Gelung Kemajuan Keseluruhan (Overall Progress Ring)

Menunjukkan peratusan keseluruhan pencapaian fizikal projek geran melalui animasi lingkaran SVG berpusat. Formula pengiraan dikira secara dinamik:

3. Empat (4) Kad KPI Utama

• Kemajuan Keseluruhan: Skor purata kemajuan semua komponen pembangunan aktif.
• Geran Digunakan: Jumlah perbelanjaan kumulatif yang telah dibelanjakan berserta peratus penggunaan bajet (cth: RM24,200.00 atau 71.2%).
• Baki Peruntukan Geran: Baki dana tersedia yang masih boleh dituntut (cth: RM9,800.00 atau 28.8%).
• Rakan Kolaborasi: Bilangan rakan universiti dan industri yang memeterai kerjasama aktif (UniMAP & Hanna Cookies).

4. Seksyen 1: Garis Masa Pembangunan & Sasaran Utama Geran (Fasa 1, Fasa 2, Fasa 3)

Memvisualkan fasa sasaran utama projek dengan peratusan kemajuan setiap fasa:

• Fasa 1 (Persediaan Projek & VR Asas): Status Selesai (100%).
• Fasa 2 (Mesin Espresso 3D, Pemarkahan & Integrasi): Status Selesai (100%).
• Fasa 3 (Pengujian Pakar, Ujian Pengguna, Paten & Pelaporan): Status Dalam Proses (60%).

Ciri Penapis Pantas (Quick Filter Tabs): Pengguna boleh menekan tab "Semua", "✓ Selesai", "⏳ Proses", atau "📋 Belum" untuk menapis kad sasaran secara serta-merta tanpa memuat semula halaman web.

5. Seksyen 2: Kemajuan Mengikut Komponen Kerja (7 Komponen Pembangunan)

Memaparkan senarai 7 komponen kerja pembangunan teknikal dengan bar kemajuan dwitona:

1. Pembangunan VR (80% - Aktif)
2. Sistem Pemarkahan Pintar (70% - Aktif)
3. Papan Pemuka Web (60% - Aktif)
4. Mesin Espresso 3D (80% - Aktif)
5. Pengujian Pengguna (50% - Aktif)
6. Pengesahan Pakar (40% - Aktif)
7. Paten / Harta Intelek (60% - Aktif)

6. Seksyen 3: Pemantauan Kewangan Geran & Carta Donat Bajet

Menampilkan carta visual donat yang memetakan nisbah dana dibelanjakan (71.2%) berbanding baki dana (28.8%) melalui formula lengkung bulatan SVG. Di bahagian bawah, jadual ringkas menyenaraikan butiran perbelanjaan bulanan terkini (Bulan 1, Bulan 2, dan Bulan 3) berserta status tuntutan.

7. Seksyen 4: Papan Skor Pengujian & Validasi Sistem

Memaparkan kad penilaian ujian kebolehgunaan dan skor kejituan sistem:

• Pengujian Sistem: Skor 92% (Pasukan Penyelidik POLIMAS) - Selesai.
• Pengesahan Pakar: Skor 85% (Fakulti Kejuruteraan UniMAP) - Dalam Proses.
• Pengujian Pengguna Industri: Skor 88% (Barista Hanna Cookies) - Dalam Proses.
• Kebolehgunaan VR: Menunggu sesi ujian akhir.

8. Seksyen 5: Penjejak Aliran Harta Intelek (MyIPO Patent Pipeline)

Menggunakan tema warna biru diraja tentera laut (*Royal Navy Blue*) yang elegan, modul ini memetakan 7 peringkat pemfailan paten di MyIPO: Carian Kebaharuan → Spesifikasi Paten → Tuntutan → Borang 1 → Borang 5 → Borang 22 → Penyerahan Rasmi MyIPO.

9. Seksyen 6: Kolaborasi Strategik & Rakan Industri

Memaparkan profil rakan kerjasama universiti awam (UniMAP) dan industri komersial F&B (Hanna Cookies) berserta skop penglibatan bersama.

10. Seksyen 7: Pembangunan Bakat TVET

Memaparkan statistik impak modal insan: 8 Pelajar, 4 Pensyarah, 3 Pakar Industri, 5 Sesi Latihan TVET, dan 12 Sijil Kompetensi yang dikeluarkan.

11. Seksyen 8: Pasukan Penyelidik Geran & Hubungan WhatsApp (5 Penyelidik)

Menampilkan barisan 5 orang ahli penyelidik geran (termasuk Ketua Geran dengan lencana mahkota emas 👑) berserta institusi pelaksana, jawatan penyelidikan dan butang pautan satu klik WhatsApp untuk membolehkan pihak Pusat Penyelidikan dan Inovasi JPPKK menghubungi PIC secara terus.

12. Jejak Audit & Kaunter Pelawat Dalam Talian (Visitor Analytics)

Memaparkan ringkasan aktiviti terkini bagi akaun pentadbir serta widget analitis trafik pelawat langsung (Pengguna Dalam Talian, Pelawat Hari Ini, Pelawat Bulan Ini, dan Jumlah Lawatan) berasaskan AJAX tak segerak.

6 Pengurusan 9 Modul Data & Key-in

6.1 Pengenalan Menu Sisi (Sidebar Navigation)

Menu sebelah kiri menyusun modul sistem kepada tiga (3) seksyen utama:

• NAVIGASI UTAMA: Papan Pemuka, Ahli Geran (5 Orang), Sasaran Utama & Aktiviti, Kewangan Geran, Kemajuan Komponen Kerja, Hasil & Output Geran.
• VALIDASI & PRESTASI: Pengujian & Validasi, Rakan Kolaborasi, Harta Intelek (IP), Pembangunan Bakat.
• PENTADBIR SISTEM: Capaian Laporan Rasmi, Senarai Geran (Admin), Urus Pengguna (Admin), Log & Jejak Audit (Admin).

6.2 Ringkasan Medan Isian Mengikut 9 Modul Data

6.3 Tatacara Menambah Rekod Baharu (Add Record)

1. Pilih modul yang dikehendaki pada menu navigasi sisi (contoh: klik "Kewangan Geran").
2. Pada bahagian atas sebelah kanan halaman, klik butang "+ Tambah Rekod".
3. Isikan maklumat pada borang:
   • Tajuk / Nama Rekod: Masukkan nama item secara jelas (contoh: "Pembelian Set Oculus Meta Quest 3").
   • Kategori: Pilih atau taip kategori berkaitan (contoh: "Perkakasan VR").
   • Nilai Nombor (RM / Skor): Masukkan angka berkaitan (contoh: 4500.00).
   • Nilai Teks: Masukkan teks paparan tambahan (contoh: "RM4,500.00 (Invois #INV-8821)").
   • Status: Pilih status semasa ("Selesai", "Dalam Proses", atau "Belum Mula").
   • Peratus Kemajuan: Gerakkan slider peratus dari 0% hingga 100%.
   • Dokumen / Resit Lampiran: Klik butang muat naik untuk melampirkan fail bukti (format PDF, PNG, atau JPG).
   • Catatan / Keterangan: Masukkan butiran sokongan atau skop pembelian.
4. Klik butang "Simpan & Terbitkan Rekod".
5. Sistem akan merekodkan transaksi ke dalam jadual records, mencipta log keselamatan dalam audit_logs, dan mengemas kini formula pengiraan papan pemuka secara langsung.

7 Pengurusan Pasukan Penyelidik (Ahli Geran)

7.1 Struktur 5 Ahli Pasukan Penyelidik Rasmi

Berdasarkan dokumen kelulusan geran penyelidikan SMART-BARISTA XPRO (POLIMAS), struktur pasukan terdiri daripada seorang (1) Ketua Penyelidik dan empat (4) Ahli Penyelidik dengan kepakaran teknikal masing-masing:

7.2 Ciri Interaktif Komunikasi Pintar (WhatsApp & Call Direct)

Halaman Pengurusan Ahli Geran (?page=team) dilengkapi dengan butang tindakan pantas yang memudahkan pihak pengurusan atau rakan penyelidik berhubung secara langsung:

• Butang WhatsApp Hijau: Menjana pautan API rasmi WhatsApp (https://wa.me/60...) yang terus membuka aplikasi WhatsApp Web atau telefon pintar dengan mesej rujukan projek automatik.
• Butang Panggilan Suara: Pautan protokol tel:... untuk memulakan panggilan terus melalui peranti mudah alih atau aplikasi telefon komputer.

7.3 Tatacara Mendaftar / Menukar Maklumat Ahli Geran

1. Navigasi ke menu "Ahli Geran (5 Orang)" pada sidebar.
2. Klik butang "+ Tambah Ahli Pasukan" (atau klik "Sunting" pada ahli sedia ada).
3. Masukkan Nama Penuh, Peranan / Jawatan dalam Projek, dan Nombor Telefon.
4. Pilih institusi ahli daripada menu lungsur institusi (senarai 36 Politeknik dan Kolej Komuniti seluruh Malaysia).
5. Tandakan kotak pilihan "Lantik Sebagai Ketua Penyelidik (Ketua Geran)" jika individu berkenaan merupakan peneraju geran (sistem akan memastikan hanya satu Ketua Geran bagi setiap projek).
6. Klik "Simpan Maklumat Ahli" untuk mengesahkan rekod.

8 Operasi Pentadbir Sistem (JPPKK Admin)

8.1 Pengurusan Senarai Geran Penyelidikan (?page=project)

Pentadbir JPPKK mempunyai kuasa pendaftaran dan kawalan ke atas semua geran inovasi politeknik dan kolej komuniti:

• Pendaftaran Geran Baharu: Memasukkan Nama Geran, Kod Projek (cth: SBX-001), Institusi Penerima Geran, Jumlah Dana Peruntukan (RM), Status Semasa, serta Tarikh Mula dan Tamat Geran.
• Pendaftaran Serentak Ketua Geran: Semasa mencipta geran baharu, pentadbir boleh terus memasukkan Nama Ketua Penyelidik dan nombor telefon bagi menjimatkan masa pendaftaran.
• Penukaran Konteks Geran Aktif: Memilih mana-mana geran daripada senarai untuk menukar paparan papan pemuka dan data pemantauan ke projek tersebut.
• Eksport Senarai Geran ke Excel / CSV: Klik butang "Eksport Excel / CSV" pada halaman pengurusan projek untuk memuat turun lembaran lengkap semua geran TVET bagi tujuan pembentangan mesyuarat JPPKK.

8.2 Pengurusan Akaun Pengguna & Kawalan Akses (?page=users)

Modul ini menguruskan pendaftaran, pengesahan, dan hak kebenaran akaun sistem:

• Mendaftar Pengguna Baharu: Memasukkan Nama Penuh, ID Pengguna (Username unik), Nombor Telefon, Institusi, dan Kata Laluan (minimum 8 aksara).
• Penetapan Peranan:
  • Pilih Pentadbir JPPKK untuk memberi akses penuh kepada pegawai kementerian.
  • Pilih Pegawai Key-in / Penyelidik untuk akaun pensyarah institusi pelaksana.
• Penguncian Geran (Project Assignment Lock): Bagi peranan Pegawai Key-in, pilih geran khusus yang dibenarkan untuk diakses. Pengguna ini tidak akan dapat melihat atau mengubah data geran institusi lain.
• Nyahaktifkan / Pulihkan Akaun: Klik butang togol status untuk menggantung akses akaun pengguna yang telah berpindah institusi atau selesai tempoh penyelidikan.

8.3 Pemeriksaan Jejak Audit Forensik (?page=audit)

Jejak Audit menyediakan rekod forensik kekal bagi setiap aktiviti yang berlaku di dalam aplikasi e-Pantau:

9 Penjanaan Laporan Rasmi Geran & Eksport Data

9.1 Modul Capaian Laporan Rasmi (?page=reports)

Halaman Laporan Rasmi Geran menyediakan lembaran dokumen eksekutif berformat piawai kerajaan yang sedia untuk dicetak (*Print-Ready A4 Document*). Laporan ini menggabungkan semua data kemajuan dan kewangan ke dalam format laporan kemajuan berkala rasmi:

Elemen-Elemen Utama Laporan Rasmi:

1. Kepala Surat Rasmi (Letterhead): Logo rasmi KPT, JPPKK, POLYCC dan nama Politeknik Sultan Abdul Halim Mu'adzam Shah (POLIMAS).
2. Metadata Geran: Kod projek, nama penuh inovasi, tarikh tempoh pelaksanaan, peruntukan dana diluluskan, perbelanjaan kumulatif, dan baki semasa.
3. Seksyen 1: Ringkasan Eksekutif Projek: Penerangan latar belakang dan objektif inovasi.
4. Seksyen 2: Senarai Pasukan Penyelidik: Jadual 5 ahli pasukan rasmi berserta institusi dan peranan.
5. Seksyen 3: Status Fasa & Sasaran Utama: Jadual pencapaian fasa Fasa 1, Fasa 2, dan Fasa 3.
6. Seksyen 4: Penyata Perbelanjaan Kewangan Geran: Jadual lejar terperinci perbelanjaan bulanan mengikut kategori berserta jumlah besar dan baki tersedia.
7. Seksyen 5: Komponen Kerja, Hasil Output & Harta Intelek: Jadual pencapaian 7 komponen teknikal dan status semakan pemfailan MyIPO.
8. Seksyen 6: Ruangan Perakuan & Pengesahan Rasmi: Dua kotak tandatangan rasmi:
   • Perakuan Ketua Penyelidik: Pengesahan keesahan data kemajuan dan perbelanjaan oleh Ketua Geran.
   • Pengesahan Pengarah Institusi / JPPKK: Ruangan sokongan dan perakuan oleh Pengarah POLIMAS atau Pengarah Pusat Penyelidikan dan Inovasi JPPKK.

9.2 Panduan Mencetak Dokumen atau Menyimpan ke PDF

1. Buka halaman Laporan Rasmi dengan menekan menu "Capaian Laporan Rasmi" pada sidebar.
2. Pada bar atas laporan, klik butang biru "🖨️ Cetak Dokumen Rasmi" (atau tekan pintasan papan kekunci Ctrl + P).
3. Pada kotak dialog cetakan pelayar web:
   • Pilih Destination: "Save as PDF" (atau pilih mesin pencetak fizikal).
   • Pilih Paper Size: "A4".
   • Pilih Layout: "Portrait".
   • Pastikan kotak "Background graphics" ditandakan bagi mengekalkan warna lencana dan garisan lejar.
4. Klik butang "Save" untuk menjana fail PDF rasmi.

9.3 Fungsi Eksport Data Mentah ke Format CSV (?page=export)

Bagi tujuan analisis data statistik atau pengauditan perakaunan luaran, pengguna boleh memuat turun keseluruhan pangkalan data rekod projek dalam bentuk fail CSV:

• Klik butang "📥 Eksport Data (.CSV)" pada halaman Laporan Rasmi.
• Pelayar web akan memuat turun fail dengan nama berformat: rekod_geran_[KOD_PROJEK]_[TARIKH].csv.
• Fail ini serasi dibuka secara terus menggunakan Microsoft Excel, Apple Numbers, Google Sheets, atau perisian SPSS.

10 Penyelenggaraan & Penyelesaian Masalah

10.1 Prosedur Sandaran Pangkalan Data (Backup & Recovery)

Bagi menjamin keselamatan data projek geran, pentadbir disyorkan melaksanakan sandaran secara berkala:

• Persekitaran MySQL (Server / cPanel / DirectAdmin): Gunakan perisian phpMyAdmin atau arahan terminal mysqldump:
  mysqldump -u [user] -p epantau > backup_epantau_$(date +%Y%m%d).sql
• Folder Lampiran Fail Bukti: Lakukan salinan keselamatan berkala bagi folder muat naik:
  epantau/uploads/

10.2 Panduan Penyelesaian Masalah Lazim (Troubleshooting & FAQ)

1. Ralat: "Sesi telah tamat. Sila kembali dan cuba lagi (Error 419)"

Punca: Token keselamatan CSRF tamat tempoh kerana borang dibiarkan terbuka terlalu lama tanpa dihantar.
Penyelesaian: Muat semula halaman web (tekan F5) dan hantar borang semula.

2. Ralat: "Pangkalan data tidak dapat disambungkan"

Punca: Servis MySQL pada XAMPP Control Panel atau pelayan hosting belum dimulakan.
Penyelesaian: Sistem e-Pantau dilengkapi dengan mekanisme *fallback* automatik yang akan beralih kepada pangkalan data SQLite sandaran secara senyap tanpa merencatkan capaian pengguna. Pastikan modul MySQL pada XAMPP diaktifkan jika ingin menggunakan pangkalan data utama.

3. Masalah: Paparan CSS / susun atur tidak berubah selepas kemas kini

Punca: Pelayar web menyimpan fail lembaran gaya CSS lama dalam cache memori.
Penyelesaian: Tekan pintasan papan kekunci Ctrl + F5 (atau Ctrl + Shift + R) untuk memuat semula sistem secara *Hard Refresh*. Fail CSS sistem telah dilengkapi penanda versi unik (cth: ?v=v5-full) bagi meminimumkan isu ini.

4. Ralat Muat Naik Fail Lampiran Gagal

Punca: Saiz fail melebihi 10MB atau format fail selain PDF/JPG/PNG.
Penyelesaian: Mampatkan (*compress*) fail PDF atau imej tersebut sebelum memuat naik, dan pastikan jenis format fail adalah dibenarkan.

10.3 Sokongan Teknikal & Meja Bantuan (Helpdesk)

Sekiranya terdapat sebarang persoalan, cadangan penambahbaikan, atau bantuan teknikal berhubung pengoperasian sistem e-Pantau Inovasi, sila hubungi: