Spare Parts Inventory
Manage your maintenance spare parts catalog, track stock levels, record issues and receipts, and receive low-stock alerts before critical parts run out.
Overview
The Spare Parts Inventory screen gives your maintenance team a centralized catalog of all parts held in stock for equipment servicing. Each part record tracks the current quantity on hand, the minimum stock threshold that triggers a low-stock alert, and the storage location. A movement log records every part issue (consumption) and receipt (restocking), providing a full audit trail of stock changes over time.
Every part's Part Number is unique across the catalog — saving a part with a number that already exists updates that existing part instead of creating a duplicate row.
Data Persistence
Parts catalog and movement log are stored together in maintenance-spare-parts.json on the server. All changes persist across page refreshes and user sessions.
📦 Parts Catalog
Full list of spare parts with current stock, minimum level, unit of measure, category, and storage location.
🔴 Low-Stock Alerts
Parts with quantity at or below minStock are flagged with a red badge. The total alert count appears in a summary tile at the top of the screen.
📋 Movement Log
Every issue (consumption) and receipt (restocking) is recorded with date, quantity, and a note — giving a full history of stock changes.
Quick Start
Part Fields
| Field | Type | Description |
|---|---|---|
| Part Name | Text (required) | Common name of the part (e.g. "SKF 6205 Ball Bearing") |
| Part Number | Text | Manufacturer or internal part number for ordering |
| Category | Select | Bearing, Belt, Filter, Seal, Electrical, Pneumatic, Hydraulic, Other |
| Current Quantity | Number | Units currently in stock. Updated automatically by Issue/Receive operations. |
| Minimum Stock | Number | Threshold below which a low-stock alert is raised |
| Unit | Select | pcs, m, L, kg, set — unit of measure for the quantity fields |
| Location | Text | Physical storage location (e.g. "Shelf B3", "Tool Room Cabinet 2") |
| Notes | Text area | Supplier info, lead time, compatible assets, or other notes |
Adding a New Part
- Click + Add Part in the top-right of the screen.
- Enter the Part Name (required — Save is disabled until this is filled).
- Fill in Part Number, Category, and Unit.
- Set the initial Current Quantity and the Minimum Stock level.
- Enter the Location in your storeroom or workshop.
- Click Save. The part appears in the catalog immediately.
Part Number Is Unique — Saving Updates the Matching Part
If you save a new part with a Part Number that already belongs to an existing part, that existing part is updated in place with your new values instead of a second, duplicate record being created. The same applies when editing an existing part's Part Number to match another part's — the two merge into one record rather than coexisting with the same number.
Recording Movements
Stock levels change through two types of movement. Both update the part's Current Quantity immediately and append an entry to the Movement Log.
Issue (Consumption)
Use Issue when parts are taken from stock to complete a work order or repair:
- Click the Issue button on a part row (or open the part detail and click Issue).
- Enter the quantity being consumed.
- Add a note (e.g. work order number, asset name).
- Click Confirm. The quantity is deducted from Current Quantity.
Receive (Restock)
Use Receive when a parts delivery arrives:
- Click the Receive button on a part row.
- Enter the quantity received.
- Add a note (e.g. PO number, supplier name).
- Click Confirm. The quantity is added to Current Quantity.
Always Log Movements
Resist the temptation to manually edit the quantity field. Using Issue and Receive instead ensures your Movement Log is accurate — which is critical for consumption analysis and reorder planning.
Low-Stock Alerts
When a part's Current Quantity falls to or below its Minimum Stock level, it is flagged with a red "Low Stock" badge in the catalog row. A summary tile at the top of the screen shows the total number of low-stock parts.
To resolve a low-stock alert, place a purchase order with your supplier and then record the delivery using the Receive movement.
Set Minimum Stock Correctly
Set minStock to your typical reorder lead time × average daily consumption. A minStock of zero means the alert never fires — you will only know a part is out of stock when a technician goes to the shelf and finds it empty.
Movement Log
The Movement Log tab shows every issue and receipt entry for all parts in reverse chronological order. Each entry displays:
- Date & time of the movement
- Part name
- Type: Issue or Receive
- Quantity changed
- Note entered at the time of the movement
Use the search bar to filter by part name or note text. The log is read-only — individual entries cannot be edited or deleted to preserve the audit trail.
Searching and Filtering
The catalog supports the following filters:
- Search — filters by part name and part number in real time.
- Category dropdown — show only parts of a selected category (Bearing, Belt, Filter, etc.).
- Low-stock only toggle — show only parts at or below their minimum stock level.