Skip to main content

Candidate List UI

Purpose​

Provides the protected candidate pipeline, add-candidate form, filters, stage actions, compensation approval action, and resume access.

Talent → Candidates; protected candidate route.

Intended users and preconditions​

Recruiter and HR-admin audiences in navigation evidence. An authenticated tenant user with Recruitment feature visibility and loaded workspace data.

Main components​

Metrics, add form, search/filter controls, pipeline cards, embedded details drawer, status badges, and resume actions.

Fields, columns, and sections​

The add form contains source-defined opening, contact, experience, location, compensation-expectation, resume, and notes fields. The list presents candidate, opening, contact, stage, and related metadata.

Filters and actions​

Add candidate, search, filter, toggle presentation, open details, change stage, record CTC approval, and view/download resume.

Validation​

Opening and candidate name are required; either email or phone is required. Positive approval amount is checked before submission.

UI states​

  • Loading: An explicit candidate-loading state is shown.
  • Empty: Pipeline columns and detail history/notes have no-record states.
  • Success: Mutations reload the workspace and update selection.
  • Error: Load, add, stage, approval, and resume failures render page errors.

Permission behavior​

Route/menu checks are coarse Recruitment feature checks. Stage, compensation, notes, and document actions have no separate UI permission gate.

API dependencies​

Uses the compatibility workspace and candidate mutations plus native resume download.

Candidate stages follow the verified status catalog. Compensation visibility and approval separation of duties require confirmation.

Screenshot placeholder​

Capture only sanitized, non-production data after product and privacy review. No screenshot is embedded in this Draft page.

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/RecruitmentCandidatesPage.tsx
  • microservices/src/recruitment-service/Api/RecruitmentCompatEndpoints.cs
  • microservices/src/recruitment-service/Api/RecruitmentEndpoints.cs

Summary​

This Draft page summarizes source-backed Recruitment behavior and explicitly marks incomplete governance or implementation.

Audience​

Recruitment stakeholders, product, engineering, QA, support, operations, architecture, security, and implementation partners as applicable to this page.

Overview​

Use the source-backed sections above as the authoritative scope. Unsupported behavior remains Requires confirmation or Not implemented.

See Also​

Keywords​

  • Recruitment
  • Hiring lifecycle
  • Draft documentation

Revision Information​

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