Skip to main content

Recruitment Document Troubleshooting

Symptoms​

Resume/candidate document upload, view, download, or offer-letter generation fails.

Scope​

Recruitment references, Document Service content, browser blob handling, and missing lifecycle synchronization.

Cause​

Likely causes​

  • Reference was not created or is mismatched.
  • Document Service content is unavailable.
  • Unsupported preview/content response occurred.
  • Authorization, retention, or delete behavior is unconfirmed.

Safe diagnostic steps​

  1. Confirm the Recruitment reference exists without opening content.
  2. Classify upload, reference, content-not-found, preview, or download failure.
  3. Trace safe correlation evidence across Recruitment and Document Service.
  4. Do not attach document content to support evidence.

Resolution​

Safe resolution​

Have the owning service restore supported access or reconcile through an approved process. Do not replace/delete records directly.

Validation​

Verify metadata/reference and an authorized content availability check with synthetic data.

Evidence to collect​

Collect the time window, environment category, affected operation, expected/actual status category, safe record reference, correlation reference where available, dependency/error category, and recent approved change. Exclude personal data, resumes/documents, interview notes, tokens, offer/compensation values, credentials, bank/KYC data, secrets, and configuration values.

Escalation​

Escalate to Recruitment and Document owners; involve privacy/security/legal for exposure, retention, or deletion.

Source References​

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

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