# Magma Index-Bewertung

Der Magma Index misst, wie digital vollständig ein Gebäude ist. Es handelt sich nicht um einen einfachen Dateizähler – er bewertet die **Qualität, Herkunft und Relevanz** jedes Datenbeitrags zum DTT® eines Gebäudes.

## Die fünf Ebenen

Der Magma Index ist in fünf Ebenen unterteilt, die jeweils einen anderen Bereich von Gebäudedaten abdecken:

| Ebene            | Was sie abdeckt                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| **Genesis**      | Grundlegende Daten: Eigentum, Recht, Finanzen, Versicherung, Diagnosen                                  |
| **Structure**    | Tragwerksplanung: Berechnungen, Zeichnungen, Compliance, BIM-Modell                                     |
| **Architecture** | Design: Zeichnungen, Landschaft, Zertifizierungen (LEED, BREEAM, HQE, WELL), 3D-Scan                    |
| **Wired**        | Technische Systeme: HLK (W1), Sanitär (W2), Elektro (W3), Geräte (W4), Lebensschutz und Sicherheit (W5) |
| **Filled**       | Innenbereich: Designpläne, Einrichtung, Reinigung, Innen-BIM-Modell                                     |

Jede Ebene hat ihren eigenen Fertigstellungsprozentsatz. Der **globale Magma Index** ergibt sich aus allen fünf Ebenen kombiniert.

***

## Wie jedes Dokument bewertet wird

Jeder Dokumenttyp hat einen **intrinsischen Wert** – einen Basisscore – der durch drei Faktoren bestimmt wird:

1. **Die Index-Ebene** (Genesis, Structure, Architecture, Wired, Filled)
2. **Der Gebäudetyp** (Hotel, Office, Residential usw.)
3. **Der spezifische Dokumenttyp** (z. B. Grundbuchurkunde, Statische Zeichnungen, LEED-Zertifizierung)

Dieser intrinsische Wert wird dann durch fünf Faktoren angepasst:

### Faktor 1 — Akteur-Kategorie

Wer die Daten beigetragen hat, spielt eine Rolle. Fachleute mit direkter Verantwortung für diesen Datenbereich tragen mehr bei:

* Ein Architekt, der statische Zeichnungen hochlädt, hat mehr Gewicht als ein allgemeiner Stakeholder, der dasselbe Dokument hochlädt
* Das System verwendet die **Kategorie** des Stakeholders (Owner, Asset Manager, Service Provider usw.) und seinen spezifischen **Typ** (Architect, Structural Engineer usw.), um diese Anpassung zu bestimmen

### Faktor 2 — Uploader/Validator-Kombination

Die Kombination aus dem, der hochgeladen hat, und dem, der das Dokument validiert hat, beeinflusst den Score:

* Ein Dokument, das vom relevantesten Fachmann (z. B. einem Diagnostician) hochgeladen und von der geeignetsten Behörde (z. B. dem Asset Manager und dem City Inspector) validiert wurde, erzielt den höchsten Score
* Ein Dokument, das von weniger relevanten Parteien hochgeladen und validiert wurde, trägt dennoch bei, aber mit einem niedrigeren Koeffizienten

### Faktor 3 — Validator-Vollständigkeit

Dokumente mit allen drei abgeschlossenen Validator-Stufen erzielen einen höheren Score als Dokumente mit nur einem Primärvalidator:

* 3 Validatoren: maximaler Vollständigkeitsscore
* 2 Validatoren: mittlerer Score
* 1 Validator: minimaler Vollständigkeitsscore
* 0 Validatoren: noch nicht validiert, trägt nicht bei

### Faktor 4 — Stakeholder-Reputation

Jeder Stakeholder hat einen **Reputations-Score** (Ganzzahl 1–5, global für alle Gebäude, Standard 3). Beitragende mit höherer Reputation erzeugen werthaltigere Daten:

* Die Reputation steigt um **+1 für je 5 gemintete Validierungen** (max. 5)
* Die Reputation sowohl des Uploaders als auch jedes Validators wird in den Endwert einbezogen
* Sanktionen können die Reputation verringern (angewendet durch einen geplanten Prozess)

