Timeclock Entry

Overview

The TimeClock Entry module enables users to record, manage, and monitor working time within the system. It provides controlled clock-in and clock-out functionality with role-based access, dynamic locking, and validation safeguards to maintain accurate time tracking.

The module is designed to support both individual time logging and administrative oversight. Regular users can manage their own entries within defined restrictions, while Time Managers and XAdmins have broader visibility and control across users.

The locking mechanism operates dynamically based on the configured system setting, ensuring that historical entries remain protected without requiring background jobs or schedulers.

Key Features and Functionality

1. Role-Based Access Control

• The module behavior changes based on user role:

  • Regular Users can clock in/out for themselves and edit their own entries until they are locked.

  • ​Time Managers can view, edit, delete, and clock out entries for any user within the same website.

  • XAdmins have global control across all websites.

• Access to administrative functionality is controlled via the “Is Time Manager?” toggle in the User module.

2. Dual Tab Structure (My & Admin)

• The module is divided into two operational tabs:

  • My Tab – Visible to all users for managing personal entries.

  • Admin Tab – Visible only to Time Managers and XAdmins for managing all user entries.

3. Clock In / Clock Out State Management

• Users can clock in using a single action button. Upon successful clock-in:

  • The Clock In button dynamically changes to Clock Out.

  • The new entry appears at the top of the table.

  • The system ensures only one open entry exists per user.

• If an entry is active, Clock Out becomes the available action.

4. Dynamic Locking Logic

• Entries are automatically considered locked after 1 hour.

• Once locked:

  • Regular users cannot edit or delete the entry.

  • Regular users cannot clock out the entry.

  • Time Managers and XAdmins can override the lock.

5. Cross-Date Handling

• If a shift spans across two dates (e.g., 10:00 PM to 6:00 AM next day), the entry intelligently appears in both date filters:

  • When filtering by the Clock In date

  • When filtering by the Clock Out date