# Magma Index

Der Magma Index ist Magmas proprietäres System zur Bewertung der Dokumentationsvollständigkeit und -qualität. Er quantifiziert, wie gut ein Gebäude über alle Ebenen und Dimensionen hinweg dokumentiert ist — von den rechtlichen Eigentumsunterlagen bis hin zu Echtzeit-IoT-Daten — und bietet ein transparentes, objektives Maß für den digitalen Reifegrad eines Gebäudes.

***

## Überblick

Der Magma Index erzeugt für jedes Gebäude einen Wert (ausgedrückt als Prozentsatz). Dieser Wert spiegelt nicht nur wider, wie viele Dokumente hochgeladen wurden, sondern auch die Qualität, Relevanz und Glaubwürdigkeit dieser Dokumente und der Akteure, die sie erstellt haben.

Der Index wird sowohl auf Gebäudeebene (gesamt) als auch auf Einzelebene (je Magma-Ebene) berechnet. Er wird auch auf die Dokumentenebene über den **Micro Index (µI)** heruntergebrochen — dem prozentualen Beitrag eines einzelnen Dokuments zum Gesamtwert seiner Ebene.

***

## Die fünf Magma-Ebenen

Der Magma Index organisiert alle Gebäudedokumentation in 5 Ebenen, die jeweils eine eigenständige Dimension des Gebäudes repräsentieren:

| Ebene            | Code  | Beschreibung                                                                                                                        |
| ---------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Genesis**      | G     | Grundlegende Dokumente: Eigentumsunterlagen, rechtliche Dokumentation, Finanzinstrumente und Gebäudediagnostik.                     |
| **Structure**    | S     | Tragwerksdokumentation: statische Berechnungen, Gutachten, geotechnische Berichte.                                                  |
| **Architecture** | A     | Architekturdokumentation: Pläne, Genehmigungen, Zertifizierungen (LEED, BREEAM, HQE, WELL).                                         |
| **Wired**        | W1–W5 | Technische Systeme: HLK (W1), Sanitär (W2), Elektro/Beleuchtung (W3), Geräte & Ausstattung (W4), Lebens- & Sicherheitssysteme (W5). |
| **Filled**       | F     | Innengestaltung und Einrichtung: Ausbausläne, Möbelspezifikationen, Innenfotos.                                                     |

Jede Ebene verfügt über eine definierte Reihe von **Dokumentaufgaben** — spezifische Dokumenttypen, die für einen vollständigen Gebäudedatensatz vorhanden sein sollten.

***

## Bewertungsfaktoren

Der Magma Index ist keine einfache Dokumentenzählung. Der Beitrag jedes Dokuments zum Index wird durch 7 Bewertungsfaktoren gewichtet:

### Faktor 1 — Menge vs. Erwartung

Das Verhältnis der tatsächlich hochgeladenen Dokumente zur Anzahl der für dieses Gebäude erwarteten Dokumenttypen (basierend auf dem Gebäudetyp). Ein Gebäude, bei dem alle erwarteten Dokumenttypen vorhanden sind, erzielt einen höheren Wert als eines mit nur wenigen.

### Faktor 2 — Akteurkategorie

Die Kategorie des Beteiligten, der das Dokument hochgeladen hat:

| Kategorie         | Beschreibung                                                      |
| ----------------- | ----------------------------------------------------------------- |
| **Professionell** | Lizenzierte Fachleute (Architekt, Ingenieur, Notar, Anwalt usw.). |
| **Laienhaft**     | Nicht lizenzierte Personen (Eigentümer in eigener Person usw.).   |

Professionelle Akteure tragen mehr zum Index bei als laienhafe Akteure, da ihre Dokumente eine höhere Glaubwürdigkeit haben.

### Faktor 3 — Relevanz der Uploader/Validator-Kombination

Ob die Person, die das Dokument hochgeladen hat, und die Person(en), die es validiert haben, die am besten geeigneten Rollen für diesen spezifischen Dokumenttyp sind. Zum Beispiel erzielt ein Versicherungsdokument, das von einem Anwalt hochgeladen und von einem Notar validiert wurde, einen höheren Wert als dasselbe Dokument, das von einem Mieter hochgeladen wurde.

