Compatibility API Boundaries

Summary

The extracted compatibility layer binds the monolith-shaped Recruitment contract and translates it to GUID-based application commands and projections. Gateway selection can route the same external operation to either implementation.

Audience

Developers, QA, support, security reviewers, and solution architects.

Compatibility routing

Verified contract families

The lifecycle subset covers workspace retrieval, offer status, move-to-onboarding, public offer read/sign/reject, onboarding status, and completion. Exact method/route pairs appear in the endpoint catalog.

Semantic differences

Concern	Monolith target	Extracted target
Identifier model	Numeric monolith records	Numeric compatibility identifiers translated to GUID aggregates
Authentication	Protected internal actions	No required endpoint policy
Completion	Labor/user creation and richer field persistence	Employee Service create; login remains pending
Completion DTO	Consumes many profile fields	Accepts full shape but uses a subset
Public acceptance	Creates onboarding during sign	Acceptance and move are separate native concepts, adapter behavior bridges response
Errors	MVC string/object results	Shared result-to-HTTP mapping

Compatibility is therefore route/shape preservation, not full side-effect equivalence.

Requires confirmation

• Formal parity matrix for fields, side effects, status codes, and error bodies.
• Cutover, rollback, and data reconciliation procedures.
• Compatibility deprecation and retirement version policy.
• Security equivalence before selecting the extracted target.

Source References

• microservices/src/recruitment-service/Api/RecruitmentCompatEndpoints.cs
• microservices/src/recruitment-service/Application/Compatibility/CompatContracts.cs
• microservices/src/recruitment-service/Application/Compatibility/CompatCommands.cs
• microservices/src/recruitment-service/Application/Compatibility/CompatQueries.cs
• Controllers/RecruitmentController.cs
• microservices/src/gateway-api/Program.cs
• UI/salary-ui/apps/client-hrms-portal/src/pages/hr/RecruitmentOnboardingPage.tsx

Related Articles

• Gateway boundaries
• DTO catalog
• Response models

See Also

• Endpoint catalog
• API limitations

Keywords

• Compatibility adapter
• Side-effect parity
• Migration routing

Revision Information

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