Skip to main content

Employee Attendance View

Summary​

Employee-only users see today status, punch timeline and recent history, with a punch action.

Audience​

  • Employees, managers, administrators, developers, QA engineers, and support engineers as applicable

Purpose​

Employee-only users see today status, punch timeline and recent history, with a punch action.

Shared Attendance route switches to ESS for employee-only users.

Intended Users​

Source-defined navigation audiences and API authorization determine access; see Navigation and access.

Preconditions​

Authenticated tenant employee with resolved identity.

Main Components​

Summary cards, today timeline, recent history, punch confirmation dialog.

Columns or Fields​

Status, punch-in/out, work hours and recent history fields returned by ESS APIs.

Filters​

No UI filter; history is server-defined.

Actions​

Open punch confirmation and submit punch.

Validation​

Confirmation precedes punch; backend validates employee and tenant context.

Loading State​

Explicit loading text/state.

Empty State​

Missing values render safe not-marked/empty fallbacks.

Success State​

Success toast and today reload.

Error State​

ESS request failures use shared query/client behavior; detailed error panel is limited.

Access Behavior​

EmployeeAware selects ESS; own-record restriction depends on ESS backend enforcement.

API Dependencies​

ESS today, history and punch operations.

Overtime/shortfall and reopen controls are not present in the compact ESS component.

Screenshot Placeholder​

Capture later from a safe non-production environment using synthetic data. Remove identifiers and personal details before publication.

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/App.tsx

See Also​

Keywords​

  • Attendance UI
  • React
  • User workflow

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly