Nhật ký Hệ thống

Trang Nhật ký cung cấp dấu vết kiểm toán toàn diện về mọi sự kiện hệ thống trong HandyCafe. Mọi hành động quan trọng -- từ bắt đầu phiên đến đăng nhập thu ngân -- đều được ghi nhận tại đây phục vụ trách nhiệm giải trình, xử lý sự cố và tuân thủ.

Hiệu suất

Trình xem nhật ký sử dụng kết xuất danh sách ảo để duy trì hiệu suất mượt mà khi hiển thị hàng nghìn mục nhập. Nghĩa là chỉ các hàng hiển thị được kết xuất trong DOM tại bất kỳ thời điểm nào, cho phép hệ thống xử lý hơn 1.000 bản ghi nhật ký mà không giảm hiệu suất giao diện.

Các Trường Mục nhập Nhật ký

Mỗi mục nhập nhật ký chứa các trường sau:

Trường	Mô tả
Thời gian	Ngày và giờ sự kiện xảy ra
Nguồn	Thành phần hệ thống tạo ra sự kiện
Danh mục	Phân loại sự kiện (xem danh mục bên dưới)
Hành động	Loại hành động cụ thể (xem hành động phổ biến bên dưới)
PC	PC khách hoặc console liên quan, nếu có
IP	Địa chỉ IP liên quan đến sự kiện
Hội viên	Hội viên liên quan, nếu có
Thu ngân	Thu ngân đã kích hoạt hoặc đang trực khi sự kiện xảy ra
Thông báo	Mô tả dễ đọc về những gì đã xảy ra

Danh mục Nhật ký

Sự kiện được phân loại thành 8 danh mục:

Máy chủ -- Khởi động máy chủ, tắt, thay đổi cấu hình và sự kiện cấp hệ thống.
Máy khách -- Kết nối, ngắt kết nối và thay đổi trạng thái máy khách.
Thu ngân -- Đăng nhập, đăng xuất và hành động quản trị của thu ngân.
Hội viên -- Đăng ký hội viên, cập nhật hồ sơ và thay đổi tài khoản.
Phiên -- Sự kiện vòng đời phiên (bắt đầu, kết thúc, tạm dừng, tiếp tục).
Console -- Sự kiện liên quan đến console (thêm, xóa, gán phiên).
Đơn hàng -- Sự kiện tạo, chỉnh sửa và đóng đơn hàng.
Thanh toán -- Xử lý thanh toán, hoàn tiền và sự kiện giao dịch tài chính.

Hành động Phổ biến

Các hành động sau xuất hiện thường xuyên trong nhật ký:

startSession -- Phiên mới được bắt đầu trên máy khách hoặc console.
stopSession -- Phiên đang hoạt động được kết thúc.
pauseSession -- Phiên đang chạy được tạm dừng.
resumeSession -- Phiên đã tạm dừng được tiếp tục.
consoleAdded -- Console chơi game mới được đăng ký trong hệ thống.
newMemberAdded -- Tài khoản hội viên mới được tạo.
orderCreated -- Đơn hàng sản phẩm mới được tạo.
orderClosed -- Đơn hàng được hoàn thành và đóng.
cashierLogin -- Thu ngân đăng nhập vào hệ thống.
cashierLogout -- Thu ngân đăng xuất.
serverStarted -- Ứng dụng HandyCafe Server được khởi động.
clientConnected -- PC khách thiết lập kết nối với máy chủ.
clientDisconnected -- PC khách ngắt kết nối khỏi máy chủ.

Lọc và Tìm kiếm

Lọc theo Danh mục

Chọn một hoặc nhiều danh mục để thu hẹp hiển thị nhật ký. Ví dụ: chỉ hiện sự kiện Phiên và Thanh toán để kiểm toán hoạt động tài chính.

Lọc theo Hành động

Lọc theo loại hành động cụ thể để tìm sự kiện nhanh chóng.

Lọc theo Khoảng Thời gian

Giới hạn chế độ xem nhật ký theo khoảng thời gian cụ thể. Kết hợp với bộ lọc khác, giúp dễ dàng điều tra sự cố xảy ra trong khung thời gian xác định.

Tùy chọn Sắp xếp

Sắp xếp mục nhật ký theo bất kỳ trường nào theo thứ tự tăng hoặc giảm. Sắp xếp theo thời gian (mới nhất trước) là mặc định.

Tìm kiếm Văn bản

Ô tìm kiếm văn bản tự do khớp với tất cả trường, cho phép tìm kiếm tên máy, địa chỉ IP, tên hội viên hoặc bất kỳ từ khóa nào trong thông báo nhật ký.

Quyền hạn

Quyền truy cập trang Nhật ký được kiểm soát bởi các quyền sau:

Quyền	Mô tả
`LOG_VIEW`	Cần thiết để truy cập trang Nhật ký
`LOG_DISPLAY_FULL`	Cho phép xem toàn bộ lịch sử nhật ký
`LOG_DISPLAY_TODAY`	Giới hạn xem chỉ mục nhập hôm nay
`LOG_DELETE`	Cho phép xóa mục nhật ký

Thu ngân có LOG_VIEW và LOG_DISPLAY_TODAY có thể xem sự kiện hôm nay nhưng không thể truy cập dữ liệu lịch sử. Chỉ người dùng có LOG_DISPLAY_FULL mới có thể duyệt toàn bộ kho nhật ký.

Cập nhật Thời gian Thực

Sự kiện nhật ký mới tự động xuất hiện trong trình xem khi chúng xảy ra. Hệ thống lắng nghe sự kiện nhật ký qua kết nối TCP nên không cần tải lại trang thủ công. Bộ nhớ đệm nhật ký cải thiện hiệu suất bằng cách giảm truy vấn cơ sở dữ liệu lặp lại khi cuộn qua mục nhập gần đây.