Skip to main content

Payroll Service Architecture

Summary​

Payroll Service is a .NET 8 ASP.NET Core bounded-context service with minimal APIs, direct application-service orchestration, EF Core persistence, messaging projections, and gateway-controlled transitional ownership.

Audience​

Backend and frontend developers, QA and DevOps engineers, support and security engineers, and solution architects.

Overview​

Payroll Service is a .NET 8 ASP.NET Core bounded-context service with minimal APIs, direct application-service orchestration, EF Core persistence, messaging projections, and gateway-controlled transitional ownership.

Technical Detail​

Architectural boundaries​

The service separates API presentation, application orchestration, domain records, infrastructure persistence, messaging consumers, and document/export generation. Shared Kernel wiring supplies configuration, messaging, correlation, and tracing; Contracts supplies integration-event types.

Runtime dependencies​

Conceptual runtime dependencies are PostgreSQL, the integration broker, gateway-forwarded request context, upstream event producers, and downstream notification consumers. PDF and CSV generation currently execute inside Payroll Service.

Current maturity​

Transitional. Native and monolith-compatible surfaces coexist, gateway routing controls ownership, historical backfill tooling supports extraction, and several boundaries remain foundations rather than completed integrations.

Source References​

  • microservices/src/payroll-service/Program.cs
  • microservices/src/payroll-service/payroll-service.csproj
  • microservices/src/payroll-service/Infrastructure/PayrollDbContext.cs
  • microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs
  • microservices/src/gateway-api/Program.cs

See Also​

Keywords​

  • Payroll Service
  • Payroll Service Architecture
  • Technical architecture

Revision Information​

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