MYKAD ENFORCER

ASP.NET 10 • REST API

Sistem Pengesahan Kad Kuasa & Biometrik Pendaftaran Pegawai Penguatkuasa JPN

Pelayan API Aktif
📖 Scalar Docs
🇲🇾

Daftar Pegawai Penguatkuasa

Aplikasi Enforcer MyKad (JPN/PDRM)

1
2
3
4
📋

Aliran Modul Pendaftaran Pegawai Penguatkuasa

Berdasarkan spesifikasi yang anda berikan, pegawai memohon untuk menjadi enforcer (yang akan menyemak MyKad rakyat melalui contactless chip atau QR code) melalui proses 3 langkah:

1. Pengecaman Muka & Biometrik

Mengambil foto swafoto, template ciri biometrik, koordinat GPS (lat/long) dan menghantar ke verifyBased64QrWithFaceTemplate(). API luar JPN mengesahkan identiti dan mengembalikan skor padanan.

2. Muat Naik Kad Kuasa

Setelah pengecaman berjaya, pegawai memuat naik kad kuasa muka hadapan. Pelayan mengira hash integriti SHA-256 dan menyimpan rekod ke supporting_documents.

3. Pengisian 6 Jadual Pangkalan Data

Data dimasukkan secara atomik (transaksi EF Core) ke jadual users, identity_card, face_profiles, enforcer_profiles, registration_requests, dan supporting_documents.

4. Kelulusan Admin (Approval)

Status awal adalah PENDING. Admin JPN menyemak pada Konsol Pentadbir. Apabila diluluskan, status user menjadi ACTIVE dan pegawai boleh log masuk untuk mula menguatkuasakan semakan MyKad.

📡 Pemantau Trafik API Langsung (Live Inspector)

MENUNGGU ARAHAN
// Menunggu interaksi dari simulator di sebelah kiri... // Cuba tekan butang "Jalankan verifyBased64QrWithFaceTemplate" untuk melihat muatan JSON sebenar.

🛡️ Modul Penguatkuasaan Lapangan: ScanReadMyCard

Satu modul bersepadu untuk semakan MyKad warganegara melalui Imbasan Kod QR & Wajah, Imbasan Cip Fizikal NFC, dan Muat Naik Bahan Bukti (uploadEvident).

KAEDAH 1

Imbasan QR (Wajah Pilihan)

verifyBased64QrWithFaceTemplate

Mendekod kod QR MyKad warganegara di lapangan. Templat wajah (swafoto) adalah tidak wajib di lapangan, tetapi jika dibekalkan padanan biometrik akan dijalankan. Dilogkan ke scan_logs.

KAEDAH 2

Imbasan Cip Fizikal NFC

readNfc

Membaca cip MyKad tanpa sentuh (NFC Contactless) dan memanggil Gateway Luar JPN untuk mengesahkan integriti cip.

BAHAN BUKTI

Muat Naik Bahan Bukti: uploadEvident(frontCardBase64, backCardBase64)

Jadual: scan_evidences

Untuk kes-kes tertentu yang perlukan evidence MyKad fizikal (contoh: kad rosak, kad gantian lama disita, atau perbezaan wajah). Disimpan dalam jadual scan_evidences dan dipautkan ke ID imbasan aktif.

📸 Gambar Depan MyKad
Parameter: frontCardBase64 (Base64)
📸 Gambar Belakang MyKad
Parameter: backCardBase64 (Base64)
Diisi secara automatik selepas imbasan QR atau NFC.

📜 Status Log Langsung (scan_logs & activity_logs)

Memuatkan log imbasan...
Jumlah Permohonan Pendaftaran
0
👥
Menunggu Kelulusan
0
⏳
Permohonan Diluluskan (Diterima)
0
🛡️
Permohonan Ditolak
0
✖
ID Pegawai No. MyKad No. Kad Kuasa & Agensi Skor Biometrik Tarikh Mohon Status Tindakan Pentadbir
Memuatkan data permohonan pendaftaran...

Penjelajah Struktur & Isi Kandungan 9 Jadual

Semak data langsung daripada Entity Framework Core & pangkalan data MySQL

users 0 rekod

Penerangan jadual...

Memuatkan lajur...
Memuatkan data...

Dokumentasi OpenAPI & Scalar Gateway

Sistem menyediakan spesifikasi OpenAPI v3 dan antaramuka Scalar moden secara terbina.

Buka Scalar Interactive UI ➜
POST /api/v1/registration/verify-face

Melakukan pengecaman biometrik muka verifyBased64QrWithFaceTemplate() dan menyemak dengan API luar JPN.

// Klik "Hantar Ujian" untuk memanggil endpoint...
GET /api/v1/tables/summary

Mengambil metadata dan statistik bilangan rekod bagi semua 6 jadual.

// Klik "Hantar Ujian" untuk memanggil endpoint...