# Aktivitätsfeed

Der Aktivitätsfeed ist Ihr Echtzeit-Stream von allem, was auf der Magma-Plattform in Ihren Gebäuden passiert. Er zeigt relevante Ereignisse, Benachrichtigungen und Aktionselemente aus allen Gebäuden, in denen Sie Beteiligter sind, in einem einzigen, chronologischen Feed — damit Sie keine wichtige Aktualisierung verpassen.

***

## Zugang zum Aktivitätsfeed

Der Aktivitätsfeed ist über das Element **Aktivität** in der linken Hauptnavigationsseitenleiste zugänglich. Ein **ungelesenes Badge** auf dem Navigationselement zeigt die Anzahl der nicht gesehenen Elemente an.

***

## Feed-Layout

Der Aktivitätsfeed ist eine vertikal scrollbare Liste von Ereigniselementen. Oben auf der Seite ermöglicht ein **Gebäude-Karussell** das Filtern des Feeds nach einem bestimmten Gebäude.

### Gebäude-Karussell

Eine horizontale Reihe von Gebäude-Miniaturbildern oben im Feed. Jedes Miniaturbild repräsentiert ein Gebäude mit aktueller Aktivität. Ein Klick auf ein Miniaturbild filtert den Feed, um nur Ereignisse aus diesem Gebäude anzuzeigen. Erneut klicken (oder auf „Alle Gebäude" klicken), um den Filter zu entfernen.

Im Karussell werden nur Gebäude mit aktueller Aktivität angezeigt — Gebäude ohne aktuelle Ereignisse werden nicht angezeigt.

***

## Feed-Elemente

Jedes Element im Aktivitätsfeed repräsentiert ein einzelnes Ereignis und enthält folgende Elemente:

| Element                   | Beschreibung                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Gebäude-Miniaturbild**  | Ein 56×56 px Bild des Gebäudes (Titelfoto). Ein Klick öffnet das Gebäude.                              |
| **Titel**                 | Ein prägnanter Titel, der das Ereignis beschreibt (z. B. „Dokument erfordert Validierung").            |
| **Ereignistyp-Badge**     | Eine farbige Kennzeichnung, die die Kategorie angibt: DOCUMENT, REMINDER oder ANNOUNCEMENT.            |
| **Beschreibung**          | Eine detaillierte Beschreibung des Geschehens, einschließlich kontextueller Informationen.             |
| **Relativer Zeitstempel** | Wie lange das Ereignis zurückliegt (z. B. „vor 2 Stunden", „Gestern").                                 |
| **Aktionsschaltfläche**   | Eine kontextbezogene Schaltfläche zum Ergreifen der geeigneten Maßnahme als Reaktion auf das Ereignis. |

### Kontextuelle Details in Beschreibungen

Beschreibungen enthalten dynamische Referenzen, um Ereignisse sofort verständlich zu machen:

* **Beteiligtenname** — Wer die Aktion durchgeführt hat (z. B. „Marie Dupont hat ein neues Dokument hochgeladen").
* **Dokumentname** — Der Name des betroffenen Dokuments.
* **Dokumentversion** — Die Versionsnummer des beteiligten Dokuments.
* **Ablehnungsgrund** — Wenn ein Dokument oder Datensatz abgelehnt wurde, wird der Ablehnungsgrund inline in der Beschreibung angezeigt.

***

## Ereignistypen

Aktivitätsfeed-Elemente sind in 3 Typen kategorisiert:

| Typ              | Badge             | Beschreibung                                                                                                                     |
| ---------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **DOCUMENT**     | Blau oder neutral | Ereignisse im Zusammenhang mit Dokument-Uploads, Validierungen, Ablehnungen, Ersetzungen oder Zugriffen.                         |
| **REMINDER**     | Gelb oder orange  | Automatisierte Erinnerungen für bevorstehende oder überfällige Aktionen (z. B. ablaufende Dokumente, ausstehende Validierungen). |
| **ANNOUNCEMENT** | Grün oder lila    | Plattformweite oder gebäudeweite Ankündigungen (z. B. neue Funktionsveröffentlichungen, Gebäudestatusänderungen).                |

***

## Aktionsschaltflächen

Jedes Aktivitätsfeed-Element enthält eine Aktionsschaltfläche, die direkt zur relevanten Funktion oder zum relevanten Workflow verlinkt. Die Schaltflächenbeschriftung ändert sich je nach Ereignistyp:

| Aktionsschaltfläche          | Wann angezeigt                                                                               | Aktion                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Dokument anzeigen**        | Ein Dokument wurde hochgeladen, validiert, abgelehnt oder aktualisiert.                      | Öffnet das Dokument im Data Room.                                 |
| **3D-Modellobjekt anzeigen** | Ein BIM-Objektereignis ist aufgetreten (Feldänderung eingereicht, genehmigt oder abgelehnt). | Öffnet den BIM 3D Viewer am spezifischen Objekt über Deep Link.   |
| **Einladung anzeigen**       | Ein neuer Beteiligter wurde zum Gebäude eingeladen.                                          | Öffnet die Details der Beteiligten-Einladung.                     |
| **Anfrage überprüfen**       | Ein Beteiligter hat eine Zugriffsanfrage für ein Dokument gestellt.                          | Öffnet den Workflow zur Genehmigung der Zugriffsanfrage.          |
| **Validator zuweisen**       | Ein Dokument wurde ohne zugewiesenen Validator hochgeladen.                                  | Öffnet das Dokument-Upload-Formular zum Zuweisen von Validatoren. |
| **Losteilung anzeigen**      | Ein Ereignis ist im Abschnitt Losteilung aufgetreten.                                        | Öffnet den Losteilungsabschnitt für das Gebäude.                  |
| **Energiezähler anzeigen**   | Ein Ereignis ist im Abschnitt Fluid Synoptic aufgetreten.                                    | Öffnet den Fluid Synoptic-Abschnitt für das Gebäude.              |
| **Aufgaben anzeigen**        | Eine neue Aufgabe wurde für den Benutzer erstellt.                                           | Öffnet das Aufgabenpanel für das relevante Gebäude.               |
| **Kommentar anzeigen**       | Ein neuer Anmerkungskommentar wurde einem Dokument hinzugefügt.                              | Öffnet das Dokument im Viewer an der Anmerkungsposition.          |

***

## Nicht gesehene Elemente

Aktivitätsfeed-Elemente, die noch nicht angesehen wurden, sind visuell mit einer **primaryLighter-Hintergrundfarbe** hervorgehoben. Dies erleichtert das Scannen bis zur letzten gesehenen Position und das Identifizieren neuer Ereignisse auf einen Blick.

### Automatisches Löschen beim Laden der Seite

Wenn Sie zur Aktivitätsfeed-Seite navigieren, werden alle aktuell sichtbaren Elemente automatisch als „gesehen" markiert. Das ungelesene Badge in der linken Navigation wird beim Besuch des Feeds gelöscht. Neue Ereignisse, die nach Ihrem Öffnen des Feeds eintreffen, werden mit der Hervorhebung angezeigt, bis Sie die Seite neu laden oder erneut besuchen.

***

## Sortierung

Der Aktivitätsfeed ist nach **occurredOn absteigend** sortiert — die neuesten Ereignisse erscheinen oben. Diese Sortierreihenfolge wird als **Benutzerpräferenz** gespeichert, sodass Ihre gewählte Sortierreihenfolge zwischen Sitzungen erhalten bleibt.

Derzeit ist die primäre Sortierung nach Aktualität (neueste zuerst), was sicherstellt, dass die aktuellsten und zeitkritischsten Ereignisse immer oben in Ihrem Feed stehen.

***

## Filtern nach Gebäude

Verwenden Sie das **Gebäude-Karussell** oben im Feed, um nur Ereignisse aus einem bestimmten Gebäude anzuzeigen:

1. Klicken Sie auf ein Gebäude-Miniaturbild im Karussell.
2. Der Feed filtert sich, um nur Ereignisse aus diesem Gebäude anzuzeigen.
3. Klicken Sie dasselbe Miniaturbild erneut an, oder klicken Sie auf die Option „Alle", um zum ungefilterten Feed zurückzukehren.

Dies ist besonders nützlich bei der Verwaltung eines großen Portfolios — Sie können sich jeweils auf ein Gebäude konzentrieren und seine Aktivitätselemente durcharbeiten, bevor Sie zum nächsten wechseln.

***

## Häufige Aktivitätsfeed-Szenarien

### Dokument zur Validierung eingereicht

Ein Teammitglied lädt ein Dokument hoch und weist Sie als Validator zu. Sie sehen:

* **Ereignistyp:** DOCUMENT
* **Titel:** „Dokument erwartet Ihre Validierung"
* **Beschreibung:** „\[Name] hat \[Dokumentname] v2 im Abschnitt \[Ebene] hochgeladen."
* **Aktion:** Dokument anzeigen → öffnet das Dokument, damit Sie es überprüfen und validieren können.

### Dokument abgelehnt

Sie haben ein Dokument hochgeladen und ein Validator hat es abgelehnt. Sie sehen:

* **Ereignistyp:** DOCUMENT
* **Titel:** „Ihr Dokument wurde abgelehnt"
* **Beschreibung:** „\[Validatorname] hat \[Dokumentname] abgelehnt — Grund: \[Ablehnungsgrund inline angezeigt]."
* **Aktion:** Dokument anzeigen → öffnet das Dokument, damit Sie den Ablehnungsgrund überprüfen und eine korrigierte Version hochladen können.

### Zugriffsanfrage erhalten

Eine externe Partei hat Zugriff auf ein Dokument angefordert, das Ihnen gehört. Sie sehen:

* **Ereignistyp:** DOCUMENT
* **Titel:** „Zugriffsanfrage für \[Dokumentname]"
* **Beschreibung:** „\[Anfordername] beantragt Zugriff auf \[Dokumentname]."
* **Aktion:** Anfrage überprüfen → öffnet den Genehmigungs-/Ablehnungsworkflow.

### Dokumentanmerkung

Ein Beteiligter hat einen Kommentar auf einer Dokumentseite hinterlassen. Sie sehen:

* **Ereignistyp:** DOCUMENT
* **Titel:** „Neuer Kommentar zu \[Dokumentname]"
* **Beschreibung:** „\[Beteiligtenname] hat auf Seite \[X] von \[Dokumentname] kommentiert."
* **Aktion:** Kommentar anzeigen → öffnet den Dokument-Viewer an der Kommentarposition.

### Erinnerung: Ablaufendes Dokument

Die Gültigkeit eines Dokuments nähert sich dem Ablaufdatum. Sie sehen:

* **Ereignistyp:** REMINDER
* **Titel:** „Dokument läuft bald ab"
* **Beschreibung:** „\[Dokumentname] läuft am \[Datum] ab. Laden Sie eine erneuerte Version hoch, um eine Indexstrafe zu vermeiden."
* **Aktion:** Dokument anzeigen → öffnet das Dokument zum Ersetzen.

***

## Tipps zur Verwendung des Aktivitätsfeeds

* Überprüfen Sie den Aktivitätsfeed **täglich**, um mit Validierungsanfragen und Ablauferinnerungen auf dem Laufenden zu bleiben — nicht angesprochene Aufgaben häufen sich an und können die Magma Index-Progression verlangsamen.
* Verwenden Sie den **Gebäude-Karussell-Filter**, wenn ein bestimmtes Gebäude Aufmerksamkeit benötigt — er eliminiert Rauschen von anderen Gebäuden.
* Reagieren Sie auf **REMINDER**-Ereignisse zeitnah — ablaufende Dokumente verursachen sofort eine Magma Index-Strafe, sobald sie ihr Ablaufdatum passieren.
* Die **Anfrage überprüfen**-Aktion ist zeitkritisch — externe Parteien, die auf Zugriff warten, benötigen eine Antwort, um ihre Arbeit fortzuführen.
* Wenn Sie ein großes Team verwalten, ist der Aktivitätsfeed eine effiziente Möglichkeit, alle Beteiligtenaktionen im Gebäude zu überwachen, ohne jeden einzelnen Abschnitt öffnen zu müssen.


---

# 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/activity-feed.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.
