WORKVO Mobile Application Documentation
=========================================

.. note::
   **Version 2.1.1 (Build 6)** • Production Release
   Powered by **CogFocus** Enterprise Workforce Suite.

Welcome to the comprehensive technical and operational documentation for the **WORKVO Mobile Application** (Android & iOS). 
WORKVO is an enterprise workforce management system designed for high-concurrency environments, featuring GPS geofencing, single-device biometric hardware locking, automated Indian statutory payroll, shift override management, and field sales live telemetry.

.. image:: _static/screenshots/01_splash_screen.png
   :width: 320px
   :align: center
   :alt: WORKVO Mobile Splash Screen

Key Operational Features
------------------------
* **Multi-Role Portal Access**: Dedicated interfaces tailored specifically for Managers, Staff Members, and Field Sales Specialists.
* **Single-Device Hardware Binding**: Every employee phone generates a tamper-resistant hardware fingerprint (UUID + Model + Android ID), preventing buddy punching and proxy clock-ins.
* **Smart Geofenced Punching**: Validates GPS radius against company offices with anti-spoofing checks and camera selfie verification.
* **Shift Overrides**: Dynamically configure custom daily or rotational shift schedules per employee, bypassing global defaults.
* **Zero-Crash Field Sales Tracking**: Lightweight background location engine streaming GPS breadcrumbs every 15 seconds with SQLite WAL batch transactions.
* **Universal In-App Payslip & Report Downloads**: Direct token-authenticated PDF generation with offline storage and preview.
* **Over-The-Air (OTA) CodePush**: Instant updates powered by Shorebird engine without requiring re-installation from app stores.

Documentation Index
-------------------

.. toctree::
   :maxdepth: 2
   :caption: System Guides & Role Portals

   architecture
   authentication
   manager_portal
   staff_portal
   sales_portal
   troubleshooting