GuardTech Manual

Manual Pengguna GuardTech

Panduan lengkap untuk Admin Panel, aplikasi Guard, dan aplikasi Admin NFC. Halaman ini awam — tiada login diperlukan.

Versi 1.0 Julai 2026 UI sistem: English

1. Pengenalan

GuardTech ialah platform pengurusan patroli keselamatan dan operasi tenaga kerja untuk syarikat pengawal dan laman pelanggan mereka.

Sistem ini menghubungkan:

  • Pejabat / operasi — melalui Admin Panel (web) untuk konfigurasi tapak, jadual, peranti, dan pemantauan
  • Pasukan lapangan — melalui aplikasi mudah alih Guard untuk clock-in/out, imbasan NFC semasa patroli, dan laporan insiden
  • Pelanggan — melalui web untuk melihat dan muat turun laporan tapak mereka

Data disusun mengikut Company (syarikat). Setiap syarikat mempunyai Location (tapak), Checkpoint, Schedule, Device, dan pengguna yang berkaitan.

2. Peranan Pengguna

Peranan Siapa Akses Web Akses Mobile Tujuan utama
admin Operator sistem / syarikat Penuh (termasuk Users) Email/password; app NFC Konfigurasi sistem & pengguna
supervisor Penyelia operasi / tapak Hampir semua (tanpa Users CRUD) Email/password; NFC tools Operasi harian, pemantauan, pautan NFC
guard Pengawal keselamatan Tidak dibenarkan Guard ID (+ PIN); biometrik (jika didaftarkan) Patroli, kehadiran, insiden
client Pengguna syarikat pelanggan Dashboard, Profile, Reports Terhad (profil & laporan) Lihat / muat turun laporan
Nota: Pengguna dengan peranan guard tidak boleh log masuk ke Admin Panel web. Mereka hanya menggunakan aplikasi mudah alih.

3. Komponen Sistem

KomponenPenerangan
Admin PanelLaman web Laravel untuk konfigurasi, pemantauan, dan laporan
Guard AppAplikasi Flutter untuk pengawal di lapangan (patroli NFC, kehadiran, insiden)
Admin NFC AppAplikasi Flutter ringan untuk admin/supervisor menulis / pautkan tag NFC
APIBackend REST yang menyambungkan aplikasi mudah alih dengan Admin Panel

4. Panduan Permulaan Pantas

Ikuti urutan ini sebelum pengawal mula bertugas. Panduan interaktif juga tersedia di Admin Panel → Operations Guide.

LangkahTindakanMenu
1Cipta Location (tapak)Locations → Create
2Tambah Checkpoint (NFC / GPS / Both)Checkpoints → Create
3Cipta Schedule (jadual patroli)Schedules → Create
4Daftarkan Device (telefon pengawal)Devices → Create
5Cipta akaun GuardUsers → Create (admin sahaja)
6Assign guard ke locationGuard → Create
7Uji login di aplikasi GuardGuard App
8Pantau operasiDashboard / Attendance / Tracking / Patrol Records
9Jana laporanReports

5. Admin Panel (Web)

5.1 Log masuk

  1. Buka URL Admin Panel di pelayar.
  2. Masukkan email dan password.
  3. Hanya peranan admin, supervisor, dan client yang aktif dibenarkan.
  4. Selepas log masuk, anda akan dibawa ke Dashboard.

Untuk log keluar: klik nama profil di penjuru atas → Logout.

5.2 Struktur menu

Dashboard

Paparan ringkasan: statistik syarikat, pengawal aktif, jadual akan datang, insiden terkini, dan carta aktiviti.

Operations Guide

Panduan interaktif langkah demi langkah untuk menyediakan dan mengendalikan sistem. Progress bar menunjukkan langkah yang sudah lengkap.

Company

MenuFungsi
CompaniesUrus syarikat sendiri (own) dan syarikat pelanggan (client) — nama, kontak, logo, status
LocationsUrus tapak: alamat, GPS, radius geofence, jenis tempat (HQ, mall, factory, dll.), tarikh kontrak, bilangan pengawal diperlukan
GuardAssign pengawal ke location — jenis: permanent / temporary / replacement / relief / other; tarikh mula/tamat; status

Management

