QuangPulse

Employee Monitoring System

Báo Cáo Đặc Tả Chức Năng

Hệ Thống Giám Sát Nhân Viên Toàn Diện

Tên hệ thống: QuangPulse Monitoring Platform
Phiên bản: 2.0 – Enterprise Edition
Loại tài liệu: Đặc tả chức năng & Hướng dẫn sử dụng
Ngày lập: Tháng 04 năm 2026
Bảo mật: Nội bộ

Biên soạn bởi QUANG IT

Mục Lục

Tổng quan hệ thống
Kiến trúc & Thành phần
Danh mục chức năng chi tiết
1. Trang chủ (Dashboard)
2. Giám sát trực tiếp (Live Monitor)
3. Quản lý thiết bị (Team & Device)
4. Dòng thời gian (Timeline)
5. Ứng dụng đang dùng (Cửa sổ)
6. Trình duyệt web (Web Activity)
7. Vắng mặt (AFK)
8. Nhập liệu (Input)
9. Nhật ký phím (Keylogger)
10. Xu hướng (Trends)
11. Báo cáo tổng hợp (Reports)
12. Phân loại hoạt động (Categories)
13. Năng suất (Productivity)
14. Chấm công (Attendance)
15. Tệp tin (File Activity)
16. Cảnh báo (Alerts)
17. Bảo mật dữ liệu (Data Security)
18. Dự án (Projects)
19. Đồng hồ bấm giờ (Stopwatch)
20. Cài đặt (Settings)
Tác nhân giám sát (QuangPulse Agent)
Hệ thống cảnh báo & danh sách chặn
Bảo mật & quyền truy cập
Hướng dẫn sử dụng cho quản trị viên
Hướng dẫn cài đặt Agent trên máy nhân viên
Câu hỏi thường gặp

1. Tổng Quan Hệ Thống

QuangPulse là nền tảng giám sát nhân viên toàn diện được phát triển cho môi trường doanh nghiệp. Hệ thống theo dõi hoạt động máy tính của nhân viên theo thời gian thực, lưu trữ lịch sử chi tiết và cung cấp báo cáo phân tích nhằm hỗ trợ quản lý hiệu suất làm việc, tuân thủ nội quy và phát hiện các mối nguy bảo mật nội bộ.

Hệ thống hoạt động theo mô hình máy chủ tập trung – các máy nhân viên cài đặt phần mềm Agent nhỏ gọn, Agent này liên tục gửi dữ liệu về máy chủ để xử lý, lưu trữ và hiển thị trên giao diện web dành cho quản trị viên.

Mục tiêu chính của QuangPulse

Nắm bắt hoạt động máy tính của toàn bộ nhân viên trong tổ chức theo thời gian thực.
Phân tích năng suất, thời gian làm việc thực tế và xu hướng sử dụng ứng dụng.
Phát hiện và cảnh báo kịp thời các vi phạm nội quy, truy cập trang web độc hại hoặc phần mềm bị cấm.
Cung cấp bằng chứng số (nhật ký, ảnh chụp màn hình, keylog) phục vụ điều tra khi cần thiết.
Chấm công tự động dựa trên dữ liệu hoạt động thực tế.

2. Kiến Trúc & Thành Phần

Thành phần	Công nghệ	Vai trò
Máy chủ Backend	Python · FastAPI · MongoDB	Tiếp nhận, lưu trữ và cung cấp API cho toàn bộ dữ liệu giám sát
Giao diện quản trị	React · TailwindCSS · WebSocket	Dashboard trực quan, truy vấn dữ liệu, quản lý thiết bị và cảnh báo
Agent máy khách	Python · PyInstaller (QuangPulse.exe)	Thu thập dữ liệu tại máy nhân viên và đẩy về máy chủ theo thời gian thực
Cơ sở dữ liệu	MongoDB	Lưu trữ toàn bộ sự kiện, thiết bị, cảnh báo, nhật ký và cấu hình
WebSocket Hub	FastAPI WebSocket	Đẩy dữ liệu trực tiếp tới trình duyệt quản trị viên mỗi 3 giây

