# Simulator

Der Simulator ist ein Planungswerkzeug, mit dem Sie die Auswirkung eines Dokument-Uploads **vor seiner Durchführung** in der Vorschau anzeigen können. Er berechnet den genauen Magma Index-Beitrag (Micro Index µI) und die MRT-Reward-Verteilung für jede hypothetische Kombination aus Gebäudeebene, Dokumenttyp, Akteuren und Validatoren — damit Sie fundierte Entscheidungen treffen können, wie Sie sowohl den Wert Ihres Gebäudes als auch die Rewards Ihrer Beteiligten maximieren.

***

## Überblick

Der Simulator beantwortet zwei Fragen, bevor Sie ein Dokument hochladen:

1. **Um wie viel wird dieses Dokument meinen Magma Index verbessern?** (Wertbeitrags-Panel)
2. **Wie viel MRT wird jeder Beteiligte verdienen?** (Reward-Verteilungs-Panel)

Durch die Anpassung der Eingaben — Dokumenttyp, Uploader-Rolle, Validator-Rollen — können Sie verschiedene Kombinationen vergleichen und die optimale Konfiguration wählen, bevor Sie sich festlegen.

***

## Zugang zum Simulator

Der Simulator ist zugänglich über:

* Die Registerkarte oder den Abschnitt **Simulator** des Gebäudes.
* Das Upload-Formular im Data Room — eine **Simulator**-Schaltfläche ist vor der Bestätigung eines Uploads verfügbar.

***

## Simulator-Eingaben

Konfigurieren Sie die folgenden Eingaben, um eine Simulation zu generieren:

### Gebäudeebene

Ein Dropdown zur Auswahl der Magma-Ebene, zu der das Dokument gehört:

* Genesis
* Structure
* Architecture
* Wired 1 (Mechanisch)
* Wired 2 (Sanitär)
* Wired 3 (Beleuchtung)
* Wired 4 (Geräte & Ausstattung)
* Wired 5 (Lebens- & Sicherheit)
* Filled

Die Auswahl einer Ebene filtert die verfügbaren Dokumenttypen auf nur die für diese Ebene anwendbaren.

### Gebäudetyp

Ein Dropdown zur Auswahl des Gebäudetyps (9 Optionen):

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

Der Gebäudetyp beeinflusst den auf den intrinsischen Wert des Dokuments angewendeten **Gewichtungsfaktor**, der wiederum sowohl den Beitrag als auch den Reward-Betrag beeinflusst.

> **Hinweis:** Dieses Feld ist mit dem konfigurierten Typ des Gebäudes vorausgefüllt und muss in der Regel nicht geändert werden.

### Dokumenttyp

Ein Dropdown mit allen Dokumenttypen, die für die ausgewählte **Ebene** anwendbar sind. Die Liste wird basierend auf der Ebenenauswahl gefiltert — durch Auswahl einer anderen Ebene wird dieses Feld zurückgesetzt und es werden nur relevante Dokumenttypen angezeigt.

### Anzahl der Dateien

Eine numerische Eingabe (1–100), die angibt, wie viele Dateien für diese Dokumentdefinition hochgeladen werden.

### Uploader

Konfigurieren Sie den Beteiligten, der das Dokument hochladen wird:

| Unterfeld  | Optionen                                                                                        |
| ---------- | ----------------------------------------------------------------------------------------------- |
| Rolle      | Aus allen verfügbaren Plattformrollen auswählen (Eigentümer, Architekt, Ingenieur, Anwalt usw.) |
| Reputation | Von 1 bis 5 auswählen (ganzzahlig)                                                              |

Das **Empfohlen**-Badge erscheint neben Rollen, die für das Hochladen des ausgewählten Dokumenttyps am besten geeignet sind. Die Auswahl einer empfohlenen Rolle maximiert die Akteurkategorie- und Rollenkombinations-Multiplikatoren.

### Primärer Validator (Optional)

Den ersten Validator konfigurieren:

| Unterfeld  | Optionen                                        |
| ---------- | ----------------------------------------------- |
| Rolle      | Aus allen verfügbaren Plattformrollen auswählen |
| Reputation | Von 1 bis 5 auswählen                           |

Das **Empfohlen**-Badge zeigt die optimale Rolle für die Primärvalidierung dieses Dokumenttyps an.

> **Einschränkung:** Dieselbe Rolle kann nicht mehr als einmal über Uploader und alle Validator-Slots hinweg ausgewählt werden.

### Sekundärer Validator (Optional)

Den zweiten Validator konfigurieren (gleiche Felder wie Primärer Validator). Optional — wenn dieses Feld leer gelassen wird, wird ein Stufe-1-Szenario (1 Validator) simuliert.

### Tertiärer Validator (Optional)

Den dritten Validator konfigurieren (gleiche Felder wie Primärer Validator). Optional — wenn dieses Feld leer gelassen wird, wird ein Stufe-2-Szenario (2 Validatoren) simuliert. Das Ausfüllen aller drei Slots simuliert das maximale Stufe-3-Szenario.

***

## Rollenempfehlungen

Für jeden Akteur-Slot (Uploader, primärer Validator, sekundärer Validator, tertiärer Validator) zeigt der Simulator ein **Empfohlen**-Badge neben Rollen an, die für den ausgewählten Dokumenttyp am besten geeignet sind. Diese Empfehlungen basieren auf der Rollenrelevanz-Matrix der Plattform, die bestimmt, welche professionellen Rollen für jeden Dokumenttyp am glaubwürdigsten sind.

