如何从零开始设置您的网咖
本指南将引导您完成在网咖、游戏中心或电竞馆中安装HandyCafe的每一步。完成后，您将拥有一个正常运行的服务器、至少一台已连接的客户端电脑、配置好的价格，以及在现金报告中记录的测试会话付款。
您需要准备的东西
- 一台用于运行HandyCafe服务器的Windows电脑（Windows 10或更高版本，至少4 GB RAM）。
- 至少一台额外的Windows电脑作为客户端工作站。
- 连接所有电脑的本地网络（建议使用有线以太网以提高可靠性）。
- 有效的HandyCafe测试版许可证密钥。您将在首次设置时输入此密钥。
- 预先决定的小时费率和货币。
阶段1：安装和配置服务器
- 从您的HandyCafe控制面板下载最新的HandyCafe服务器安装程序。
- 在您指定为服务器的电脑上运行安装程序。按照屏幕提示操作并接受默认安装目录。
- 启动HandyCafe服务器。首次运行时，首次设置向导会自动出现。
- 按提示输入您的测试版许可证密钥。服务器将在线验证密钥并显示您的网咖名称和电脑限制。
- 创建您的管理员账户。输入用户名和强密码。此账户可以不受限制地访问所有功能。
- 设置您的网咖名称。此名称将显示在客户端空闲屏幕和报告中。
- 点击完成以完成向导。
预期结果： 服务器主窗口打开，显示管理员面板，尚无连接的客户端。您的网咖名称显示在标题栏中。
阶段2：配置价格
- 点击左侧边栏中的齿轮图标打开设置页面。
- 导航到价格标签。
- 设置您的基础货币。从货币下拉菜单中选择。所有价格、交易和报告将使用此货币。
- 输入您的小时费率。这是后付费会话的基础每小时价格。例如，输入10.00表示每小时10个单位的货币。
- 设置增值税率。输入适用于会话费用的百分比（0到100）。如果不适用增值税，请输入0。
- 设置启动费。这是每个会话的最低收费，无论持续时间如何。如果不想要最低收费，请输入0。
- 为常用时长创建价格预设。向下滚动到预设部分。点击添加预设。创建如下预设：
- "30分钟"时长为30分钟。
- "1小时"时长为60分钟。
- "2小时"时长为120分钟。
- 点击保存以应用您的价格配置。
预期结果： 价格标签显示您的小时费率、增值税率、启动费和所有预设列在下方。这些预设将在启动预付费会话时显示为快速选择按钮。
阶段3：验证网络设置
- 仍在设置中，导航到网络标签。
- 验证监听端口。默认是7842。只有在网络上的其他服务使用该端口时才更改。
- 设置或记下连接密钥。此密钥用于验证客户端连接。所有客户端电脑必须使用相同的密钥才能连接。
- 确保服务器电脑的防火墙允许在配置的端口上进行入站TCP连接。在Windows上，HandyCafe通常在安装期间添加此规则。如果您更改了端口，请手动添加新的防火墙规则。
- 记下网络标签中显示的服务器电脑IP地址。如果客户端无法通过自动发现找到服务器，您将需要它。
预期结果： 网络标签显示监听端口和连接密钥。服务器状态指示器显示绿色的“监听中”。
阶段4：部署第一个客户端
- 从您的控制面板下载HandyCafe客户端安装程序。
- 在您的第一个客户端电脑上安装它。运行安装程序并按照提示操作。
- 启动HandyCafe客户端。客户端将尝试通过本地网络上的mDNS自动发现服务器。
- 如果自动发现失败，请在客户端连接对话框中手动输入服务器IP地址和端口。
- 输入您在阶段3中记下的连接密钥。
- 等待连接建立。客户端屏幕将切换到显示时钟的锁屏空闲页面。
预期结果： 在服务器上，管理员面板现在显示一个已连接的客户端。客户端图块显示主机名和蓝色“空闲”状态。客户端电脑显示锁屏。
- 服务器将根据主机名自动为客户端分配显示名称。要重命名它，请在服务器上选择客户端图块并点击重命名。
阶段5：运行您的第一个测试会话
- 在服务器管理员面板上，点击空闲客户端图块上的开始。
- 在会话对话框中，选择后付费。将会员字段留空以进行访客会话。
- 点击确认以开始会话。
预期结果： 客户端图块变为绿色并显示计时器向上计时。在客户端电脑上，锁屏消失，在线页面桌面出现。
- 让会话运行至少5分钟，以便您可以验证价格计算。
- 点击服务器上绿色客户端图块上的停止。
- 查看成本明细对话框。它将显示：
- 时长（例如，5分钟）。
- 应用的小时费率。
- 增值税金额。
- 总费用。
- 选择一种付款方式（默认是现金）。
- 点击确认以关闭会话并记录付款。
预期结果： 客户端图块返回到蓝色“空闲”状态。客户端电脑再次显示锁屏。系统中记录了一笔交易。
阶段6：在现金报告中验证
- 使用左侧边栏导航到现金报告页面。
- 确认今天的报告显示一笔会话交易。
- 验证交易金额与您停止会话时看到的成本明细一致。
- 检查付款方式列显示“现金”（或您选择的任何方式）。
预期结果： 现金报告列出一笔已完成的会话，金额、时长和付款方式正确。您的网咖现在可以运营。
阶段7：可选的后续步骤
一旦您的基本设置正常工作，考虑配置这些功能：
- 添加会员。 导航到会员页面。点击添加以创建带有用户名和可选钱包余额的会员账户。会员可以从客户端电脑登录。
- 设置产品。 导航到产品页面。添加食品和饮料项目及价格，以便收银员可以创建订单。
- 配置客户端菜单。 导航到设置 > 客户端菜单。添加应用程序类别和应用程序，以便客户在在线页面上看到启动器网格。
- 部署其他客户端。 在网咖的每台工作站电脑上安装HandyCafe客户端。每台电脑将自动出现在服务器上。
- 创建收银员账户。 导航到管理页面。添加具有适当角色的收银员账户，以便员工可以登录和管理会话。
- 设置高峰/非高峰价格。 导航到设置 > 价格时间表。创建基于时间的倍数，以便在繁忙时段收取更高费用。
- 启用OAuth登录。 导航到设置 > OAuth。配置Google或其他提供商，以便客户可以使用社交账户登录。
常见错误避免
- 跳过防火墙规则。 如果客户端无法连接，最常见的原因是Windows防火墙规则阻止了监听端口。在排除其他问题之前，验证规则是否存在。
- 连接密钥不匹配。 每个客户端上的密钥必须与服务器上的密钥完全匹配。复制粘贴以避免输入错误。
- 将小时费率设置为0。 如果您将小时费率留为零，所有后付费会话将免费。上线前务必验证您的价格。
- 忘记保存设置。 设置页面中的更改在您点击保存之前不会生效。如果重启后设置似乎未更改，您可能忘记保存。
- 在同一台电脑上运行服务器和客户端。 虽然技术上可以用于测试，但不建议在生产环境中这样做。服务器电脑应为专用工作站。