Skip to main content

API Testing Architecture

Summary​

Script-based Recruitment smoke coverage verifies major native, public, compatibility, gateway, outbox, joining-report, and Employee Service handoff behavior. No dedicated automated offboarding endpoint suite or lifecycle unit/integration/contract test project was found.

Audience​

Developers, QA, support, and solution architects.

Testing architecture​

Existing verified coverage​

  • Public offer acceptance and rejection idempotence
  • Accepted offer move-to-onboarding idempotence
  • Onboarding status transition and completion
  • Candidate Joined outcome
  • Compatibility completion behavior and status restriction
  • Gateway Recruitment route selection checks
  • Real Employee Service creation and retry behavior
  • Recruitment outbox lifecycle event assertions
  • Joining-report aggregation

Some smoke comments refer to older placeholder behavior; this documentation relies on executed assertions and current client code rather than stale comments.

Missing automated evidence​

  • Exit creation, approval, rejection, rollback, and access revoke
  • Generic onboarding-task API
  • Extracted endpoint authentication/authorization denial
  • Tenant-isolation and public-link boundary tests
  • Compatibility status/body/side-effect parity across both targets
  • Downstream timeout and partial-failure behavior
  • OpenAPI schema validation
  • API version/deprecation tests
  • Frontend lifecycle component tests

Recommended work is not existing implementation: add domain unit tests, minimal API integration tests, monolith controller tests, dual-target contract suites, security tests, Employee failure simulations, exit notification failure tests, and frontend request/response tests.

No execution commands, hosts, ports, credentials, or test identifiers are reproduced.

Requires confirmation​

  • Mandatory release gates and test environments.
  • Test tenant/data isolation and cleanup ownership.
  • Compatibility cutover acceptance criteria.
  • Offboarding API test ownership.

Source References​

  • microservices/scripts/smoke-recruitment.ps1
  • microservices/scripts/smoke-employee.ps1
  • microservices/src/recruitment-service/Api/RecruitmentEndpoints.cs
  • microservices/src/recruitment-service/Api/RecruitmentCompatEndpoints.cs
  • Controllers/HrOperationsController.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/RecruitmentOnboardingPage.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/HrOperationsPage.tsx

See Also​

Keywords​

  • API smoke coverage
  • Contract parity
  • Offboarding test gap

Revision Information​

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