Payroll: show per-session clock in/out times inline in the hours view
Objective
- Allow payroll reviewers to see individual punch-in and punch-out timestamps for each employee across a date range without opening each day individually.
- Reduce friction in the payroll approval workflow by surfacing session-level detail inline rather than requiring per-record navigation.
Background
- Tiffany Fisher reported via Google Chat that reviewing hours before approving payroll requires opening each day/record one at a time. No view currently shows individual session timestamps (clock-in/clock-out pairs) at a glance.
- The inspector/date range filter on the payroll hours view already exists and returns a daily total per employee — but only the aggregated hours value is surfaced, not the underlying sessions.
- The
HoursDatatype (defined inClockInOut.tsx) includes asessionsarray of{ clockIn: string, clockOut?: string }objects. The data is already returned frompayroll/hours-history; this is a rendering gap, not a data gap. - The
ClockInOutdashboard widget already renders session-level history for the logged-in employee using this samesessionsarray — formatting clock-in/out times and per-session duration. That rendering logic is the direct reference for what needs to be added to the manager-facing hours view. - Applies to all employee types (inspectors and office staff), not inspector-only.
Product Decisions
Locked
- Scope — Manager/payroll-reviewer-facing view only; no changes to the employee-facing Time Clock widget.
- Data source —
HoursData.sessionsis already returned frompayroll/hours-history; no new backend endpoint needed. - Placement — Session timestamps expand inline as sub-rows beneath each day row. No click or hover required to reveal them.
- Employee type — Applies to all employee types. The feature works the same whether one or multiple employees are displayed.
Scope
Frontend
attik/apps/frontend/src/app/tools/hr/payroll/PayrollOverview.tsx— Primary manager-facing table. Inline session sub-rows would be added within the existing day-level row rendering.attik/apps/frontend/src/app/tools/hr/payroll/PayrollBase.tsx— Likely orchestrates the hours data fetch alongside payroll; relevant if data shape changes are threaded through.attik/apps/frontend/src/components/dashboard/ClockInOut/ClockInOut.tsx— Reference implementation. Contains the session rendering logic (sessions.map) usingtzDayjs(session.clockIn).format('h:mm A')that can be extracted or adapted for the manager view.
References
payroll/hours-history— existing endpoint returningHoursData[]withsessionsarrayClockSessiontype:{ clockIn: string; clockOut?: string }defined inClockInOut.tsx
Status: Planned
Log in to comment and vote
No comments yet
Be the first to share your thoughts.