MenuFungsi
CheckpointsTitik patroli pada sesuatu location. Jenis check-in: NFC, GPS Radius, atau Both. Boleh tetapkan urutan, lantai, arahan, dan pautan Tag ID NFC
SchedulesJadual pengawal di location (tarikh/masa, urutan checkpoint). Status: scheduled, in_progress, dll.
DevicesDaftarkan telefon pengawal (device_id dari app), assign ke location, sejarah assignment, bind/unbind pengawal
NFC DevicesInventori tag NFC fizikal — status (aktif/hilang/rosak), maintenance, pautan ke checkpoint
Users(Admin sahaja) Cipta / edit / padam / aktifkan pengguna; tetapkan peranan, employee ID (untuk guard), syarikat

Operations

MenuFungsi
AttendanceSenarai dan butiran clock-in / clock-out pengawal (GPS, kaedah verifikasi)
IncidentsSenarai dan butiran insiden dari lapangan; tambah remarks; kemas kini resolusi
TrackingPaparan peta / kehadiran GPS pengawal secara langsung
Patrol RecordsSejarah patroli dari aplikasi (NFC atau GPS radius, checkpoint, koordinat, nota, masa)

Reports

Jana dan muat turun laporan (PDF / Excel). Lihat Bahagian 9.

5.3 Location (Tapak)

  1. Pergi ke Locations → Create.
  2. Isi nama tapak (contoh: Main Office Building).
  3. Masukkan alamat dan koordinat GPS.
  4. Tetapkan geofence radius.
  5. Pilih jenis tempat dan tarikh kontrak jika berkaitan.
  6. Save.

5.4 Checkpoint

  1. Pergi ke Checkpoints → Create.
  2. Pilih Location.
  3. Pilih jenis check-in: NFC, GPS Radius, atau Both.
  4. Masukkan nama checkpoint (contoh: Main Entrance).
  5. Jika NFC / Both: pautkan NFC Tag ID.
  6. Jika GPS Radius / Both: tetapkan latitude, longitude dan radius (meter).
  7. Tetapkan urutan, lantai, dan arahan jika perlu.
  8. Save.

5.5 Schedule

  1. Pergi ke Schedules → Create.
  2. Pilih location dan pengawal.
  3. Tetapkan tarikh serta masa mula / tamat.
  4. Pilih urutan checkpoint untuk laluan patroli.
  5. Save.
Penting: Pengawal hanya boleh log masuk di telefon yang di-assign ke location jika mereka mempunyai schedule (status scheduled / in_progress, tarikh ≥ hari ini) untuk location tersebut.

5.6 Devices (Telefon)

  1. Buka aplikasi Guard pada telefon → dapatkan Device ID.
  2. Di Admin Panel: Devices → Create.
  3. Masukkan Device ID, nama peranti, dan assign ke Location.
  4. Pastikan status peranti aktif.
  5. Save.

Tanpa assignment location yang betul, pengawal tidak boleh log masuk di telefon itu.

5.7 NFC Devices

  1. Pergi ke NFC Devices.
  2. Daftarkan tag mengikut Tag ID hardware (atau sync dari Admin NFC App).
  3. Pautkan tag ke checkpoint yang berkaitan.
  4. Tandakan tag sebagai hilang / rosak / dalam maintenance bila perlu.
  5. Secara pilihan, tulis nama checkpoint ke tag menggunakan Admin NFC App.

5.8 Users (Admin sahaja)

  1. Pergi ke Users → Create.
  2. Isi nama, email, telefon.
  3. Untuk pengawal: Role = guard, tetapkan Employee ID (contoh: GRD001), dan PIN 4 digit jika diperlukan.
  4. Assign ke syarikat yang betul.
  5. Save.

5.9 Guard Assignments

  1. Pergi ke Guard → Create.
  2. Pilih pengguna guard dan location.
  3. Pilih jenis assignment (permanent / temporary / replacement / relief / other).
  4. Tetapkan tarikh mula dan tamat.
  5. Save.

5.10 Operations — Insiden & Pemantauan

  • Incidents — lihat laporan, tambah remarks, kemas kini resolusi.
  • Tracking — pantau lokasi GPS pengawal aktif.
  • Patrol Records — semak setiap imbasan NFC.
  • Attendance — semak rekod clock-in / clock-out.

5.11 Akses Client

Pengguna client hanya melihat Dashboard, Profile, dan Reports (skop syarikat mereka).

6. Aplikasi Guard (Mobile)

