Skip to main content

Cross-Domain Integrations

Summary​

Onboarding completion synchronously ensures an Employee exists. Employee lifecycle events then support downstream Payroll and Leave projections. Attendance readiness and Asset clearance exist in their own domains, but direct lifecycle coordination was not verified.

Audience​

Integration developers, QA, support, domain owners, and solution architects.

Integration topology​

Readiness interpretation​

Joined and Employee creation are technical milestones, not proof that payroll, attendance, leave, login, or assets are operationally ready. Each downstream domain owns its own projection or configuration.

Integration behavior​

  • The Recruitment Employee client performs synchronous find/create handling and fails closed outside explicitly enabled development fallback.
  • Employee domain events are the verified asynchronous seam for Payroll and Leave consumers.
  • A dedicated Attendance employee-profile service exists, but direct handling of the inspected employee/onboarding events was not confirmed.
  • Asset Service exposes clearance status as a query model, including blocking states, but the HR Operations exit flow does not invoke it.
  • Document integration is registered in Recruitment; document completeness enforcement during onboarding completion was not found.

Failure and consistency model​

There is no distributed transaction across Recruitment, Employee, the broker, projections, or monolith HR Operations. Synchronous employee failure prevents normal extracted completion. Downstream event consumers converge independently after publication. Operators need service-specific diagnostics and reconciliation.

Requires confirmation​

  • End-to-end ownership and service levels for downstream readiness.
  • Attendance projection trigger and reconciliation behavior.
  • Whether exit completion must block on asset clearance or payroll processing.
  • Document completeness rules and the authority that enforces them.

Source References​

  • microservices/src/recruitment-service/Infrastructure/EmployeeServiceClient.cs
  • microservices/src/recruitment-service/Infrastructure/Gateways.cs
  • microservices/src/employee-service/Domain/Employees/Employee.cs
  • microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs
  • microservices/src/leave-service/Messaging/EmployeeProfileConsumer.cs
  • microservices/src/attendance-service/Application/Services/EmployeeProfileService.cs
  • microservices/src/asset-service/Application/Queries/AssetQueries.cs

See Also​

Keywords​

  • Cross-domain readiness
  • Employee lifecycle events
  • Asset clearance

Revision Information​

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