Dual Validation System

Every QR scan submitted by the SoftaLabs Mobile App goes through two layers of real-time validation:

Layer 1 — QR Code Cryptographic Validation

The scanned QR code is decoded and its encrypted hash is verified server-side. The system checks:

  • Is this an authentic SoftaLabs QR code tag?
  • Does it belong to the active site and checkpoint?
  • Is the checkpoint in ACTIVE status?

Layer 2 — GPS Geofence Validation (Haversine Formula)

The security guard's live device GPS coordinates are compared against the registered checkpoint/site coordinates using the Haversine formula to calculate precise real-world distance.

  • Within Configured GPS Radius → Scan Accepted ✅ (Logged with timestamp, floor, and guard identity)
  • Outside GPS Radius → Scan Rejected ❌ (Logged as out-of-range scan alert)

Common Scan Errors & Solutions

ErrorCauseSolution
"Outside GPS Radius"Guard is too far from the physical checkpoint locationGuard must physically be within the checkpoint geofence radius
"GPS Not Available"Device location permission is disabled or signal is lostEnable high-accuracy location access in phone settings
"Invalid QR Code"Scanning an unregistered or incorrect barcodeEnsure the guard is scanning the official SoftaLabs QR checkpoint tag
"Inactive Checkpoint"The checkpoint status has been disabledCheck the QR Checkpoints dashboard and set status to ACTIVE
"Scan Failed / Blurry"QR code tag is physically dirty, scratched, or damagedWipe tag surface or use the View action to reprint the QR tag
↔ Swipe horizontally to view all columns

Tips for Accurate GPS Validation

  • High Accuracy Mode: Ensure guards set their smartphone location services to High Accuracy / Use GPS & Wi-Fi.
  • GPS Lock Time: Allow 3–5 seconds after opening the camera scanner for the device GPS sensor to achieve full satellite lock.
  • Indoor Checkpoints: For basements or thick concrete areas, configure an appropriate GPS radius (e.g. 150m–200m) or ensure nearby Wi-Fi assisted positioning is available.