App Access Methods
ZenTime is distributed through multiple channels to accommodate different organizational deployment strategies:
Android Devices:
- Distribution: Google Play Store
- Installation: Search "ZenTime" or use direct link provided by IT department
- Updates: Need to exit and manually need to update for now. Automatic updates through Play Store/App Store can be achieved in the future after MDM.
iOS Devices:
- Distribution: Apple App Store
- Installation: Search "ZenTime" or use direct link provided by IT department
- Updates: Automatic updates through App Store (configurable)
- Enterprise Deployment: Available through Apple Business Manager for corporate deployments
Web Access:
- Platform: Zenople Web Application portal
- Use Case: Administrative configuration and reporting
Device Setup (Admin/Supervisor Only)
The initial device setup process establishes the connection between the physical tablet device and the organizational timeclock configuration. This is a one-time setup process performed by admin or supervisors.
Initial Setup Screen Fields
When launching ZenTime for the first time (or after a reset), the application presents a setup configuration screen with the following required fields:
I. Company Field
- Purpose: Identifies the tenant organization within the Zenople multi-tenant system
- Format: Full legal company name or designated tenant identifier
- Example: "ABC Manufacturing Corp" or "XYZ Healthcare Services"
- Validation: Must match exactly with registered tenant name in Zenople system
II. Alias Field
- Purpose: Provides a shortened identifier for the organization
- Format: Typically 3-8 character alphanumeric code
- Example: "ABCMFG" or "XYZHEALTH"
- Validation: Must match registered alias in system
- Usage: Streamlines login process and system identification
III. Timeclock ID Field
- Purpose: Specifies which timeclock configuration to load onto the device
- Format: Numeric identifier
- Critical Function: This ID determines ALL operational parameters for the device
Timeclock ID Controls the Following Properties:
- Punch Sequence Rules
- Valid punch order (e.g., Clock In → Break Out → Break In → Clock Out)
- Prevention of duplicate punch types
- Required punch progression logic
- Geo-Location Settings
- GPS coordinate boundaries (latitude/longitude with radius)
- Location validation requirements
- GPS accuracy thresholds
- Handling of location services being disabled
- PIN Type Configuration
- 4-digit PIN option
- 6-digit PIN option
- Last 4 digits of SSN as PIN
- Name + Last 4 SSN combination
- Custom PIN formats if configured
- Reset Timer Settings (Reset timer while setting up time clock property)
- Automatic return to PIN entry screen after inactivity
- Configurable timeout duration (typically 15-120 seconds)
- Security lockout parameters
- IP Address Validation
- Allowed IP address ranges
- Network-based access restrictions
- VPN requirement settings
- IP whitelist configurations
- Break Compliance Configuration
- Federal/state break policy requirements
- Mandatory break surveys and questions
- Break duration minimum/maximum settings
- Break timing windows (e.g., must occur between hours 3-5 of shift)
- Post Clock-Out Question Setup
- Survey questions presented after clock-out
- Required vs. optional questions
- Question types (multiple choice, text entry, rating scale)
- Conditional question logic
IV. Username/Password Fields
- Purpose: Authenticates the admin or supervisor performing the setup
- Requirements:
- Must be valid Admin or Supervisor account credentials
- Account must have permission to access the specified Timeclock ID
- Account must belong to the specified Company/Alias
- Validation Process:
- System verifies username exists
- Password is validated against the encrypted stored value
- Role permissions are checked (Admin or Supervisor required)
- Timeclock ID access rights are verified
- If all checks pass, device configuration proceeds
Post-Setup Device State
Successful Setup Results:
Once all fields are validated and setup completes successfully, the device transitions from setup mode to operational mode:
- Screen Transition: Setup screen is replaced with PIN Entry Screen
- Configuration Storage: All timeclock properties are downloaded and cached locally
- Employee Interface Activation: Device is now ready for employee time punching
- Background Sync Initialization: 10-minute sync cycle begins (if online)
- Offline Capability: Device can now operate without internet connection using cached data
PIN Entry Screen becomes the default screen, displaying:
- Company name/logo
- PIN entry keypad
- Customer name
- Department name
- Timeclock name
- Online/offline status indicator
- Current date and time
Supported Roles and Responsibilities
ZenTime operates with a clear role-based access model. Each role has specific permissions and capabilities within the application.
Employee Role
Primary Responsibilities:
- Punch in at shift start
- Punch out at shift end
- Log break periods (break out/break in)
- View personal timesheet entries
- Select work assignment (if multiple jobs)
- Complete required surveys and compliance questions
- Respond to clock-out questionnaires
Capabilities:
- Access time entry screen using personal PIN
- View current day punch history
- View previous punch entries (limited historical view)
- See "Updated Time" markers for edited entries
- Navigate multi-assignment selection screens
Restrictions:
- Cannot access device setup or configuration
- Cannot view other employees' time entries
- Cannot export data
- Cannot reset device
- Cannot modify system settings
Admin/Supervisor Role
Primary Responsibilities:
- Perform initial device setup
- Configure timeclock properties
- Reset device when necessary
- Export time punch data
- Monitor device sync status
- Resolve synchronization conflicts
- Maintain device operational status
Capabilities:
- Access setup screen
- Enter admin/supervisor credentials for privileged operations (exiting/resetting timeclock)
- Force device reset and reconfiguration
- Perform manual sync operations - Force Sync
- Export JSON data files
- View sync status and error logs
- Perform manual sync operations
Access Method:
- Double-tap company name to reveal admin/supervisor functions to exit/reset the timeclock (10-second visibility window)
- Perform manual force sync operations by double-tapping on the green/red indicator.