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.
3. Complete the Action
What the user does:
Add a scaffold (if creating)
Edit a scaffold
View a scaffold
Scaffold Status Lifecycle
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
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.
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.
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
Last updated