会员管理

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

会员资料字段

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

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

会员状态

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

活跃/停用

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

登录权限

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

等级分配

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

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

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

并发连接限制

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

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

搜索和筛选会员

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

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

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

在线状态指示

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

创建新会员

创建新会员：

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

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

编辑会员

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

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

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

删除会员

删除会员将其资料从活跃系统中移除。此操作需要 MEMBER_DELETE 权限。关联数据如时段历史和钱包记录保留用于报表，但不再关联到活跃的会员资料。

权限要求

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

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