# Data Room

Der Data Room ist das zentrale Dokumentenverwaltungssystem der Magma-Plattform. Er bietet sicheren, strukturierten Speicher für alle gebäudebezogenen Dokumente mit Unterstützung für Dokumentenversionierung, kryptografisches Hashing, Stakeholder-Freigabe, Annotationen, Validierungs-Workflows und Blockchain-Minting.

***

## Layout-Modi

Der Data Room bietet zwei Layout-Modi, die über die Werkzeugleiste umgeschaltet werden können:

### Erweiterter (3-Spalten-) Modus

Die Standardansicht. Drei Panels werden nebeneinander angezeigt:

1. **Linkes Panel** — Dokumentenbaum-/Listennavigation.
2. **Mittleres Panel** — Dokumentzeilen für die ausgewählte Kategorie.
3. **Rechtes Panel** — Dokumentinformationspanel für das ausgewählte Dokument.

Dieser Modus ist ideal zum Arbeiten mit einem bestimmten Dokument, Überprüfen seiner Metadaten und Verwalten von Freigabe oder Validierung.

### Kompakter Modus

Das rechte Informationspanel ist zugeklappt. Dokumente werden in einem breiteren Listen-/Rasterformat angezeigt, was das Durchsuchen großer Sammlungen erleichtert, ohne sich auf ein einzelnes Dokument zu konzentrieren. Das Klicken auf eine Dokumentzeile öffnet das Informationspanel als Overlay oder erweitert das Layout vorübergehend.

***

## Navigationsstruktur

Dokumente sind in einer strengen Hierarchie namens **Magma Index-Baum** organisiert:

```
Ebene (Genesis / Structure / Architecture / Wired / Filled)
  └── Kategorie (z.B. Eigentümerschaft, Rechtliches, Versicherung)
        └── Dokumentdefinition (z.B. Eigentumsurkunde, Grundbuchauszug)
              └── IFC-Unterordner (für anwendbare Dokumenttypen)
```

### Baumansicht

Das linke Panel zeigt diese Hierarchie als erweiterbaren Baum. Das Klicken auf einen Knoten öffnet oder schließt seine Unterelemente. Das Klicken auf einen **Dokumentdefinition**-Knoten lädt seine Dokumente in das mittlere Panel.

### Listenansicht

Eine alternative flache Ansicht, die alle Dokumente aller Kategorien in einer einzigen scrollbaren Liste anzeigt, ohne hierarchische Gruppierung. Nützlich zum schnellen Durchsuchen aller Dokumente unabhängig von Ebene oder Kategorie.

### IFC-Unterordner

Bestimmte Dokumentdefinitionen unterstützen IFC (Industry Foundation Classes)-Dateien. Diese Definitionen zeigen einen **IFC-Unterordner** im Dokumentenbaum. Innerhalb eines IFC-Unterordners sind zwei Aktionsschaltflächen verfügbar:

* **In BIM öffnen** — Öffnet die IFC-Datei im [BIM 3D-Viewer](/magma-documentation/de/funktionen/bim-3d-viewer.md).
* **In Scan öffnen** — Öffnet den zugehörigen Scan im [Scan Viewer](/magma-documentation/de/funktionen/scan-viewer.md).

***

## Dokumentzeile

Jedes Dokument wird als Zeile im mittleren Panel angezeigt. Die Zeile enthält folgende Elemente:

| Element           | Beschreibung                                                          |
| ----------------- | --------------------------------------------------------------------- |
| Statussymbol      | Visueller Indikator des aktuellen Status des Dokuments (siehe unten). |
| Dokumentname      | Der lesbare Name der Dokumentdefinition.                              |
| Version           | Die aktuelle Versionsnummer (z.B. v1, v2, v3).                        |
| Originaldateiname | Der tatsächliche Dateiname der hochgeladenen Datei.                   |
| Kategorie         | Die Kategorie des Dokuments im Magma Index.                           |
| Dateigröße        | Größe der hochgeladenen Datei.                                        |
| Eigentümer-Avatar | Profilbild des Dokument-Uploaders (Eigentümer).                       |
| Validator-Avatare | Profilbilder der zugewiesenen Validatoren (bis zu 3).                 |
| Zuletzt geändert  | Relativer oder absoluter Zeitstempel der letzten Änderung.            |

