Overview

XcodeSol Security Guard Admin is a Laravel + Vue SPA for managing private security guard operations. It centralizes guard records, attendance tracking (manual and biometric), location assignment, payroll processing, client billing, and asset management into a single admin dashboard.

Who It Is For

• Security companies managing guards deployed across multiple client locations.
• Admin teams that need attendance and payroll visibility without paper registers.
• Operators who want biometric device integration for automated check-in and check-out.

Core Capabilities

• Guard personnel records with CNIC, contact, salary, and location assignment.
• Daily attendance marking with Present, Absent, Leave, Off statuses.
• Biometric device integration — enroll guard fingerprints, face scans, or NFC tags. Devices send check-in and check-out data via API.
• Geo attendance mode (planned) — guards check in using GPS location.
• Monthly salary calculation with per-day deduction for absences and advance recovery.
• Client and location management with billing rates and tax configuration.
• Payment tracking (cash in, cash out) per party.
• Asset tracking for weapons and uniforms issued to guards.
• Advance salary management with recovery tracking.
• Reporting — monthly attendance summaries, salary sheets, and financial reports.
• Single admin user authentication via Laravel Sanctum API tokens.

Next Steps

Start with installation, then complete configuration.