Die Auswahl empfohlener Rollen für alle Slots ergibt den maximalen Rollenkombinations-Multiplikator und produziert den höchstmöglichen Indexbeitrag und Reward-Betrag.

***

## Rolleneinzigartigkeitsbeschränkung

Um unrealistische Simulationen zu verhindern (z. B. dass dieselbe Person ihr eigenes Dokument in mehreren Slots validiert), **kann dieselbe Rolle nicht mehr als einmal** über alle Akteur-Slots hinweg ausgewählt werden. Die Dropdowns deaktivieren oder filtern automatisch Rollen heraus, die bereits in einem anderen Slot ausgewählt wurden.

***

## Simulator-Ausgaben

Nach der Konfiguration aller Eingaben zeigt der Simulator zwei Ausgabe-Panels an:

### 1. Wertbeitrags-Panel

Zeigt, wie das simulierte Dokument den Magma Index beeinflussen würde:

| Feld                   | Beschreibung                                                                             |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| **Wert pro Akteur**    | Der jedem Akteur zugeschriebene Indexbeitragswert (Uploader, primär, sekundär, tertiär). |
| **Micro Index (µI %)** | Der geschätzte prozentuale Beitrag des Dokuments zum Magma Index-Wert der Ebene.         |

Dieses Panel zeigt Ihnen die genaue Verbesserung des Magma Index des Gebäudes, die aus diesem Upload resultieren würde, vorausgesetzt, das Dokument erreicht den Validated-Status mit der angegebenen Konfiguration.

### 2. Reward-Verteilungs-Panel

Zeigt, wie MRT-Rewards verteilt würden:

| Feld                      | Beschreibung                                                                                                                 |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **MRT-Reward pro Akteur** | Der geschätzte MRT-Reward-Betrag für jeden Akteur (Uploader, primärer Validator, sekundärer Validator, tertiärer Validator). |

Rewards werden einzeln aufgeführt, damit jeder Beteiligte seinen persönlichen erwarteten Reward sehen kann, bevor eine Verpflichtung eingegangen wird.

***

## Löschen-Schaltfläche

Die **Löschen**-Schaltfläche setzt alle **Akteurfelder** (Uploader, primäre/sekundäre/tertiäre Validatoren) zurück, während die Dokumenttyp- und Gebäudeebenen-Auswahl erhalten bleibt. Dadurch können Sie schnell verschiedene Akteurkombinationen für denselben Dokumenttyp testen, ohne Ebene und Dokumenttyp von Grund auf neu auswählen zu müssen.

***

## Praktische Anwendungsfälle

### Vor dem Hochladen eines kritischen Dokuments

Verwenden Sie den Simulator, um sicherzustellen, dass die geplante Akteurkonfiguration (Uploader + Validatoren) die erwartete Magma Index-Verbesserung und Reward-Verteilung liefert. Wenn das Ergebnis niedriger als erwartet ist, experimentieren Sie mit verschiedenen Validator-Rollen oder Reputationsstufen, um die Auswirkung zu verstehen.

### Die richtigen Validatoren wählen

Geben Sie verschiedene Validator-Rollenkombinationen ein, um die Kombination zu finden, die Reward und Indexbeitrag maximiert. Die Empfohlen-Badges leiten Sie, aber der Simulator ermöglicht es Ihnen, genau zu quantifizieren, wie viel jede Wahl ausmacht.

### Ausrichtung der Beteiligten

Teilen Sie die Simulator-Ausgabe mit Validatoren, bevor Sie sie zuweisen — ihnen ihren erwarteten MRT-Reward zu zeigen, bietet einen konkreten Anreiz, die Validierungsaufgabe zeitnah zu priorisieren.

### Portfolio-Planung

Verwenden Sie den Simulator über mehrere Dokumenttypen hinweg, um eine priorisierte Upload-Roadmap zu erstellen — beginnend mit Dokumenten, die die höchste µI-Verbesserung und den höchsten Reward-Ertrag für das Gebäude bieten.

***

## Tipps zur effektiven Verwendung des Simulators

* Füllen Sie immer alle **3 Validator-Slots** im Simulator aus, um den maximal erreichbaren Reward und Indexbeitrag zu sehen — entscheiden Sie dann, ob der Aufwand der Rekrutierung von 3 Validatoren den Mehrwert wert ist.
* Testen Sie die Auswirkung **verschiedener Reputationsstufen** — ein primärer Validator mit Reputation 5 vs. Reputation 3 kann einen erheblichen Unterschied sowohl bei Reward- als auch Indexwerten machen.
* Verwenden Sie den Simulator für die **Due-Diligence-Vorbereitung** — bevor Sie ein großes Audit oder eine Investorenüberprüfung durchführen, simulieren Sie die Uploads, die erforderlich sind, um einen Ziel-Magma Index-Wert zu erreichen, und erstellen Sie entsprechend einen Upload-Plan.
* Der Simulator spiegelt die **aktuelle Gewichtungsmatrix** der Plattform wider — wenn Gebäudetyp- oder Dokumenttyp-Gewichtungen aktualisiert werden, führen Sie die Simulation erneut durch, um die aktualisierten Prognosen zu sehen.


---

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