术语表

HandyCafe 文档中使用的领域术语按字母顺序排列的参考。

管理面板 HandyCafe 服务器中的主要监控仪表板。显示所有已连接的客户端、其状态和活动会话。还在每个客户端卡片上提供会话控制和远程管理操作的按钮。

佣金率 用于表示支付处理费用的百分比。例如，1% 或 5%。用于支付方式配置中定义接受特定支付方式的成本。

二进制协议 用于 HandyCafe 服务器与客户端之间 TCP 通信的紧凑编码格式。由于其速度和消息体积小而被选择，相较于基于文本的格式。

客户端 运行 HandyCafe 客户端软件的面向客户的 PC。客户端通过本地网络连接到服务器，接收会话命令，并报告状态和使用数据。每个客户端通过其 MAC 地址和主机名标识。

连接密钥 在设置期间配置在服务器和每个客户端上的共享密钥。用于生成 TCP 通信的加密认证令牌，确保只有授权设备才能与服务器交换命令。

游戏机 由 HandyCafe 管理的游戏设备，如 PlayStation 或 Xbox。游戏机支持会话、定价和会员使用，与客户端 PC 类似，但不运行 HandyCafe 客户端软件。通过 MAC 地址进行跟踪。

餐饮服务 HandyCafe 中集成的食品和饮料服务模块。包括可视化的平面图、桌面管理、带有类别和产品的菜单编辑器、实时订单仪表板，以及在 handy.cafe/{slug} 上的品牌客户菜单。餐饮服务使用云优先的数据模型，本地和云数据库保持同步。

网络咖啡厅 / 网络咖啡馆 提供公共计算机和互联网连接的业务，通常按小时收费。也称为网吧。HandyCafe 管理网络咖啡厅运营的各个方面，包括会话、结算和会员管理。

设备限制 指定钱包余额、时间余额或定价规则适用的设备类型的设置。可能的值包括：客户端（PC）、游戏机（游戏机）、仅限 PC、仅限游戏机或两者（任何设备）。

电竞场馆 专注于竞技游戏和电竞赛事的场所，通常配备高性能 PC、比赛舞台区域和观众席。HandyCafe 支持电竞场馆的会话管理、会员跟踪和游戏机结算。

权益 会员通过购买套餐获得的价值。这可能是时间余额（预付的会话使用分钟数）、货币钱包余额或两者的组合。权益记录为会员钱包或时间余额中的信用条目。

平面图 餐饮服务中的可视化编辑器，用于在画布上排列桌子。支持多层楼、拖放定位和 3D 轴测视图。桌子被分配到每个楼层。参见餐饮服务 > 平面图。

外汇汇率 用于将基础货币转换为本地显示货币的外汇汇率。这使得不同货币地区的咖啡厅能够以本地货币定价，同时保持一致的内部会计基础。

游戏中心 客户支付使用 PC 或游戏机的商业场所，通常提供高性能硬件和社交游戏环境。HandyCafe 旨在管理游戏中心的运营，从会话结算到会员计划。

加密认证 用于确保服务器与客户端之间 TCP 消息的完整性和真实性的消息验证机制。双方使用连接密钥计算和验证认证代码。

网吧 为客户提供定时访问计算机和互联网服务的业务。网吧是 HandyCafe 的主要使用场景，负责会话管理、定价、会员计划和销售点操作。

空闲 PC 连接到服务器但没有活动会话时的客户端状态。在空闲状态下，客户端显示锁定屏幕（IdlePage），等待会话开始、会员登录或管理操作。

旧版客户端 连接到现代服务器的 HandyCafe V3 或 V4 客户端安装，使用原始旧版协议。旧版客户端在管理面板中显示的操作集较少（登录、注销、添加时间、截图、注销、重启、关机）。在设置 > 旧版客户端中启用运行时支持。

钱包余额 / 时间余额 通过充值或套餐购买创建的钱包余额或预付分钟的独立条目。每个信用条目记录其来源（现金充值、套餐权益、活动奖励）、剩余价值和适用的设备限制。在会话结算期间按顺序消耗。

MAC 地址 分配给网络接口的硬件标识符。HandyCafe 使用 MAC 地址唯一标识客户端和游戏机，确保即使设备的 IP 地址更改也能识别。

mDNS（多播 DNS） 用于本地网络自动服务发现的协议。HandyCafe 客户端通过 mDNS 宣告其存在，使服务器无需手动 IP 配置即可检测到它们。