### Faktor 4 — Validator-Vollständigkeit

Ob dem Dokument 1, 2 oder 3 Validatoren zugewiesen wurden:

| Validatoren   | Stufe                  |
| ------------- | ---------------------- |
| 0 Validatoren | Kein Validierungsbonus |
| 1 Validator   | Stufe 1                |
| 2 Validatoren | Stufe 2                |
| 3 Validatoren | Stufe 3 (maximal)      |

Mehr Validatoren erhöhen die Glaubwürdigkeit des Dokuments und damit seinen Index-Beitrag.

### Faktor 5 — Beteiligten-Reputation

Der Reputationswert (ganzzahlig 1–5, Standard 3) des Uploaders und der Validatoren. Höhere Reputation bedeutet mehr Vertrauen in ihren Beitrag.

* Standardreputation für alle Beteiligten: **3**
* Reputation steigt um **+1** für jeweils **5 gemintete Validierungen** (max. **5**).
* Reputation kann durch Sanktionen gesenkt werden, die durch einen geplanten Cron-Job angewendet werden (z. B. für abgelehnte Validierungen, Inaktivität usw.).

### Faktor 6 — Ablaufstrafe für Daten

Dokumente mit einem abgelaufenen Ablaufdatum wenden eine **negative Strafe** auf ihren Beitrag an. Abgelaufene Dokumente reduzieren den Magma Index-Wert für ihre Ebene. Dies gibt einen Anreiz, zeitkritische Dokumente aktuell zu halten.

### Faktor 7 — Gewichtung nach Gebäudetyp

Verschiedene Dokumenttypen haben je nach Gebäudetyp unterschiedliche intrinsische Bedeutung. Zum Beispiel ist eine Sicherheitsvereinbarung für ein Hotel wichtiger als für ein Lagergebäude. Die Gewichtungsmatrix passt den Grundbeitrag jedes Dokuments entsprechend dem Gebäudetyp an.

**Die 9 Gebäudetypen und ihre Gewichtungsprofile:**

* Hotel
* Public
* Industrial
* Warehousing
* Mixed Use
* Commercial
* Residential
* Office
* Medical

***

## Micro Index (µI)

Der **Micro Index** (abgekürzt **µI**) repräsentiert den prozentualen Beitrag eines einzelnen Dokuments zum Gesamten Magma Index-Wert seiner Ebene.

* µI wird als Prozentsatz ausgedrückt (z. B. kann ein Dokument 3,4 % zum Architecture-Ebenenwert beitragen).
* µI ist im Dokumentinformationspanel im Data Room sichtbar.
* µI ist auch im Abschnitt [Wertbeiträge](/magma-documentation/de/funktionen/value-contributions.md) sichtbar, wo der Beitrag jedes Dokuments aufgelistet ist.
* µI wird im [Simulator](/magma-documentation/de/funktionen/simulator.md) verwendet, um die Auswirkung eines neuen Dokuments vor dem Hochladen in der Vorschau anzuzeigen.

Das Verständnis von µI hilft Beteiligten dabei, zu priorisieren, welche Dokumente hochgeladen oder aktualisiert werden sollen, um den Gesamtindexwert des Gebäudes zu maximieren.

***

## Gebäudeindex-Widget

Das Gebäudeindex-Widget bietet eine visuelle Übersicht des Magma Index des Gebäudes. Es ist von der Hauptprofilseite des Gebäudes aus zugänglich.

### Einfache Ansicht

Ein **kreisförmiger Fortschrittsring** für jede der 5 Ebenen, der zeigt:

* **Primärfarbe** — Prozentsatz der validierten Dokumente.
* **Erfolgsfarbe** — Prozentsatz der ausstehend zu validierenden Dokumente (Dokumente, die hochgeladen, aber noch nicht validiert sind).

Die Ringe bieten einen schnellen Überblick, wie vollständig und validiert die Dokumentation des Gebäudes auf jeder Ebene ist.

