Zum Inhalt

Projekte in Cloudbrixx

Projekte sind eine der wichtigsten Zugriffssteuerungsebenen in Cloudbrixx. Sie bestimmen, welche Firmen und Personen auf welche Liegenschaften und Daten zugreifen können.

Schlüsselprinzip: In Cloudbrixx wird nahezu jeder Vorgang (Auftrag, technische Anlage, Budget usw.) einem Projekt zugeordnet. Das Projekt ist damit nicht nur Zugriffssteuerung, sondern der zentrale Organisationsrahmen für alle Arbeit im System.

Hamburger-Menü → „Liegenschaften" (hovern, nicht klicken) → Untermenü öffnet sich → „Projekte"

Wichtig: Klick auf „Liegenschaften" schließt das Menü. Nur Hover öffnet das Untermenü.

URL: /#/base/v2/projects

Projekttypen

In Cloudbrixx gibt es drei Projekttypen (API-Feld: projectType):

UI-Bezeichnung API-Typ Beschreibung
Freies Projekt open_realestate Kein Liegenschaftsbezug. Existiert unabhängig von Liegenschaften.
Stammprojekt realestate Automatisch erstelltes Root-Projekt pro Liegenschaft. isBaseProject=true. Dient als Ablage für liegenschaftsrelevante Stammdaten.
Liegenschaftsprojekt building Gebäudebezogenes Projekt. Manuell erstellbar, z.B. für Bauprojekte, Sanierungen oder Stammordner-Struktur.

Freies Projekt (open_realestate)

Beispiel: REAL-001 (Basisprojekt „REAL")

  • Kein Liegenschaftsbezug
  • propertyIds: []
  • Dient als Systembasis- oder Testprojekt
  • Erscheint nicht im Dashboard-Dropdown „Projekte / Liegenschaften wählen"
  • Dialog-Tabs: Grunddaten, Projektbeteiligte, Budgets, Notizen, Mittelabfluss, Zuständigkeiten

🔲 Ausbau ausstehend: Der fachliche Anwendungsfall von Freien Projekten (wann und warum man sie nutzt, wie sie sich im Arbeitsalltag unterscheiden) ist noch nicht dokumentiert. Dieser Abschnitt soll später erweitert werden.

Stammprojekt (realestate)

Beispiele: PS-FFM-00, CZ-B-00

  • Wird automatisch angelegt, wenn eine neue Liegenschaft erstellt wird
  • isBaseProject: true, isRealestateProject: true
  • Bezeichnet mit „Stammprojekt" (Projektbeschreibung: „Stammordner für die Speicherung der objektrelevanten Stammdaten")
  • Kann mehrere propertyIds referenzieren (mehrere Gebäude einer Liegenschaft)
  • Erscheint im Dashboard-Dropdown

Liegenschaftsprojekt (building)

Beispiele: PS-FFM-B1 (Bürogebäude), CZ-B-G1 (NEUBAU Meeting Center)

  • Liegenschafts- und gebäudebezogen
  • isRealestateProject: true, isPropertyProject: true
  • propertyIds: [<Gebäude-ID>] — in der Regel ein Gebäude
  • Extra Dialog-Tabs: Gebäude und Flächen (fehlen bei Freiem Projekt und Stammprojekt)
  • Tab „Gebäude" zeigt das verknüpfte Gebäude mit Portfolio, Eigentümer, Eigentümervertreter, Adresse

Projektzuordnung beim Anlegen von Vorgängen

Wenn ein Nutzer einen Auftrag, eine technische Anlage oder einen anderen Vorgang anlegt, wählt er aktiv ein Projekt aus einem Dropdown. Dieses Projekt gilt dann als Zugriffsfilter.

Ausnahme — Kontextableitung: Wenn ein Auftrag direkt an einem Budget angelegt wird, das bereits einem Projekt zugeordnet ist, ergibt sich die Projektzuordnung automatisch aus dem Kontext.

