仪表盘

HandyCafe Server 仪表盘是管理网吧或电竞馆的中枢。登录后进入 MainPage，它作为路由加载系统中的所有其他页面。所有导航、监控和管理任务均从这里开始。

布局概览

仪表盘分为四个区域：

1. 顶部面板。 窗口顶部的水平标题栏。显示 HandyCafe 品牌名称和当前活跃页面的标题。
2. 侧边栏工具栏。 左侧的垂直导航栏。每个项目是一个图标按钮，点击切换到不同的页面。当前页面会高亮显示。
3. 内容区域。 侧边栏右侧的主要工作区。此区域渲染当前选中的页面（管理面板、会员、报表等）。
4. 状态栏。 窗口底部的可选页脚栏。可在视图设置中显示或隐藏。

侧边栏导航

侧边栏工具栏提供对系统中所有页面的快速访问。每个条目显示一个图标，悬停时显示页面名称。可用页面如下：

设置页面通过侧边栏底部的独立齿轮图标访问，与主导航项分开。

待处理订单角标

订单导航项上显示一个角标，表示当前未完成（待处理）订单的数量。每当创建或关闭订单时，该计数实时更新，收银员可以立即了解是否有待处理的工作。

基于角色的页面访问

不是每个用户都能看到相同的侧边栏。页面可见性取决于已登录收银员的角色和权限：

• 管理员账户（在首次设置向导中创建）拥有所有页面的不受限制访问权限。
• 收银员账户被分配带有特定权限标志的角色。如果收银员的角色未授予某个页面的访问权限，该页面在其侧边栏中隐藏。
• 收银员登录时，系统检查其角色权限，如果当前处于受限页面，则自动重定向到第一个可访问的页面。

角色和权限的详细信息请参阅收银员角色与权限。

自动更新检查

启动时，仪表盘检查是否有可用的软件更新。如果有更新版本的 HandyCafe Server 可用，屏幕右上角会出现一个持久通知。通知显示新版本号，并提供下载和安装更新的选项。

此检查静默运行。如果没有可用更新或更新端点不可达，不显示任何通知。

许可证心跳

仪表盘加载后，后台启动许可证心跳进程。此进程定期与许可证服务器验证您的 HandyCafe 许可证。如果许可证过期或遇到问题，仪表盘上可能出现测试版许可证覆盖层，将应用限制为只读模式，直到许可证问题解决。

详情请参阅授权许可。

状态栏

状态栏是仪表盘底部的细长水平栏。它显示应用当前状态的上下文信息。其可见性由设置控制：

• 显示或隐藏状态栏： 进入设置，在视图部分切换状态栏选项。

隐藏后，内容区域扩展填满窗口的完整高度。

启动序列

成功登录后仪表盘加载时，会自动执行以下初始化步骤：

1. 从数据库加载系统设置。
2. 恢复已保存的时段（如果重启前有正在运行的时段）。
3. 服务端套接字开始监听客户端连接。
4. 发送网络 ping 请求以发现已连接的客户端。
5. 加载收银员的角色权限并隐藏受限页面。
6. 检查测试版许可证状态。
7. 启动许可证心跳计时器。
8. 初始化工具栏角标的待处理订单计数。
9. 后台运行自动更新检查。

所有步骤都是非阻塞的。如果某个步骤失败，仪表盘继续正常运行。失败会记录到控制台，但不会阻止您使用系统。

系统字体

仪表盘遵循"设置 > 常规"中配置的系统字体设置。整个界面的所有文本使用所选的字体。

后续步骤

• 管理面板：了解如何监控和控制客户端 PC
• 时段管理：开始、暂停和结束时段
• 设置：配置系统偏好
• 收银员登录：了解登录流程