Hoppa till huvudinnehåll
Petanque Life

Staff App + Time-Clock (PL-T195)

F22.13 7 features

I korthet

A mobile staff app for chain-venue employees with my-shifts view, peer-to-peer shift swaps with accept/decline/cancel, geo-fenced punch-in/out that rejects from outside the venue, an auto-close cron with manager override for forgotten punch-outs, four tip-distribution algorithms (even, weighted-by-hours, role-percentage, individual-assigned) with idempotent payouts on (tenant, location, period), and monthly payroll exports to CSV, Fortnox and Visma.

Så fungerar det

Staff log in to the mobile app and land on my-shifts — upcoming, today, and past shifts in a thumb-friendly stacked layout. Swap-shift lets a staff member request another colleague to take a shift; the recipient can accept, decline, or the originator can cancel. Punch-in/out uses the device's geolocation and a geo-fence (radius configured per location) so a barista can't clock in from home — the app rejects with "You're not at the venue" if outside the fence.

An auto-close cron runs hourly to close any time-clock entries left open past expected end time, and managers can override entries (e.g. correct a forgotten punch-out) with an audit trail. Tip distribution offers four rules: even (split flat across all staff on the period), weighted_by_hours (pro-rata to hours worked), role_percentage (e.g. 40% to bartenders, 30% to servers, 20% to kitchen, 10% to host), and individual_assigned (manager assigns explicit amounts). Payouts use idempotency on (tenant, location, period) so re-running a closed period doesn't double-pay.

Monthly payroll summary exports to CSV and to Fortnox / Visma format, listing per-staff hours, tips, hourly rate, and gross. The whole subsystem talks to the same StaffMember and Shift models from F22.12, so manager-side scheduling and staff-side time-clock are one consistent record.

Centrala funktioner

  • My-shifts mobile view (upcoming / today / past)
  • Swap-shift requests (accept / decline / cancel)
  • Geo-fenced punch-in/out
  • Auto-close cron with manager override
  • Four tip-distribution rules: even / weighted_by_hours / role_percentage / individual_assigned
  • Idempotent tip payout on (tenant, location, period)
  • Monthly payroll export (CSV / Fortnox / Visma)

I praktiken

Sara is rostered for the Friday-night dinner shift but a family event clashes. She opens the staff app, taps the shift, hits Swap, and offers it to Jonas. Jonas gets a push, accepts, and the shift transfers — both calendars update live.

On Friday Jonas arrives, opens the app at the venue, and taps Punch In — the geo-fence confirms he's on-site and stamps the start. After service the bar pulls the night's tips: 3,200 SEK across four staff. The manager picks role_percentage, the system computes shares (bartender 40%, server 30%, kitchen 20%, host 10%), and approves the payout — the period locks idempotently so a second click doesn't double-pay.

End of month the manager exports the Fortnox CSV and uploads it; payroll runs without manual entry.

Features i detta subsystem

7
ID Status Funktioner
F22.13.01 Levererad My-shifts view (mobile-first)
F22.13.02 Levererad Swap-shift request (accept/decline/cancel)
F22.13.03 Levererad Punch-in/out with geo-fence
F22.13.04 Levererad Auto-close cron + manager override of open entries
F22.13.05 Levererad Tip-distribution rules (even / weighted_by_hours / role_percentage / individual_assigned)
F22.13.06 Levererad Tip pay-out with idempotency on (tenant, location, period)
F22.13.07 Levererad Monthly payroll summary export (CSV / Fortnox / Visma)

Intressenter som behöver detta subsystem

Förekommer i 1 intressentanalyser