Ambitwin · source-available, not open source · © 2026 Nicolò Ghignatti
| Word | Meaning | Example |
|---|---|---|
| Account | One person who can sign in | Lia |
| Organization | A customer. The unit that keeps data apart | northfield-university |
| Sub-organization | A part of an organization with its own access | physics under Northfield |
| Membership | “This person belongs here, with this role” | Lia in Northfield, Standard User |
| Role | How much a person may do inside one organization | Staff Member |
| Sign-in Method | How an organization checks people | Its own passwords, or the company login |
| Pass | Statement of who you are and your memberships | Lia’s pass, valid for minutes |
| Tenant | Same as Organization: one customer, kept apart from the others | Northfield and Acme are two tenants |
Question: who are you, and what may you do? Kind: Supporting. Needs: nothing.
Comes first because every other domain needs to know who is asking.
Lia studies at Northfield University and volunteers at a city museum. Both use Ambitwin.
So: a person is one thing, and their place inside an organization is another.
classDiagram
class Account {
name
email
}
class Membership {
organization
role
}
class Organization {
name
visibility
signInMethod
}
Account "1" *-- "many" Membership
Membership "many" ..> "1" Organization : by name
Organization "1" *-- "many" Organization : sub-organizationsThree roles. Each can do everything the one below can.
Domain Administrator > Staff Member > Standard User| Role | Can |
|---|---|
| Standard User | See buildings and live values, ask the assistant |
| Staff Member | Also edit rooms, connect sensors, set room limits |
| Domain Administrator | Also add buildings, onboard members, split the organization |
Checking is one rule: your role must be at least the one needed.
The Platform Administrator is not on this list. They run the platform and hold no membership.
The main thing this domain gives to the others.
who: lia@example.com
memberships: northfield-university Standard User
city-museum Staff Member
valid for: a short time
issued by: Identity & Access, and nobody elsesequenceDiagram
participant L as Lia
participant I as Identity & Access
participant B as Building Management
L->>I: sign in
Note over I: find account and memberships
I-->>L: pass
L->>B: buildings of northfield-university, here is my pass
Note over B: does the pass list northfield-university? yes
B-->>L: Science HallTrade-off: if Lia loses a role, her pass still shows the old one until it expires. That is why a pass lives only for minutes.