日志

日志页面提供 HandyCafe 中所有系统事件的完整审计记录。从时段开始到收银员登录，每个重要操作都记录在这里，用于问责、故障排查和合规目的。

性能

日志查看器使用虚拟列表渲染，即使显示数千条记录也能保持流畅性能。这意味着任何时刻只渲染可见的行，系统可以处理 1000+ 条日志记录而不会降低界面性能。

日志条目字段

每条日志包含以下字段：

日志类别

事件分为 8 个类别：

1. 服务端 -- 服务端启动、关闭、配置变更和系统级事件。
2. 客户端 -- 客户端连接、断开和状态变更。
3. 收银员 -- 收银员登录、登出和管理操作。
4. 会员 -- 会员注册、资料更新和账户变更。
5. 时段 -- 时段生命周期事件（开始、结束、暂停、恢复）。
6. 主机 -- 主机相关事件（添加、移除、时段分配）。
7. 订单 -- 订单创建、修改和关闭事件。
8. 支付 -- 支付处理、退款和财务交易事件。

常见日志操作

以下操作频繁出现在日志中：

• startSession -- 在客户端或主机上开始了新时段。
• stopSession -- 活跃时段已结束。
• pauseSession -- 运行中的时段已暂停。
• resumeSession -- 已暂停的时段已恢复。
• consoleAdded -- 新游戏主机已在系统中注册。
• newMemberAdded -- 新会员账户已创建。
• orderCreated -- 新商品订单已下达。
• orderClosed -- 订单已完成并关闭。
• cashierLogin -- 收银员已登录系统。
• cashierLogout -- 收银员已登出。
• serverStarted -- HandyCafe Server 应用已启动。
• clientConnected -- 客户端 PC 已建立与服务端的连接。
• clientDisconnected -- 客户端 PC 已断开与服务端的连接。

筛选和搜索

类别筛选

选择一个或多个类别缩小日志显示范围。例如，只显示时段和支付事件以审计财务活动。

操作筛选

按特定操作类型筛选，快速找到特定事件。

日期范围筛选

将日志视图限制在特定时间段。与其他筛选条件组合使用，可方便地调查已知时间窗口内发生的事件。

排序选项

按任何字段升序或降序排列日志条目。默认按时间戳排序（最新优先）。

文本搜索

自由文本搜索框匹配所有字段，允许按特定主机名、IP 地址、会员名称或日志消息中的任何关键词搜索。

权限

日志页面的访问由以下权限控制：

拥有 LOG_VIEW 和 LOG_DISPLAY_TODAY 的收银员可以查看今日的事件，但无法访问历史数据。只有拥有 LOG_DISPLAY_FULL 的用户可以浏览完整的日志存档。

实时更新

新的日志事件在发生时自动出现在查看器中。系统通过 TCP 事件连接监听日志事件，无需手动刷新页面。日志缓存通过减少滚动浏览近期条目时的重复数据库查询来提升性能。