会员管理

会员是网吧或电竞馆中的注册顾客。会员资料存储顾客的身份、联系方式、登录凭证和计费偏好。会员可以从客户端 PC 登录、积累钱包余额、购买时间套餐、获得忠诚积分，并享受基于等级的会话和订单折扣。

会员资料字段

每条会员记录包含以下信息：

• 用户名：会员在客户端 PC 上登录时使用的唯一、不区分大小写的标识符。创建后，用户名在系统中不可重复。
• 显示名称：在管理面板、会话列表和客户端问候语中显示的名称。这是必填字段。
• 密码：会员可以设置密码用于客户端 PC 的自助登录。密码以哈希形式存储，初始可留空（会员在首次登录时设置）。
• 邮箱：可选的电子邮箱地址。可见性由 DISPLAY_EMAIL 权限控制。
• 手机号：可选的手机号码。可见性由 DISPLAY_GSM 权限控制。
• 头像：在客户端锁定屏幕和会员列表中显示的个人资料图片 URL。
• 性别：默认为“未知”。可设为男性、女性或其他，用于人口统计筛选。
• 备注：内部使用的自由文本备注字段。仅对员工可见，会员不可见。

会员状态

每个会员有两个独立的状态标志：

活跃/停用

活跃/停用开关控制会员是否出现在标准搜索结果中以及能否与系统交互。停用会员属于软删除。资料和所有关联数据（钱包余额、时间余额、会话历史）被保留，但会员从日常运营中隐藏。

登录权限

can_login 标志控制会员是否被允许从客户端 PC 登录。会员可以处于活跃状态（在系统中可见）但登录被禁用，这对有未清欠款或违反政策的会员很有用。

等级分配

每个会员可以分配到一个忠诚度等级。等级决定：

• BPS 折扣：应用于会话定价的基点折扣。例如，discount_bps = 500 的等级给会员 5% 的小时费率折扣。
• 等级标签：描述性标签（如白银、黄金、VIP），显示在会员资料卡和会话面板中。

等级分配可以手动设置或根据忠诚积分系统自动分配。等级如何配置以及会员如何逐级晋升，详情请参阅会员等级页面。

剩余时长与设备范围

会员的剩余时长不是一个数字。时长以批次的形式持有，每个批次只能用于 PC、只能用于主机，或者两者都能用。这几类互不重叠，总余额就是它们的简单相加。

会员实际能用掉多少，取决于他坐在哪里：

会员面板显示总余额，并单独列出其中有多少可用于 PC、有多少可用于主机。会员就座期间，面板还会按其所用设备的定价组和设备范围，显示在该座位上可用的时长。会员离座后，该徽标随即清除。

正因如此，会员总共可能持有 480 分钟，而眼前这台机器上却只有几分钟可用。仅限主机的套餐在 PC 上毫无价值。

如果在会员的时长都覆盖不到的设备上开启会话，面板会显示会员时长无法在此设备上使用。

即将到期的时长

面板把下一个到期时间点按组呈现，而不是按单个批次。所有在同一时刻到期的批次会被加总，并按设备范围拆分显示。因此该警告反映的是即将失效的全部数量。

会员卡

可以给会员发一张 NFC 或 RFID 卡片，刷卡即可开启会话，无需输入用户名和密码。卡片的发放、归还和注销都在会员面板中完成。参见会员卡。

并发连接限制

max_connection 字段设置会员在所有客户端 PC 上可同时拥有的最大进行中的会话数。默认值为 1，意味着会员同一时间只能在一台 PC 上登录。如果会员在已有进行中的会话时尝试在第二台 PC 上登录，系统将拒绝登录。

增加此值适用于管理多台机器的会员（如员工账户）或允许多设备使用的特殊会员等级。

搜索和筛选会员

会员页面提供虚拟滚动列表，高效处理大型会员数据库。您可以：

• 搜索：在搜索栏中输入，按用户名、显示名称、邮箱或手机号筛选。搜索不区分大小写，结果实时更新。
• 按状态筛选：切换显示所有会员、仅活跃会员或仅停用会员。
• 排序：点击列标题按名称、最后在线日期或创建日期排序。

虚拟滚动实现只将会员列表的可见部分加载到内存中，即使有数万名注册会员也能保持流畅性能。

在线状态指示

当会员当前登录在客户端 PC 或有进行中的主机会话时，其资料在会员列表中显示绿色在线指示器。指示器还显示会员当前使用的具体客户端或主机，以便员工快速定位顾客。

创建新会员

创建新会员：

1. 从侧边栏导航到会员页面。
2. 点击工具栏中的添加会员按钮。
3. 至少填写显示名称（必填），可选填写用于登录的用户名。
4. 如适用，设置等级，或保持默认值。
5. 如果默认值 1 不合适，调整最大连接数。
6. 点击保存创建会员。

系统自动为会员生成唯一 ID 并记录创建者收银员的身份。

编辑会员

从列表中选择会员以打开其资料详情视图。在此可以：

• 更新任何资料字段（显示名称、邮箱、手机号、性别、备注）。
• 更改会员的等级分配。
• 切换 active 和 can_login 标志。
• 重置或更改会员的密码。
• 调整并发连接限制。

所有更改立即保存并创建审计日志条目。

删除会员

删除会员将其资料从活跃系统中移除。此操作需要 MEMBER_DELETE 权限。即使会员有过往会话或登录历史，也可以删除。会话和交易历史会保留用于报表，但不再关联到某个会员资料。钱包余额和时长余额随资料一并删除。若要完整保留会员记录，请停用会员而不是删除。

权限要求

会员管理功能的访问权限由收银员角色上的以下权限控制：

如果收银员的角色不包含 DISPLAY_EMAIL 或 DISPLAY_GSM，即使数据存在于数据库中，这些字段在会员详情面板中也会被隐藏。