Staff Settings
The Staff Settings category is where you manage the people who operate your cafe. Open Settings, then Staff in the Venue group.
The page has a Shifts box at the top and two tabs below it: Cashiers and Roles & Permissions. Each tab header shows a count badge with the current number of cashiers or roles.
This page focuses on the panel structure and on managing cashier accounts. For the full catalog of permission flags, see the Cashier Roles & Permissions page.
Shifts
Shifts are off by default.
| Setting | Effect |
|---|---|
| Enable shifts | Cashiers open the till by counting it at sign-in and close it by counting again at sign-out. The difference is recorded against the shift. |
| Require a note when the count does not match | Shown when shifts are on. A cashier whose count differs from the expected amount must write a note. |
Press Save at the bottom of the page to apply. The shift counts appear in the cashier shift table of the Day-End Summary. That page also describes what the cashier sees at sign-in and sign-out.
Cashiers Tab
The top of the tab has the Add Cashier button. Below it is the staff card switch and the Registered Cashiers list.
Add Cashier
Add Cashier opens a dialog with three sections:
| Section | Field | Required | Notes |
|---|---|---|---|
| Identity | Display Name | Yes | The name shown for the cashier in the list and reports. |
| Identity | Username | Yes | The login name. Automatically lowercased and limited to letters, numbers and the characters . _ -. |
| Identity | Password | Yes | The login password. Choose a strong value because this account may access financial data and customer information. |
| Contact | Mobile | No | Limited to digits and the + character. |
| Contact | No | Lowercased automatically with spaces removed. | |
| Access | Cashier Role | Yes | Admin, Manager, Cashier or Custom. |
| Access | Custom Role | Conditional | Active only when Cashier Role is Custom. Lists the roles you created yourself. |
- Admin has full access to every feature.
- Manager and Cashier are built-in roles. Their permissions can be changed on the Roles & Permissions tab.
- Custom uses a role you created on the Roles & Permissions tab.
The Add button stays disabled until the required fields are filled in. If you selected Custom, a custom role must also be chosen.
Staff card sign-in
Allow staff to sign in to the server with a card lets a cashier or admin tap their card on the server sign-in screen and go straight in, with no password. It is off by default.
Each row has a card button, Assign a card to this cashier. It opens a dialog where you scan the card you are handing over. The card is linked to that cashier the moment it is read. The dialog also lists the cards the cashier holds, with Return to stock and Report lost for each. Staff cards come from the same stock as member cards. See Member Cards.
Tapping a card on the reader while this tab is open highlights the cashier who holds it.
Registered Cashiers
The list shows every cashier account under the Registered Cashiers heading, with a count line such as "3 active, 1 passive". The columns are Staff, Contact, Role, Status and Actions.
- Staff shows the display name and the username. A You badge marks the account you are signed in with. A Disabled badge marks accounts that are not active.
- Contact shows the mobile number and email when present.
- Role shows the assigned role. A lock icon marks the last remaining active administrator.
- Status is a switch that enables or disables the account. A disabled cashier cannot sign in and is not listed on the sign-in screen. The switch is locked for the last active administrator.
- Actions has the card button, Edit and Delete. Delete asks for confirmation first.
The list is sorted with administrators first, then active accounts before disabled ones, then alphabetically by display name.
Account Protection Rules
HandyCafe prevents actions that would leave you locked out or remove the only administrator:
- You cannot disable the last administrator. The system shows: Cannot disable the last administrator. Promote another user to Admin first.
- You cannot delete the last administrator. The system shows: Cannot delete the last administrator. Promote another user to Admin first.
- You cannot delete the account you are currently signed in with. The system shows: You cannot delete the account you are currently signed in with.
The same wording is surfaced as tooltips on the locked controls.
Edit Cashier Dialog
Edit opens the Edit Cashier dialog. It has the same Identity, Contact and Access sections as Add Cashier.
The password field is optional here. The hint reads Leave empty to keep the current password. Enter a value only when you want to change the password.
Save stays disabled until the username and display name are filled in and a valid role is selected.
Roles & Permissions Tab
The Roles & Permissions tab is one matrix. Each row is a permission and each column is a role. This lets you compare roles side by side. The rows are grouped: Computer Management, Members, Consoles, Logs, Logs Page Tabs, Reporting, Sales, Stock & Payments, Bills, Orders, Stock and Page Visibility.
- Admin is read-only. It has every permission and cannot be changed or deleted.
- Manager and Cashier are built-in roles. Their permissions can be edited. They cannot be deleted. Granting or revoking every permission of a built-in role at once asks for confirmation first, because the change reaches every cashier who uses it.
- Add Role creates a custom role. A new role starts with the built-in Cashier permissions. Review the matrix after adding it.
- Select a role column to target it. Grant every permission to this role, Revoke every permission from this role and Delete act on the selected role. Delete works only on custom roles and asks for confirmation.
A search box finds a permission by name. The filters All, Granted, Differences and Flagged narrow the rows. Some permissions carry a Risky or Privacy tag.
Changes are marked with an unsaved dot on the role column. They are saved with the Save button at the bottom of the Settings page, not inside the tab.
For the complete list of permission flags and guidance on building custom roles, see Cashier Roles & Permissions. To hide pages from a role without changing its permissions, see View Settings.
Where Cashiers Sign In
Cashier accounts created here sign in on the server application with their username and password or, when staff card sign-in is on, with their card. For details on the sign-in screen, see the Cashier Login page. What each cashier took during a day is shown on the Day-End Summary.