> For the complete documentation index, see [llms.txt](https://help.tillit.cloud/tillit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/resource-management.md).

# Resource Management

## Overview

Resource Management tracks reusable physical production items that attach to machines across manufacturing lines. These include tools, change parts, mould sets, depositing heads, format parts, and calibrated test devices.

The system monitors four core attributes for every physical item:

* **Current location**: Which machine and position slot it occupies, or its current storage rack/bench location.
* **Serviceable condition**: Whether the resource is ready for production, undergoing strip-down, quarantined, or retired.
* **Usage metrics**: Aggregated machine wear, cycles, running hours, or calendar days tracked via dedicated meters.
* **Calibration status**: Compliance status against interval policies, enforcing certificate validity at installation.

### Edge Resources vs. Resource Management

To ensure clarity across system settings:

* **Edge Resources**: Network credentials, certificates, and TLS keys used to authenticate physical IoT gateway devices and Edge nodes with TilliT Cloud.
* **Resource Management**: Physical tools, changeparts, moulds, and testing kits physically mounted on plant machinery to execute production orders.

## Core Concepts & Architectural Model

Resource Management operates on three independent layers evaluated concurrently during plant execution:

1. **Resources (The Equipment Layer)**:
   * **Resource Class**: High-level functional category (e.g., *Moulds*, *Depositing heads*, *Test devices*).
   * **Resource Definition**: The catalog model or part specification defining calibration frequency and default meters.
   * **Resource Instance**: The physical serialized asset on the shop floor carrying an individual serial number, wear reading, and operational history.
2. **Machines (The Asset Layer)**:
   * **Asset Class Positions**: Reusable physical slots defined on machine types.
   * **Asset Positions**: Machine-specific slot configurations and capacity overrides.
3. **Production (The Execution Layer)**:
   * **Resource Requirements**: Pre-conditions defined on Materials or Work Orders enforcing that the correct tooling is installed before running production.

## The Install Check Workflow

When an operator installs a tool using an Activity Form or via direct operations, TilliT enforces a strict sequential 5-stage validation check:

| Stage | Validation Check        | Result if Check Fails (No)                                                                       | Result if Check Passes (Yes)                                         |
| ----- | ----------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| **1** | **Serviceable & Free?** | Refused: Not serviceable or already installed                                                    | Proceeds to Stage 2                                                  |
| **2** | **Calibration Valid?**  | Refused: Calibration Required, Overdue, or Failed                                                | Proceeds to Stage 3                                                  |
| **3** | **Position Takes It?**  | Refused: Class or definition does not fit the machine slot                                       | Proceeds to Stage 4                                                  |
| **4** | **Requirements Met?**   | <p><strong>BLOCK:</strong> Rejects install<br><strong>WARN:</strong> Displays inline warning</p> | Proceeds to Stage 5                                                  |
| **5** | **Position Has Room?**  | Refused: Slot capacity reached                                                                   | **Installed successfully** (assignment opens, meters start counting) |

## Day-to-Day Operations

Shop floor resource lifecycle updates are managed dynamically using [Activity Templates](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/activity-templates.md) configured with **Resource Action** form items. When operators complete these activities, the system automatically processes the physical tooling changes against the database.

Supported Operations:

* **Install:** Mounts an available, calibrated resource into an asset position slot, enforcing the 5-stage validation check.
* **Remove:** Demounts a resource from a machine, closing its active line assignment.
* **Move:** Updates the designated storage location (rack or toolroom) for uninstalled tools.
* **Change Condition:** Transitions status (such as moving worn tools to *Under maintenance* or *Quarantined*). Restoring a tool to *Serviceable* allows wear meters to be reset.
* **Calibrate:** Captures test results (*Pass* or *Fail*), certificate references, and updates calibration expiration dates.

Operational Behaviors:

* **Atomic Transactions:** Multi-action workflows (such as a line changeover that demounts an outgoing tool and installs an incoming one) execute atomically—both operations commit together or the submission is rejected.
* **Batch Operations:** When placed inside repeatable form containers, operators can inspect, verify, or calibrate multiple tools within a single activity run.
