Revised Designation Master

The Revised Designation Master is used to define and manage revised designation mappings along with associated units and amounts.
This master is commonly used in payroll, deployment, and HR configurations.

Module URL

• Revised Designation Master Page
  /masters/revised-designation-master

1. Revised Designation List Page

Purpose

Displays all revised designation records and allows users to search, edit, or delete them.

Page Elements

Table Columns

• S No
• Code
• Description
• Unit
• Designation
• Amount
• Actions

Available Features

• Global search across records
• Column-level filters
• Checkbox selection for rows
• Edit and Delete actions for each record

2. Add Revised Designation

Purpose

Allows users to create a new revised designation mapping.

Form Fields

• Code

  • Text input
  • Placeholder: Enter Code
  • Mandatory field

• Description

  • Text input
  • Placeholder: Enter Description
  • Mandatory field

• Unit

  • Dropdown
  • Placeholder: Select or create a unit
  • Mandatory field

• Designation

  • Dropdown
  • Placeholder: Select designation
  • Mandatory field

• Amount

  • Numeric input
  • Mandatory field

Actions

• Save
  • Validates all required fields
  • Saves the revised designation record
• Reset
  • Clears all entered data

Validation Rules

• Code cannot be empty
• Description cannot be empty
• Unit selection is mandatory
• Designation selection is mandatory
• Amount must be a valid numeric value
• Duplicate codes are not allowed

3. Edit Revised Designation

/masters/revised-designation-master/edit-revised-designation/:id

Purpose

Allows modification of an existing revised designation record.

Behavior

• Clicking the Edit icon opens the record in editable mode
• Existing values are pre-filled in the form

Editable Fields

• Code
• Description
• Unit
• Designation
• Amount

Actions

• Save
  • Updates the revised designation details
• Reset
  • Restores the original values

4. Delete Revised Designation

Purpose

Allows removal of an existing revised designation record.

Delete Flow

1. Click the Delete icon from the Actions column

2. A confirmation popup appears:

   Are you sure you want to delete this Revised Designation?

3. User options:

   • Yes – Permanently deletes the record
   • Cancel – Aborts the action

Summary

The Revised Designation Master ensures structured and controlled management of designation-related financial configurations, enabling accurate payroll and deployment processing.

Field Definitions, Usage, and Calculation Logic

This section provides a technical analysis of the Revised Designation Master's role in role-based salary benchmarking.

1. Field Definitions

2. Field Usage & System Impact

3. Business & Calculation Logic

The Revised Designation Master facilitates smooth role transitions:

A. Role Transition Engine

The master is designed to bridge the gap between legacy roles and new organizational structures:

1. Selection: When an HR manager initiates a "Bulk Promotion" or "Role Update", the system filters available templates using the oldDesignation field.
2. Auto-Filling: Upon selecting a revision, the employee's pending profile is auto-populated with the newDesignation and the revised amount.

B. Audit & History

Unlike a direct update to the SalaryDesignationMaster, the revisedDesignationMaster maintains a permanent record of the state change:

• Reference: It holds OIDs for both the source and destination roles.
• Reporting: Allows the "Designation History Report" to trace which revision caused an employee's salary head changes.

C. Relational Scoping

The master utilizes heavy indexing on companyId, unitId, and isActive to ensure that only relevant revisions are presented during deployment and payroll configuration workflows.

The Revised Designation Master module interacts with the following API endpoints:

Base URL

export const REVISEDDESIGNATION_URL = '/api/revisedDesignationMaster'

Endpoints

RTK Query Hooks

The following hooks are available for frontend integration:

• useAddRevisedDesignationApiSliceMutation
• useGetAllRevisedDesignationlQuery
• useGetRevisedDesignationByIdQuery
• useUpdateRevisedDesignationMutation
• useDeleteRevisedDesignationMutation

End of Documentation