Onboarding & Offboarding Business Rules
Summary
This catalog lists only rules enforced or calculated by verified source.
Audience
HR operations, product owners, engineering, QA, support, and architecture reviewers.
Reference Content
Each row identifies the trigger, business outcome, validation, and primary source file for one rule.
Verified rule catalog
| # | Rule | Trigger | Business outcome | Validation | Source |
|---|---|---|---|---|---|
| 1 | Only an Accepted offer moves to onboarding | Move offer | Onboarding can start | Non-Accepted returns conflict | OfferCommands.cs |
| 2 | Existing non-cancelled onboarding is reused | Repeat move | No second active record for offer | Repository lookup | OfferCommands.cs |
| 3 | Completed onboarding is terminal | Status update | Record remains Completed | Other target returns conflict | OnboardingCommands.cs |
| 4 | Completion needs the candidate | Complete onboarding | Provisioning uses candidate data | Missing candidate returns not found | OnboardingCommands.cs |
| 5 | Employee provisioning precedes completion | Complete onboarding | Joined/completion recorded after success | Dependency failure prevents save/events | OnboardingCommands.cs |
| 6 | Extracted retry uses deterministic employee code | Repeat provisioning | Existing Employee may be returned | Create conflict triggers lookup | EmployeeServiceClient.cs |
| 7 | New Employee starts Active | Create Employee | Active workforce record and history | Domain creation rule | Employee.cs |
| 8 | Employee cannot report to self | Change manager | Invalid manager change rejected | Domain validation | Employee.cs |
| 9 | UI requires core joining and pay-mode fields | Complete form | Submission allowed after client checks | Required code/email/date/department/designation/pay input | RecruitmentOnboardingPage.tsx |
| 10 | Exit reason is required | Submit resignation | Request may be created | Blank reason rejected | HrOperationsController.cs |
| 11 | Resignation date is current date | Submit resignation | Server fixes effective submission date | Request value is not authoritative | HrOperationsController.cs |
| 12 | Last working date cannot precede resignation | Submit resignation | Chronology remains non-negative | Earlier date rejected | HrOperationsController.cs |
| 13 | One active exit per employee | Submit resignation | Duplicate active request blocked | Active status query | HrOperationsController.cs |
| 14 | Actor cannot decide own exit | Approve/reject | Separation of self and approver | Permission helpers reject same actor | HrOperationsController.cs |
| 15 | Rejection needs a reason | Reject exit/rollback | Rejection evidence recorded | Blank reason rejected | HrOperationsController.cs |
| 16 | Rollback is allowed only for approved exit before last working date | Request rollback | Approved exit can be reconsidered | Status/date checks | HrOperationsController.cs |
| 17 | Access revoke targets approved exits after last working date | Process revokes | Login/labor disabled and exit Completed | Status, date, null-and-void, prior-revoke checks | HrOperationsController.cs |
| 18 | Asset clearance is true only with no blocking assets | Query clearance | Read-only clear/block verdict | Issued, Damaged, Lost, Repair block | AssetQueries.cs |
Total
This catalog contains 18 verified rules. It does not include policy proposals or UI labels that are not enforced.
Rules requiring confirmation
Mandatory onboarding documents, task completion gates, joining-date horizon, department/manager mandates, credential policy, asset bundles, payroll/leave/attendance activation, notice-period exceptions, clearance sign-off, final settlement, termination categories, retention, and archival require confirmation.
Source References
microservices/src/recruitment-service/Application/Commands/OfferCommands.csmicroservices/src/recruitment-service/Application/Commands/OnboardingCommands.csmicroservices/src/recruitment-service/Infrastructure/EmployeeServiceClient.csmicroservices/src/employee-service/Domain/Employees/Employee.csControllers/HrOperationsController.csmicroservices/src/asset-service/Application/Queries/AssetQueries.csUI/salary-ui/apps/client-hrms-portal/src/pages/hr/RecruitmentOnboardingPage.tsx
Related Articles
See Also
Keywords
- Onboarding rules
- Exit rules
- Validation catalog
Revision Information
- Status: Draft
- Last reviewed: 2026-07-20
- Review cycle: Quarterly