***

## Dokumentstatus

Dokumente durchlaufen einen definierten Lebenszyklus, der durch ein Statusabzeichen angezeigt wird:

| Status                      | Beschreibung                                                                                        |
| --------------------------- | --------------------------------------------------------------------------------------------------- |
| **Entwurf**                 | Dokument wurde hochgeladen, aber noch nicht zur Validierung eingereicht.                            |
| **Ausstehende Validierung** | Dokument wurde eingereicht und wartet auf Validator-Überprüfung.                                    |
| **Validiert**               | Alle zugewiesenen Validatoren haben das Dokument genehmigt.                                         |
| **Geminted**                | Das Dokument wurde in ein DTT-Minting auf der Blockchain einbezogen.                                |
| **Aktion erforderlich**     | Das Dokument erfordert Aufmerksamkeit — typischerweise weil es abgelehnt wurde oder abgelaufen ist. |

***

## Dokumentinformationspanel

Das Auswählen einer Dokumentzeile öffnet das Dokumentinformationspanel auf der rechten Seite des Bildschirms (oder als Overlay im kompakten Modus). Dieses Panel bietet vollständige Details zum ausgewählten Dokument:

### Uploader-Informationen

* **Avatar**, **vollständiger Name** und **Plattformrolle** des Uploaders (z.B. Architekt, Eigentümer).

### Statusabzeichen

Spezielle Statusabzeichen erscheinen bei Anwendbarkeit:

* **ERSETZT** — Diese Dokumentversion ersetzt eine ältere Version durch eine Totalaktualisierung.
* **KORRIGIERT** — Diese Dokumentversion ersetzt eine ältere Version durch eine Korrektur.

### Metadaten

| Feld              | Beschreibung                                                                                                                                                          |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dateigröße        | Größe der aktuellen Dokumentdatei.                                                                                                                                    |
| Upload-Datum      | Datum und Uhrzeit des Datei-Uploads.                                                                                                                                  |
| Validierungsdatum | Datum, an dem das Dokument den Status Validiert erreicht hat (falls zutreffend).                                                                                      |
| Ablaufdatum       | Das Datum, nach dem die Gültigkeit des Dokuments abläuft (variiert je nach Dokumenttyp — siehe Gültigkeitszeiträume).                                                 |
| Dokument-Hash     | Ein kryptografischer Hash des Dateiinhalts. Dieser Hash wird auch während des Mintings auf der Blockchain gespeichert und kann zur Echtheitsprüfung verwendet werden. |

### Neueste Aktivitätsprotokoll

Ein chronologischer Feed aller Ereignisse im Zusammenhang mit diesem Dokument, einschließlich:

* Datei hochgeladen
* Zur Validierung gesendet
* Validator genehmigt / abgelehnt
* Dokument ersetzt oder korrigiert
* Dokument geminted
* Zugang gewährt / widerrufen

### Liste der autorisierten Benutzer

Eine Liste aller Stakeholder und Gäste, denen Zugang zu diesem spezifischen Dokument gewährt wurde. Jeder Eintrag zeigt:

* Benutzer-Avatar und Name
* Ihre Rolle oder Zugriffstyp (Gebäude-Stakeholder, Nicht registrierter Gast, Magma-Gastbenutzer)
* Eine **Widerrufen**-Schaltfläche zum sofortigen Entfernen ihres Zugangs

### Versionshistorie

Eine Liste aller früheren Versionen dieses Dokuments in umgekehrter chronologischer Reihenfolge. Jeder Versionseintrag ist anklickbar und lädt die Metadaten und Datei dieser Version. Versionen zeigen:

* Versionsnummer
* Upload-Datum
* Status zum Zeitpunkt der Ersetzung
* Ersetzungstyp (Totalaktualisierung oder Korrektur)

***

## Filter und Sortierung

### Suche

Ein Volltextsuchfeld oben in der Dokumentliste. Sucht nach Dokumentnamen, Dateinamen und Kategorien.

### Statusfilter

