KPI — Tính năng¶
Ai dùng: nhân viên (tự đánh giá — xem TT nhân sự › KPI cá nhân), quản lý (chấm, duyệt), HR (tiêu chí, đối tượng), Ban Giám đốc.
Đường vào: /app › Rail Nhân sự › nhóm KPI.
| Mục menu | Quyền |
|---|---|
| KPI Công ty | Cột Báo cáo KPI (KPI_VIEW) hoặc Super Admin |
| KPI Phòng ban › Bảng đánh giá KPI | KPI_VIEW |
| KPI Phòng ban › Báo cáo KPI Phòng ban | KPI_VIEW |
| Cài đặt KPI | Hiện chỉ Tùng (chưa có ô quyền) |
KPI_VIEW không mặc định cho Admin — phải tick (ADMIN_NEEDS_EXPLICIT_TICK_). Phạm vi bên trong module (toàn công ty / phòng ban / cá nhân) do kpiIsAdmin_ trong legacy/gas/Kpi.js quyết định.
1. KPI Công ty¶
Dashboard toàn công ty (LarkCompanyTab, số từ useCompanyAnalytics): kết quả KPI theo tháng, theo khối/phòng. RPC getKpiWorkspace.
2. KPI Phòng ban¶
Bố cục: danh sách phòng bên trái, chi tiết bên phải (Bộ lọc → Dashboard → Bảng nhân sự).
Quản lý chấm KPI cho nhân viên:
1. Chọn tháng, chọn phòng ban, mở Bảng đánh giá KPI.
2. Mở phiếu của từng nhân viên (phiếu chấm KpiDeptScorecard). Xem cột NV tự đánh giá và tài liệu tham chiếu.
3. Nhập Quản lý đánh giá và Ghi chú đánh giá cho từng tiêu chí (saveKpiManagerRows). Hệ thống tính Kết quả, % HT, Điểm.
4. Bấm gửi báo cáo của quản lý (submitKpiManagerReport). Khối ký: Nhân viên → Quản lý trực tiếp → Ban Giám đốc ("[BOD duyệt]").

Báo cáo KPI Phòng ban: tổng hợp điểm, xếp loại của phòng.
3. Cài đặt KPI (HR)¶
Bố cục Bộ lọc → Dashboard → Bảng tiêu chí (LarkSettingsTab). HR sửa tiêu chí (saveKpiCriteria) và đối tượng áp dụng (saveKpiEligibility). Hiện chỉ Tùng thấy mục này trên giao diện mới.
4. Lưu và xung đột¶
Thay đổi giữ ở hàng đợi trên trình duyệt (anna_kpi_outbox_v1) tới khi máy chủ xác nhận; lỗi thì giữ chữ và thử lại. Lỗi đang mở (sổ sản phẩm): "file KPI trên Base không hiện; KPI cá nhân không lưu được kết quả và tài liệu" — trạng thái hiện tại: cần xác nhận.
5. Tự động¶
| Job | Lịch (VN) | Việc |
|---|---|---|
runKpiMonthlySeed |
02:00 (chỉ ngày 1) | Seed bảng 1.3 tháng mới |
Ảnh cần chụp¶
Portal: https://one-anna-api.tungpham-hn219.workers.dev/app (đăng nhập Lark). Ảnh đặt vào thư mục images/ của module này, đúng tên file. Che (làm mờ) số tiền lương, CCCD, số tài khoản, số điện thoại khách hàng trước khi đưa vào tài liệu.
| File | Nội dung | Đường dẫn / thao tác | Vai trò đăng nhập | Trạng thái cần chụp |
|---|---|---|---|---|
images/kpi-cong-ty.png |
KPI Công ty | https://one-anna-api.tungpham-hn219.workers.dev/app › Nhân sự › KPI › KPI Công ty | BOD hoặc HR có ô Báo cáo KPI | Tháng trước, toàn công ty |
images/kpi-phong-ban.png |
KPI Phòng ban — danh sách + chi tiết | https://one-anna-api.tungpham-hn219.workers.dev/app › Nhân sự › KPI › KPI Phòng ban › Bảng đánh giá KPI | Quản lý phòng có ô Báo cáo KPI | Đã chọn 1 phòng |
images/kpi-phieu-cham.png |
Phiếu chấm KPI của quản lý | https://one-anna-api.tungpham-hn219.workers.dev/app › KPI Phòng ban › mở phiếu 1 nhân viên | Quản lý trực tiếp | NV đã gửi tự đánh giá, QL chưa chấm |
images/kpi-cai-dat.png |
Cài đặt KPI | https://one-anna-api.tungpham-hn219.workers.dev/app › Nhân sự › KPI › Cài đặt KPI | Tùng (canary) | Danh sách tiêu chí |