/

Ambitwin · source-available, not open source · © 2026 Nicolò Ghignatti

Building Management

Keywords on this page
WordMeaningExample
BuildingOne real structureScience Hall
Building DescriptionWhat a person provides so a twin can be madeScience Hall: three floors, 40 rooms
FloorOne level of a buildingFloor 2
RoomA bounded space on a floorLab 2
PositionWhere a room sits, as x, y, z12, 4, 6
SizeWidth, height, depth10 by 3 by 8 m
CapacityHow many people a room is meant for30
HighlightA mark making a room stand outExam room this week
TwinThe 3D copy of a real buildingThe 3D Science Hall
OrganizationA customer, the owner of buildingsnorthfield-university
PassStatement of who you are and your membershipsLia’s pass lists Northfield

Question: what does the place look like? Kind: Core. Needs: Identity & Access, to know whose building it is.

The 3D twin is the product. Everything live is drawn on top of this model.


In the real world

Ada runs facilities at Northfield. She has a description of Science Hall: three floors, 40 rooms, where each room is and how big.


The model

classDiagram
    class Building {
        name
        organizations
        status
    }
    class Room {
        name
        floor
        capacity
        highlighted
    }
    class Position {
        x
        y
        z
    }
    class Size {
        width
        height
        depth
    }
    Building "1" *-- "many" Room
    Room "1" *-- "1" Position
    Room "1" *-- "1" Size

From description to twin

stateDiagram-v2
    [*] --> Refused: description is invalid
    [*] --> Accepted: description is valid
    Accepted --> Ready: twin is built
    Ready --> [*]: Building Ready news
    Refused --> [*]: error says what failed

Example of a refusal:

Ada describes Science Hall
Room "Lab 2" has width -10
Refused: room "Lab 2": width must be above 0
Result: no building

Rules

  1. A Building belongs to one or more Organizations, by name.
  2. A shared Building exists once. Two organizations see the same one.
  3. You see a Building only if it belongs to one of the organizations on your pass.
  4. The twin matches the real building: each Room at its real Position and Size.
  5. Each Room belongs to one Floor.

Rule 3 needs only the pass:

Lia's pass says:           northfield-university
Science Hall belongs to:   northfield-university, city-of-northfield
Overlap?                   yes, so she sees it

Harbour Tower belongs to:  acme
Overlap?                   no, so she does not

What leaves this domain

WhatHowTo whom
Building Ready, with its roomsNewsIngestion sets starting limits, Distribution sets starting Focus
Which organizations own a buildingAnswer to a questionAlerting
What a building looks likeAnswer to a questionKnowledge & Assistance

A building exists on its own. It does not depend on its limits or its Focus.


Open questions