Appearance
Fixed Asset Reports
| Backlog field | Value |
|---|---|
| Story ID | AP-FA-008 |
| Epic | Fixed Assets |
| Story type | Report |
| 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 asset managers, I want to review depreciation, purchase, sales, and asset status reports so that asset movement and valuation are auditable.
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
Report date/period and authorized asset scope are required as applicable.
Optional or conditional
Group, location, status, acquisition, depreciation, vendor/customer, and document filters are optional.
Action behavior
View/Print/Export are read-only and use posted asset lifecycle and journal data.
Blocking rule or downstream effect
Cost, accumulated depreciation, and net book value must reconcile with asset records.
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 |
|---|---|---|---|---|---|
| assets-purchase-invoice-report | FixedAssetsPurchaseReportComponent | Report/print | No route-level permission/guard found in source window | Feature token match | apps/fixedAssets/src/app/remote-entry/reports/reports-routing.module.ts:26 |
| reports | Lazy-loaded route | Report/print | No route-level permission/guard found in source window | Feature token match | apps/fixedAssets/src/app/remote-entry/routes.ts:36 |
Observed frontend fields and validation
| Component | Control | Observed frontend rule | Component source |
|---|---|---|---|
| FixedAssetsPurchaseReportComponent | assetsGroupIds | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | assetsIds | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | assetsLocationIds | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | fromDate | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | Statuses | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | toDate | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | vendorsIds | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
Observed frontend actions
| Component | Click action/handler | Business review requirement | Component source |
|---|---|---|---|
| FixedAssetsPurchaseReportComponent | printReport | Generate the printout for the selected record and authorized branch/tenant; use posted/current values and surface print, template, ZATCA/ETA, or popup failures without changing transaction state. | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | routeToAssetView | 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/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | routeToInvoice | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | routeToJournalEntryView | 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/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | routeToVendorDef | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
| FixedAssetsPurchaseReportComponent | viewData | 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/fixedAssets/src/app/remote-entry/reports/fixed-assets-purchase-report/fixed-assets-purchase-report.component.ts |
Page-specific frontend acceptance criteria
- assets-purchase-invoice-report - Report/print: Expose documented filters, validation, empty/loading/error states, authorized results, totals, drill-through, print, and export behavior where present. Security observed: No route-level permission/guard found in source window
- reports - Report/print: Expose documented filters, validation, empty/loading/error states, authorized results, totals, drill-through, print, and export behavior where present. Security observed: No route-level permission/guard found in source window