App 10 – Lương
Hướng: Bổ sung vào hrm · Đợt: Song song (backlog hrm) · Phụ thuộc: App 4
Quy ước chung, nguồn dữ liệu nhân viên và cách chạy builder: 00-tong-quan.md
Mục đích: tính lương theo kỳ cho từng nhân viên từ mức lương, giờ làm đã duyệt, thưởng và khấu trừ; chốt bảng lương và phát phiếu lương. Tài liệu Gauzy về lương khá mỏng (Payroll Overview), nên phần quy trình chốt kỳ dưới đây là đề xuất. VENI đã có app payroll: nên đối chiếu trước khi xây.
Hướng: bổ sung vào hrm. Bảng lương đang nằm trong hrm (hồ sơ lương, pay run, dòng pay run, phụ cấp, phúc lợi, chính sách tăng ca, chấm công). Repo payroll chỉ là khung trống, không nên xây ở đó. Cần đối chiếu và thêm: lương theo giờ lấy từ timesheet App 4, hoa hồng, tính lương theo ngày làm thực tế khi vào hoặc nghỉ giữa kỳ.
Vai trò & quyền
| Vai trò | Được làm |
|---|---|
| Kế toán lương | Thiết lập mức lương, tạo kỳ lương, nhập thưởng/khấu trừ, tính và gửi duyệt |
| Giám đốc / Quản trị | Duyệt và chốt kỳ lương; xem báo cáo chi phí lương |
| Nhân viên | Chỉ xem phiếu lương đã chốt của mình |
Dữ liệu
| Thực thể | Trường | Ghi chú |
|---|---|---|
| Mức lương | nhân viên, kiểu (Cố định theo tháng, Theo giờ, Hoa hồng, Hỗn hợp lương cứng + hoa hồng), lương cơ bản, đơn giá giờ, tỉ lệ hoa hồng (%), tiền tệ, kỳ trả (Tuần, 2 tuần, Tháng), hiệu lực từ ngày | Giữ lịch sử khi đổi mức |
| Kỳ lương | từ ngày, đến ngày, trạng thái, người duyệt, ngày chốt, tổng chi (tự tính) | |
| Khoản cộng/trừ | kỳ, nhân viên, loại (Thưởng, Phụ cấp, Khấu trừ, Bảo hiểm, Thuế), số tiền, ghi chú | |
| Phiếu lương | kỳ, nhân viên, giờ thường, giờ tăng ca, lương cơ bản, tiền tăng ca, hoa hồng, tổng cộng thêm, tổng khấu trừ, lương gộp, lương thực nhận | Tự tính |
Trạng thái kỳ lương
Nháp → Đã tính → Chờ duyệt → Đã chốt. Từ Chờ duyệt có thể Trả lại (về Đã tính) kèm lý do.
Quy tắc nghiệp vụ
- Lương gộp = lương cơ bản + tiền tăng ca + hoa hồng + các khoản cộng; thực nhận = lương gộp − các khoản trừ.
- Theo giờ: lương cơ bản = giờ thường × đơn giá; tiền tăng ca = giờ tăng ca × đơn giá × 1,5. Giờ tăng ca là phần vượt giờ chuẩn mỗi tuần (mặc định 40).
- Giờ làm chỉ lấy từ timesheet Đã duyệt của App 4 nằm trong kỳ.
- Hoa hồng = doanh thu do nhân viên mang lại trong kỳ × tỉ lệ (doanh thu lấy từ App 9).
- Dùng mức lương có hiệu lực tại ngày đầu kỳ; nhân viên vào hoặc nghỉ giữa kỳ thì lương cố định tính theo số ngày làm thực tế.
- Các kỳ lương không chồng ngày; kỳ Đã chốt không sửa được và không tính lại.
- Người duyệt không được là người đã tính lương kỳ đó.
- Nhân viên chỉ thấy phiếu lương của chính mình và chỉ sau khi kỳ Đã chốt.
Màn hình
| Màn hình | Nội dung |
|---|---|
| Mức lương | Danh sách nhân viên và mức hiện hành; lịch sử thay đổi |
| Kỳ lương | Danh sách kỳ; tạo kỳ; Tính lương; Gửi duyệt; Duyệt / Trả lại |
| Bảng lương kỳ | Mỗi dòng một nhân viên với các cột phiếu lương; nhập khoản cộng/trừ; xuất Excel |
| Phiếu lương của tôi | Các kỳ đã chốt, xem và tải PDF |
| Báo cáo | Tổng chi lương theo kỳ, theo phòng ban; tăng ca theo nhân viên |
Prompt tham khảo
Khuyến nghị đội dev làm trực tiếp trong repo hrm: builder mở được repo có sẵn nhưng việc chạy migration cho app có database được nhập vào chưa được thiết kế xong. Prompt dưới đây mô tả đầy đủ nghiệp vụ, dùng để đối chiếu với hrm và lập backlog; chỉ làm phần còn thiếu nêu ở dòng Hướng.
Tôi cần app tính lương có phân quyền, lưu trong database.
Dữ liệu: mức lương theo nhân viên (kiểu cố định/theo giờ/hoa hồng/hỗn hợp, lương
cơ bản, đơn giá giờ, tỉ lệ hoa hồng, hiệu lực từ ngày), kỳ lương (từ ngày, đến
ngày, trạng thái Nháp/Đã tính/Chờ duyệt/Đã chốt), khoản cộng trừ (thưởng, phụ cấp,
khấu trừ, bảo hiểm, thuế) và phiếu lương (giờ thường, giờ tăng ca, lương gộp, thực nhận).
Phân quyền: kế toán lương thiết lập và tính lương; giám đốc duyệt và chốt kỳ,
không phải người đã tính; nhân viên chỉ xem phiếu lương của mình sau khi chốt.
Quy tắc: thực nhận = lương gộp trừ các khoản trừ; theo giờ thì tăng ca là phần vượt
40 giờ mỗi tuần và tính hệ số 1,5; vào hoặc nghỉ giữa kỳ thì lương cố định tính theo
ngày làm thực tế; kỳ lương không chồng ngày; kỳ đã chốt không sửa được.
Màn hình: mức lương có lịch sử, danh sách kỳ lương, bảng lương kỳ có xuất Excel,
phiếu lương của tôi, báo cáo chi lương theo phòng ban.