Der Reputationsfaktor stellt sicher, dass erfahrene, konsistent genaue Beitragende im Laufe der Zeit anerkannt werden.

### Faktor 5 — Datenverfall

Dokumente mit Gültigkeitszeiträumen (Versicherungen, Grundsteuer, Prüfberichte usw.) verlieren ihren Index-Beitrag, wenn sie sich dem Ablauf nähern:

* Ein aktives, nicht abgelaufenes Dokument trägt seinen vollen Wert bei
* Ein abgelaufenes Dokument reduziert den Index-Score für seine Kategorie, bis eine erneuerte Version hochgeladen und validiert wird

***

## Der Micro Index (µI)

Der **Micro Index** (µI) stellt den prozentualen Beitrag eines einzelnen Dokuments zum Score seiner Ebene dar. Er wird als Prozentsatz angezeigt (z. B. „2,3%") und ist sichtbar in:

* Den **Simulator**-Ergebnissen (vor dem Hochladen, als Vorschau der Auswirkung)
* Der Registerkarte **Value Contributions** (nach dem Hochladen, zeigt den tatsächlichen Beitrag)
* Der **Building Index Details**-Akkordeon (im Entwicklermodus)

Der µI ermöglicht es Ihnen, die relative Bedeutung verschiedener Dokumente zu vergleichen und Uploads zu priorisieren, die den größten Einfluss auf Ihren Magma Index haben.

***

## Das Magma Index-Widget lesen

Das Building Index-Widget auf der Registerkarte Übersicht zeigt drei Arten von Fortschritt pro Ebene:

| Farbe             | Bedeutung                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------- |
| **Blau (primär)** | Daten bereits on-chain geminted – in der Blockchain-Aufzeichnung gespeichert                      |
| **Grün (Erfolg)** | Daten validiert und genehmigt, aber noch nicht geminted – werden beim nächsten Minting einbezogen |
| **Verbleibend**   | Daten ausstehend zur Validierung oder noch nicht hochgeladen – tragen noch nicht bei              |

Die **Einfache Ansicht** zeigt kreisförmige Fortschrittsanzeigen pro Ebene mit sowohl validierten (blau) als auch zur Validierung ausstehenden (grün) Prozentsätzen.

Die **Detailansicht** (Akkordeon) zeigt jede einzelne Dokumentaufgabe, ihren Status, wer sie hochgeladen hat, und ermöglicht das Durchklicken zu diesem Dokument.

***

## Zusammenfassung der Bewertungsformel

```
Dokumentbeitrag = 
  Intrinsischer Wert (Ebene × Gebäudetyp × Dokumenttyp)
  × Akteur-Kategorie-Anpassung
  × Uploader/Validator-Kombinations-Anpassung  
  × Validator-Vollständigkeits-Anpassung
  × Reputationsfaktor (Uploader + Validatoren)
  × Verfall-Anpassung (Abschlag bei Ablauf)
```

Die Summe aller Dokumentbeiträge über alle Ebenen ergibt den gesamten Magma Index-Prozentsatz des Gebäudes.

***

## Ihren Magma Index maximieren

Um den höchstmöglichen Magma Index zu erreichen:

1. **Alle erwarteten Dokumenttypen hochladen** für Ihren Gebäudetyp – der Index berücksichtigt, was erwartet wird, nicht nur was Sie haben
2. **Den richtigen Fachmann einsetzen** – sicherstellen, dass die zugewiesene Uploader-Rolle für jedes Dokument die Person ist, die es hochlädt
3. **Alle drei Validator-Stufen zuweisen** – Sekundär- und Tertiärvalidatoren nicht überspringen
4. **Dokumente aktuell halten** – ablaufende Dokumente erneuern, bevor sie verfallen
5. **Reputation aufbauen** – Stakeholder mit höherer Reputation liefern wertvollere Beiträge
6. **BIM-Modelle hochladen** für alle Ebenen – 3D-Objektdaten tragen separat von Dokumenten bei
7. **Den Simulator verwenden** – den genauen µI-Einfluss vor dem Hochladen eines Dokuments in der Vorschau prüfen


---

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