Scaffolds

View and manage scaffolds by status, search the list, open scaffold details, and add new scaffolds.

Purpose

Show all scaffolds for a site, grouped by status, so users can locate a scaffold, review its list details, and open it or create a new one.

---

How to Access

Sites → Select a site → Scaffolds

• Visibility depends on permissions

• Buttons and actions may be hidden based on role

---

System Preconditions

Before this tool can be used:

• Site record exists

• Scaffold records exist for the site (to display results)

• User must belong to a company

• Required permissions must be assigned

If not met, (tool hidden, empty state, etc.) if known:

• Scaffolds tab is hidden without the view permission

• Add (+) button is hidden if the site is closed or create permission is missing

• If no scaffolds exist, the list shows 0 and the table is empty

• If the site is missing, the user is redirected to the Sites list

---

Workflow Overview

Open Scaffolds tab → Review status sections → Search or browse → Open a scaffold → Optional: add a scaffold

Step-by-Step Workflow

1. View Records

What the user does:

• Open the Scaffolds tab.

What the system displays:

• Status legend badges: Pending, Not safe for use, Safe for use

• Accordion sections with counts: Pending Scaffolds, Inactive Scaffolds, Erected Scaffolds, Dismantled Scaffolds

• Search bar: “Search by code or status”

• Table columns: Code, Description, Location, Start Date, End Date, Created By, Status

• Rows-per-page selector: 7, 10, 50, 100

Outcome:

• The user sees scaffold counts and a list grouped by status.

2. Create or Open a Record

What the user does:

• Select a table row to open a scaffold, or

• Click the + button to add a scaffold (if visible).

What the system displays:

• Selecting a row opens the scaffold detail page.

• Clicking + opens the Add Scaffold modal.

Learn how to create a scaffold

3. Complete the Action

What the user does:

• Add a scaffold (if creating)

• Edit a scaffold

• View a scaffold

---

Scaffold Status Lifecycle

Status	Meaning
Work In Progress	Scaffold is to be erected
Failed Inspection	Scaffold has failed a safety inspection
Handed Over	Scaffold is erected and green tagged
Dismantled	Scaffold has been dismantled

---

Key Rules and Notes

Rule	What it Means
Scaffolds tab visibility	Shown only when the view permission is granted
Add button visibility	Shown only when site is not closed and create permission is granted
Search scope	Searches by code or status text
Status grouping	Scaffolds are grouped into Pending, Inactive, Erected, and Dismantled sections

---

Permissions Required

Permissions are evaluated per action, not globally. UI adapts based on role.

Action	Required Permission
View scaffolds	sites-scaffolds-view
Create scaffolds	Any of roles-super-admin-enable, roles-site-admin-enable, sites-scaffolds-create

---

Troubleshooting and Common Questions

Common issues with missing tabs, empty lists, or hidden add actions are usually tied to permissions, site status, or search filters.

Problem	Solution
Scaffolds tab not visible	Confirm the user has the view permission
Add (+) button missing	Confirm site is not closed and user has create permission
List is empty	Confirm scaffolds exist for the site or clear the search field

---

Common Mistakes to Avoid

• Expecting the Scaffolds tab without the view permission

• Expecting the Add button when the site is closed

• Searching with terms that do not match code or status

---

Related Pages and Links

Create a scaffold

Edit a scaffold

Scaffold overview