# Gebäude-Dashboard

Das Gebäude-Dashboard ist Ihr zentrales Hub zur Verwaltung aller Objekte, auf die Sie auf der Magma-Plattform Zugriff haben. Es bietet einen Überblick über jedes Gebäude in Ihrem Portfolio mit schnellem Zugriff auf die Funktionen, Statusindikatoren und Verwaltungsaktionen jedes Gebäudes.

***

## Zugriff auf das Dashboard

Nach dem Anmelden ist das Gebäude-Dashboard der erste Bildschirm, den Sie sehen. Sie können jederzeit dorthin zurückkehren, indem Sie auf das Magma-Logo oder den Eintrag **Gebäude** in der Hauptnavigation klicken.

***

## Ansichtsmodi

Das Dashboard unterstützt zwei Ansichtsmodi, die über den Layout-Umschalter in der oberen rechten Toolbar umgeschaltet werden:

### Rasteransicht (Standard)

Gebäude werden als Karten in einem responsiven Raster angezeigt. Jede Karte bietet eine visuelle Momentaufnahme des Gebäudes:

* **Titelbild** — Das Titelfoto des Gebäudes (festgelegt über die Galerie-Funktion). Wenn kein Titelbild festgelegt wurde, wird ein Standard-Platzhalter angezeigt.
* **Gebäudename** — Gut sichtbar unter dem Bild angezeigt.
* **Adresse** — Stadt und Land des Gebäudes.
* **Gebäudetyp** — Einer der 9 unterstützten Typen: Hotel, Öffentlich, Industrie, Lager, Gemischte Nutzung, Gewerbe, Wohn, Büro oder Medizin.
* **Magma Index** — Ein kreisförmiger Fortschrittsindikator, der den Gesamtdokumentationsvollständigkeitsscore des Gebäudes anzeigt.
* **Status-Badge** — Spiegelt den aktuellen Betriebsstatus des Gebäudes wider (siehe Statusfarben und -symbole unten).
* **Schnellaktionsmenü** — Ein Drei-Punkte-Menü (⋯), das Zugriff auf Aktionen auf Gebäudeebene gibt, ohne das Gebäude öffnen zu müssen.

### Tabellenansicht

Gebäude werden als Zeilen in einer sortierbaren Tabelle angezeigt. Jede Zeile enthält folgende Spalten:

| Spalte      | Beschreibung                                              |
| ----------- | --------------------------------------------------------- |
| Gebäudename | Anklickbarer Link zum Öffnen des Gebäudes                 |
| Adresse     | Vollständige Adresse oder Stadt/Land                      |
| Typ         | Gebäudetyp-Bezeichnung                                    |
| Magma Index | Numerischer Score (%)                                     |
| Stakeholder | Anzahl der registrierten Stakeholder                      |
| Status      | Status-Badge (siehe unten)                                |
| Abonnement  | Aktueller Abonnementplan (Essential / Premium / Infinity) |
| Aktionen    | Schnellaktions-Symbole                                    |

Die Tabellenansicht ist besonders nützlich bei der Verwaltung großer Portfolios, da sie schnelleres Scannen und Sortieren über viele Gebäude hinweg ermöglicht.

***

## Gebäudestatus-Farben und Symbole

Jede Gebäudekarte oder -zeile zeigt einen Statusindikator, der den aktuellen Zustand widerspiegelt:

| Status     | Farbe       | Beschreibung                                                                                                                            |
| ---------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Aktiv      | Grün        | Das Gebäude ist voll funktionsfähig und alle Funktionen sind zugänglich.                                                                |
| Überfällig | Orange/Gelb | Eine Zahlung ist fehlgeschlagen. Bestimmte Funktionen können je nachdem, wie viele Tage die Zahlung überfällig ist, eingeschränkt sein. |
| Archiviert | Rot / Grau  | Das Gebäude wurde aufgrund anhaltender Nichtzahlung (Tag 60) archiviert. Alle Funktionen sind deaktiviert.                              |
| Pausiert   | Grau        | Das Abonnement wurde manuell pausiert.                                                                                                  |
| Storniert  | Rot         | Das Abonnement wurde storniert und wird nicht verlängert.                                                                               |

> **Hinweis:** Gebäude mit dem Status Überfällig oder Archiviert zeigen ein Banner innerhalb des Gebäudes an, das erklärt, welche Funktionen eingeschränkt sind und welche Maßnahmen erforderlich sind.

***

## Filter

Das Dashboard enthält eine Filterleiste über dem Gebäuderaster oder der Tabelle. Verfügbare Filter:

### Suche

Ein Volltextsuchfeld, das Gebäude nach Name oder Adresse filtert, während Sie tippen.

### Gebäudetyp

Ein Dropdown- oder Mehrfachauswahl-Filter, mit dem Sie nur Gebäude eines bestimmten Typs anzeigen können (z. B. nur Wohngebäude oder nur Büro und Gewerbe).

### Status

Filtern Sie nach dem aktuellen Status des Gebäudes: Aktiv, Überfällig, Pausiert, Storniert oder Archiviert.

### Abonnementplan

Filtern Sie nach dem Plantarif: Essential, Premium oder Infinity.

### Meine Rolle