6.1 Keperluan

  • Telefon Android/iOS dengan NFC (untuk patroli NFC)
  • GPS dihidupkan
  • Sambungan internet (kerja offline disokong dan akan dihantar kemudian)
  • Peranti telah didaftarkan dan di-assign ke location
  • Akaun guard dengan Employee ID dan schedule yang sah

6.2 Pendaftaran peranti

  1. Pasang dan buka aplikasi GuardTech.
  2. Nota atau salin Device ID yang dipaparkan.
  3. Berikan Device ID kepada admin/supervisor untuk didaftarkan di Devices.
  4. Selepas peranti di-assign ke location, anda boleh log masuk.

6.3 Log masuk pengawal

  1. Buka aplikasi.
  2. Pilih mod login Guard (Guard ID).
  3. Masukkan Employee ID (contoh: GRD001).
  4. Masukkan PIN jika diminta.
  5. Pilih mod: Attendance atau Patrolling.
  6. Sync peranti jika diminta.

Syarat berjaya login: device aktif + location; schedule sah; credential betul.

Selepas login berjaya, peranti di-bind kepada pengawal. Logout melepaskan bind itu.

6.4 Log masuk staff (email)

Supervisor / admin boleh log masuk dengan email + password. Jika biometrik telah didaftarkan, butang biometrik boleh digunakan.

6.5 Skrin utama (Home)

TabFungsi
PatrolImbas NFC atau check-in GPS radius, tambah nota, simpan rekod; senarai pending offline
IncidentLaporkan insiden; senarai pending offline
InformationMaklumat jadual / peranti / patroli; akses alat NFC (jika dibenarkan)

6.6 Kehadiran (Attendance)

  1. Log masuk atau buka skrin Attendance.
  2. Pastikan GPS aktif dan anda berada dalam kawasan tapak.
  3. Ketik Clock In pada mula syif.
  4. Ketik Clock Out pada akhir syif.
  5. Rekod muncul di Admin Panel → Attendance.

6.7 Patroli NFC atau GPS radius

  1. Buka tab Patrol.
  2. Untuk checkpoint NFC: dekatkan telefon ke tag (butang putih NFC).
  3. Untuk checkpoint GPS radius: ketik butang gelap GPS semasa anda berada dalam radius.
  4. Semak maklumat: kaedah, checkpoint, koordinat.
  5. Tambah notes jika perlu.
  6. Save rekod.
  7. Jika offline, rekod masuk ke pending queue dan dihantar apabila online.

Checkpoint jenis Both menerima NFC atau GPS. Checkpoint jenis Radius hanya GPS — tiada tag NFC diperlukan.

Tag ID vs Checkpoint name

MedanSumberPerlu tulis ke tag?
Tag IDHardware tag (read-only)Tidak
CheckpointTeks NDEF pilihan pada tag, atau pautan di adminYa, jika mahu nama dari tag
Lat/LongGPS telefon semasa imbasTidak

6.8 Laporkan Insiden

  1. Buka tab Incident.
  2. Isi butiran insiden.
  3. GPS akan direkodkan.
  4. Hantar (atau simpan pending jika offline).
  5. Supervisor/admin menyemak di Incidents.

6.9 Offline

  • Aplikasi menyimpan rekod patroli dan insiden secara tempatan jika tiada rangkaian.
  • Apabila sambungan kembali, pending records dihantar ke server.
  • Pastikan sync selesai sebelum menukar telefon atau uninstall app.

6.10 Biometrik & PIN

  • PIN 4 digit boleh ditetapkan untuk login Guard ID.
  • Biometrik boleh didaftarkan untuk laluan login berasaskan email.

7. Aplikasi Admin NFC

Aplikasi ini untuk admin dan supervisor yang mentadbir tag fizikal.

Fungsi utama

  1. Log masuk dengan email + password (admin / supervisor).
  2. Senarai dan sync NFC devices dari API.
  3. Tulis / pautkan nama checkpoint ke tag fizikal (NDEF).
  4. Simpanan tag tempatan untuk kerja di lapangan.

Cara tulis nama checkpoint ke tag

  1. Pastikan tag sudah didaftarkan di NFC Devices dan dikaitkan dengan checkpoint.
  2. Masukkan nama checkpoint (contoh: Front Gate).
  3. Ketik Write, kemudian tahan telefon pada tag sehingga selesai.
  4. Alternatif: gunakan aplikasi pihak ketiga (contoh: NFC Tools) untuk menulis rekod Text.

8. Aliran Kerja Utama

8.1 Setup tapak baharu

