# Magma Index-scoring

De Magma Index meet hoe digitaal compleet een gebouw is. Het is geen simpele bestandsteller — het evalueert de **kwaliteit, herkomst en relevantie** van elk stuk data dat bijgedragen wordt aan de DTT® van een gebouw.

## De vijf niveaus

De Magma Index is verdeeld in vijf niveaus, elk gericht op een ander domein van gebouwgegevens:

| Niveau           | Wat het omvat                                                                                          |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| **Genesis**      | Fundamentele gegevens: eigendom, juridisch, financieel, verzekering, diagnoses                         |
| **Structure**    | Constructietechniek: berekeningen, tekeningen, compliance, BIM-model                                   |
| **Architecture** | Ontwerp: tekeningen, landschap, certificeringen (LEED, BREEAM, HQE, WELL), 3D-scan                     |
| **Wired**        | Technische systemen: HVAC (W1), Sanitair (W2), Elektra (W3), Apparaten (W4), Brand- en veiligheid (W5) |
| **Filled**       | Interieur: ontwerpenplannen, inrichting, schoonmaak, interieur BIM-model                               |

Elk niveau heeft zijn eigen voltooiingspercentage. De **globale Magma Index** is afgeleid van alle vijf niveaus gecombineerd.

***

## Hoe elk document wordt gescoord

Elk documenttype heeft een **intrinsieke waarde** — een basisscore — bepaald door drie factoren:

1. **Het indexniveau** (Genesis, Structure, Architecture, Wired, Filled)
2. **Het gebouwtype** (Hotel, Office, Residential, enz.)
3. **Het specifieke documenttype** (bijv. Eigendomstitel, Constructietekeningen, LEED-certificering)

Deze intrinsieke waarde wordt vervolgens aangepast door vijf factoren:

### Factor 1 — Acteurscategorie

Wie de gegevens heeft bijgedragen is van belang. Professionals met directe verantwoordelijkheid voor dat datadomein dragen meer bij:

* Een architect die constructietekeningen uploadt heeft meer gewicht dan een algemene stakeholder die hetzelfde document uploadt
* Het systeem gebruikt de **categorie** van de stakeholder (Owner, Asset Manager, Service Provider, enz.) en hun specifieke **type** (Architect, Structural Engineer, enz.) om deze aanpassing te bepalen

### Factor 2 — Uploader/validator-combinatie

De combinatie van wie uploadde en wie het document valideerde beïnvloedt de score:

* Een document dat is geüpload door de meest relevante professional (bijv. een Diagnostician) en gevalideerd door de meest passende autoriteit (bijv. de Asset Manager en City Inspector) scoort het hoogst
* Een document dat is geüpload en gevalideerd door minder relevante partijen draagt nog steeds bij, maar met een lagere coëfficiënt

### Factor 3 — Validatorvolledigheid

Documenten waarbij alle drie validatorniveaus zijn voltooid scoren hoger dan documenten met slechts één primaire validator:

* 3 validators: maximale volledigheidscore
* 2 validators: gemiddelde score
* 1 validator: minimale volledigheidscore
* 0 validators: nog niet gevalideerd, draagt niet bij

### Factor 4 — Stakeholderreputatie

Elke stakeholder heeft een **reputatiescore** (geheel getal 1–5, globaal voor alle gebouwen, standaard 3). Bijdragers met een hogere reputatie produceren waardevoller data:

* Reputatie neemt toe met **+1 voor elke 5 geminte validaties** (maximaal 5)
* De reputatie van zowel de uploader als elke validator wordt meegenomen in de eindwaarde
* Sancties kunnen de reputatie verlagen (toegepast door een gepland proces)

De reputatiefactor zorgt ervoor dat ervaren, consistent nauwkeurige bijdragers in de loop van de tijd worden erkend.

### Factor 5 — Gegevensverval

Documenten met geldigheidsperioden (verzekeringen, onroerendezaakbelasting, auditrapporten, enz.) verliezen hun indexbijdrage naarmate ze de vervaldatum naderen:

* Een actief, niet-verlopen document draagt zijn volledige waarde bij
* Een verlopen document verlaagt de indexscore voor de categorie totdat een vernieuwde versie is geüpload en gevalideerd

***

## De Micro Index (µI)

De **Micro Index** (µI) vertegenwoordigt het procentuele aandeel van een enkel document in de score van zijn niveau. Het wordt weergegeven als een percentage (bijv. "2,3%") en is zichtbaar in:

* De **Simulator**-resultaten (vóór uploaden, om de impact te bekijken)
* Het tabblad **Value Contributions** (na uploaden, met de werkelijke bijdrage)
* Het **Building Index Details**-accordeon (in ontwikkelaarsmodus)

De µI stelt u in staat de relatieve belang van verschillende documenten te vergelijken en uploads te prioriteren die de grootste impact hebben op uw Magma Index.

***

## Het Magma Index-widget lezen

Het Building Index-widget op het tabblad Overzicht toont drie soorten voortgang per niveau:

| Kleur               | Betekenis                                                                                          |
| ------------------- | -------------------------------------------------------------------------------------------------- |
| **Blauw (primair)** | Gegevens al on-chain gemint — vastgelegd in de blockchainregistratie                               |
| **Groen (succes)**  | Gegevens gevalideerd en goedgekeurd maar nog niet gemint — worden opgenomen in de volgende minting |
| **Resterend**       | Gegevens wachten op validatie of nog niet geüpload — dragen nog niet bij                           |

De **Eenvoudige weergave** toont cirkelvormige voortgangsindicatoren per niveau met zowel gevalideerde (blauw) als nog te valideren (groen) percentages.

De **Gedetailleerde weergave** (accordeon) toont elke afzonderlijke documenttaak, de status, wie het heeft geüpload, en biedt de mogelijkheid door te klikken naar dat document.

***

## Samenvatting van de scoringsformule

```
Documentbijdrage = 
  Intrinsieke waarde (niveau × gebouwtype × documenttype)
  × Aanpassing acteurscategorie
  × Aanpassing uploader/validator-combinatie  
  × Aanpassing validatorvolledigheid
  × Reputatiefactor (uploader + validators)
  × Vervalcorrectie (korting bij verloop)
```

De som van alle documentbijdragen over alle niveaus levert het algehele Magma Index-percentage van het gebouw op.

***

## Uw Magma Index maximaliseren

Om de hoogst mogelijke Magma Index te bereiken:

1. **Upload alle verwachte documenttypen** voor uw gebouwtype — de index houdt rekening met wat verwacht wordt, niet alleen met wat u heeft
2. **Gebruik de juiste professional** — zorg ervoor dat de aangewezen uploaderrol voor elk document degene is die het uploadt
3. **Wijs alle drie validatorniveaus toe** — sla secundaire en tertiaire validators niet over
4. **Houd documenten actueel** — vernieuw verlopende documenten voordat ze vervallen
5. **Bouw reputatie op** — stakeholders met een hogere reputatie leveren waardevoller bijdragen
6. **Upload BIM-modellen** voor alle niveaus — 3D-objectgegevens dragen afzonderlijk bij naast documenten
7. **Gebruik de Simulator** — bekijk de exacte µI-impact voordat u een document uploadt


---

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