Skip to main content

Offer Acceptance and Onboarding Profile

Summary​

The extracted Recruitment service creates or reuses onboarding only after an offer is accepted. Completion synchronously initializes an Employee record, then completes onboarding and marks the candidate Joined.

Audience​

Backend and frontend developers, QA, support, and solution architects.

Offer acceptance and move to onboarding​

The move operation is idempotent for an active, non-cancelled onboarding aggregate. An offer in another status cannot be moved by this command.

Employee initialization at completion​

Employee initialization is not a distributed transaction. If the remote employee operation succeeds but Recruitment persistence fails, retry behavior depends on employee lookup and create-conflict handling. The client generates a deterministic employee code and attempts lookup after a conflict to reduce duplicate creation.

Profile mapping boundary​

The extracted path initializes core candidate and offer-derived employee data. Department, designation, manager, and work location are not fully mapped by this handoff. A numeric manager value from compatibility input is not translated to the Employee Service identifier model. Login provisioning is also outside this client.

The monolith compatibility path has different behavior: it creates labor and user records and stores more of the completion payload. Consumers must not assume both runtime paths produce identical profile completeness.

Requires confirmation​

  • Operational reconciliation for a remote employee created before a failed Recruitment commit.
  • Ownership of department, designation, manager, and location enrichment after extracted completion.
  • Whether an employee login must exist before onboarding is considered operationally complete.

Source References​

  • microservices/src/recruitment-service/Application/Commands/OfferCommands.cs
  • microservices/src/recruitment-service/Application/Commands/OnboardingCommands.cs
  • microservices/src/recruitment-service/Infrastructure/EmployeeServiceClient.cs
  • microservices/src/recruitment-service/Domain/Recruitment/Onboarding.cs
  • Controllers/RecruitmentController.cs

See Also​

Keywords​

  • Offer acceptance
  • Employee initialization
  • Idempotent onboarding

Revision Information​

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