Location → Checkpoints → Schedule → Device → User (guard) → Guard Assignment → Uji App → Monitor → Reports

8.2 Syif pengawal (hari biasa)

  1. Pengawal buka app pada telefon yang telah didaftarkan.
  2. Login dengan Guard ID (+ PIN).
  3. Clock In.
  4. Patroli: imbas NFC atau check-in GPS radius mengikut jenis checkpoint.
  5. Laporkan insiden jika berlaku.
  6. Clock Out di akhir syif.
  7. Penyelia semak Attendance, Patrol Records, Incidents, Tracking.

8.3 Pengendalian insiden

  1. Guard laporkan di app.
  2. Supervisor buka Incidents di web.
  3. Semak butiran + GPS.
  4. Tambah remarks / assign / kemas kini resolusi.
  5. Jana laporan insiden jika diperlukan.

8.4 Pelanggan melihat laporan

  1. Client log masuk ke Admin Panel.
  2. Pergi ke Reports.
  3. Pilih jenis, julat tarikh, format (PDF/Excel).
  4. Generate & Download.

9. Laporan

Menu: Reports

Siapa boleh akses

  • admin / supervisor — laporan operasi syarikat mereka
  • client — laporan skop syarikat pelanggan mereka sahaja

Jenis biasa

  • Laporan kehadiran (attendance)
  • Laporan insiden
  • Laporan patroli (jika tersedia)
  • Export PDF atau Excel

Langkah jana laporan

  1. Pilih jenis laporan.
  2. Pilih location / julat tarikh.
  3. Pilih format.
  4. Generate.
  5. Download fail yang dihasilkan.

10. Glosari

IstilahMaksud
CompanyPenyewa data; jenis own (operator) atau client (pelanggan)
LocationTapak / premis yang digawal; ada GPS + geofence
CheckpointTitik wajib dilawati semasa patroli
NFC Device / TagTag fizikal NFC; Tag ID = ID hardware unik
DeviceTelefon mudah alih yang didaftarkan untuk Guard App
Employee ID / Guard IDKod pengawal untuk login app (contoh: GRD001)
Guard AssignmentHubungan pengawal ↔ location (tempoh & jenis)
ScheduleJadual masa & laluan patroli
AttendanceRekod clock-in / clock-out
Patrol RecordSatu peristiwa check-in patroli (NFC atau GPS radius)
IncidentLaporan kejadian di lapangan
TrackingPemantauan GPS / kehadiran aktif
GeofenceRadius GPS di sekitar location
Offline queueRekod tempatan menunggu dihantar ke server

11. Soalan Lazim (FAQ)

Pengawal tidak boleh log masuk di app

  1. Device sudah didaftarkan di Devices dan status aktif?
  2. Device sudah di-assign ke Location yang betul?
  3. Guard mempunyai Schedule untuk location itu?
  4. Employee ID dan PIN betul?
  5. Akaun guard aktif?

“Not allowed to access the admin panel”

Akaun anda berperanan guard. Gunakan aplikasi mudah alih, bukan web Admin Panel.

Imbasan NFC tidak merekod checkpoint name

  • Tag ID sentiasa dibaca dari hardware.
  • Nama checkpoint muncul jika teks NDEF ditulis ke tag, atau Tag ID dipautkan ke checkpoint di Admin Panel.

Rekod patroli / insiden hilang selepas offline

Jangan padam data app atau uninstall sebelum sync selesai. Buka app semula dengan internet dan pastikan senarai pending kosong.

Client tidak nampak menu Locations / Users

Ini sengaja: peranan client hanya Dashboard, Profile, dan Reports.

Bagaimana dapatkan Device ID?

Buka Guard App pada telefon; Device ID dipaparkan untuk didaftarkan oleh admin di Devices.

Bolehkah satu telefon digunakan ramai pengawal?

Ya, setiap pengawal login dengan ID sendiri dan mesti ada schedule untuk location device tersebut. Login bind device kepada pengawal aktif; logout melepaskan bind.

12. Sokongan

SumberLokasi
Manual ini (HTML awam)/user-manual.html
Panduan operasi interaktifAdmin Panel → Operations Guide
Panduan tag NFCguardtech_app/docs/nfc_tag_guide.md
Panduan deployment (teknikal)guardtech/DEPLOYMENT_GUIDE.md

Untuk isu teknikal (server, API, install app), rujuk pasukan IT / deployment.