Wer sieht den Vorgang? Nur Nutzer, die dem Projekt zugeordnet sind (als Projektbeteiligte). Ausnahme: Ergänzende systemweite Berechtigungen können eine projektübergreifende Sicht erlauben (→ Berechtigungssystem, konfigurierbar im Admin-Bereich).

Zugriffssteuerung durch Projekte (3 Ebenen)

Projekt
 ├── Projektbeteiligte → Firmen    (Welche Firmen haben Zugang?)
 ├── Projektbeteiligte → Personen  (Welche Kontakte haben Zugang?)
 └── Zuständigkeiten               (Wer trägt welche Rolle?)

Ebene 1: Projektbeteiligte → Firmen

Firmen werden dem Projekt zugeordnet. Über den API-Parameter allow_all_users kann gesteuert werden, ob alle Kontakte der Firma automatisch Zugang erhalten oder ob Personen einzeln eingetragen werden müssen.

Ebene 2: Projektbeteiligte → Personen

Individuelle Kontaktpersonen werden dem Projekt zugeordnet — unabhängig von der Firmenzuordnung.

Ebene 3: Zuständigkeiten

Rollen-basierte Verantwortlichkeiten innerhalb von drei Gruppen:

Rolle Gruppe
Accounting Asset Management
Facility Manager Facility Management
Portfolio Manager Asset Management
TPM (Technischer Property Manager) Property Management

Zu jeder Rolle kann ein „Projektverantwortlicher Nutzer" eingetragen werden.

Dashboard-Dropdown „Projekte / Liegenschaften wählen"

Der Dropdown oben rechts im Dashboard filtert den Kontext des eingeloggten Nutzers. Nur Projekte vom Typ realestate und building erscheinen dort. Freie Projekte (open_realestate) tauchen im Dropdown nicht auf.

Das bedeutet: Ein Nutzer, der nur in einem Freien Projekt als Beteiligter eingetragen ist, sieht den Dropdown leer — auch wenn er technisch Zugang hat.

Dialog-Tabs im Überblick

Tab Freies Projekt Stammprojekt Liegenschaftsprojekt
Grunddaten ✓ ✓ ✓
Gebäude – – ✓
Flächen – – ✓
Projektbeteiligte ✓ ✓ ✓
Budgets ✓ ✓ ✓
Notizen ✓ ✓ ✓
Mittelabfluss ✓ ✓ ✓
Zuständigkeiten ✓ ✓ ✓

Projektliste: Demo-Daten (demo-hw)

Alias Bezeichnung Typ (API) Liegenschaft Gebäude-IDs
REAL-001 Basisprojekt „REAL" open_realestate – –
PS-FFM-B1 Projekt: Bürogebäude building Prime Space Office Frankfurt 4
CZ-B-G1 Projekt: NEUBAU Meeting Center Hauptbau building MCB Meeting Center Berlin 5
GN-001 Stammordner GN building Prime Space Plaza Offenbach 6
GS-001 Stammordner GS building Prime Space Plaza Offenbach 7
PS-FFM-00 Stammprojekt realestate Prime Space Office Frankfurt 4
CZ-B-00 Stammprojekt realestate MCB Meeting Center Berlin 5

API-Zugriff

# Liste aller Projekte
GET /slimAPI/connectors/v1/projects

# Suche mit Paginierung
POST /slimAPI/connectors/v1/projects/search
{
  "offset": 0,
  "limit": 50
}

# Einzelnes Projekt
GET /slimAPI/connectors/v1/projects/{id}

Wichtige API-Felder

Feld Bedeutung
id Numerische ID
alias Projektcodierung (z.B. „PS-FFM-B1")
name Bezeichnung
projectType open_realestate | realestate | building
isBaseProject true bei Stammprojekten
isRealestateProject true bei Liegenschaftsprojekten
isPropertyProject true bei gebäudebezogenen Projekten
propertyIds Liste der verknüpften Gebäude-IDs

Firma einem Projekt zuweisen (API)

PATCH /slimAPI/connectors/v1/companies/{company_id}/assignProjects
{
  "id": {company_id},
  "projects": [{
    "project_id": {project_id},
    "allow_all_users": true
  }]
}

Verwandte Themen