Skip to main content

Employee Gateway Interaction

Summary​

Gateway is the transitional edge for Employee traffic. Configuration selects whether Employee-owned compatibility paths resolve to Employee Service or remain with the monolith, while direct/shadow Employee routing also exists.

Audience​

  • Backend developers and QA engineers
  • DevOps engineers, solution architects, and security engineers

Purpose​

Explain route ownership and cutover behavior without publishing an endpoint catalog or environment-specific route values.

Confirmed interaction​

  • Gateway evaluates an Employee cutover setting when it constructs and resolves routes.
  • A defined set of Employee-owned compatibility prefixes can switch between Employee Service and the monolith.
  • Gateway has an Employee shadow route and distinguishes the selected route source for diagnostics/cutover behavior.
  • Gateway self-service aggregation contains Employee downstream resolution for selected employee information.
  • Employee Service maps foundation, direct, and compatibility presentation groups.
  • Authentication/tenant context is expected to traverse the edge and is interpreted by Employee Service.

Transitional request flow​

Production cutover state, parity criteria, shadow comparison behavior, and final retirement of compatibility paths Require confirmation.

Source References​

  • microservices/src/gateway-api/Program.cs
  • microservices/src/gateway-api/EssEndpoints.cs
  • microservices/src/employee-service/Program.cs
  • microservices/src/employee-service/Api/EmployeeCompatibilityEndpoints.cs

See Also​

Keywords​

  • Gateway cutover
  • Route ownership
  • Compatibility routing

Revision Information​

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