Filtern Sie Dokumente nach ihrem aktuellen Status:

* Entwurf
* Ausstehende Validierung
* Validiert
* Geminted
* Aktion erforderlich

Mehrere Status können gleichzeitig ausgewählt werden.

### Ebenenfilter

Filtern Sie Dokumente nach ihrer Magma Index-Ebene:

* Genesis
* Structure
* Architecture
* Wired (W1 bis W5)
* Filled

### Rollenfilter

Umschalten zwischen:

* **Meine Rolle** — Zeigt nur Dokumente, die für Ihre zugewiesene Rolle relevant sind (z.B. Dokumente, die Sie validieren sollen oder hochgeladen haben).
* **Alle** — Zeigt alle Dokumente unabhängig von der Rollenzuweisung.

### Sortieroptionen

| Sortierung      | Beschreibung                                                 |
| --------------- | ------------------------------------------------------------ |
| Alphabetisch    | Sortiert Dokumente von A bis Z nach Dokumentdefinitionsname. |
| Neueste         | Zuletzt hochgeladene Dokumente zuerst.                       |
| Älteste         | Älteste hochgeladene Dokumente zuerst.                       |
| Letzte Änderung | Zuletzt geänderte oder aktualisierte Dokumente zuerst.       |

***

## Lesezeichen-Seitenleiste

Die **Lesezeichen**-Seitenleiste ist ein 312 px breites Panel, das von der rechten Seite des Bildschirms eingeblendet wird (unabhängig vom Informationspanel). Sie ermöglicht es Ihnen, häufig verwendete Dokumente zu speichern und schnell darauf zuzugreifen.

* **Dokument als Lesezeichen markieren** — Klicken Sie auf das Lesezeichen-Symbol in einer Dokumentzeile, um es zu Ihren Lesezeichen hinzuzufügen.
* **Lesezeichen öffnen** — Klicken Sie auf das Lesezeichen-Symbol in der Data Room-Werkzeugleiste, um die Seitenleiste einzublenden.
* **Lesezeichen entfernen** — Klicken Sie erneut auf das Lesezeichen-Symbol bei einem mit Lesezeichen markierten Dokument oder entfernen Sie es aus der Seitenleiste.

Lesezeichen sind persönlich und werden nicht mit anderen Stakeholdern geteilt.

***

## Mein Tresor

Der Umschalter **Mein Tresor** filtert den Data Room, um nur Dokumente anzuzeigen, die Sie persönlich hochgeladen haben, die Ihnen gehören oder auf die Sie bestimmte Zugriffsrechte haben. Dies ist nützlich, um schnell Ihre eigenen Beiträge zu finden, ohne durch die vollständige Dokumentliste zu scrollen.

***

## Dokumente hochladen

### Anforderungen

* **Maximale Dateigröße:** 150 MB pro Datei.
* **Dateien pro Upload:** Zwischen 1 und 6 Dateien pro Dokumentdefinition (je nach Konfiguration der Definition).
* **Upload-Methode:** Dateien per Drag-and-Drop auf die Upload-Zone ziehen oder klicken, um das Dateisystem zu durchsuchen.

### Upload-Formularfelder

| Feld        | Beschreibung                                                                                                                                                   |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Datei(en)   | 1–6 Dateien auswählen. Drag-and-Drop unterstützt.                                                                                                              |
| Validatoren | Bis zu 3 Validatoren zuweisen. Validatoren mit dem **Empfohlen**-Abzeichen sind diejenigen, deren Rolle am besten zum Dokumenttyp passt.                       |
| Ablaufdatum | Optional ein Ablaufdatum festlegen. Einige Dokumenttypen haben feste Gültigkeitszeiträume (siehe unten) und dieses Feld kann automatisch vorausgefüllt werden. |

### Empfohlen-Abzeichen

Neben jedem Validator-Auswahlfeld erscheint ein **Empfohlen**-Abzeichen neben Stakeholdern, deren Berufsrolle am besten für die Validierung dieses bestimmten Dokumenttyps geeignet ist. Dies hilft Uploadern, die glaubwürdigsten Validatoren auszuwählen, was sich positiv auf den Magma Index-Score auswirkt.