Giao tiếp giữa Agent và máy chủ thực hiện qua giao thức HTTP/HTTPS với xác thực Token. Mỗi thiết bị có token duy nhất được cấp khi đăng ký lần đầu và lưu tự động vào file cấu hình cục bộ.

3. Danh Mục Chức Năng Chi Tiết

3.1 Trang Chủ – Dashboard

Trang chủ là màn hình tổng quan đầu tiên sau khi đăng nhập, cung cấp cái nhìn toàn diện về tình trạng hệ thống trong ngày hôm nay.

Chỉ số	Mô tả
Số máy đang online	Tổng số thiết bị đang kết nối và hoạt động trong thời điểm hiện tại
Thời gian hoạt động	Tổng thời gian làm việc thực tế (không tính vắng mặt) trong ngày
Thời gian vắng mặt	Tổng thời gian máy bật nhưng không có hoạt động bàn phím/chuột
Điểm năng suất	Phần trăm thời gian dùng ứng dụng/website được phân loại "Hiệu quả"
Ứng dụng phổ biến nhất	App được dùng nhiều nhất trong ngày trên toàn bộ thiết bị
Trang web phổ biến nhất	Domain được truy cập nhiều thời gian nhất
Số cảnh báo	Cảnh báo vi phạm chưa được xử lý trong ngày
Top sự kiện gần đây	Danh sách hoạt động mới nhất từ tất cả thiết bị

Dashboard tự động làm mới dữ liệu mỗi 30 giây. Dữ liệu trực tiếp (số máy online, cảnh báo) được cập nhật qua WebSocket mỗi 3 giây mà không cần tải lại trang.

3.2 Giám Sát Trực Tiếp – Live Monitor

Màn hình giám sát trực tiếp hiển thị trạng thái tức thời của toàn bộ thiết bị đang online, không cần làm mới trang.

Thông tin hiển thị theo thời gian thực (cập nhật mỗi 3 giây)

Trạng thái hoạt động: Online / Vắng mặt (AFK) / Offline
Ứng dụng đang dùng: Tên app và tiêu đề cửa sổ hiện tại
Trang web đang xem: URL đang mở trên trình duyệt
Tài nguyên hệ thống: CPU%, RAM%, dung lượng đĩa, băng thông mạng
Tình trạng pin: Phần trăm pin và trạng thái sạc (nếu là laptop)
Ảnh chụp màn hình mới nhất: Ảnh chụp gần đây nhất của màn hình nhân viên
Số cảnh báo trong 24 giờ: Tổng vi phạm gần đây

Quản trị viên có thể nhấn vào bất kỳ thiết bị nào để xem chi tiết ngay lập tức.

3.3 Quản Lý Thiết Bị – Team & Device Detail

Quản lý toàn bộ danh sách thiết bị đã đăng ký trong hệ thống.

Chức năng	Mô tả
Danh sách thiết bị	Xem tất cả máy đã đăng ký, trạng thái online/offline, lần cuối kết nối
Chi tiết thiết bị	Thông tin phần cứng, hệ điều hành, CPU, RAM, IP, tên đăng nhập
Lịch sử hoạt động	Xem toàn bộ lịch sử sự kiện của từng thiết bị theo ngày
Ảnh chụp màn hình	Xem lại thư viện ảnh chụp màn hình được lưu theo thời gian
Danh sách tiến trình	Các tiến trình đang chạy trên máy tại thời điểm snapshot gần nhất
Thống kê ngày	Biểu đồ hoạt động trong ngày: thời gian làm việc, vắng mặt, app phổ biến
Gán vào dự án	Liên kết thiết bị với dự án để theo dõi theo nhóm công việc

3.4 Dòng Thời Gian – Timeline

