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
| Error | Cause | Solution |
|---|---|---|
| "Outside GPS Radius" | Guard is too far from the physical checkpoint location | Guard must physically be within the checkpoint geofence radius |
| "GPS Not Available" | Device location permission is disabled or signal is lost | Enable high-accuracy location access in phone settings |
| "Invalid QR Code" | Scanning an unregistered or incorrect barcode | Ensure the guard is scanning the official SoftaLabs QR checkpoint tag |
| "Inactive Checkpoint" | The checkpoint status has been disabled | Check the QR Checkpoints dashboard and set status to ACTIVE |
| "Scan Failed / Blurry" | QR code tag is physically dirty, scratched, or damaged | Wipe 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.