Admin Reference
Assets Route Reference
Understand the office-side asset register, asset mutations, export controls, and import entry points.
Before you start
- You need to review or mutate the shared asset register from the office side.
Expected outcome
You can manage the asset layer cleanly enough for inspections, defects, and reports to stay coherent.
What this route is for
Assets owns the office-side register of physical equipment under each system and site, including asset creation, editing, export, and imported register maintenance.
Visibility and capability notes
| Item | Details |
|---|---|
| Route id | assets |
| Visibility | Customer-facing core route. |
| Capability notes | Import and export actions depend on scope and connected-system availability, but the register itself is broadly available. |
| Direct inbound | Shell nav, dashboard asset totals, system row links, global search, inspection context, and activity links. |
Main regions, dialogs, and controls
| Surface | What it does |
|---|---|
| Asset list | Searchable, paginated register by site, system, and asset type. |
| Scope banner | Shows when the route is narrowed to one system. |
| Asset mutation dialog | Create or edit asset detail without leaving the route. |
| Import and export controls | Launch staged import or export a site-scoped CSV. |
Key actions
- Create or edit an asset.
- Filter the register by site, system, and asset type.
- Export assets when a site is selected.
- Launch staged import for systems and assets.
Filters and URL state
| Param | What it controls |
|---|---|
page | Pagination |
q | Search |
siteId | Site scope |
systemId | System scope |
assetType | Asset-type filter |
assetId | Open detail context |
create | Opens create mode |
- Search is debounced and the register is paginated.
- The route is list-first and dialog-driven.
Outputs and side effects
- Creates or updates asset records used later in inspections, defects, and reports.
- Produces CSV export when site scope is active.
- Launches staged import rather than performing bulk upload locally.
Inbound links
- Shell
Assetsnavigation. #/systems?systemId=...row links.- Dashboard totals and fire-damper summary context.
- Activity Feed resource links.
Outbound links
#/connected-systems?section=imports&dataset=systems-assets- Site-scoped export output
Indirect handoffs
- Asset quality affects inspection binding, defect traceability, and report clarity.
- The active system scope banner is important when the office wants to avoid editing the wrong slice of a large estate.
Troubleshooting
| Symptom | What to check |
|---|---|
| Export is unavailable | Asset CSV export is only exposed when the route is scoped to a site. |
| The register feels incomplete | Re-check siteId, systemId, and assetType filters before assuming records are missing. |
| An inspection cannot find the expected asset context | Confirm the asset is attached to the right system and site here. |