Phòng ban (Departments)

TLDR

Một Department có tên, mã (code), người đứng đầu (head_person_id — 1 nhân viên) và có thể có department cha (parent_department_id) để tạo cây tổ chức. Ai là head của một phòng ban quyết định họ có thấy/duyệt nghỉ phép cho phòng đó hay không (leave.approve.dept). Việc gán nhân viên vào phòng ban thực hiện ở hồ sơ nhân viên, không phải ở trang Departments.

Danh sách phòng ban

Trang Phòng ban hiển thị mỗi department dưới dạng 1 card, không phải cây lồng nhau — dù schema có parent_department_id để tự tham chiếu, UI hiện tại render phẳng theo danh sách. Mỗi card có:

Tên + mô tả

name, description, cùng màu/icon tuỳ chỉnh cho card (color, icon).

2 chỉ số

member_count (số nhân viên) và avg_tenure_months (thâm niên trung bình) — hai số này do backend tính sẵn khi trả list, không phải field lưu trong hr_departments.

Người đứng đầu (Head)

Avatar + tên head, click vào để mở thẳng hồ sơ nhân viên đó (/hr/employees/:id). Nếu chưa gán head, hiển thị “chưa có”.

Menu ⋮

Sửa hoặc xoá department. Xoá một department còn thành viên sẽ bị chặn (lỗi DEPT_HAS_MEMBERS) — phải chuyển hết nhân viên sang phòng khác trước.

Tạo / sửa phòng ban

Nút Tạo phòng ban (yêu cầu quyền hr:create) mở modal dùng field-registry (FormRoot + useHrFieldRegistry(['hr_departments'])), chỉ hiện đúng 5 field:

name, code, description, head_person_id, parent_department_id

name là bắt buộc; các field còn lại tuỳ chọn. head_person_id/parent_department_id là dropdown M2O — chọn từ danh sách hr_people/hr_departments hiện có.

Gán nhân viên vào phòng ban

Không có thao tác “thêm thành viên” trên trang Departments. Field department_id nằm trên hr_people, nên việc gán/đổi phòng ban của một người luôn thực hiện từ phía hồ sơ nhân viên (form Employee) — xem Nhân viên (Employees). Trang Departments chỉ đọc ngược để đếm member_count và hiển thị head.

Department làm head → mở khoá quyền duyệt nghỉ phép theo phòng

Theo PERMISSIONS.md, policy Dept Manager có action leave.approve.dept — chỉ duyệt được leave request của nhân viên thuộc phòng ban mà họ đứng đầu. Cơ chế resolve:

1. Tìm hr_people record của user hiện tại qua hr_people.user_id.
2. Tìm các hr_departments có head_person_id = person đó.
3. Mọi GET /people và GET /leave/requests tự động lọc theo các phòng ban tìm được ở bước 2.

Không link user → không thấy gì

Nếu chưa gán hr_people.user_id cho người được đặt làm head, một user có policy Dept Manager sẽ thấy danh sách rỗng — không phải lỗi quyền, mà vì hệ thống không resolve được “họ là head của phòng nào”. Gán link bằng cách sửa head person và chọn tài khoản ODP tương ứng, hoặc POST /api/hr/people/:id/link-user { user_id }.

Đọc tiếp

• Nhân viên (Employees) — nơi thực sự gán department_id cho một người
• Nghỉ phép (Leave) — duyệt leave request theo phạm vi phòng ban
• Khái niệm cốt lõi — glossary đầy đủ các thực thể HR