# Aufgaben

Das Aufgabensystem ist Magmas integrierte Aktionsverwaltungsebene. Aufgaben werden automatisch erstellt, wenn auf der Plattform Ereignisse auftreten, die die Aufmerksamkeit der Beteiligten erfordern — wie Dokumente, die auf Validierung warten, abgelaufene Dokumente, die erneuert werden müssen, oder DTT-Minting-Voraussetzungen. Aufgaben stellen sicher, dass nichts übersehen wird.

***

## Überblick

Aufgaben werden:

* **Automatisch erstellt**, wenn auslösende Domänenereignisse auftreten (z. B. ein Dokument wird zur Validierung eingereicht).
* **Automatisch abgeschlossen**, wenn die entsprechende Aktion durchgeführt wird (z. B. ein Validator genehmigt das Dokument).
* **Historisch bewahrt** — abgeschlossene und archivierte Aufgaben verbleiben zu Prüfzwecken in der Historie.

***

## Aufgabentypen

Es gibt 10 Aufgabentypen, in 3 Gruppen organisiert:

### DOCUMENTS-Gruppe

| Aufgabentyp                    | Beschreibung                                                                                                          | Zugewiesen an                 |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **VALIDATE\_DOCUMENT**         | Ein Dokument wurde zur Validierung eingereicht und wartet auf die Überprüfung des Validators.                         | Zugewiesene Validatoren       |
| **UPDATE\_EXPIRED\_DOCUMENT**  | Die Gültigkeitsdauer eines Dokuments ist abgelaufen und muss aktualisiert oder ersetzt werden.                        | Dokumenteigentümer / Uploader |
| **UPDATE\_REJECTED\_DOCUMENT** | Ein Dokument wurde von einem Validator abgelehnt. Der Eigentümer muss die Ablehnung ansprechen und erneut einreichen. | Dokumenteigentümer / Uploader |

### 3D\_MODEL-Gruppe

| Aufgabentyp                            | Beschreibung                                                                                               | Zugewiesen an               |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------- |
| **VALIDATE\_3D\_MODEL\_FIELD**         | Eine BIM-Feldänderungsanfrage wurde eingereicht und wartet auf die Genehmigung des Validators.             | Zugewiesene BIM-Validatoren |
| **UPDATE\_REJECTED\_3D\_MODEL\_FIELD** | Eine BIM-Feldänderungsanfrage wurde abgelehnt. Der Einreicher muss sie überarbeiten und erneut einreichen. | Feldänderungsanforderer     |

### ENERGY\_METERS-Gruppe (Fluid Synoptic)

| Aufgabentyp                         | Beschreibung                                                                                           | Zugewiesen an                 |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------- |
| **VALIDATE\_ENERGY\_METER**         | Ein Energiezählerdatensatz wurde zur Validierung eingereicht und wartet auf die Validator-Überprüfung. | Zugewiesener Zähler-Validator |
| **UPDATE\_REJECTED\_ENERGY\_METER** | Ein Energiezählerdatensatz wurde abgelehnt. Der Einreicher muss korrigieren und erneut einreichen.     | Zähler-Datensatz-Einreicher   |

### Weitere Gruppen

| Aufgabentyp                         | Gruppe    | Beschreibung                                                                             | Zugewiesen an           |
| ----------------------------------- | --------- | ---------------------------------------------------------------------------------------- | ----------------------- |
| **MINT\_DTT**                       | DTT       | Die Minting-Voraussetzungen sind erfüllt und das Gebäude ist bereit für ein DTT-Minting. | Gebäudeeigentümer / KV  |
| **VALIDATE\_LOT\_DIVISION**         | DOCUMENTS | Ein Losteilungsdatensatz wurde zur Validierung eingereicht.                              | Zugewiesene Validatoren |
| **UPDATE\_REJECTED\_LOT\_DIVISION** | DOCUMENTS | Ein Losteilungsdatensatz wurde abgelehnt und muss korrigiert werden.                     | Datensatz-Einreicher    |

***

## Aufgaben-Modi

Das Aufgabenpanel bietet zwei Anzeigemodi:

### USER-Modus (Meine Aufgaben)

Zeigt nur Aufgaben, die Ihnen persönlich zugewiesen sind. Dies ist der Standardmodus und die am häufigsten verwendete Ansicht — es ist Ihre persönliche To-do-Liste der Aktionen, die in den Gebäuden erforderlich sind, an denen Sie Beteiligter sind.

### ALL-Modus (Alle Aufgaben)

Zeigt alle Aufgaben im Gebäude, unabhängig davon, wem sie zugewiesen sind. In diesem Modus wird eine zusätzliche **Verantwortliche**-Spalte angezeigt, die zeigt, welcher Beteiligte für jede Aufgabe verantwortlich ist. Dieser Modus ist für Eigentümer und Kontoverwalter zur Übersicht und Teamverwaltung verfügbar.

***

## Aufgabenpanel im BIM 3D Viewer

Das Aufgabenpanel ist direkt in den BIM 3D Viewer integriert:

* Drücken Sie **Shift+T**, um das Aufgabenpanel zu öffnen oder zu schließen.
* Ein **Anzahl-Badge** wird auf der Aufgabenschaltfläche in der Viewer-Symbolleiste angezeigt und zeigt die Anzahl der offenen Aufgaben.
* Aus dem Viewer heraus können Sie BIM-bezogene Aufgaben (VALIDATE\_3D\_MODEL\_FIELD, UPDATE\_REJECTED\_3D\_MODEL\_FIELD) verwalten, ohne den 3D-Kontext verlassen zu müssen.

***

## Aufgaben-Lebenszyklus

```
(Auslösendes Ereignis) → Aufgabe erstellt (offen) → Aktion durchgeführt → Aufgabe abgeschlossen (archiviert)
```

