Departments & Sub-Departments Management

The Departments Module (/departments) in Work Clock HQ provides workspace administrators with powerful organizational controls to structure divisions, establish specialized sub-teams, manage staff allocations, and delegate supervisory oversight.

---

🧭 Main Department Directory (/departments)

Navigating to Departments from the main navigation sidebar displays your organization's operational units in an interactive card grid:

• Department Cards: Each card displays the department title (e.g. Engineering, Operations, Sales), total assigned staff count (staff_count), and quick links to manage or view department details.
• Workforce Strength Indicators: Provides real-time visual visibility into personnel distribution across your company.

---

➕ Provisioning & Editing Departments

Clicking + Add Department from the header or toolbar opens the department configuration modal:

1. Department Name: Enter a clear, descriptive title for the organizational unit (e.g., Engineering, Operations, Customer Support, Finance).
2. Description: Optional summary detailing the department's operational scope and responsibilities.

---

⚠️ Department Deletion Safety Guards

To prevent accidental data loss or orphaned staff profiles, Work Clock HQ enforces strict deletion safety rules:

1. Zero User Requirement Condition: A department can only be deleted if its assigned user count is exactly zero (0 Users). If staff members are currently assigned to the department, the delete icon (Trash2) is automatically hidden or disabled. Administrators must reassign all users to another department before deletion is permitted.
2. Strict Text Confirmation: To prevent accidental clicks, deleting a department requires the administrator to manually type DELETE {department_name} into the confirmation textarea. Copy-pasting into the input field is disabled.

---

🏗️ Critical Architectural Hierarchy Conditions: Direct Users vs. Sub-Departments

To maintain clean payroll, shift, and reporting structures, Work Clock HQ enforces strict architectural hierarchy conditions between parent departments and sub-departments:

[!IMPORTANT] The Mutually Exclusive Hierarchy Condition: A department can contain EITHER direct users OR sub-departments, but NEVER both simultaneously.

🔴 Condition 1: Sub-Departments Exist Under Department

• Operational Rule: If a department has one or more sub-departments provisioned under it (e.g., Engineering has Frontend, Backend, and QA), users cannot be added directly to the top-level parent department.
• UI System Response: The + Add User button on the department detail page (/departments/view) is disabled.
• Hover Tooltip Explanation: Hovering over the disabled button displays the system guidance tooltip:

  "You cannot add a user directly to this department because it has sub-departments. Please add the user to a specific sub-department instead."

🔴 Condition 2: Direct Users Exist Under Department

• Operational Rule: If a top-level department already has users directly assigned to it, administrators cannot create sub-departments under that department.
• UI System Response: The + Add Sub-Department button is disabled.
• Hover Tooltip Explanation: Hovering over the disabled button displays the system guidance tooltip:

  "You cannot add a sub-department because this department already has users assigned directly to it. Please move them to existing sub-departments or another department first."

---

🌿 Sub-Department Management (/departments/view/sub-department)

Sub-departments allow large organizations to group specialized teams under a parent division:

1. Creating Sub-Departments: Click + Add Sub-Department within an eligible department to open the creation modal. Enter the sub-department title (e.g. Mobile Engineering, Quality Assurance).
2. Sub-Department Detail View: Navigating to a sub-department opens its dedicated hub where administrators can enroll users and monitor team attendance logs.
3. Sub-Department Deletion Safety: Deleting a sub-department similarly requires 0 Users assigned and manual confirmation typing DELETE {sub_department_name}.

---

👑 Assigning Department Heads

Leadership delegation allows organizations to empower team leads and department managers:

• Assign Department Head: Click Assign Department Head on any user row or department header to open the dialog.
• Supervisor Privileges: Designated Department Heads gain administrative oversight over their assigned department, enabling them to review team attendance logs, approve shift requests, and monitor lateness alerts.

---

🔐 Permission & RBAC Code Reference

Configuration Domain	Required Administrative Permission
View Departments & Directories	DEPARTMENTS.VIEW
Create New Departments	DEPARTMENTS.CREATE
Edit Department Details	DEPARTMENTS.UPDATE
Delete Empty Departments	DEPARTMENTS.DELETE
Create Sub-Departments	SUB_DEPARTMENTS.CREATE
Edit Sub-Departments	SUB_DEPARTMENTS.UPDATE
Delete Empty Sub-Departments	SUB_DEPARTMENTS.DELETE

---

❓ Frequently Asked Questions

Why is the + Add User button disabled on my department page?

The button is disabled because your department contains sub-departments. According to Work Clock HQ hierarchy rules, users must be added directly to one of the specific sub-departments listed under the parent department.

Why can't I create a new sub-department under my department?

You cannot add a sub-department if users are already directly assigned to the parent department. Move or reassign those users to another department or sub-department first to enable sub-department creation.

Why can't I delete a department?

Departments can only be deleted if they have zero assigned users (0 Users). Reassign all staff members to another department first to enable the delete action.