Scaffolds
View and manage scaffolds by status, search the list, open scaffold details, and add new scaffolds.
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.
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:
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:
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)
Scaffold Status Lifecycle
Scaffold is to be erected
Scaffold has failed a safety inspection
Scaffold is erected and green tagged
Scaffold has been dismantled
Key Rules and Notes
Shown only when the view permission is granted
Shown only when site is not closed and create permission is granted
Searches by code or status text
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
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
Confirm site is not closed and user has create permission
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
