# Simulator

De Simulator is een planningshulpmiddel waarmee u de impact van een documentupload kunt bekijken **voordat het plaatsvindt**. Het berekent de exacte Magma Index-bijdrage (Micro Index µI) en de MRT-beloningsdistributie voor elke hypothetische combinatie van gebouwniveau, documenttype, actoren en validators — zodat u weloverwogen beslissingen kunt nemen over hoe u zowel de score van uw gebouw als de beloningen van uw stakeholders kunt maximaliseren.

***

## Overzicht

De Simulator beantwoordt twee vragen vóór het uploaden van een document:

1. **Hoeveel verbetert dit document mijn Magma Index?** (Waardebijdragepaneel)
2. **Hoeveel MRT verdient elke stakeholder?** (Beloningsdistributiepaneel)

Door de invoer aan te passen — documenttype, uploaderrol, validatorrollen — kunt u verschillende combinaties vergelijken en de optimale configuratie kiezen voordat u zich vastlegt.

***

## Toegang tot de Simulator

De Simulator is toegankelijk vanuit:

* Het tabblad of de sectie **Simulator** van het gebouw.
* Het uploadformulier in de Data Room — een knop **Simulator** is beschikbaar vóór het bevestigen van een upload.

***

## Simulatorinvoer

Configureer de volgende invoer om een simulatie te genereren:

### Gebouwniveau

Een vervolgkeuzelijst om te selecteren tot welk Magma-niveau het document behoort:

* Genesis
* Structure
* Architecture
* Wired 1 (Mechanisch)
* Wired 2 (Sanitair)
* Wired 3 (Verlichting)
* Wired 4 (Apparaten & Toestellen)
* Wired 5 (Leven & Veiligheid)
* Filled

Het selecteren van een niveau filtert de beschikbare documenttypen tot alleen die van toepassing op dat niveau.

### Gebouwtype

Een vervolgkeuzelijst om het gebouwtype te selecteren (9 opties):

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

Het gebouwtype beïnvloedt de **wegingsfactor** die wordt toegepast op de intrinsieke waarde van het document, wat op zijn beurt zowel de bijdrage als het beloningsbedrag beïnvloedt.

> **Opmerking:** Dit veld is vooraf ingevuld met het geconfigureerde type van het gebouw en hoeft doorgaans niet te worden gewijzigd.

### Documenttype

Een vervolgkeuzelijst met alle documenttypen die van toepassing zijn op het geselecteerde **Niveau**. De lijst wordt gefilterd op basis van de niveauselectie — het selecteren van een ander niveau reset dit veld en toont alleen relevante documenttypen.

### Aantal bestanden

Een numerieke invoer (1–100) die aangeeft hoeveel bestanden worden geüpload voor deze documentdefinitie.

### Uploader

Configureer de stakeholder die het document zal uploaden:

| Subveld   | Opties                                                                                         |
| --------- | ---------------------------------------------------------------------------------------------- |
| Rol       | Selecteer uit alle beschikbare platformrollen (Eigenaar, Architect, Ingenieur, Advocaat, enz.) |
| Reputatie | Selecteer van 1 tot 5 (geheel getal)                                                           |

De badge **Aanbevolen** verschijnt naast rollen die het meest geschikt zijn voor het uploaden van het geselecteerde documenttype. Het selecteren van een aanbevolen rol maximaliseert de vermenigvuldigers voor actorcategorie en rolcombinatie.

### Primaire validator (optioneel)

Configureer de eerste validator:

| Subveld   | Opties                                        |
| --------- | --------------------------------------------- |
| Rol       | Selecteer uit alle beschikbare platformrollen |
| Reputatie | Selecteer van 1 tot 5                         |

De badge **Aanbevolen** geeft de optimale rol aan voor primaire validatie van dit documenttype.

> **Beperking:** Dezelfde rol kan niet meer dan één keer worden geselecteerd over de uploader en alle validatorslots.

### Secundaire validator (optioneel)

Configureer de tweede validator (dezelfde velden als Primaire validator). Optioneel — dit leeg laten simuleert een Niveau 1-scenario (1 validator).

### Tertiaire validator (optioneel)

Configureer de derde validator (dezelfde velden als Primaire validator). Optioneel — dit leeg laten simuleert een Niveau 2-scenario (2 validators). Het invullen van alle drie de slots simuleert het maximum Niveau 3-scenario.

***

## Rolaanbevelingen

