Skip to main content

Payroll Reports UI

Summary​

This page records confirmed payroll reports ui behavior and marks incomplete boundaries explicitly.

Audience​

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

Reference Content​

This screen inventory reflects the reviewed React route and component implementation.

Purpose​

Present Payroll summaries and advance-ledger rows and export the currently available role-scoped report data.

/reports/payroll from Payroll and Reports navigation.

Users​

Users with the reports module and reports-payroll or reports feature; navigation targets Payroll/HR administrators.

Permissions​

The role, module, and feature conditions summarized above govern UI visibility. They do not prove API or gateway authorization; those enforcement boundaries are Requires confirmation unless separately confirmed in source.

Components​

PayrollReportsPage, metric cards, summary table, advance table, and ImportExportToolbar configured for export-only behavior.

Fields and filters​

Month/run summaries, employee counts and aggregate outcome fields, plus advance/recovery ledger fields as returned.

Actions​

Load reports and export available Payroll rows. Payroll import is intentionally disabled.

Validation​

Route feature checks apply. Empty or unavailable report responses are surfaced rather than synthesized.

Business rules​

Reports present returned aggregates and advance-ledger rows; they do not create a Payroll run or alter lifecycle state. Export operates on the role-scoped data available to the page, and Payroll import is intentionally disabled.

Success and failure states​

Confirmed states include loaded metrics and tables, empty tables, export preparation, and load/export failure. Missing data must remain empty or unavailable rather than being inferred from another period.

API usage​

The page uses compatibility Payroll-summary and advance-ledger reporting routes. This is not a standalone native run-management, bank-file, accounting, or statutory-submission screen.

Known limitations​

No dedicated bank-export UI was found even though an API contract exists.

Screenshot placeholder​

Capture summary and advance tables using synthetic, non-sensitive rows.

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/hr/PayrollFeaturePages.tsx

See Also​

Keywords​

  • Payroll ui
  • Payroll Reports UI

Revision Information​

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