Skip to main content

Designations and Job Roles

Summary

An HR designation describes an employee’s organizational position. It is separate from recruitment titles and from Identity/application roles used for authorization.

Audience

  • Tenant administrators and implementation partners
  • Developers, QA engineers, architects, security engineers, and product owners

Purpose

This distinction prevents organization master data from granting application access implicitly.

Architecture

Business concepts

ConceptConfirmed purposeOwning boundaryRelationshipStatus
DesignationTenant-scoped workforce master with name, code, optional department, grade, level, and active stateEmployee ServiceAssigned to employees; optionally associated with a departmentImplemented
Job titleTitle on recruitment requisition or position recordsMonolith recruitment compatibilityMay be selected alongside department/designation, but is not the extracted Employee designationTransitional
Application roleNamed role associated with a user/account and UI/access behaviorIdentity and monolith compatibilityMay group permissions; does not define HR positionImplemented / Transitional
Permission roleAuthorization grouping that grants permission claims or keysIdentity and application authorizationControls access, not organization placementImplemented / Transitional

Technical implementation

Designation name and code are required, and code is unique per tenant. A designation may reference a department, grade, and numeric level and can be active or inactive. Employee creation validates that an assigned designation exists and is active; when both department and designation are supplied and the designation is department-specific, they must agree.

Extracted Designation Service deactivates a designation for its delete operation. Unlike extracted department deactivation, it does not currently reject deactivation because active employees reference it. The monolith rejects physical deletion while referenced, so final lifecycle parity is Transitional.

Recruitment models reference departments and designations and also store separate position/requisition titles. No reviewed integration event proves automatic designation synchronization into recruitment or performance services; those linkages Require confirmation.

Source References

  • microservices/src/employee-service/Domain/Organization/Organization.cs
  • microservices/src/employee-service/Application/Organization/Organization.cs
  • microservices/src/employee-service/Application/Validators/EmployeeCommandValidators.cs
  • microservices/src/employee-service/Domain/Employees/Employee.cs
  • Controllers/DesignationsController.cs
  • Models/Designation.cs
  • Models/JobPosition.cs
  • Models/JobRequisition.cs
  • Controllers/RecruitmentController.cs
  • microservices/src/identity-service/Domain/Entities/Role.cs

See Also

Keywords

  • HR designation
  • Recruitment title
  • Security role
  • Permission role

Revision Information

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