HandyCafe Docs
owner cashier

Member Management

Members are registered customers in your internet cafe or gaming center. A member profile stores the customer's identity, contact information, login credentials, and billing preferences. Members can log in from client PCs, accumulate wallet balances, purchase time packages, earn loyalty points, and receive tier-based discounts on sessions and orders.

Member Profile Fields

Every member record contains the following information:

  • Username: A unique, case-insensitive identifier the member uses to sign in at client PCs. Once created, the username cannot be duplicated across the system.
  • Display name: The name shown in the Admin Panel, session lists, and client-side greeting. This is a required field.
  • Password: The password the member uses to sign in at client PCs. It is required when the member is created from the Members page and is stored as a hash.
  • Email: Optional email address. Visibility is controlled by the DISPLAY_EMAIL permission.
  • Mobile: Optional phone number. Visibility is controlled by the DISPLAY_GSM permission.
  • Avatar: A profile image URL displayed on the client lock screen and in member lists.
  • Gender: Defaults to "unknown". Can be set to male, female, or other for demographic filtering.
  • Memo: A free-text note field for internal use. Only visible to staff, not to the member.

Member States

Each member has two independent state flags:

Active / Inactive

The active/inactive toggle controls whether the member appears in standard search results and can interact with the system. Deactivating a member is a soft delete. The profile and all associated data (wallet credits, time credits, session history) are preserved but the member is hidden from day-to-day operations.

Login Permission

The can_login flag controls whether the member is allowed to sign in from client PCs. A member can be active (visible in the system) but have login disabled, which is useful for members with outstanding debts or policy violations.

Tier Assignment

Each member can be assigned to a loyalty tier. The tier determines:

  • Discount in BPS: A basis-point discount applied to session pricing. For example, a tier with discount_bps = 500 gives the member a 5% discount on the hourly rate.
  • Role label: A descriptive label (such as Silver, Gold, VIP) shown in the member's profile card and in session panels.

Tier assignment can be manual or automatic based on the loyalty points system. See the Loyalty Tiers page for details on how tiers are configured and how members progress through them.

Remaining Time and Device Scope

A member's remaining time is not one number. Time is held in lots. Each lot is usable on PCs only, on consoles only or on both. The buckets do not overlap. The total balance is their plain sum.

What a member can actually spend depends on where they are sitting:

Seat Usable time
A PC The PC-only lots plus the both-device lots
A console The console-only lots plus the both-device lots

The membership panel shows the total balance and, separately, how much of it is usable on PCs and on consoles. While the member is seated, it also shows how much is usable at that seat, calculated with the pricing group and scope of the device they are on. The badge clears when they leave the seat.

This is why a member can hold 480 minutes in total while only a few minutes are available on the machine in front of them. A console-scoped package is worth nothing on a PC.

If a session is opened on a device that none of the member's time covers, the panel shows Member time not usable on this device.

Expiring time

The panel names the next expiry as a group rather than as a single lot. Every lot that expires at the same moment is added together and broken down by scope. The warning therefore reflects the whole amount about to be lost.

Subscription

When member subscriptions are available, the member detail panel has a Subscription tab. The cashier sells, renews and cancels the member's subscription there and sees its balances and payments. See Member Subscriptions.

Member Cards

A member can be given an NFC or RFID card that opens a session with a tap instead of a username and password. Cards are assigned, returned and cancelled from the member's panel. See Member Cards.

Member Files

The Files tab sits immediately before Notes in the member detail panel. It stores local copies of documents associated with the selected member, such as an identity document scan.

Click New File, select a source file and enter a title. HandyCafe copies the file to the member's local folder without changing its original file name, letter casing or extension. The source file remains unchanged. Each table row shows the title, MIME type, size, description and SHA-256 checksum. Hover over a row to reveal its edit and delete actions. Click Open folder to open the selected member's file folder in the operating system file manager.

If the member folder already contains a file with the same name, HandyCafe rejects the new copy instead of overwriting the existing file. Different members can store files with the same name because each member has a separate folder.

The edit action changes the displayed title and description. It does not alter the stored bytes or checksum. The delete action removes only HandyCafe's copy from the member folder. It does not delete the original source file. Deleting the member also removes that member's file folder.

Member file bytes are stored outside SQLite. They are not included in database-only local or cloud backups. MEMBER_VIEW allows staff to list file metadata. MEMBER_UPDATE is required to add, edit or delete files.

Concurrent Connection Limit

Members created from the Members page get a max_connection value of 1. The New member dialog and the member detail panel have no field to change it.

Searching and Filtering Members

The Members page provides a virtual-scrolling list that handles large member databases efficiently. You can:

  • Search: Type in the search bar to filter by username, display name, email, or mobile number. The search is case-insensitive and updates results in real time.
  • Filter: Pick one filter from the Filter list next to the search box:
Filter Shows
All members Every member
Online members Members who are signed in on a client or seated at a console
With balance Members with money in their wallet
Zero balance Members with an empty wallet
In debt Members who owe money
With time Members with remaining time
No time Members with no remaining time
Inactive Deactivated members
Login disabled Members who are not allowed to sign in
Never logged in Members who have never signed in
No login 30+ days Members whose last sign-in is more than 30 days ago
Missing email Members without an email address
Missing phone Members without a mobile number
  • Sort: Click column headers to sort by name, last seen date, or creation date.

The virtual scrolling implementation loads only the visible portion of the member list into memory so performance remains smooth even with tens of thousands of registered members.

Online Status Indicator

When a member is currently logged into a client PC or has an active console session, their profile shows a green online indicator in the member list. The indicator also displays which specific client or console the member is currently using so staff can quickly locate a customer.

Creating a New Member

To create a new member:

  1. Navigate to the Members page from the sidebar.
  2. Click the New member button in the toolbar.
  3. Fill in the required fields: Display Name, Username and Password.
  4. Optionally fill in Email, Mobile, Gender and Notes.
  5. Click Save to create the member.

Save stays disabled until the three required fields are filled. Usernames accept lowercase letters, digits, dots, underscores and hyphens. To create many members at once, use Import from CSV next to New member.

The system automatically generates a unique ID for the member and records the creating cashier's identity.

Editing a Member

Select a member from the list to open their profile detail view. From here you can:

  • Update any profile field (display name, email, mobile, gender, memo).
  • Change the member's tier assignment.
  • Toggle the active flag.
  • Reset or change the member's password.

All changes are saved immediately and an audit log entry is created.

Deleting a Member

Deleting a member removes their profile from the active system. This action requires the MEMBER_DELETE permission. A member can be deleted even if they have past sessions or login history. Session and transaction history is preserved for reporting but is no longer linked to a member profile. Wallet and time credit balances are removed with the profile. The member's local file folder is also removed. To keep a member's full record intact, deactivate them instead of deleting.

Permission Requirements

Access to member management features is controlled by the following permissions on the cashier role:

Permission Grants
MEMBER_VIEW View the member list and search members
MEMBER_ADD Create new member profiles
MEMBER_UPDATE Edit existing member profiles
MEMBER_DELETE Delete member profiles
DISPLAY_EMAIL See the member's email address in the detail view
DISPLAY_GSM See the member's mobile number in the detail view

If a cashier's role does not include DISPLAY_EMAIL or DISPLAY_GSM, those fields are hidden in the member detail panel even though the data exists in the database.

Related Videos

Find Any Customer in One Search

Search, filter and sort your member list, then bring existing customers over with CSV import.