Skip to main content

Salary Component Model

Summary​

Salary components are tenant-owned, active/effective, optionally employee-scoped records classified by category and evaluated from a fixed or percentage basis.

Audience​

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

Overview​

Salary components are tenant-owned, active/effective, optionally employee-scoped records classified by category and evaluated from a fixed or percentage basis.

Technical Detail​

Confirmed model​

The model stores name, category, basis, default amount, recurrence, optional employee scope, effective dates, and active state. Calculation loads active components effective for the period and applies tenant-wide or matching employee-scoped records.

Evaluation boundary​

Fixed and percentage-of-base behavior is confirmed. No general formula or expression engine is present. Negative calculated component values are not carried into outcomes. Customer-specific names, amounts, formulas, and rates are excluded.

Assignment and governance​

Employee scope is represented directly on the component rather than through a separate assignment aggregate. Duplicate-name rules, approval, versioning, change audit, recurrence enforcement, and assignment precedence are Requires confirmation.

Source References​

  • microservices/src/payroll-service/Domain/PayrollEntities.cs
  • microservices/src/payroll-service/Application/PayrollCalculationService.cs
  • microservices/src/payroll-service/Application/PayrollCompatService.cs
  • microservices/src/payroll-service/Infrastructure/PayrollDbContext.cs

See Also​

Keywords​

  • Payroll Service
  • Salary Component Model
  • Technical architecture

Revision Information​

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