Crew Time Tracking

story-landscaping-assistant-crew-time-tracking User Story

active user-story

story: Crew Time Tracking

Role

Crew Member and Crew Lead

Key

crew-time-tracking

Want

As a crew member or lead, I want to clock in/out, track breaks, and view my daily and weekly hours from an Hours tab

So That

So that my work hours are recorded accurately for payroll, and I can verify my time before it's submitted

Acceptance Criteria

  • Hours tab appears in nav slot 2 for members and leads (not clients, not admins)
  • Tapping Clock In starts a live timer; tapping Clock Out stops it
  • Take Break pauses the timer; End Break resumes it
  • Break time is subtracted from total worked time
  • Today's completed entries show below the timer with start/end/break/worked times
  • Weekly summary shows Mon-Sun daily totals and a weekly grand total
  • Timer state survives page refresh (reconstructed from server timestamps)
  • Feature gated behind time_tracking flag

Success Metric

100% of crew members and leads can clock in, take a break, and clock out with accurate time totals — verified by comparing timer display to server-stored timestamps
  • arch:rails — TimeEntry/TimeBreak models, HoursController, Stimulus timer
  • board-landscaping-assistant — project board
  • project-landscaping-assistant — project page
  • Forgejo issues: #331 (parent), #332 (model), #333 (UI), #334 (summary)
  • BusyBusy — competitive reference for interaction model
  • Future work: admin crew-hours dashboard, QuickBooks export (out of scope for this story)