Attendance
Explains the no-side-scroll day view, row and staged saves, Swal/toastr feedback, manual attendance form, HR-first issue triage, correction queue, employee analytics, and monthly/yearly summaries.
Workflow
- Filter dayHR / Manager: Choose date, employee scope, branch, department, shift, status, and rows.
- Mark or importHR / Device / Employee: Capture punches, enter manual times, set status, and add remarks.
- Review issueHR / Manager / Admin: Triage employee disputes, duplicate changes, holiday duty, and approval notes.
- FinalizeTenant admin / Payroll: Approve final changes before reports and payroll close.
| Stage | Actor | Action | Result |
|---|---|---|---|
| Filter day | HR / Manager | Choose date, employee scope, branch, department, shift, status, and rows. | The day sheet shows the right employees. |
| Mark or import | HR / Device / Employee | Capture punches, enter manual times, set status, and add remarks. | Attendance records are staged or created. |
| Review issue | HR / Manager / Admin | Triage employee disputes, duplicate changes, holiday duty, and approval notes. | Only valid corrections move forward. |
| Finalize | Tenant admin / Payroll | Approve final changes before reports and payroll close. | Payroll uses reviewed attendance. |
Use Attendance Issue Flow for the HR-first process when an employee was present but marked absent, including pending_hr, hr_review, and final tenant-admin mutation rules.
Attendance row save and staged bulk save use SweetAlert confirmation, SweetAlert loading, and toastr success/error feedback when the local assets are available.
Attendance day filters and row action form
Filters the daily attendance list and lets authorized users mark status, enter times, or add remarks.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Search | Find employee by name, email, or code. | Ali Ahmed |
Optional. |
| Date | Attendance day being managed. | 2026-06-08 |
Required. |
| Branch / department | Limit employees by organization. | Head Office / Operations |
Optional. |
| Designation / shift | Limit by job title or shift. | Support Executive / General 9 to 6 |
Optional. |
| Status | Show present, absent, late, leave, holiday, etc. | Absent |
Optional. |
| Rows | How many employees to show. | 25 |
Keep readable. |
| Check-in / check-out | Manual time values for the row. | 09:05 / 18:02 |
Must match date/time rules. |
Manual attendance create/edit form
Creates or updates a specific attendance record when device or portal capture is missing or wrong.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Employee | Person the record belongs to. | EMP-1002 - Ali Ahmed |
Required. |
| Shift | Shift used to evaluate timing. | General 9 to 6 |
Required. |
| Attendance date | Work date. | 2026-06-08 |
Required. |
| Check in/out | Actual recorded times. | 09:05 / 18:10 |
Optional depending on status. |
| Notes | Operational note. | Device was offline |
Visible to admins. |
| Approval reason | Why duplicate or sensitive change is allowed. | Correcting imported duplicate |
Required in duplicate scenarios. |
| Holiday duty confirmation | Confirms work on holiday. | Checked |
Needed when date is a holiday. |
Correction approval form
Triages employee attendance issues first, then approves or rejects correction requests through manager and tenant-admin approval.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Requested status | Status the employee or admin says is correct. | Present |
Employee status disputes enter HR triage. |
| Requested times | What employee says should be corrected. | 09:00 / 18:00 |
Compare against logs. |
| Reason | Employee explanation. | Forgot to check out |
Read before approval. |
| Reviewer notes | HR, manager, or admin decision reason. | Approved after manager confirmation |
Required for clear audit. |
| Triage decision | HR accepts or rejects an employee status dispute. | Accept issue |
Accepted issues move forward; rejected issues do not change attendance. |
| Final decision | Tenant admin final approval or rejection. | Approve |
Changes attendance only at final approval. |
Monthly, yearly, and employee analytics filters
Changes the period or employee shown in attendance charts and detail cards.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Month / year | Reporting period. | 2026-06 / 2026 |
Required. |
| Employee | Person for employee view. | Ali Ahmed |
Required for employee page. |
| Status scope | Which attendance states are summarized. | Late |
Optional depending on view. |
| Reset | Restores default period/filter. | Reset |
Does not delete data. |
Attendance day table
Daily operational list for reviewing employee attendance without side scroll.
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Employee | Name, email, avatar, and context. | employee record. | Ali Ahmed in Operations. |
| Shift | Expected working shift. | shift relationship. | General 9 to 6. |
| Time | Check-in and check-out state. | attendance record or manual inputs. | Dash means no time recorded. |
| Status | Attendance outcome. | computed/manual status. | Late means check-in exceeded grace. |
| Remarks | Notes attached to the day. | attendance notes/remarks. | Explains unusual manual entries. |
| Actions | Row buttons for save, edit, remarks, calendar, or menu. | permission checks. | Save row submits one staged employee. |
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Correction queue table
Lists attendance correction requests waiting for review.
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Employee | Who requested correction. | correction request employee. | Sara Khan. |
| Date | Attendance date to change. | correction request. | 2026-06-08. |
| Requested change | New times or status requested. | correction payload. | Check-out 18:00. |
| Reason | Why change is requested. | employee input. | I was present but marked absent. |
| Approval stage | Current workflow owner. | approval steps. | HR triage, manager review, or tenant admin final. |
| Reviewer | Who approved/rejected. | review fields. | Ayesha Manager. |
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Main docs show essential fields only. Open Documentation Coverage for every detected source field, action, column, route hint, controller hint, and test hint.