Employee Attendance (Check-In / Check-Out)

Purpose - Lets an employee record their daily arrival and departure from their school using their mobile device, verified by the school's geofence and time window. 

Who Can Use It

Employees. A teaching principal or head-master with school-admin privileges can also mark their own attendance through this feature. 

Key Capabilities 

• Check-in and check-out with GPS coordinates, verified against the school's geofenced boundary. 
• Late-check-in and early-check-out remarks (10–50 characters) when the employee is late or leaving before scheduled time. 
• A "will be late" and "will be early" preview endpoint so the mobile app can prompt for a reason before the punch. 
• A "what actions are available right now" query so the app only offers punches the server would accept, along with the current server time. 
• Automatic detection and prevention of duplicate punches within the same day.
• Offline queueing when there is no network, with a bulk sync when the device is back online. 
• Recording of GPS accuracy alongside every punch (see GPS Accuracy Tracking).

How to Use It 

• Open the SamarthX mobile app while inside the school premises. 
• The app shows whether a check-in or check-out is currently available and the timing window it applies to. 
• Tap Check-In. If the employee is arriving after the allowed buffer, the app asks for a late remark before submitting. 
• At the end of the day, tap Check-Out. If leaving before the scheduled end time, the app asks for an early remark. 
• If the device was offline during any punch, the app queues it locally and uploads it automatically once connectivity is restored.  

Rules & Restrictions

• A punch is accepted only when the device coordinates fall within the school's geofence radius (plus any state-wide grace radius configured in the academic year).
• Only one check-in and one check-out per day in the legacy single-pair model; see Multi Segment Attendance for the exception. 
• A duplicate check-in or check-out on the same day is rejected with a friendly message.
• Late remarks are required when the check-in is after the shift start plus the check-in buffer. 
• Early remarks are required when the check-out is before the scheduled end time.
• If the location cannot be verified because the device reports a very poor GPS fix, the punch is refused unless the employee explicitly uses the Low-Accuracy Override path.