Staff Settings

The Staff Settings category is where you manage the people who operate your cafe. It is organized into two tabs: 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 and how role-based access control behaves on the backend, see the Cashier Roles & Permissions page.

Panel Structure

When you open Staff Settings, the Cashiers tab is shown first. Use the tab buttons at the top to switch between the two tabs:

• Cashiers: the list of staff accounts, plus the form to add a new one and tools to edit, enable, disable, or delete existing accounts.
• Roles & Permissions: the list of roles and the permission matrix used to define what each custom role can access.

Cashiers Tab

The Cashiers tab is split into two areas. The left side holds the Add Cashier form. The right side shows the Registered Cashiers list.

Add Cashier

The Add Cashier form on the left creates a new staff account. It has the following fields:

The Cashier Role dropdown offers four choices:

• Admin: full access to every feature in the system.
• Manager: a built-in role seeded by the system.
• Cashier: a built-in role seeded by the system.
• Custom: a role you define yourself in the Roles & Permissions tab.

When you choose Custom, the Custom Role dropdown becomes active so you can pick one of your user-defined roles. Built-in roles (Manager and Cashier) are excluded from this dropdown because they are selected directly through the Cashier Role dropdown.

The Add button stays disabled until the required fields are filled in. If you selected Custom, a custom role must also be chosen before you can save.

Registered Cashiers

The right side lists every cashier account under the Registered Cashiers heading, with a count line below it. Each entry shows the display name (or the role name when no display name is set), the assigned role, the username, and the mobile and email values when present. Several badges and indicators appear on each entry:

• A You badge marks the account you are currently signed in with.
• Admin accounts are highlighted with a distinct role badge.
• A lock icon appears on the role badge of the last remaining active administrator.
• A Disabled badge appears on accounts that are not active.

The list is sorted with administrators first, then active accounts before disabled ones, then alphabetically by display name.

Each entry has three action buttons:

• Enable / Disable: toggles whether the account is active. A disabled cashier cannot sign in. This control is locked for the last active administrator.
• Edit: opens the cashier edit dialog (described below).
• Delete: removes the account after a confirmation prompt.

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 action buttons.

Cashier Edit Dialog

Selecting Edit on a cashier opens a dialog with the account's avatar, current role, and four sections.

In the Security section, the password field is optional. The hint reads Leave empty to keep the current password. Enter a value only when you want to change the password.

The Access section works the same way as the Add Cashier form. Choose the role type from Cashier Role, and pick a user-defined role from Custom Role when the type is Custom.

The footer has a Save button on the left and a Cancel button on the right. 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 lists all roles on the left under the Roles heading and shows the permission matrix for the selected role on the right.

• Built-in roles are marked with a Built-in badge and a lock icon. Their permissions are managed by the system and cannot be edited or deleted. Selecting one shows the banner: Built-in roles cannot be edited or deleted. Duplicate this role or create a new custom role to define your own permissions.
• Custom roles can be created with Add Role, edited through the permission matrix, and removed with Delete after a confirmation prompt.

The permission matrix groups individual permission checkboxes into categories (Authentication, Members, Consoles, Logs, Reports, and Payment Methods). Changes to a custom role are tracked with an unsaved indicator dot and are committed when you save the Settings page, not through a separate Save button inside the tab.

For the complete list of permission flags in each category and detailed guidance on building custom roles, see the Cashier Roles & Permissions page.

Where Cashiers Sign In

Cashier accounts created here are used to sign in on the server application and on client PCs. For details on the sign-in screen and what cashiers can do after signing in, see the Cashier Login page.