Attendance

Flowcharts

Each diagram auto-plays steps when it scrolls into view. Use Play / Pause, or click a step. Matching nodes highlight as the narration advances.

flowchart TD
  A[Enable attendance role] --> B[Shift / holiday config]
  B --> C[Regularization policy optional]
  C --> D[Mark matrix]
  D --> E[Approve pending]
  E --> F[Soft payroll lock]
          

flowchart TD
  O[Open Attendance] --> F[Filter team / employee / month]
  F --> C[Click day cell]
  C --> M[Mark popover]
  M --> S{Status}
  S -->|Present / Absent / Half-day / Leave| Save[Save mark]
  Save --> Aud[Audit event]
  Save --> Pend{Needs approval?}
  Pend -->|Yes| Queue[Pending approvals]
  Pend -->|No| Done[Visible on matrix]
          

flowchart TD
  Emp[Employee or manager] --> Reg[Submit regularization]
  Reg --> Pol{Policy / payroll lock OK?}
  Pol -->|No| Block[Blocked with reason]
  Pol -->|Yes| Sub[SUBMITTED]
  Sub --> Mgr[Manager / delegate decides]
  Mgr -->|Approve| Upd[Attendance updated]
  Mgr -->|Reject| Rel[Rejected + comment]
          

flowchart TD
  L[Leave approved] --> Flag{leaveAutoSyncToAttendance?}
  Flag -->|Yes| Sync[Write LEAVE / HALF_DAY]
  Sync --> Mat[Shows on Attendance matrix]
  Flag -->|No| Manual[Manual mark or leave overlay only]
          

flowchart TD
  P[Pending panel or Approvals inbox] --> Rev[Review employee-day]
  Rev --> Dec{Decision}
  Dec -->|Approve| Acc[Accept mark / regularization]
  Acc --> Mat[Matrix updated]
  Dec -->|Reject| Com[Reject + comment]
          

Overview

HRMS → Attendance is the month-at-a-glance control surface for who was present, absent, on leave, or needs correction. Managers mark cells, approve pending items, and (when enabled) process regularization. Approved leave can auto-write attendance when leaveAutoSyncToAttendance is on.

Work-Time Governance can ingest swipe evidence and compose a read-only source (leave → swipe → timesheet WFH → regularization). That compose API does not write this matrix and does not invent entry/exit times from hours-only timesheets. attendance.period-lock is catalogued but has no lock service yet — do not accept it as active. A complete ACS / device feed still needs the client vendor API; overnight pairing is limited, not full shift windows.

Screen layout

• Header — team scope, employee filter, Documentation link, month navigation via summary.
• Summary strip — attendance rate and absence KPIs for the filtered month.
• Pending approvals — attendance marks / regularizations awaiting decision.
• Matrix — employees × days; color-coded cells; click to mark or view details.
• Current-user panel — your own pattern when viewing self.
• Payroll lock banner — soft lock when prior-month edits are frozen (no matrix export).

Flags & prerequisites

• Role: hrmsModules.attendanceEnabled + attendance CRUD as needed.
• Org: attendanceAdditional.attendanceRegularizationEnabled for regularization flows.
• Org: leaveAdditional.leaveAutoSyncToAttendance for leave → attendance writes.
• Work-Time catalog (Feature Flags): attendance.swipe-ingest, attendance.source-resolution, attendance.timesheet-wfh, attendance.cross-midnight — all default off until enabled.
• Do not rely on attendance.period-lock — no lock service is shipped for that flag.
• Optional: shift policies (/admin/shift-policies), holidays (Leave Configuration → Holidays), delegation for approvers away.

Feature & use-case map

Permissions