FOCUS organizes all data in a common structure that mimics the real-world relationship between the physical location of assets, the ownership of those assets, and the work performed to support those assets.

Understanding this structure will help you navigate FOCUS more easily.


Table of Contents

Data Structures

<aside> 💡 There are 4 main data structures in FOCUS:

</aside>

  1. Organizations: Synonymous with a company, an organization represents the legal entity who owns an asset or performs services. Organizations sit at the top of the data structure.
  2. Facilities: Synonymous with a building or construction address, a facility represents the physical location and associated attributes of a solar farm, wind turbine, warehouse, etc. Many facilities can belong to a single organization.
  3. Projects: The term project is often used by (our) customers to represent a facility, but for (us) a project is a body of work, or services (we) provide as a supplier. A facility may have many projects that include separate scopes of services (we) provide throughout the life cycle of a facility. During initial construction, project #1 may include an interconnection and SCADA system. Later project #2 may include an extended warranty or services package. Many projects can belong to a single facility.
  4. Users: Users are represented by user accounts and are uniquely identified by their email address. Users may be invited to an organization, a facility, or a project with unique permissions to each. Users who are invited to an organization or facility automatically have access to all data structures below where they were invited via inherited permissions. Users can belong to multiple organizations, facilities, and projects with different permissions for each.

Data Hierarchy

An organizational tree is the easiest way to picture the relationship between organizations, facilities and projects.

The example diagram below depicts a single organization, with three facilities, each facility with its own project(s).

focus_data_hierarchy.png

User Assignments

When a user is assigned to any part of this organizational tree, the user has access to the data structures at and below the level of assignment, but not above.

Example #1 - Assigning a user to the ACME Energy, Inc (an organization) grants the user access to:

Example #2 - Assigning a user to proposal #2 (a project) below Go Big Solar (a facility) grants the user access to only Proposal #2.