### Gültigkeitszeiträume

Bestimmte Dokumenttypen haben von der Plattform festgelegte Gültigkeitszeiträume:

| Gültigkeitszeitraum                  | Dokumenttypen                                                                       |
| ------------------------------------ | ----------------------------------------------------------------------------------- |
| **1 Jahr**                           | Versicherung, Hypothek, Gewinn & Verlust, Sicherheitsvertrag / Sicherheitsprotokoll |
| **1 Monat**                          | Grundsteuern, Prüfberichte, Budget, Sicherheitsplan                                 |
| **Nach Fertigstellung des Gebäudes** | Benutzungsgenehmigung                                                               |
| **Dauerhaft**                        | Eigentumsurkunde, Grundbuchauszug                                                   |

***

## Dokumentersetzung

Wenn ein Dokument aktualisiert werden muss, müssen Sie den Ersetzungs-Workflow verwenden anstatt zu löschen und erneut hochzuladen. Dies bewahrt die Versionshistorie und den Prüfpfad.

### Ersetzungstypen

| Typ                     | Beschreibung                                                                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **TOTALAKTUALISIERUNG** | Eine vollständige Ersetzung des Dokuments. Wird verwendet, wenn der Inhalt sich grundlegend geändert hat (z.B. eine neue Versicherungspolice). |
| **KORREKTUR**           | Eine geringfügige Korrektur eines bestehenden Dokuments (z.B. Beheben eines Tippfehlers, Aktualisieren einer Unterschrift).                    |

### Ersetzungs-Workflow

1. Öffnen Sie das Informationspanel des Dokuments.
2. Klicken Sie auf die Schaltfläche **Ersetzen**.
3. Wählen Sie den Ersetzungstyp: **Totalaktualisierung** oder **Korrektur**.
4. Geben Sie einen **Grund** für die Ersetzung ein (mindestens 5 Zeichen — erforderlich).
5. Laden Sie die neue Datei hoch.
6. Einreichen.

Die alte Version wird in der Versionshistorie archiviert und mit dem Abzeichen **ERSETZT** oder **KORRIGIERT** markiert. Die neue Version wird zum aktuellen aktiven Dokument und beginnt erneut den Validierungs-Workflow, wenn Validatoren zugewiesen sind.

***

## Dokumente teilen

Sie können einzelne Dokumente mit Personen teilen, die noch nicht Teil des Stakeholder-Teams des Gebäudes sind. Die Freigabe erfolgt über die Schaltfläche **Teilen** im Dokumentinformationspanel.

### Freigabetypen

| Typ                          | Beschreibung                                                                                             |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Gebäude-Stakeholder**      | Mit einem bestehenden Stakeholder des Gebäudes teilen. Aus einer Liste aktueller Stakeholder auswählen.  |
| **Nicht registrierter Gast** | Mit jemandem teilen, der kein Magma-Konto hat. E-Mail-Adresse eingeben; sie erhalten einen Zugriffslink. |
| **Magma-Gastbenutzer**       | Mit einem Magma-Benutzer teilen, der kein Stakeholder dieses Gebäudes ist. Nach Name oder E-Mail suchen. |

Der gemeinsame Zugang ist dokumentspezifisch. Gemeinsame Benutzer erscheinen in der Liste der autorisierten Benutzer im Informationspanel, und ihr Zugang kann jederzeit widerrufen werden.

***

## Annotationen

Annotationen ermöglichen es Stakeholdern, Kommentare, Anfragen oder Schwärzungen direkt auf Dokumentseiten im Data Room-Viewer zu hinterlassen.

### Eine Annotation erstellen

1. Öffnen Sie ein Dokument im Viewer.
2. Klicken und ziehen Sie auf dem Seitenbereich, um die Annotationszone zu definieren.
3. Ein Kommentar-Popup erscheint.

### Kommentar-Annotationen

* Kommentartext eingeben.
* **Emoji-Reaktionen** hinzufügen, um schnell zu bestätigen oder zu antworten.
* **@Erwähnungen** verwenden, um bestimmte Stakeholder zu benachrichtigen.
* **Dateien anhängen** (Bilder oder Dokumente) an den Kommentar.
* **Geordnete Antworten** — Andere Stakeholder können direkt innerhalb desselben Annotations-Threads antworten.

