Datenhierarchie in Cloudbrixx REAL¶

Die Hierarchie¶

Mandat
 └── Portfolio
      └── Liegenschaft
           └── Gebäude
                └── Einheit

Bedeutung der Ebenen¶

Ebene	Beschreibung	Beispiel
Mandat	Höchste Organisationsebene, repräsentiert den Auftraggeber	„Claude-Fonds GmbH"
Portfolio	Fasst mehrere Liegenschaften zu einer Verwaltungseinheit zusammen	„Claude Immobilien Portfolio"
Liegenschaft	Physisches Grundstück / zusammenhängendes Areal mit Adresse	„Musterstraße 1"
Gebäude	Physisches Objekt auf der Liegenschaft	„Mustergebäude 1"
Einheit	Vermietbare Einheit (Wohnung, Büro, Gewerbe)	„Wohnung 2.OG links"

Das Gebäude als Verbindungselement¶

Das Gebäude ist das zentrale Verbindungsstück der gesamten Hierarchie:

Mandat und Portfolio werden nicht direkt an der Liegenschaft gesetzt
Erst am Gebäude werden alle drei oberen Ebenen verknüpft (Mandat, Portfolio, Liegenschaft)
Das Setzen von portfolio_id am Gebäude kaskadiert automatisch zur Liegenschaft

Empfohlene Anlege-Reihenfolge (Praxis)¶

Beim Aufbau eines kompletten neuen Datensatzes hat sich diese Reihenfolge bewährt (verprobt am Demodatensatz Elbe & Pleiße):

Eigentümer-Firma in Firmen & Kontakte anlegen (Firmentyp „Eigentümer") — wird als Vertragspartner des Mandats, Eigentümer des Portfolios und Kontaktrolle am Gebäude gebraucht
Mandat anlegen (Vertragspartner = Eigentümer-Firma, Vertretungsformel)
Portfolio anlegen (Eigentümer = Eigentümer-Firma) — vor dem ersten Gebäude, da das Portfolio im Gebäude-Wizard Pflicht ist
Liegenschaft anlegen (Adresse, Nutzungsart laut Bebauungsplan, Objekt-Bild)
Gebäude anlegen — hier werden Mandat und Portfolio zugeordnet (kaskadiert zur Liegenschaft)
Eigentümer als Kontaktrolle am Gebäude hinterlegen (Tab Kontakte); die Liegenschaft zeigt die Kontaktrollen nur aggregiert an

Technische Felder (API)¶

Am Gebäude-Objekt (base/property) werden gesetzt:

Feld	Bedeutung
`mandate_id`	ID des Mandats
`portfolio_id`	ID des Portfolios
`realestate_id`	ID der Liegenschaft

API-Update: POST /slimAPI/base/properties mit {id: "X", ...} im Body. Nicht PUT/PATCH oder POST /properties/{id} (letzteres legt ein neues Gebäude an!).

Flächentypen¶

Cloudbrixx unterscheidet vier Flächentypen, die an Gebäuden und Liegenschaften strukturiert werden können:

Flächentyp	Beschreibung
Gebäudeflächen	Bebaute Außenfläche, auf der ein Gebäude steht; untergliedert sich als Baumstruktur (s.u.)
Grünflächen	Rasenflächen, Bepflanzungen, Gärten auf dem Grundstück; keine Untergliederung
Grauflächen	Versiegelte Außenflächen; können als Parkplatz/Stellplatz untergliedert werden
Wasserflächen	Teiche, Brunnen, Löschwasserbecken, Gewässer auf dem Grundstück; keine Untergliederung

Flächenhierarchie Gebäudefläche¶

Gebäudefläche
 └── Bauteil (optional, z.B. Flügel A / Flügel B desselben Gebäudes)
      └── Stockwerk (Etage)
           └── Raum / Mieteinheit (z.B. Büro, Wohnung, Technikraum)

Bauteil ≠ Gebäude: Ein Bauteil ist eine Gliederungsebene innerhalb eines einzigen Gebäudes — z.B. Ost- und Westflügel. Stehen auf einem Grundstück zwei physisch getrennte Gebäude, müssen diese als separate Gebäude-Objekte in Cloudbrixx angelegt werden, nicht als Bauteile.

Flächenhierarchie Graufläche¶

Graufläche
 └── Parkplatz / Stellplatz (optional)