Skip to main content

Employee Organization Assignment UI

Summary​

The Job Details step provides optional department, designation, and reporting-manager selectors backed by lookup requests.

Audience​

  • HR administrators, frontend/backend developers, QA engineers, and architects

Purpose and navigation path​

Add or edit an employee from People → Employees, then open Job Details.

Confirmed controls​

Department options are limited to active departments in the form. Designations are limited to active values and narrowed to the selected department when the designation has a department association. Changing department clears the selected designation. Reporting managers come from active users; during edit, entries linked to the current employee are filtered from the selector. Every selector supports an unassigned value.

Validation​

The UI does not display dedicated inline organization errors. Employee Service validators require referenced departments/designations/managers to exist and be active, enforce designation/department consistency during create, and reject self-management. The active monolith service remains the current runtime authority, so exact parity Requires confirmation.

Success, error, and downstream expectations​

Assignment fields are included in the create/update payload. Save success follows the common modal behavior. Failures appear in the page-level error. Dedicated ManagerChanged/DepartmentChanged event behavior belongs to the extracted service and is not assumed for current monolith UI traffic.

Permission behavior and API dependencies​

Lookups fall back to empty arrays if their requests fail, which can look like “no options.” Route and mutation authorization follow the shared Employee controls.

Screenshot placeholder​

Screenshot placeholder: Job Details selectors using synthetic organization labels.

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/App.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/pages/Labor.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
  • microservices/src/employee-service/Application/Validators/EmployeeCommandValidators.cs
  • microservices/src/employee-service/Domain/Employees/Employee.cs

See Also​

Keywords​

  • department selector
  • designation selector
  • manager selector

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly