📋 Attendance Module – Overview

The Attendance Module is a core feature designed to track and manage employee check-in and check-out activities. It supports both online and offline operations, ensuring attendance is accurately recorded even during network disruptions. The module enhances transparency, automates presence logging, and streamlines workforce monitoring across locations.

✅ Key Features

🔁 Check-In / Check-Out Functionality

Employees can record attendance using "IN" (Check-In) and "OUT" (Check-Out) logs.
Only the first IN and last OUT per day are considered for accurate time tracking.

🔄 Auto Sync to Server

Offline attendance logs are stored locally and automatically synced with the server once internet connectivity is restored.
Sync includes timestamp, GPS coordinates, and other essential metadata.

📍 Location-Based Validation

Every attendance entry captures GPS coordinates and performs reverse geocoding to retrieve area, city, and state.
Ensures that logs are tied to real physical locations, preventing spoofed entries.

📅 Date-Based and User-Based Filtering

Attendance data is dynamically filtered by system date based on the user's device time settings.
Records shown are relevant to the currently logged-in employee and current date.

🛠️ Error Handling and Logging

Integrated debug logs help track processing steps and potential issues.
Exception handling ensures that corrupted or tampered data is ignored or cleared.

🚧 Geo-Fence Enforcement

Attendance can only be marked if the user’s device location is within a predefined geo-fence radius.
Geo-fencing prevents fake location check-ins and enforces on-site presence.

📡 Dynamic Location Validation

GPS coordinates are validated in real-time against geo-fence boundaries before allowing attendance logs.
Ensures employees are physically present within the approved area during check-in or check-out.

📄 Attendance Fetch Configuration

This configuration facilitates server-side attendance retrieval via the middleware by specifying the module, filters, and mapping criteria.

Field	Description
Module Name	`Attendance_New`Specifies the Zoho module from which attendance data will be fetched.
Search Criteria1	`Mobile_User_Email`Defines the primary search key used to identify records. This is mapped to the mobile user's email address.
Operator1	`like`Logical operator used to compare the search value with the field defined in `Search Criteria1`.
Value1	Dynamic (Mobile User Email) Populated at runtime with the logged-in user's email. Filters attendance records corresponding to this specific user.
Cvid	`635921000002841511`A unique custom view ID that refines the data fetched. It limits the query to a predefined report or view within the Zoho system.
Mobile User	Maps the retrieved attendance data to the corresponding user entity in the mobile application.
Attendance Date	Maps to the `Time` fieldUsed to extract and sort attendance records by date.
Created Time	Indicates when the record was created in Zoho. Useful for sync comparison and audit trails.
Log Type	Identifies whether the record is a Check-In or Check-Out. Ensures proper interpretation of attendance events.

📤 Posting Attendance to Server (Post CRM Checkin Data)

This configuration facilitates server-side attendance creation via the middleware by specifying the module, filters, loggings along with time and Location Co-ordinates.

Field Name	Value / Input	Description
Mobile User API Name	`Mobile_User`	API identifier of the mobile user.
LogType	`IN` / `OUT`	Check-in or check-out status.
Time	`Time`	Timestamp of log creation (check-in/out time).
Latitude	`Latitude`	GPS latitude captured during the log event.
Longitude	`Longitude`	GPS longitude captured during the log event.
City	`City`	Derived city name from reverse geocoding.
State	`State`	Derived state from reverse geocoding.
Area	`Area`	Specific area/location derived from GPS coordinates.