### Schwärzungs-Annotationen

Schwärzungen ermöglichen es Ihnen, schwarze Boxen über sensiblen Inhalten auf Dokumentseiten zu zeichnen:

1. Wählen Sie das **Schwärzen**-Tool in der Annotations-Werkzeugleiste aus.
2. Zeichnen Sie schwarze Boxen über alle Inhalte, die Sie schwärzen möchten.
3. Klicken Sie auf **Speichern**.

Das Speichern einer Schwärzung erstellt eine **neue Version** des Dokuments mit dem dauerhaft angewendeten geschwärzten Inhalt. Die originale (ungeschwärzte) Version wird in der Versionshistorie für autorisierte Benutzer mit den entsprechenden Berechtigungen aufbewahrt.

### Annotationstypen

| Typ       | Beschreibung                                                                                                   |
| --------- | -------------------------------------------------------------------------------------------------------------- |
| Kommentar | Ein allgemeiner Kommentar, eine Frage oder Notiz, die an einen bestimmten Bereich des Dokuments angehängt ist. |
| Schwärzen | Eine schwarze Box-Schwärzung über sensiblem Inhalt. Das Speichern erstellt eine neue Dokumentversion.          |

***

## Zugriffsanfrage-Ablauf

Wenn ein Stakeholder oder externer Benutzer versucht, ein Dokument anzuzeigen, zu dem er keinen Zugang hat, kann er eine **Zugriffsanfrage** einreichen:

1. Der Benutzer klickt auf **Zugang anfordern** beim eingeschränkten Dokument.
2. Optionaler Hinweis, warum Zugang benötigt wird.
3. Der Dokumenteigentümer und Gebäudeadministratoren erhalten eine Benachrichtigung im [Aktivitätsfeed](/magma-documentation/de/funktionen/activity-feed.md) mit einer Schaltfläche **Anfrage überprüfen**.
4. Der Prüfer genehmigt oder lehnt die Anfrage ab.
5. Bei Genehmigung wird der anfragende Benutzer zur Liste der autorisierten Benutzer hinzugefügt und erhält eine Zugriffsbenachrichtigung.

***

## Kryptografischer Dokument-Hash

Jedes in den Data Room hochgeladene Dokument erhält einen **kryptografischen Hash** (SHA-256 oder äquivalent), der aus dem binären Inhalt der Datei berechnet wird. Dieser Hash:

* Wird im Dokumentinformationspanel zur Transparenz angezeigt.
* Wird während des DTT-Mintings auf der Blockchain gespeichert (über den HashStorage-Smart-Contract).
* Kann von jeder Partei unabhängig verifiziert werden, um die Echtheit des Dokuments zu bestätigen und Manipulationen zu erkennen.

Der Hash ist unveränderlich — wenn sich der Dateiinhalt ändert (auch nur um ein einzelnes Byte), ändert sich der Hash und es muss eine neue Version erstellt werden.

***

## Tipps und Best Practices

* Weisen Sie wann immer möglich **3 Validatoren** zu — ein vollständig validiertes Dokument erhält den höchsten Magma Index-Beitrag und die maximale Belohnung.
* Verwenden Sie das **Empfohlen-Abzeichen**, um Validatoren auszuwählen, deren Rolle am besten zum Dokumenttyp passt, für optimale Bewertung.
* Setzen Sie Ablaufdaten genau — abgelaufene Dokumente reduzieren Ihren Magma Index-Score durch die Datenablauf-Strafe.
* Verwenden Sie die **Lesezeichen-Seitenleiste**, um schnell auf häufig referenzierte Dokumente zuzugreifen.
* Verwenden Sie **Annotationen** für kollaborative Dokumentenüberprüfung, bevor Sie fertigstellen und minten.
* Ersetzen Sie Dokumente mit dem richtigen **Ersetzungs-Workflow** anstatt zu löschen und erneut hochzuladen — dies bewahrt Ihren Prüfpfad und die Versionshistorie.


---

# 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/data-room.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.