术语表

HandyCafe 文档中使用的专业术语字母顺序参考。

管理面板（Admin Panel） HandyCafe Server 中的主要监控仪表盘。显示所有已连接客户端、它们的状态和活跃时段。每张客户端卡片上提供时段控制和远程管理操作的按钮。

手续费率（Commission Rate） 用于表示支付处理费用的百分比。例如 1% 或 5%。用于支付方式配置中定义接受某种支付方式的成本。

二进制协议（Binary Protocol） HandyCafe Server 与客户端之间 TCP 通信使用的紧凑编码格式。相比文本格式，因其速度快和消息体小而被选用。

客户端（Client） 运行 HandyCafe Client 软件的面向顾客的 PC。客户端通过局域网连接到服务端，接收时段命令，报告状态和使用数据。每个客户端通过其 MAC 地址和主机名识别。

连接密钥（Connection Key） 在部署期间配置于服务端和每台客户端上的共享密钥。用于生成 TCP 通信的加密认证令牌，确保只有授权设备可以与服务端交换命令。

主机（Console） 由 HandyCafe 管理的 PlayStation 或 Xbox 等游戏设备。主机支持时段、定价和会员使用，与客户端 PC 相同，但不运行 HandyCafe Client 软件。通过 MAC 地址追踪。

网吧（Cybercafe / Cyber Cafe） 提供公共计算机和互联网访问的商家，通常按小时收费。也称为网咖。HandyCafe 管理网吧运营的各个方面，包括时段、计费和会员。

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

电竞馆（Esports Arena） 专注于竞技游戏和电竞赛事的场馆，通常配备高性能 PC、比赛区和观众席。HandyCafe 通过时段管理、会员追踪和主机计费支持电竞馆运营。

权益（Entitlement） 会员购买套餐后获得的价值。可以是时间余额（预付的时段使用分钟数）、钱包余额，或两者的组合。权益记录为会员钱包或时间余额中的余额条目。

汇率（FX Rate） 将基础货币转换为本地显示货币的外汇汇率。允许使用不同货币的地区的网吧以当地货币定价，同时保持一致的内部记账基准。

电竞中心（Gaming Center） 顾客付费使用 PC 或游戏主机的商业场所，通常提供高性能硬件和社交游戏环境。HandyCafe 从时段计费到会员体系全面管理电竞中心运营。

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

网吧（Internet Cafe） 向顾客提供按时计费的计算机和互联网服务的商家。网吧是 HandyCafe 的主要使用场景，处理时段管理、定价、会员体系和销售运营。

空闲（Idle） 客户端 PC 已连接到服务端但无活跃时段的状态。在空闲状态下，客户端显示锁定屏幕（待机页面），等待时段开始、会员登录或管理操作。

钱包余额 / 时间余额（Wallet Credit / Time Credit） 通过充值或购买套餐创建的离散钱包余额或预付分钟数条目。每条记录其来源（现金充值、套餐权益、活动赠送）、剩余价值和适用的设备限制。在时段结算期间按顺序消费。

MAC 地址（MAC Address） 分配给网络接口的硬件标识符。HandyCafe 使用 MAC 地址唯一识别客户端和主机，确保即使 IP 地址变化也能识别设备。

mDNS（Multicast DNS） 局域网上自动服务发现的协议。HandyCafe 客户端通过 mDNS 公告其存在，允许服务端无需手动 IP 配置即可发现它们。

会员（Member） 在 HandyCafe 系统中拥有注册档案的顾客。会员有钱包、等级和交易历史。他们可以在客户端 PC 上登录以获得个性化时段。会员也可能有 OAuth 关联的账户。

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

倍率（Multiplier） 在定价排期档位中应用于基础小时费率的系数。1.0 倍率表示标准费率。1.5 倍率表示费率高 50%（如高峰时段），0.5 倍率表示半价（如低谷折扣）。

PC 房（PC Bang） 韩式网吧和电竞中心，顾客按小时付费使用 PC。PC 房以高端游戏硬件和竞技游戏文化著称。HandyCafe 通过灵活的定价排期和时段管理支持 PC 房运营。

在线（Online） 活跃时段期间的客户端状态。在线时，客户端显示桌面界面（在线页面），允许顾客使用应用、浏览和与客户端菜单交互。

后付费（Postpaid） 顾客自由使用 PC 并在结束时根据实际使用时长付款的时段计费模式。最终费用在时段关闭时使用适用的定价排期分段计算。

预付费（Prepaid） 顾客预先支付固定时长的时段计费模式。购买的时间用完后时段自动结束，除非续时。

定价分段（Pricing Segment） 时段中应用单一定价倍率的部分。分段边界由时段开始、暂停、恢复或排期中的定价档位转换等事件创建。

定价档位（Pricing Slot） 周定价排期网格中带颜色的区域。每个档位定义一个时间范围和修改基础小时费率的倍率。档位可以覆盖特定日期的特定时段，实现高峰与低谷的差异化定价。

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

分段边界（Segment Boundary） 触发在时段内创建新定价分段的事件。边界包括：时段开始、时段结束、时段暂停、时段恢复和定价档位变更（当时钟从一个定价档位进入另一个时）。

时段（Session） 顾客使用 PC 或主机的计时期间。时段追踪开始时间、结束时间、暂停、定价分段和总费用。可以是预付费或后付费。

结算（Settlement） 时段结束时执行的费用计算。结算处理所有定价分段，应用相关倍率，添加起步费和增值税，扣除会员折扣，得出应付总额。

班次（Shift） 收银员从登录到登出的工作期间。班次内执行的所有交易、时段操作和管理操作都归属于已登录的收银员。班次数据用于问责和绩效分析。

起步费（Startup Fee） 无论时段时长都按次收取的最低费用。如果时段的计算费用（基于时间和定价）低于起步费，则收取起步费。确保每个时段的基准收入。

同步（Sync） 从 HandyCafe Server 到客户端 PC 的文件同步过程。使用基于清单的比对和基于分块的传输，高效地在网络中分发文件。

等级（Tier） 会员等级体系中的忠诚度级别。等级由积分门槛定义，提供时段和订单的折扣。会员通过消费积累积分，晋升到享有更好优惠的更高等级。

交易（Transaction） 时段、订单、钱包充值或其他计费事件的付款财务记录。交易记录金额、支付方式、关联的会员或收银员和时间戳。

增值税（VAT, Value Added Tax） 应用于时段费用和订单金额的税率百分比。增值税率在定价设置中配置，纳入结算计算。增值税金额单独追踪用于税务报告。

钱包（Wallet） 存储在 HandyCafe 系统中的会员预付资金余额。钱包由一个或多个余额条目组成，可用于支付时段、订单和其他服务。可通过现金、套餐或促销活动充值。