会员 在 HandyCafe 系统中注册的客户，拥有个人资料。会员拥有钱包、等级和交易历史。他们可以在客户端 PC 上登录以进行个性化会话。会员还可能拥有 OAuth 关联账户。

最小单位 货币的最小面额，内部用于所有财务计算以避免浮点舍入错误。例如，美元使用美分（1 美元 = 100 最小单位），而日元直接使用日元（1 日元 = 1 最小单位）。

倍数 在定价计划时段内应用于基础小时费率的因子。倍数为 1.0 表示适用标准费率。倍数为 1.5 表示费率高出 50%（例如高峰时段），而 0.5 表示半价（例如非高峰折扣）。

PC Bang 韩国风格的网吧和游戏中心，客户按小时支付 PC 使用费用。PC bang 以高端游戏硬件和竞技游戏文化闻名。HandyCafe 支持 PC bang 的运营，提供灵活的定价计划和会话管理。

在线 活动会话期间的客户端状态。在线时，客户端显示桌面界面（OnlinePage），允许客户使用应用程序、浏览和与客户端菜单交互。

后付费 一种会话结算模式，客户自由使用 PC，结束时根据实际使用时长付款。最终费用在会话关闭时根据适用的定价计划段计算。

预付费 一种会话结算模式，客户预先支付固定时长。除非延长，否则会话在购买时间到期时自动结束。

定价段 会话期间单一定价倍数适用的部分。段边界由会话开始、暂停、恢复或计划中的定价时段转换等事件创建。

定价时段 每周定价计划网格中的彩色编码区域。每个时段定义一个时间范围和一个修改基础小时费率的倍数。时段可以覆盖特定日期的特定小时，允许高峰与非高峰时段的不同定价。

角色 分配给收银员账户的一组权限。角色定义收银员可以执行的操作（例如，开始会话、管理会员、查看报告）。多个收银员可以共享相同的角色，权限在整个界面中强制执行。

安全码 员工在餐饮桌上安排客户时生成的 6 位代码。客户在扫描桌面二维码后输入该码以证明实际在场。代码在服务器端哈希，并在关闭桌面或结算账单时过期。显示代码显示缓存的明文；旋转二维码生成新代码并使先前的贴纸失效。

段边界 触发会话中新定价段创建的事件。边界包括：会话开始、会话停止、会话暂停、会话恢复和定价时段变化（当时钟从一个定价时段跨越到另一个时段时）。

会话 客户使用 PC 或游戏机的计时期。会话跟踪开始时间、结束时间、暂停、定价段和总收费金额。可以是预付费或后付费。

结算 会话结束时进行的计算，以确定最终费用。结算处理所有定价段，应用相关倍数，添加启动费和增值税，扣除任何会员折扣，并生成应付总额。在餐饮服务中，结算也是一键操作，使用选定的支付方式关闭桌面上的所有未结订单，并将桌面恢复到空闲状态。

STE（智能/涡轮版） 旧版客户端的协议变体。STE 帧包括 70 字节的许可证信息前缀；帧大小为 1337 字节。替代方案是标准版（1267 字节，无前缀）。根据旧版服务器的构建方式匹配变体，否则帧会丢失或误读。在设置 > 旧版客户端中设置变体。

班次 收银员从登录到注销的工作时段。班次期间执行的所有交易、会话操作和管理操作均归因于登录的收银员。班次数据用于责任和绩效分析。

启动费 每个会话无论时长如何都适用的最低收费。如果会话的计算费用（基于时间和定价）低于启动费，则收取启动费。这确保了每个会话的基本收入。

同步 从 HandyCafe 服务器到客户端 PC 的文件同步过程。使用基于清单的比较和基于块的传输来有效地在网络中分发文件。

等级 会员等级系统中的忠诚度级别。等级由积分门槛定义，并提供会话和订单的折扣率。随着会员通过消费积累积分，他们晋升到更高的等级，享受更好的福利。

交易 会话、订单、钱包充值或其他可计费事件的支付财务记录。交易记录金额、支付方式、相关会员或收银员及时间戳。

增值税（VAT） 适用于会话费用和订单金额的百分比税。增值税率在定价设置中配置，并在结算计算中考虑。增值税金额单独跟踪以用于税务报告。

钱包 HandyCafe 系统中存储的会员预付货币余额。钱包由一个或多个信用条目组成，可用于支付会话、订单和其他服务。充值可以通过现金、套餐或活动进行。