[INTRODUCTION]
Organisations
Every resource within PLTFRMS is tied to an organisation. An organisation acts as a namespace, ensuring that data, resources, and operations are logically grouped and isolated.
This means that everything you create β whether itβs invoices, users, or other resources β exists within the context of a specific organisation.
Namespacing
Organisations define clear boundaries:
- Resources are scoped to a single organisation
- There is no overlap between organisations
- Access and permissions are enforced at the organisation level
This structure allows you to safely manage multiple environments, clients, or use cases within the same platform.
Sub-organisations
Organisations can be structured hierarchically using sub-organisations.
This is useful for scenarios such as:
- Resellers managing multiple customers
- Multi-tenant platforms separating client data
- Internal structures such as departments or environments
Each sub-organisation operates independently, while still being part of a larger organisational structure.
Why it matters
Using organisations as namespaces provides:
- Clear separation of data
- Scalable multi-tenant architecture
- Flexible delegation and access control
It also ensures that as your platform grows, your structure remains manageable and predictable.