Payroll Project Structure

Summary

The service is a single ASP.NET Core project organized into API, Application, Domain, Infrastructure, Messaging, and Backfill folders.

Audience

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

Reference Content

• Api/ maps native, output, foundation, and compatibility minimal APIs.
• Application/ contains calculation, compatibility, output, PDF, DTO, and tenant-abstraction code.
• Domain/ contains mutable Payroll records and status-bearing entities.
• Infrastructure/ contains the EF Core context, tenant context, outbox store, migrations, and development seeding.
• Messaging/ contains the inbound read-model consumer.
• Backfill/ contains extraction, upsert, validation, resume, and audit tooling.
• Program.cs is the composition root; the project file declares .NET and package dependencies.

There is no separate Persistence/, Documents/, or configuration-options folder. Persistence lives in Infrastructure; PDF/export implementations live in Application; configuration is composed at startup.

Source References

• microservices/src/payroll-service/Program.cs
• microservices/src/payroll-service/payroll-service.csproj
• microservices/src/payroll-service/Api/PayrollRunEndpoints.cs
• microservices/src/payroll-service/Application/PayrollCalculationService.cs
• microservices/src/payroll-service/Infrastructure/PayrollDbContext.cs
• microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs
• microservices/src/payroll-service/Backfill/PayrollBackfillRunner.cs

Related Articles

• Payroll technical overview
• Payroll business documentation

See Also

• Payroll module
• Known limitations

Keywords

• Payroll Service
• Payroll Project Structure
• Technical architecture

Revision Information

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