Hiển thị toàn bộ lịch sử hoạt động của một hoặc nhiều thiết bị dưới dạng dòng thời gian liên tục, sắp xếp theo thứ tự thời gian.

Lọc theo thiết bị, ngày hoặc khoảng thời gian tùy chỉnh.
Mỗi sự kiện hiển thị: ứng dụng, tiêu đề cửa sổ, thời lượng, tên máy.
Hỗ trợ phân trang khi dữ liệu lớn.
Màu sắc phân biệt: hoạt động, vắng mặt, trình duyệt web.

3.5 Ứng Dụng Đang Dùng – Cửa Sổ (Window Activity)

Thống kê chi tiết toàn bộ thời gian sử dụng từng ứng dụng trên máy nhân viên.

Danh sách tất cả ứng dụng đã dùng trong khoảng thời gian chọn, sắp xếp theo thời lượng.
Mỗi dòng hiển thị: tên ứng dụng, tiêu đề cửa sổ, tổng thời gian, tên máy.
Biểu đồ tỷ lệ sử dụng ứng dụng trong ngày.
Hỗ trợ lọc theo tên máy khi quản lý nhiều thiết bị.

Dữ liệu cửa sổ chỉ được ghi khi nhân viên đang thực sự sử dụng máy (không tính khoảng thời gian vắng mặt).

3.6 Trình Duyệt Web – Web Activity

Ghi lại lịch sử duyệt web từ Chrome, Edge và Firefox. Đây là nguồn dữ liệu quan trọng để phát hiện truy cập ngoài phạm vi công việc hoặc nội dung độc hại.

Thông tin	Chi tiết
URL đã truy cập	Địa chỉ trang web đầy đủ
Tiêu đề trang	Tên trang web hoặc nội dung tab trình duyệt
Thời gian truy cập	Thời điểm và thời lượng xem trang
Tên máy	Thiết bị nào đã truy cập
Tên miền	Domain được nhóm lại để thống kê nhanh

Hệ thống tự động đối chiếu mỗi URL với danh sách chặn. Nếu khớp, cảnh báo sẽ được tạo ngay lập tức và thông báo tới quản trị viên qua giao diện web.

3.7 Vắng Mặt – AFK (Away From Keyboard)

Theo dõi và thống kê khoảng thời gian máy tính bật nhưng không có tương tác từ bàn phím hoặc chuột.

Ngưỡng vắng mặt mặc định: 180 giây (3 phút không có input).
Biểu đồ thời gian làm việc thực tế so với thời gian vắng mặt theo ngày.
Tổng thời gian online, tổng thời gian vắng mặt, tỷ lệ phần trăm.
Có thể lọc theo từng thiết bị hoặc xem tổng hợp tất cả máy.

3.8 Nhập Liệu – Input Statistics

Đếm và thống kê cường độ làm việc của nhân viên dựa trên các thao tác nhập liệu vật lý.

Loại input	Thông tin đo lường
Bàn phím	Tổng số phím đã gõ trong ngày / khoảng thời gian chọn
Chuột – click	Tổng số lần nhấp chuột trái và phải
Chuột – cuộn	Số lần cuộn bánh xe chuột
Biểu đồ theo giờ	Phân bổ hoạt động theo từng giờ trong ngày làm việc

3.9 Nhật Ký Phím – Keylogger

Ghi lại nội dung văn bản thực tế mà nhân viên gõ trên bàn phím, phục vụ điều tra khi cần thiết hoặc kiểm soát nội dung nhạy cảm.

Đặc điểm kỹ thuật

Hỗ trợ đầy đủ tiếng Việt Unicode, bao gồm các ký tự đặc biệt như đ, ơ, ư và toàn bộ dấu thanh điệu.
Nhận biết ranh giới từ ngữ: chỉ ghi và gửi khi hoàn thành câu/đoạn, tránh cắt giữa chừng.
Buffer tối đa 4.000 ký tự. Khi đạt giới hạn sẽ tự động gửi về máy chủ.
Dữ liệu được lưu kèm thời gian, tên máy và tên thiết bị.
Quản trị viên có thể tìm kiếm theo từ khoá, lọc theo thiết bị và khoảng ngày.

