Perko

Perko Workforce

Staff setup

How to set up the Solid Cafe team: roles, staff access, the attendance QR, and the kitchen display.

Open staff console

Roles

Owner
Policies, devices, roles, staff, pay, and schedules.
Manager
Team, schedule, attendance, and time approval.
Employee
Own schedule, attendance, and earnings.
Kitchen staff
Kitchen tickets on the kitchen display.
Cashier / Barista
Counter orders when Commerce is active.

A job title does not give access. The authorization role sets permissions.

Add staff

  1. 1 Open /staff and sign in as Owner or Manager.
  2. 2 Select Solid Cafe as the working location.
  3. 3 Open Workforce and press Add employee.
  4. 4 Enter the name, work email, and position.
  5. 5 Choose the employment type and start date.
  6. 6 Choose the authorization role: Employee or Venue manager.
  7. 7 Add pay: hourly rate or fixed shift pay.
  8. 8 Add the first shift, add a reason, and press Create employee.

The employee signs in at /staff with the same email. They can request an email sign-in link.

Publish the schedule

  1. 1 Open Workforce and choose the Calendar tab.
  2. 2 Add shifts for the week.
  3. 3 Save the draft.
  4. 4 Press Publish.

An employee can check in only when the attendance policy and the published schedule allow it.

Attendance QR terminal

  1. 1 Open Workforce and choose the Time tab.
  2. 2 Publish the attendance policy: geofence radius, accuracy, check-in windows, and fallback rules.
  3. 3 In Attendance terminals, press Enroll terminal.
  4. 4 Copy the one-time code. It lasts 30 minutes.
  5. 5 On the shared attendance iPad, open /staff?attendanceTerminal=1.
  6. 6 Enter the code on the iPad.
  7. 7 Wait until the terminal shows QR live.
  8. 8 Test one check-in and one check-out.

Keep this iPad as the shared attendance display. Employees scan the QR with their own phones.

Check in and check out

Check in

  1. 1 Open /staff on the employee phone.
  2. 2 Open My Profile and choose Attendance.
  3. 3 Press Scan QR to check in.
  4. 4 Scan the QR on the attendance terminal.
  5. 5 Review the policy and allow one location sample.
  6. 6 Press Agree and verify presence.

Check out

  1. 1 End any open break first.
  2. 2 Press Check out.
  3. 3 Scan the QR again and allow one location sample.
  4. 4 Confirm the check-out.

If the phone, network, or GPS fails, a manager records an audited fallback. A reason is required.

Kitchen display (KDS iPad)

Do this only when Kitchen / Fulfillment is active.

  1. 1 Open /staff, then Settings and Registered devices.
  2. 2 Press Enroll device. Type: Kitchen. Name: Kitchen iPad. Key: kds-main-01.
  3. 3 Press Create enrollment code and copy the code.
  4. 4 On the KDS iPad, open /staff and sign in as the owner.
  5. 5 Open Settings and press Activate device. Enter the one-time code.
  6. 6 Sign out. The iPad now keeps its own device access.
  7. 7 If the station list is empty, ask support to bind the iPad to the kitchen station.

Work a kitchen shift

  1. 1 The kitchen staff member checks in with the QR first.
  2. 2 On the KDS iPad, open /staff?staffPage=kitchen.
  3. 3 Sign in as the kitchen staff member.
  4. 4 Press Claim and choose the station.
  5. 5 Work the tickets: accept, start, mark ready, serve.
  6. 6 At the end of the shift, press End KDS session, sign out, and check out.

Kitchen actions require an active attendance shift. Offline actions are blocked.

Solid Cafe · Perko Workforce

Open staff console