| Zustand           | Beschreibung                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Offen**         | Die Aufgabe ist aktiv und wartet auf eine Aktion.                                                                        |
| **Abgeschlossen** | Die erforderliche Aktion wurde durchgeführt. Die Aufgabe wird als abgeschlossen markiert und in die Historie verschoben. |
| **Archiviert**    | Historische Aufgaben, die nicht mehr aktionierbar sind (z. B. abgelaufen, ersetzt).                                      |

### Automatische Erstellung

Aufgaben werden automatisch von der Plattform erstellt, wenn relevante Ereignisse auftreten:

| Ereignis                                     | Erstellte Aufgabe                                                 |
| -------------------------------------------- | ----------------------------------------------------------------- |
| Dokument zur Validierung eingereicht         | VALIDATE\_DOCUMENT (für jeden zugewiesenen Validator)             |
| Ablaufdatum des Dokuments erreicht           | UPDATE\_EXPIRED\_DOCUMENT (für Dokumenteigentümer)                |
| Dokument von Validator abgelehnt             | UPDATE\_REJECTED\_DOCUMENT (für Dokumenteigentümer)               |
| BIM-Feldänderung eingereicht                 | VALIDATE\_3D\_MODEL\_FIELD (für jeden zugewiesenen BIM-Validator) |
| BIM-Feldänderung abgelehnt                   | UPDATE\_REJECTED\_3D\_MODEL\_FIELD (für Änderungsanforderer)      |
| Los-Datensatz zur Validierung eingereicht    | VALIDATE\_LOT\_DIVISION (für zugewiesene Validatoren)             |
| Los-Datensatz abgelehnt                      | UPDATE\_REJECTED\_LOT\_DIVISION (für Datensatz-Einreicher)        |
| Zähler-Datensatz zur Validierung eingereicht | VALIDATE\_ENERGY\_METER (für zugewiesenen Validator)              |
| Zähler-Datensatz abgelehnt                   | UPDATE\_REJECTED\_ENERGY\_METER (für Datensatz-Einreicher)        |
| DTT-Minting-Voraussetzungen erfüllt          | MINT\_DTT (für Gebäudeeigentümer/KV)                              |

### Automatischer Abschluss

Aufgaben werden automatisch abgeschlossen, wenn die entsprechende Aktion durchgeführt wird:

| Aufgabe                            | Automatisch abgeschlossen, wenn                        |
| ---------------------------------- | ------------------------------------------------------ |
| VALIDATE\_DOCUMENT                 | Validator genehmigt oder lehnt das Dokument ab.        |
| UPDATE\_EXPIRED\_DOCUMENT          | Eine neue Version des Dokuments hochgeladen wird.      |
| UPDATE\_REJECTED\_DOCUMENT         | Eine korrigierte Dokumentenversion eingereicht wird.   |
| VALIDATE\_3D\_MODEL\_FIELD         | Validator über die Feldänderung abstimmt.              |
| UPDATE\_REJECTED\_3D\_MODEL\_FIELD | Eine überarbeitete Feldänderung eingereicht wird.      |
| VALIDATE\_LOT\_DIVISION            | Validator den Los-Datensatz genehmigt oder ablehnt.    |
| UPDATE\_REJECTED\_LOT\_DIVISION    | Ein korrigierter Los-Datensatz eingereicht wird.       |
| VALIDATE\_ENERGY\_METER            | Validator den Zähler-Datensatz genehmigt oder ablehnt. |
| UPDATE\_REJECTED\_ENERGY\_METER    | Ein korrigierter Zähler-Datensatz eingereicht wird.    |
| MINT\_DTT                          | Das DTT-Minting erfolgreich abgeschlossen wird.        |

***

## Aufgaben im Aktivitätsfeed

Aufgabenbezogene Ereignisse erscheinen auch im [Aktivitätsfeed](/magma-documentation/de/funktionen/activity-feed.md). Der Aktivitätsfeed bietet Aktionsschaltflächen, die direkt zur relevanten Aufgabe verlinken:

* **Validator zuweisen** — Einem Dokument, das auf einen wartet, einen Validator zuweisen.
* **Anfrage überprüfen** — Eine Zugriffsanfrage genehmigen oder ablehnen.
* **Aufgaben anzeigen** — Zum Aufgabenpanel des relevanten Gebäudes navigieren.

***

## Tipps für effektives Aufgabenmanagement

* Überprüfen Sie das Aufgabenpanel regelmäßig — Aufgaben häufen sich im Laufe der Zeit an, und überfällige Aufgaben können die Magma Index-Progression verlangsamen und das Minting verzögern.
* Verwenden Sie den **ALL-Modus** als Eigentümer oder Kontoverwalter, um Engpässe zu identifizieren — wenn ein Validator viele offene VALIDATE\_DOCUMENT-Aufgaben hat, erwägen Sie, einige Dokumente neu zuzuweisen.
* Im BIM 3D Viewer behalten Sie das **Anzahl-Badge** (Shift+T) im Auge — eine wachsende Anzahl offener BIM-Feldvalidierungsaufgaben zeigt an, dass Änderungsanfragen sich ohne Überprüfung anhäufen.
* Für zeitkritische Dokumente (z. B. Versicherung, Steuern) priorisieren Sie UPDATE\_EXPIRED\_DOCUMENT-Aufgaben sofort, um die Datenablaufstrafe auf dem Magma Index zu vermeiden.
* Beteiligte können über die **Aktivitätsfeed**-Benachrichtigungen auf dem Laufenden über ihre Aufgaben bleiben — jedes relevante Ereignis generiert ein Aktivitätselement mit einer direkten Aktionsschaltfläche.


---

# 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/tasks.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.
