krow_backend/skills/attendance-analysis.md

id, name, description, category, pages, status, version, triggers, owliver

id	name	description	category	pages	status	version	triggers	owliver
attendance-analysis	Attendance Analysis	Analyse workforce attendance, lateness and absence, and compare people and departments.	workforce	analytics control-center	active	1	attendance absence absences absenteeism late arrival missed shift missed shifts	enabled suggestions capabilities responses true label capability How is attendance? summary label capability Compare attendance by person table label capability Attendance over recent periods flow summary stats table progress flow insight summary stats table progress flow insight title source Attendance workforce.attendance title source Attendance workforce.attendance title source Attendance by person workforce.attendance title source Attendance by person workforce.attendance title source periods Attendance over time workforce.attendance last-7-days this-month previous-month title source Attendance workforce.attendance

Attendance Analysis

Purpose

• Report how reliably the workforce is turning up.
• Separate turning up from turning up on time, because they have different causes.
• Compare people and departments so a problem can be located rather than only counted.

Capabilities

• Summarize attendance, punctuality and missed shifts.
• Compare attendance per person, worst first.
• Show attendance across recent periods.

Data

Reads workforce.attendance, which counts ShiftRecord entries — every shift scheduled, whether it was worked, how late it started and how long it ran. Department is the position's role_category, the same field Hired History and Analytics group by.

Analysis

Attendance is the share of scheduled shifts that were turned up for at all, late or not. Punctuality is reported separately, as the share turned up for on time. Folding the two together would make a reliably-late team look absent and a genuinely absent one look better than it is.

Minutes lost to lateness are reported alongside the count, because four late arrivals says nothing about whether it cost ten minutes or two hours.

Output

Headline attendance and punctuality rates, missed shifts split into absences and no-shows, and a row per person with their record. Over periods, one figure per window.

Limitations

• Only shifts that were scheduled are counted. Unrostered work does not appear.
• A no-show and an absence are counted separately but both reduce attendance; the distinction is in the detail line, not in the headline rate.
• The roster is whoever has shift records. This workspace has three, so a department average is one person's record — the per-person view is the more honest read at this size.
• Excused absence is a recognised status but none is currently recorded.