> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Maintenance Cost Analysis

> Track maintenance spending by asset at /fm/maintenance-cost-report, with monthly trend and top-10 cost charts plus CSV/Excel export.

This screen provides a maintenance cost report broken down by asset and is available at `/fm/maintenance-cost-report`.

## Overview

The Maintenance Cost Analysis page uses `useMaintenanceCostReportData` to load cost data grouped by asset (`byAsset`) and by month (`byMonth`), plus a `topAssets` list. Four summary cards show **Assets with Maintenance**, **Total Work Orders**, **Total Maintenance Cost**, and **Avg Cost per Asset**. An optional filter panel allows filtering by Category, Date From, and Date To. Two charts are rendered when data is available: a line chart of **Monthly Cost Trend** and a horizontal bar chart of **Top 10 Highest Cost Assets**. The data table shows per-asset columns: Asset Tag, Name, Category, Site, Work Orders count, Total Cost, Avg Cost/WO, and Last Maintenance date. CSV and Excel export are available.

## Who it's for

Requires permission `fm.dashboard.view`. Financial export access should be confirmed with SME.

## Before you start

* Work orders must have `actual_material_cost` or equivalent cost data recorded for the report to be meaningful.

## Steps

<Steps>
  <Step title="Open Maintenance Cost Analysis">Navigate to `/fm/maintenance-cost-report` via the FM sidebar or from the Assets area.</Step>
  <Step title="Review summary cards">Check total assets with maintenance, work order count, total cost, and average cost per asset.</Step>
  <Step title="Apply filters">Click **Filters** and set Category or a date range to scope the analysis.</Step>
  <Step title="Analyze the trend chart">Review the Monthly Cost Trend line chart to identify spending patterns over time.</Step>
  <Step title="Review top-cost assets">Check the Top 10 Highest Cost Assets bar chart to identify high-maintenance assets.</Step>
  <Step title="Browse the detail table">Examine per-asset cost breakdown in the Cost by Asset table.</Step>
  <Step title="Navigate to an asset">Click any Asset Tag in the table to open that asset's detail page.</Step>
  <Step title="Export">Click **CSV** or **Excel** to download the report.</Step>
</Steps>

## Key concepts

* **Total cost** — `total_cost` aggregated from maintenance work orders linked to each asset.
* **Avg Cost/WO** — `avg_cost_per_wo` = total cost / work order count per asset.
* **Monthly trend** — `byMonth` data keyed by `YYYY-MM` month strings.

## Related

<Columns cols={2}>
  <Card title="Facilities & Inventory" icon="warehouse" href="/fm/overview">
    Facilities & Inventory core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fm.tsx
  * src/cores/fm/pages/MaintenanceCostReportPage.tsx
</Accordion>