Payroll Source Map

Summary

This page records confirmed payroll source map behavior and marks incomplete boundaries explicitly.

Audience

Payroll users, developers, QA and support engineers, architects, and implementation reviewers.

Reference Content

Documentation concern	Primary source area
Routes, guards, navigation	Client portal App, AppLayout, ProtectedRoute
Dashboard	DashboardPages
Calculation/review/freeze	CalculateSalaryPage
Advances	AdvanceSalaryPage
Payslips/components/statutory/reports	PayrollFeaturePages
Employee Payroll	EssPages
Runtime/startup/health	Payroll Program
Native calculation/lifecycle	PayrollCalculationService
Compatibility behavior	PayrollCompatService
Payslip/export behavior	PayrollOutputsService
Projection synchronization	PayrollReadModelConsumer
Persistence/outbox	PayrollDbContext and Persistence
Shared contracts	Contracts event definitions
Observability	Shared observability extension
Cutover/parity/smoke	Payroll runbook and validation scripts

API endpoint and database object catalogs remain in their dedicated sections to avoid duplication.

Source References

• UI/salary-ui/apps/client-hrms-portal/src/App.tsx
• UI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx
• UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
• UI/salary-ui/apps/client-hrms-portal/src/pages/salary/CalculateSalaryPage.tsx
• UI/salary-ui/apps/client-hrms-portal/src/pages/salary/AdvanceSalaryPage.tsx
• UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsx
• UI/salary-ui/apps/client-hrms-portal/src/dashboard/DashboardPages.tsx
• UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx
• microservices/src/payroll-service/Program.cs
• microservices/src/payroll-service/Application/PayrollCalculationService.cs
• microservices/src/payroll-service/Application/PayrollCompatService.cs
• microservices/src/payroll-service/Application/PayrollOutputsService.cs
• microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs
• microservices/src/payroll-service/Infrastructure/PayrollDbContext.cs
• microservices/src/payroll-service/Infrastructure/Persistence.cs
• microservices/src/shared-kernel/Extensions/ObservabilityExtensions.cs
• microservices/src/contracts/Events/PayrollCalculatedEvent.cs
• microservices/src/contracts/Events/PayslipGeneratedEvent.cs
• microservices/docs/payroll-cutover-runbook.md
• microservices/scripts/compare-payroll-parity.ps1
• microservices/scripts/payroll-cutover-go-no-go.ps1
• microservices/scripts/smoke-payroll-cutover.ps1
• microservices/scripts/smoke-payroll.ps1
• scripts/validate-payroll-scenarios.ps1

Related Articles

• Payroll reference documentation
• Payroll technical documentation

See Also

• Payroll API documentation
• Payroll module

Keywords

• Payroll reference
• Payroll Source Map

Revision Information

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