Voor elk actorslot (uploader, primaire validator, secundaire validator, tertiaire validator) toont de Simulator een badge **Aanbevolen** naast rollen die het meest geschikt zijn voor het geselecteerde documenttype. Deze aanbevelingen zijn gebaseerd op de rolrelevantie-matrix van het platform, die bepaalt welke professionele rollen het meest geloofwaardig zijn voor elk documenttype.

Het selecteren van aanbevolen rollen voor alle slots resulteert in de maximale vermenigvuldiger voor rolcombinaties en produceert de hoogst mogelijke indexbijdrage en beloningsbedragen.

***

## Beperking voor roluniekheid

Om onrealistische simulaties te voorkomen (bijv. dezelfde persoon die hun eigen document in meerdere slots valideert), **kan dezelfde rol niet meer dan één keer worden geselecteerd** over alle actorslots. De vervolgkeuzelijsten schakelen automatisch rollen uit of filteren rollen die al zijn geselecteerd in een ander slot.

***

## Simulatoruitvoer

Na het configureren van alle invoer toont de Simulator twee uitvoerpanelen:

### 1. Waardebijdragepaneel

Toont hoe het gesimuleerde document de Magma Index zou beïnvloeden:

| Veld                   | Beschrijving                                                                                  |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| **Waarde per actor**   | De indexbijdragewaarde toegeschreven aan elke actor (uploader, primair, secundair, tertiair). |
| **Micro Index (µI %)** | Het geschatte procentuele aandeel van het document in de Magma Index-score van het niveau.    |

Dit paneel toont u de exacte verbetering van de Magma Index van het gebouw die het gevolg zou zijn van deze upload, ervan uitgaande dat het document de status Gevalideerd bereikt met de opgegeven configuratie.

### 2. Beloningsdistributiepaneel

Toont hoe MRT-beloningen zouden worden gedistribueerd:

| Veld                       | Beschrijving                                                                                                                 |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **MRT-beloning per actor** | Het geschatte MRT-beloningsbedrag voor elke actor (uploader, primaire validator, secundaire validator, tertiaire validator). |

Beloningen worden individueel uitgesplitst zodat elke stakeholder hun persoonlijk verwachte beloning kan zien voordat enige verplichting wordt aangegaan.

***

## Knop Wissen

De knop **Wissen** reset alle **actorvelden** (uploader, primaire/secundaire/tertiaire validators) terwijl de documenttype- en gebouwniveauselectie behouden blijft. Hierdoor kunt u snel verschillende actorcombinaties testen voor hetzelfde documenttype zonder het niveau en documenttype opnieuw te moeten selecteren.

***

## Praktische gebruiksscenario's

### Vóór het uploaden van een kritisch document

Gebruik de Simulator om te bevestigen dat de geplande actorconfiguratie (uploader + validators) de verwachte Magma Index-verbetering en beloningsdistributie zal opleveren. Als het resultaat lager is dan verwacht, experimenteer dan met verschillende validatorrollen of reputatieniveaus om de impact te begrijpen.

### De juiste validators kiezen

Voer verschillende validatorrrolcombinaties in om de combinatie te vinden die de beloning en indexbijdrage maximaliseert. De Aanbevolen-badges begeleiden u, maar de Simulator laat u kwantificeren hoe groot de impact van elke keuze precies is.

### Stakeholderafstemming

Deel de Simulatoruitvoer met validators voordat u hen toewijst — het tonen van hun verwachte MRT-beloning biedt concrete stimulans om de validatietaak snel te prioriteren.

### Portfolioplanning

Gebruik de Simulator over meerdere documenttypen om een geprioriteerde uploadroadmap te bouwen — te beginnen met documenten die de hoogste µI-verbetering en beloningsopbrengst bieden voor het gebouw.

***

## Tips voor effectief gebruik van de Simulator

* Vul altijd alle **3 validatorslots** in de Simulator in om de maximaal haalbare beloning en indexbijdrage te zien — beslis vervolgens of de inspanning om 3 validators te werven de verbetering waard is.
* Test de impact van **verschillende reputatieniveaus** — een primaire validator met reputatie 5 versus reputatie 3 kan een significant verschil maken in zowel beloning als indexscores.
* Gebruik de Simulator voor **due diligence-voorbereiding** — vóór een grote audit of investeerdersreview, simuleer de uploads die nodig zijn om een doelscorore voor de Magma Index te bereiken en bouw dienovereenkomstig een uploadplan.
* De Simulator weerspiegelt de **huidige wegingsmatrix** van het platform — als het gebouwtype of de documenttypewegingen worden bijgewerkt, voer de simulatie opnieuw uit om de bijgewerkte projecties te zien.


---

# 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/nl/functies/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.