Tính năng Keylogger phải được bật rõ ràng trong cấu hình Agent và cần tuân thủ quy định pháp lý về quyền riêng tư tại địa phương trước khi triển khai.

3.10 Xu Hướng – Trends

Phân tích xu hướng sử dụng theo thời gian, hỗ trợ quản lý đánh giá hành vi làm việc theo tuần, tháng.

Biểu đồ đường: thời gian làm việc qua các ngày trong kỳ chọn.
Biểu đồ cột: so sánh thời gian dùng từng ứng dụng hàng ngày.
Top ứng dụng, top trang web theo tổng thời gian trong kỳ.
Hỗ trợ lọc theo thiết bị hoặc xem tổng hợp toàn bộ.
Khoảng thời gian: tùy chỉnh ngày bắt đầu và ngày kết thúc.

3.11 Báo Cáo Tổng Hợp – Reports

Tạo báo cáo chi tiết theo kỳ, tổng hợp toàn bộ hoạt động của một hoặc nhiều thiết bị.

Tổng thời gian làm việc, vắng mặt, tỷ lệ năng suất.
Danh sách ứng dụng sử dụng nhiều nhất, xếp hạng theo thời lượng.
Danh sách trang web truy cập nhiều nhất.
Số lượng cảnh báo vi phạm trong kỳ, phân loại theo mức độ.
Biểu đồ tổng quan dễ đọc.

3.12 Phân Loại Hoạt Động – Categories

Hệ thống cho phép phân loại từng ứng dụng và trang web thành các nhóm phục vụ đánh giá năng suất.

Nhóm phân loại	Ví dụ
Hiệu quả cao	Microsoft Office, IDE, phần mềm kế toán
Bình thường	Email, tài liệu, họp trực tuyến
Giải trí	YouTube, Facebook, trò chơi
Không xác định	Ứng dụng chưa được phân loại

Quản trị viên có thể tùy chỉnh quy tắc phân loại theo tên ứng dụng hoặc domain. Kết quả phân loại được dùng để tính điểm năng suất.

3.13 Năng Suất – Productivity

Tính toán và hiển thị điểm năng suất làm việc dựa trên phân loại hoạt động.

Điểm năng suất = Thời gian hoạt động "Hiệu quả" / Tổng thời gian online × 100%.
Biểu đồ tỷ lệ phân bổ theo danh mục trong ngày.
So sánh năng suất giữa các ngày trong tuần.
Xem theo từng thiết bị hoặc tổng hợp toàn bộ nhân viên.

3.14 Chấm Công – Attendance

Hệ thống tự động xác định giờ làm việc của nhân viên dựa trên dữ liệu hoạt động thực tế, không cần nhân viên bấm vào/ra.

Thông tin	Mô tả
Giờ vào làm	Thời điểm có hoạt động đầu tiên trong ngày
Giờ tan ca	Thời điểm hoạt động cuối cùng trong ngày
Tổng giờ làm việc	Tổng thời gian từ vào đến ra trừ đi thời gian vắng mặt
Số ngày làm trong tháng	Đếm tổng số ngày có hoạt động trong tháng chọn
Lịch chấm công	Bảng theo dạng lịch tháng, màu sắc thể hiện trạng thái từng ngày

Chức năng chấm công hỗ trợ lọc theo từng thiết bị hoặc xem tổng hợp để xuất báo cáo nhân sự hàng tháng.

3.15 Tệp Tin – File Activity

Ghi lại mọi thao tác với tệp tin trên máy nhân viên, bao gồm tạo mới, mở, chỉnh sửa, xóa, sao chép và đổi tên.

