Quản trị (web Admin)

Bảng chấm công & wifi chấm công

Bảng chấm công

Menu Ca & chấm công → Bảng chấm công. Chọn kỳ lương (tháng kết thúc kỳ — kỳ 26 → 25, vd kỳ 01/2027 = 26/12 – 25/01; khoảng ngày hiện cạnh ô chọn) và khu.

Mỗi hàng là một nhân viên, mỗi ô là một ngày:

  • số giờ công (vd 7,5);
  • ô vàng: đi muộn / về sớm / quên check-out — đã trừ phần có yêu cầu đi muộn / về sớm được duyệt;
  • V (đỏ): vắng — có ca đã công bố mà không chấm công và không có nghỉ phép được duyệt;
  • P: nghỉ được duyệt (có lương); KL: nghỉ không lương;
  • L (xanh lá): ngày lễ;
  • dấu +: có tăng ca được duyệt (rê chuột để xem số giờ);
  • dấu *: lượt chấm công đã được sửa.

Các cột cuối là tổng ngày công, giờ công, số lần và số phút muộn / về sớm, số ngày vắng, nghỉ phép (trong ngoặc: số ngày không lương), Tăng ca (giờ tăng ca tính lương — rê chuột xem tách ngày thường / ngày nghỉ / lễ và giờ đã đổi nghỉ bù) và Lễ (giờ làm vào ngày lễ).

Bấm vào một ô để xem từng lượt chấm công (giờ vào/ra, cách chấm, ảnh check-in/out nếu có). Cửa hàng trưởng / Giám đốc bấm Sửa giờ, nhập giờ đúng và lý do — hệ thống tính lại muộn/sớm/giờ công theo ca và ghi người sửa.

Bấm Excel (hoặc CSV) để tải bảng công cho kế toán.

Giới hạn số yêu cầu đi muộn / về sớm / ra ngoài mỗi tháng của một nhân viên: Cài đặt tham số → attendance.late_early_requests_per_month (0 = không giới hạn). Số lần đi muộn không bị phạt mỗi tháng: payroll.late_free_count (mặc định 3).

Màn hình chấm công QR

Từ 17/10/2026 nhân viên chấm công bằng mã QR trên điện thoại (không cần app):

  1. Thiết bị → Thêm thiết bị, loại Tablet chấm công, lấy mã kích hoạt 6 số.
  2. Trên tablet / TV đặt tại quán mở trang màn hình TV, thêm /cham-cong vào cuối địa chỉ (vd http://<máy chủ>:13003/cham-cong), nhập mã kích hoạt. Màn hình hiện mã QR đổi mỗi 30 giây (attendance.qr_seconds) và đồng hồ.
  3. Nhân viên quét mã → đăng nhập tài khoản của mình → vào / ra ca. Lượt chấm công có cách chấm QR, gắn ca đã công bố và tính đi muộn / về sớm như các cách khác; không có ca → cờ ngoài lịch chờ quản lý xác nhận.

Máy chủ chặn: mã hết hạn, mã giả, mã chi nhánh khác (nhân viên chưa được gán chi nhánh đó), dùng lại cùng một mã. Quét lại trong attendance.qr_min_minutes phút (mặc định 10) sau khi vào ca không tính là ra ca.

Wifi chấm công

Menu Ca & chấm công → Wifi chấm công: khai báo tên wifi và BSSID của từng router trong quán. Nhân viên chỉ check-in/out được bằng app khi điện thoại bắt đúng router đã khai báo.

Khi nhân viên gặp wifi trùng tên quán nhưng router lạ (vd vừa thay router), trang hiện cảnh báo. Bấm Thêm router này nếu đó đúng là router của quán.

Chấm công từ xa bằng GPS

Dùng cho nhân viên làm việc ngoài quán (đi chợ, giao hàng…):

  1. Đặt vị trí chi nhánh: Thiết lập → Chi nhánh → Sửa → ô Vị trí — dán tọa độ từ Google Maps (nhấn giữ vị trí quán, chép dòng số dạng 12.238791, 109.196749) hoặc bấm Vị trí hiện tại khi đang đứng ở quán.
  2. Bật cho từng người: hồ sơ nhân viên → tab Công việc → tích Cho chấm công từ xa bằng GPS → Lưu. Người chưa được bật vẫn chấm bằng wifi quán.
  3. Bán kính hợp lệ mặc định 150 m quanh chi nhánh (Cài đặt tham số → attendance.gps_radius_m).
  4. Chấm xa hơn bán kính vẫn được ghi nhưng gắn nhãn Ngoài vị trí — chờ duyệt. Mở ô ngày trong Bảng công để xem khoảng cách, độ chính xác GPS và link bản đồ → bấm Duyệt vị trí nếu hợp lệ (hoặc sửa giờ như thường).
← Tổng quan & báo cáo kháchThu chi & sổ quỹ →