Wenn aktiviert, werden nur Gebäude angezeigt, in denen Sie eine aktive Stakeholder-Rolle zugewiesen haben.

Filter können kombiniert werden. Die Ergebnisanzahl wird dynamisch aktualisiert, wenn Filter angewendet werden.

***

## Sortierung

Klicken Sie in der Tabellenansicht auf eine beliebige Spaltenüberschrift, um nach diesem Feld zu sortieren. Ein zweites Klicken kehrt die Sortierreihenfolge um (aufsteigend/absteigend). In der Rasteransicht ist ein Sortier-Dropdown in der Toolbar mit folgenden Optionen verfügbar:

* **Alphabetisch (A → Z)**
* **Alphabetisch (Z → A)**
* **Neueste zuerst** — Basierend auf dem Erstellungsdatum des Gebäudes.
* **Älteste zuerst** — Basierend auf dem Erstellungsdatum des Gebäudes.
* **Zuletzt geändert** — Basierend auf der neuesten Aktivität innerhalb des Gebäudes.
* **Magma Index** — Höchster Score zuerst.

***

## Aktionen pro Gebäude

### Von der Karte / Zeile

* **Gebäude öffnen** — Klicken Sie auf den Gebäudenamen, die Karte oder die Zeile, um in das Gebäude zu navigieren und auf alle seine Funktionen zuzugreifen.
* **Schnellaktionsmenü (⋯)** — Verfügbar beim Hovern oder per Rechtsklick auf eine Karte; verfügbar als Symbolspalte in der Tabellenansicht:
  * **Gebäudeinformationen bearbeiten** — Namen, Adresse, Typ oder Titelbild des Gebäudes aktualisieren.
  * **Stakeholder verwalten** — Das Stakeholder-Verwaltungspanel direkt öffnen.
  * **Abonnement anzeigen** — Das Abonnementdetails-Modal öffnen.
  * **Gebäude archivieren** — Ein Gebäude manuell archivieren (erfordert Eigentümer- oder Account-Manager-Rolle).
  * **Gebäude löschen** — Das Gebäude dauerhaft löschen (nicht rückgängig zu machen; erfordert Eigentümer-Rolle und Bestätigung).

### Ein neues Gebäude erstellen

Die Schaltfläche **+ Neues Gebäude** befindet sich gut sichtbar oben rechts im Dashboard. Ein Klick darauf startet den 5-stufigen Gebäudeerstellungs-Assistenten. Vollständige Details finden Sie im Leitfaden zur [Gebäudeerstellung](/magma-documentation/de/funktionen/building-creation.md).

***

## Leerzustände

### Noch keine Gebäude

Wenn Ihr Konto keine Gebäude hat, zeigt das Dashboard einen illustrierten Leerzustand mit der Meldung:

> „Sie haben noch keine Gebäude. Erstellen Sie Ihr erstes Gebäude, um loszulegen."

Eine Handlungsaufforderung **Gebäude erstellen** wird in der Mitte der Seite angezeigt.

### Keine Ergebnisse nach dem Filtern

Wenn die aktiven Filter keine passenden Gebäude zurückgeben, zeigt das Dashboard:

> „Keine Gebäude entsprechen Ihren Filtern."

Eine Schaltfläche **Filter zurücksetzen** ermöglicht das Zurücksetzen aller aktiven Filter mit einem Klick.

***

## Gebäudekarte — Detaillierte Aufschlüsselung

In der Rasteransicht werden beim Hovern über eine Gebäudekarte zusätzliche Interaktionsmöglichkeiten sichtbar:

| Element         | Position                | Beschreibung                                                          |
| --------------- | ----------------------- | --------------------------------------------------------------------- |
| Titelbild       | Oben auf der Karte      | Vollbreites Foto; Klicken öffnet das Gebäude.                         |
| Status-Badge    | Oben rechts überlagert  | Farbcodierter Punkt oder Bezeichnung, der den Betriebsstatus anzeigt. |
| Gebäudename     | Unter dem Bild          | Fettgedruckter Text; anklickbar.                                      |
| Gebäudetyp      | Unter dem Namen         | Kleine Bezeichnung in einer neutralen Farbe.                          |
| Adresse         | Unter dem Typ           | Stadt und Land.                                                       |
| Magma Index     | Unten auf der Karte     | Kreisförmiger Fortschrittsring mit prozentualer Bezeichnung.          |
| Aktionsmenü (⋯) | Oben rechts beim Hovern | Zeigt das Schnellaktions-Dropdown.                                    |

***

## Tipps für große Portfolios

* Verwenden Sie die **Tabellenansicht** für schnelleres Scannen bei der Verwaltung von mehr als 10 Gebäuden.
* Kombinieren Sie die Filter **Gebäudetyp** und **Status**, um Gebäude zu priorisieren, die Aufmerksamkeit erfordern (z. B. nach Überfällig + alle Typen filtern).
* Der **Magma Index**-Score hilft dabei, Gebäude mit unvollständiger Dokumentation zu identifizieren — sortieren Sie nach Index, um diejenigen zu finden, die am meisten Arbeit benötigen.
* Heften Sie häufig aufgerufene Gebäude mit dem Stern-/Lesezeichen-Symbol (wenn in Ihrem Plan verfügbar) ans Anfang des Rasters.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/de/funktionen/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
