Appearance
HR General Settings
| Backlog field | Value |
|---|---|
| Story ID | AP-HR-002 |
| Epic | HR |
| Story type | Master data / configuration |
| Review status | Draft - business analyst and business owner review required |
| Source evidence | AppsPortal.Apis controller, application command/query handlers, validators, domain entities, and matching MFE workflow where available |
| Last source review | 2026-07-10 |
User story
As HR administrators, I want to configure shared HR defaults exposed through AppsPortal so that employee workflows use consistent policy.
Acceptance criteria
- Only authorized users can view or execute the feature's actions.
- Required business data, active dependencies, tenant/branch scope, and current document state are validated.
- Invalid requests return actionable validation errors without applying a partial change.
- Search, list, view, print, and export operations use the same authorized business scope.
- Material create, edit, status, approval, posting, reversal, and integration actions are auditable where applicable.
- Financial or stock effects are applied atomically and no more than once.
Business rules
Required
Enabled HR integrations require their defaults and active references.
Optional or conditional
Unused optional defaults may remain empty.
Action behavior
Save changes future employee behavior only and creates no accounting transaction.
Blocking rule or downstream effect
Cross-module assignments remain governed by their own permissions.
Frontend page coverage
The following UI coverage is sourced from the pulled MFE route configuration. A Module-level supporting artifact mapping is evidence of a reachable screen, but requires BA confirmation that it belongs to this story rather than a more specific feature story.
| Route/page | Component | Mode | Route permission/guard | Mapping confidence | Source |
|---|---|---|---|---|---|
| (module default) | EndOfServiceBenefitsSettingsListComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/end-of-service-benefits-settings-routing.module.ts:20 |
| (module default) | GeneralRequestListComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/general-request-routing.module.ts:11 |
| (module default) | GeneralRequestListComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/general-request-routing.module.ts:18 |
| (module default) | HrPayrollGeneralSettingComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/hr-payroll-general-setting-routing.module.ts:17 |
| (module default) | LeavesSettingsViewComponent | View/detail | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/leaves-settings-routing.module.ts:18 |
| (module default) | MainEndOfServiceBenefitsSettingsComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/end-of-service-benefits-settings-routing.module.ts:12 |
| (module default) | MainHrPayrollGeneralSettingComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/hr-payroll-general-setting-routing.module.ts:9 |
| (module default) | MainLeavesSettingsComponent | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/leaves-settings-routing.module.ts:10 |
| add | AddEndOfServiceBenefitsSettingsComponent | Add | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/end-of-service-benefits-settings-routing.module.ts:36 |
| add | GeneralRequestAddComponent | Add | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/general-request-routing.module.ts:26 |
| edit | LeavesSettingsEditComponent | Edit | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/leaves-settings-routing.module.ts:26 |
| edit/:id | EditEndOfServiceBenefitsSettingsComponent | Edit | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/end-of-service-benefits-settings-routing.module.ts:44 |
| edit/:id | GeneralRequestEditComponent | Edit | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/general-request-routing.module.ts:34 |
| end-of-service-benefits-settings | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/master-data/master-data-routing.module.ts:68 |
| end-of-service-benefits-settings | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/payroll-wages-routing.module.ts:44 |
| general-request | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/transaction-routing.module.ts:9 |
| general-settings | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/payroll-wages-routing.module.ts:30 |
| leaves-settings | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/leaves/master-data/master-data-routing.module.ts:23 |
| view/:id | EndOfServiceBenefitsSettingsViewComponent | View/detail | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/end-of-service-benefits-settings-routing.module.ts:28 |
| view/:id | GeneralRequestViewComponent | View/detail | No route-level permission/guard found in source window | Feature token match | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/general-request-routing.module.ts:42 |
Observed frontend fields and validation
| Component | Control | Observed frontend rule | Component source |
|---|---|---|---|
| GeneralRequestBodyComponent | description | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| GeneralRequestBodyComponent | employeeId | Required in component validator | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| GeneralRequestBodyComponent | requestDate | Required in component validator | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| GeneralRequestBodyComponent | requestName | Required in component validator | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| HrPayrollGeneralSettingComponent | citizenCompanyShare | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | citizenEmployeeShare | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | citizenInsuranceTypeId | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | citizenTotalPercentage | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | fromDay | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | isAdvanceRequestAutoConversionEnabled | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | payrollDay | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | residentCompanyShare | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | residentEmployeeShare | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | residentInsuranceTypeId | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | residentTotalPercentage | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| HrPayrollGeneralSettingComponent | toDay | Required in component validator | apps/hr/src/app/remote-entry/payroll-wages/master-data/hr-payroll-general-setting/pages/hr-payroll-general-setting/hr-payroll-general-setting.component.ts |
| LeavesSettingsEditComponent | autoIncreaseAfterYearsOfService | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | autoIncreaseDays | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | balanceAvailabilityType | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | isHalfDayLeaveAllowed | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | isWeeklyOffIncludedInLeaveDuration | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | leaveTypeId | Required in component validator | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | maxPostDays | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | postType | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | salaryCalculationItemIds | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsEditComponent | salaryDeductionItemId | Visible control; optional or API-dependent | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings-edit/leaves-settings-edit.component.ts |
| LeavesSettingsViewComponent | leaveTypeId | Required in component validator | apps/hr/src/app/remote-entry/leaves/master-data/leaves-settings/pages/leaves-settings/leaves-settings.component.ts |
Observed frontend actions
| Component | Click action/handler | Business review requirement | Component source |
|---|---|---|---|
| EndOfServiceBenefitsSettingsListComponent | onDelete | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/pages/end-of-service-benefits-settings-list/end-of-service-benefits-settings-list.component.ts |
| EndOfServiceBenefitsSettingsListComponent | onEdit | Open the identified editable record only with Edit permission; posted/locked records remain blocked by route or action state and list context must be recoverable on return. | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/pages/end-of-service-benefits-settings-list/end-of-service-benefits-settings-list.component.ts |
| EndOfServiceBenefitsSettingsListComponent | onView | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/hr/src/app/remote-entry/payroll-wages/master-data/end-of-service-benefits-settings/pages/end-of-service-benefits-settings-list/end-of-service-benefits-settings-list.component.ts |
| GeneralRequestBodyComponent | openAttachments | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| GeneralRequestBodyComponent | openEmployeeDialog | Open the item/lookup/tracking dialog with the current warehouse, item, UOM, and remaining quantity context; accepted values must return to the correct line and cancel must not mutate it. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/components/general-request-body/general-request-body.component.ts |
| GeneralRequestListComponent | onApprove | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onCancel | Leave or close without persisting; warn when the current form has unsaved changes and restore the prior list/filter context. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onDelete | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onEdit | Open the identified editable record only with Edit permission; posted/locked records remain blocked by route or action state and list context must be recoverable on return. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onReject | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onSubmit | Validate the concrete form and line collection, prevent duplicate submission, persist once, show API field/business errors in context, and navigate/refresh only after success. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestListComponent | onView | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-list/general-request-list.component.ts |
| GeneralRequestViewComponent | openAttachments | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/hr/src/app/remote-entry/employee-personnels/transactions/general-request/pages/general-request-view/general-request-view.component.ts |
Page-specific frontend acceptance criteria
- (module default) - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- (module default) - View/detail: Load an authorized immutable/detail representation with status-aware actions, linked records, print/export where exposed, and not-found/forbidden handling. Security observed: No route-level permission/guard found in source window
- add - Add: Render permitted fields, required indicators, defaults, dependent lookups, validation, Save/Cancel, loading, success, and API-error states. Security observed: No route-level permission/guard found in source window
- edit - Edit: Load the identified record, enforce state/permission field locks, preserve concurrency identity, validate changes, and return without losing filters. Security observed: No route-level permission/guard found in source window
- edit/:id - Edit: Load the identified record, enforce state/permission field locks, preserve concurrency identity, validate changes, and return without losing filters. Security observed: No route-level permission/guard found in source window
- end-of-service-benefits-settings - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- general-request - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- general-settings - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- leaves-settings - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- view/:id - View/detail: Load an authorized immutable/detail representation with status-aware actions, linked records, print/export where exposed, and not-found/forbidden handling. Security observed: No route-level permission/guard found in source window