Skip to main content

Basics

Organizations​

Corvina is a multi-tenant platform. This means that multiple customers can use the same Corvina instance. Each customer has its own namespace.

We call a namespace a top-level organization.

The top-level organization is a logical container for all the resources that belong to the customer. The top-level organization is also used to isolate the customer from other customers.

The top-level organization is also the root of the hierarchy of organizations. Each organization can have one or more sub-organizations.

Organization tree

info

We use the field organizationId in the API to refer to the top-level and sub-organizations. This organizationId is a unique identifier for the organization.

Instances​

Corvina is software built on top of microservice architecture pattern and is deployed multiple times. For sake of simplicity, we call each deployment an instance of Corvina software.

We create multiple instances for different reasons:

  • keep low latency for our organization
  • legal reasons
  • Corvina can be deployed as a white label software

In each instance, we can have multiple top-level organizations as we can see in the following picture:

Corvina instances

We would however emphasize that we adopt a one-software policy. This means that each Corvina instance has always the same software version.

info

We use the field instanceId in the API to refer to the Corvina instance. This instanceId is a unique UUID across all the instances.