User Roles & Permissions
Understand the hierarchical user roles in Deficiency Detect, including Organization Admins, Project Admins, and Building Trades, and their specific access levels and constraints.
Deficiency Detect employs a clear, hierarchical role-based access system to ensure that every team member has the precise level of control and access needed for their responsibilities, promoting both efficiency and data security. Understanding these roles is key to managing your projects effectively.
Role Hierarchy Overview
Our system features three primary roles, each with a defined scope of control that cascades down the organizational structure:
- Organization Admin / Owner
- Project Admin
- Building Trade
This hierarchy ensures that individuals at higher levels of the structure have broader oversight, while those at lower levels have focused access relevant to their day-to-day tasks.
Detailed Role Breakdown
1. Organization Admin (and Owner)
The Organization Admin holds the highest level of control within an organization.
- Scope of Control: Possesses complete control over all projects, all buildings, all users, and all billing information within their respective organization. They can create, edit, delete, and manage every aspect of the organization's data and structure.
- Organization Owner: The user who initially creates an organization automatically becomes its Organization Owner, a special designation of an Organization Admin. The Owner has the same full control but cannot be removed from the organization unless the title is switched to a different member.
- Key Responsibility: Managing overall organizational settings, user access at all levels, and financial aspects.
2. Project Admin
The Project Admin is responsible for managing specific construction projects.
- Scope of Control: Has full control over their assigned project(s) and all buildings and users within those assigned project(s). They can add/remove project team members, manage project settings, and oversee all deficiencies related to their projects.
- Important Constraint: A user cannot be a Project Admin in an organization where they are already an Organization Admin. This prevents redundant permissions and encourages clear responsibility lines.
- Key Responsibility: Day-to-day project oversight, team management within projects, and ensuring project completion.
3. Building Trade
The Building Trade role is designed for field-level accessibility, focusing on the execution of work related to deficiencies.
- Scope of Control: Primarily has access to assigned buildings only within specific projects. They can view, update the status of, and add details (like photos or comments) to deficiencies within their designated buildings. They do not have broad management capabilities over projects or other users.
- Important Constraint: A user cannot be a Building Trade under a project where they are already a Project Admin. This separation ensures that roles are distinct and avoids confusion in responsibilities.
- Key Responsibility: Directly addressing and updating the status of deficiencies on-site within specific buildings.
By adhering to this structured permission system, Deficiency Detect ensures data integrity, clear lines of responsibility, and efficient workflow for all users across your construction projects.