Skip to content

Time Clock

🐸 Introduced in Frogge v0.2

Time Clock tracks staff attendance: a clock in/out toggle for staff, admin backfill and editing, and hours reporting. It's tied to your Staffing roster (only staff members can clock in) but lives as its own top-level /admin menu module rather than nested inside Staffing.

Quick Start

  1. A staff member runs /timeclock and taps Clock In (or Clock Out, once already in).
  2. Admin: /admin menu → Time Clock → Entries to see who's currently clocked in and browse past records.
  3. Reports for per-staff-member hour totals over a period, with a text export.

Screenshot needed

The /timeclock self-service view and the admin Entries screen.

Full reference

Self-service: /timeclock

Only members on the Staffing roster can use this; anyone else gets a message saying they aren't on staff. It shows current status (clocked in since a given time, or not clocked in), a single toggle button, and the 5 most recent entries with their duration. Clock-in is disabled once the staff member is terminated, though an already-open entry can still be clocked out normally.

Admin: Entries

Two separate lists, each with its own scoped Add/Modify/Remove:

  • Currently Clocked In: Add here is a quick clock-in for any eligible staff member (not already clocked in, not terminated).
  • Clocked Out Records: Add here is a full backfill for a missed record: pick a staff member, then a Clocked In At and Clocked Out At via the date/time picker, plus an optional Note.

An entry's own detail screen shows Clocked In, Clocked Out (or "Still open"), Duration (always computed, never stored), and Note, each editable individually, plus Remove.

Reports

Pick a period, This Month, Last 30 Days, This Year, or All Time, to see every staff member's total hours in that window, highest first. Export downloads the same breakdown as a plain-text file.

  • FK-linked to Staffing: only staff members can clock in, and a terminated staff member's entries stay on record. Doesn't connect to Finance or any pay-period/overtime calculation; that's out of scope for this version.