Loại hành động	Mô tả
Mở (open)	Nhân viên mở file để đọc hoặc chỉnh sửa
Chỉnh sửa (edit)	Nội dung file được thay đổi
Tạo mới (create)	File hoặc thư mục mới được tạo
Xóa (delete)	File bị xóa khỏi hệ thống
Sao chép (copy)	File được sao chép sang vị trí khác
Di chuyển (move)	File được di chuyển hoặc đổi tên

Mỗi sự kiện lưu kèm: đường dẫn đầy đủ, tên tiến trình thực hiện, tên người dùng, kích thước file và thời gian.

Tính năng theo dõi tệp tin có thể cấu hình đường dẫn giám sát cụ thể trong file cấu hình Agent để tập trung vào các thư mục quan trọng như Documents, Desktop, USB.

3.16 Cảnh Báo – Alerts

Hệ thống cảnh báo tự động phát hiện vi phạm theo thời gian thực dựa trên danh sách chặn đã cấu hình.

Các loại cảnh báo

Trang web bị cấm Nhân viên truy cập website nằm trong danh sách chặn
Ứng dụng bị cấm Phần mềm không được phép đang được chạy trên máy
Tệp tin nhạy cảm Thao tác với file khớp mẫu đường dẫn trong danh sách
Từ khoá nhạy cảm Từ khoá bị cấm xuất hiện trong nhật ký phím

Mỗi cảnh báo lưu đầy đủ thông tin: tên máy, thời gian, loại vi phạm, nội dung cụ thể, mức độ nghiêm trọng (Thấp / Trung / Cao / Nghiêm trọng). Quản trị viên xác nhận đã xử lý bằng cách nhấn "Ghi nhận" (Acknowledge).

Cảnh báo mới xuất hiện ngay lập tức trên giao diện qua WebSocket, có thể xem chi tiết mà không cần tải lại trang.

3.17 Bảo Mật Dữ Liệu – Data Security

Màn hình tổng hợp chuyên về các sự kiện liên quan đến an toàn thông tin.

Tổng hợp cảnh báo vi phạm theo mức độ: thống kê số lượng cảnh báo Nghiêm trọng, Cao, Trung, Thấp.
Danh sách các thiết bị có nhiều vi phạm nhất.
Biểu đồ xu hướng vi phạm theo ngày trong tháng.
Lọc, tìm kiếm và xuất báo cáo bảo mật.

3.18 Dự Án – Projects

Quản lý và phân nhóm các thiết bị theo dự án hoặc bộ phận.

Tạo dự án mới với tên, màu sắc nhận dạng và mô tả.
Gán thiết bị vào dự án để nhóm theo bộ phận (Kế toán, IT, Kinh doanh...).
Xem báo cáo tổng hợp năng suất, thời gian làm việc theo từng dự án.
Quy tắc tự động: gán hoạt động vào dự án dựa theo tên ứng dụng hoặc tiêu đề cửa sổ.

3.19 Đồng Hồ Bấm Giờ – Stopwatch

Công cụ bấm giờ tích hợp cho phép quản trị viên hoặc nhân viên tự theo dõi thời gian thực hiện một nhiệm vụ cụ thể.

Bắt đầu, dừng, tiếp tục và đặt lại bộ đếm thời gian.
Lưu lịch sử phiên làm việc kèm ghi chú mô tả.
Có thể liên kết với dự án để tích hợp vào báo cáo thời gian dự án.

3.20 Cài Đặt – Settings

Cấu hình toàn bộ hệ thống theo nhu cầu của tổ chức.

