Getting Started

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