Organization hierarchy
PlatformModel hospital groups, clinic networks, pharmacy chains, departments and other nested organizational structures.
Isolation
Tenant-scoped by design
Hierarchy
Organizations + sub-organizations
Access
Membership + role context
Configuration
Policies, modules & branding
Overview
Hierarchy expresses business structure; it does not bypass tenant isolation or permission checks.
Hierarchy model
LEVEL 1
Group
Hospital Group
LEVEL 2
Organization
Luxembourg Clinic
LEVEL 3
Unit
Cardiology
LEVEL 4
Tenant
Cardiology workspace
Parent and child organizations
| Pattern | Recommended model |
|---|---|
| Hospital group → hospitals | Parent organization with child organizations |
| Pharmacy chain → branches | Group organization with branch tenants / locations |
| Clinic → departments | Organization with locations or sub-organizations depending on governance |
| SaaS provider → customers | Provider organization with customer-owned tenants; never merge customer data |
Common patterns
Choose the smallest boundary that needs independent access control, configuration or data isolation as a tenant. Use organization hierarchy for governance and ownership.
Example
Organization hierarchyCopy
{
"id": "org_hospital_group",
"children": [
{ "id": "org_clinic_01", "tenant_ids": ["tnt_clinic_01"] },
{ "id": "org_clinic_02", "tenant_ids": ["tnt_clinic_02"] }
]
}