Nhóm cài đặt	Nội dung
Giao diện	Giao diện sáng / tối, ngôn ngữ, múi giờ
Thời gian vắng mặt	Ngưỡng giây không hoạt động trước khi coi là AFK
Chụp màn hình	Bật/tắt, khoảng thời gian chụp tự động
Keylogger	Bật/tắt tính năng ghi nhật ký phím trên từng thiết bị
Theo dõi tệp tin	Bật/tắt, cấu hình đường dẫn cần theo dõi
Theo dõi trình duyệt	Bật/tắt theo dõi lịch sử trình duyệt
Thông báo	Cấu hình loại cảnh báo cần hiển thị
Tài khoản	Đổi mật khẩu quản trị viên

4. Tác Nhân Giám Sát – QuangPulse Agent

QuangPulse Agent (QuangPulse.exe) là phần mềm cài đặt trên máy nhân viên. Chạy nền hoàn toàn, không hiển thị cửa sổ, không cần người dùng thao tác.

Dữ liệu Agent thu thập và gửi về máy chủ

Loại dữ liệu	Tần suất gửi	Mô tả
Cửa sổ đang dùng	Mỗi 2 giây	Tên app, tiêu đề cửa sổ, PID, đường dẫn file .exe
Trạng thái AFK	Mỗi 2 giây	Đang hoạt động hay vắng mặt dựa theo input cuối
Tài nguyên hệ thống	Mỗi 10 giây	CPU%, RAM%, đĩa cứng, băng thông mạng, pin
Tiến trình đang chạy	Mỗi 60 giây	Top 25 tiến trình theo CPU/RAM
Lịch sử trình duyệt	Mỗi 15 giây	URL và tiêu đề từ Chrome, Edge, Firefox
Nhật ký phím	Mỗi 30 giây	Văn bản đã gõ, chỉ gửi khi hoàn thành từ/câu
Thao tác tệp tin	Mỗi 6 giây	Các sự kiện tạo/sửa/xóa/copy file
Ảnh chụp màn hình	Mỗi 3 phút	Ảnh JPEG nén, chỉ khi không vắng mặt
Thông tin hệ thống	Khi khởi động	Tên máy, OS, CPU, RAM, màn hình

Agent sử dụng rất ít tài nguyên hệ thống: CPU trung bình dưới 1%, RAM dưới 30MB. Toàn bộ dữ liệu gửi qua HTTP, có thể cấu hình HTTPS cho môi trường bảo mật cao.

5. Hệ Thống Cảnh Báo & Danh Sách Chặn

Danh sách chặn (Blocklist) là tập hợp các quy tắc giúp hệ thống tự động phát hiện vi phạm. Quản trị viên tự cấu hình theo chính sách của tổ chức.

Loại chặn	Ví dụ mẫu	Áp dụng cho
Trang web (website)	facebook.com, tiktok.com, .\.onlyfans\..	Hoạt động trình duyệt
Ứng dụng (app)	game.exe, telegram.exe, vlc.exe	Cửa sổ đang mở
Tệp tin (file)	.\.mp4$, D:\\phim\\.	Hoạt động file
Từ khoá (keyword)	nghỉ việc, bỏ cty, mật khẩu	Nhật ký phím

Mỗi quy tắc hỗ trợ Regular Expression, cho phép viết mẫu linh hoạt. Ví dụ: .*\.gambling\..* sẽ chặn mọi trang cờ bạc dù tên miền bất kỳ.

Mức độ nghiêm trọng

Thấp Thông tin, cần theo dõi thêm
Trung bình Cần xem xét và nhắc nhở
Cao Vi phạm nghiêm trọng, cần xử lý ngay
Nghiêm trọng Nguy cơ bảo mật hoặc vi phạm pháp luật

6. Bảo Mật & Quyền Truy Cập

Toàn bộ giao diện web yêu cầu đăng nhập bằng tài khoản quản trị viên.
Phiên đăng nhập được bảo vệ bằng JWT Token, tự động hết hạn.
Mỗi thiết bị Agent xác thực bằng token riêng biệt, được tạo tự động khi đăng ký.
Giao diện web chặn hoàn toàn truy cập từ thiết bị di động (điện thoại, máy tính bảng).
Dữ liệu ảnh chụp màn hình và keylog chỉ hiển thị cho tài khoản quản trị có quyền.
Toàn bộ dữ liệu lưu nội bộ trong MongoDB, không gửi ra ngoài internet.