### Detaillierte Ansicht

Zur detaillierten Ansicht wechseln, um eine vollständige Aufschlüsselung zu sehen:

* Ein **Akkordeon** für jede Ebene, das erweitert werden kann.
* Innerhalb jedes Akkordeons: eine Liste aller Dokumentaufgaben für diese Ebene.
* Jede Dokumentaufgabenzeile zeigt:
  * **Statussymbol** — Ob das Dokument fehlt, hochgeladen (ausstehend) oder validiert ist.
  * **Dokumentname** — Der Name des Dokumenttyps.
  * **Uploader-Avatar** — Der Avatar des Beteiligten, der die neueste Version hochgeladen hat.
  * **Anklickbar** — Ein Klick auf eine Dokumentaufgabenzeile öffnet das Dokument direkt im Data Room.

Die detaillierte Ansicht erleichtert es, genau zu erkennen, welche Dokumente fehlen oder noch auf die Validierung warten, damit sofort Maßnahmen ergriffen werden können.

***

## Zertifizierungen auf Architecture-Ebene

Die Architecture-Ebene des Magma Index verfolgt speziell Nachhaltigkeits- und Gebäudeleistungszertifizierungen. Unterstützte Zertifizierungstypen umfassen:

* **LEED** (Leadership in Energy and Environmental Design)
* **BREEAM** (Building Research Establishment Environmental Assessment Method)
* **HQE** (Haute Qualité Environnementale)
* **WELL** (WELL Building Standard)

Zertifizierungsdokumente, die unter der Architecture-Ebene mit dem entsprechenden Dokumenttyp hochgeladen werden, werden erkannt und entsprechend in der Indexberechnung gewichtet.

***

## Wie der Magma Index andere Funktionen beeinflusst

Der Magma Index-Wert wird plattformweit auf verschiedene Arten verwendet:

| Funktion         | Verwendung des Index                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| **DTT Minting**  | Der Indexwert wird auf der DTT-Karte angezeigt und in die Metadaten des geminteten Tokens eingebettet. |
| **Rewards**      | Dokumentprämienbeträge werden teilweise durch den Indexbeitrag des Dokuments bestimmt.                 |
| **Dashboard**    | Der Index wird auf jeder Gebäudekarte als wichtiger Leistungsindikator angezeigt.                      |
| **Simulator**    | Zeigt den Indexbeitrag (µI) eines hypothetischen Dokument-Uploads in der Vorschau, bevor er erfolgt.   |
| **Wertbeiträge** | Listet den individuellen Beitrag jedes Dokuments und jedes BIM-Objekts zum Index auf.                  |

***

## Tipps zur Maximierung Ihres Magma Index

* Beginnen Sie mit **Genesis-Ebene**-Dokumenten — Titel, Urkunde und Grundbucheintrag sind permanente Dokumente, die vom ersten Tag an beitragen und nie ablaufen.
* Priorisieren Sie **professionelle Uploader** — Dokumente, die von lizenzierten Fachleuten (Architekten, Ingenieuren, Anwälten) hochgeladen werden, erhalten einen höheren Akteurkategorie-Bonus.
* Weisen Sie immer **3 Validatoren** zu, wenn Sie kritische Dokumente hochladen — der Stufe-3-Validator-Vollständigkeitsbonus steigert den Dokumentenbeitrag erheblich.
* Bauen Sie im Laufe der Zeit **Beteiligten-Reputation** auf — konsistente, hochwertige Validierungen erhöhen die Reputationswerte, was den Indexbeitrag jedes nachfolgenden Dokuments verstärkt.
* Aktualisieren Sie regelmäßig **zeitkritische Dokumente** (Versicherung, Grundsteuer, Prüfberichte), bevor sie ablaufen, um die Ablaufstrafe zu vermeiden, die Ihren Wert senkt.
* Verwenden Sie den **Simulator**, bevor Sie teure oder komplexe Dokumente hochladen, um genau zu sehen, wie viel sie zum Index beitragen werden.


---

# 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/magma-index.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.