7. Hướng Dẫn Sử Dụng Cho Quản Trị Viên

7.1 Đăng Nhập Hệ Thống

Mở trình duyệt trên máy tính và truy cập địa chỉ IP máy chủ, cổng 8001 (ví dụ: http://192.168.1.10:8001).

Nhập tên đăng nhập và mật khẩu quản trị viên vào form đăng nhập.

Sau khi xác thực thành công, hệ thống chuyển vào Dashboard chính.

7.2 Xem Trạng Thái Máy Nhân Viên

Nhìn vào thanh bên trái (Sidebar) – chỉ số X/Y máy đang online cho biết số thiết bị đang kết nối.

Vào menu Giám sát trực tiếp để xem chi tiết từng máy theo thời gian thực.

Nhấn vào tên máy cụ thể để xem ứng dụng đang dùng, URL đang mở và ảnh chụp màn hình gần nhất.

7.3 Xem Lịch Sử Hoạt Động

Chọn menu Dòng thời gian hoặc Cửa sổ từ thanh bên.

Dùng bộ lọc ở đầu trang để chọn ngày, khoảng ngày và tên máy cần xem.

Dữ liệu tự động tải và hiển thị theo bộ lọc đã chọn.

7.4 Quản Lý Cảnh Báo

Khi có cảnh báo mới, biểu tượng chuông trong Sidebar hiển thị số lượng chưa xử lý.

Vào menu Cảnh báo để xem danh sách đầy đủ.

Nhấn nút Ghi nhận (Acknowledge) vào từng cảnh báo sau khi đã xem xét và xử lý.

Dùng bộ lọc theo mức độ nghiêm trọng, loại vi phạm và tên máy để tìm nhanh.

7.5 Cấu Hình Danh Sách Chặn

Vào Bảo mật dữ liệu → tab Danh sách chặn.

Nhấn Thêm quy tắc, chọn loại (Website / Ứng dụng / Tệp tin / Từ khoá).

Nhập mẫu khớp (có thể dùng Regex) và chọn mức độ nghiêm trọng.

Nhấn Lưu. Quy tắc có hiệu lực ngay lập tức, áp dụng cho toàn bộ thiết bị đang kết nối.

7.6 Xem Báo Cáo Chấm Công

Vào menu Chấm công từ thanh bên.

Chọn thiết bị (hoặc "Tất cả") và chọn tháng cần xem.

Bảng lịch tháng hiển thị màu sắc: xanh là có đi làm, xám là vắng.

Nhấn vào từng ngày để xem giờ vào, giờ ra và tổng thời gian làm việc.

7.7 Xem Nhật Ký Phím

Vào menu Nhật ký phím.

Lọc theo tên máy và khoảng ngày cần tra cứu.

Dùng ô tìm kiếm để lọc theo từ khoá cụ thể trong nội dung.

Mỗi dòng hiển thị: thời gian, tên máy và đoạn văn bản đã gõ.

8. Hướng Dẫn Cài Đặt Agent Trên Máy Nhân Viên

8.1 Yêu Cầu Hệ Thống

Hệ điều hành: Windows 10 / 11 (64-bit)
RAM: Tối thiểu 4GB
Kết nối mạng nội bộ tới máy chủ QuangPulse
Quyền Administrator để cài đặt

8.2 Cài Đặt Và Khởi Động

Sao chép file QuangPulse.exe và config.json vào cùng một thư mục trên máy nhân viên (ví dụ: C:\QuangPulse\).

Mở file config.json bằng Notepad, điền địa chỉ IP máy chủ vào trường "server_url". Ví dụ: "server_url": "http://192.168.1.10:8001".

Chạy QuangPulse.exe với quyền Administrator lần đầu tiên. Agent sẽ tự đăng ký thiết bị với máy chủ và tạo token xác thực.

Thiết lập tự khởi động cùng Windows: vào Task Scheduler → tạo Task mới → Action: chạy QuangPulse.exe → Trigger: At log on.

8.3 Xác Nhận Kết Nối Thành Công

Sau 10-15 giây kể từ khi chạy Agent, đăng nhập vào giao diện web quản trị.

Vào Giám sát trực tiếp – thiết bị vừa cài đặt sẽ xuất hiện với trạng thái Online.

Chỉ số X/Y máy đang online ở Sidebar sẽ tăng lên.

8.4 Tùy Chỉnh Cấu Hình Agent

Tham số config.json	Mặc định	Mô tả
server_url	–	Địa chỉ máy chủ QuangPulse (bắt buộc điền)
device_name	Tên máy tính	Tên hiển thị trên giao diện quản trị
afk_timeout	180 (giây)	Thời gian không hoạt động trước khi coi là vắng mặt
screenshot_enabled	true	Bật/tắt chụp màn hình tự động
screenshot_interval	180 (giây)	Khoảng thời gian giữa các lần chụp màn hình
keylog_enabled	true	Bật/tắt nhật ký phím
keylog_flush_interval	30 (giây)	Tần suất gửi dữ liệu keylog về máy chủ
file_watch_enabled	true	Bật/tắt theo dõi tệp tin
web_watch_enabled	true	Bật/tắt theo dõi lịch sử trình duyệt
verify_ssl	true	Xác minh chứng chỉ SSL (đặt false nếu dùng self-signed)

Sau khi chỉnh sửa config.json, cần khởi động lại QuangPulse.exe để áp dụng thay đổi.

9. Câu Hỏi Thường Gặp

Máy nhân viên hiển thị Offline dù Agent đang chạy?

Kiểm tra kết nối mạng từ máy nhân viên tới máy chủ. Thử mở Command Prompt và ping địa chỉ IP máy chủ. Đảm bảo cổng 8001 không bị tường lửa chặn. Xem lại trường server_url trong config.json có đúng địa chỉ không.

Ảnh chụp màn hình không hiển thị?

Kiểm tra screenshot_enabled: true trong config.json. Agent chỉ chụp màn hình khi nhân viên không vắng mặt. Nếu nhân viên để máy nhưng không dùng, sẽ không có ảnh mới.

Keylog không ghi tiếng Việt đúng?

Đảm bảo đang sử dụng phiên bản Agent mới nhất (QuangPulse 2.0+). Phiên bản mới đã xử lý đầy đủ các ký tự tiếng Việt đặc biệt (đ, ơ, ư và tất cả dấu thanh điệu).

Cảnh báo xuất hiện quá nhiều?

Vào Danh sách chặn và xem lại các quy tắc. Điều chỉnh mức độ nghiêm trọng hoặc thu hẹp mẫu Regex để giảm false positive. Có thể xóa bớt quy tắc quá rộng.

Làm thế nào để thêm thiết bị mới?

Chỉ cần cài đặt Agent trên máy mới theo hướng dẫn mục 8. Agent tự đăng ký, không cần thao tác gì trên giao diện web. Thiết bị sẽ xuất hiện tự động sau vài giây.

Dữ liệu lưu trữ bao lâu?

Mặc định dữ liệu không tự xóa. Quản trị viên có thể cấu hình MongoDB Time-To-Live (TTL) hoặc xóa thủ công qua giao diện quản lý database nếu cần giải phóng dung lượng.

Giao diện web hiển thị "Không hỗ trợ thiết bị di động"?

Đây là tính năng bảo mật chủ động. Hệ thống QuangPulse chỉ hỗ trợ truy cập từ máy tính để bàn hoặc laptop. Vui lòng dùng trình duyệt Chrome, Edge hoặc Firefox trên máy tính.