# Magma Index

De Magma Index is Magma's eigen systeem voor het scoren van de volledigheid en kwaliteit van documentatie. Het kwantificeert hoe goed een gebouw is gedocumenteerd over alle niveaus en dimensies — van juridische eigendomsrecords tot realtime IoT-data — en biedt een transparante, objectieve maatstaf voor de digitale volwassenheid van een gebouw.

***

## Overzicht

De Magma Index produceert een score (uitgedrukt als een percentage) voor elk gebouw. Deze score weerspiegelt niet alleen hoeveel documenten zijn geüpload, maar ook de kwaliteit, relevantie en geloofwaardigheid van die documenten en de actoren die ze hebben geproduceerd.

De index wordt berekend op zowel het gebouwniveau (overall) als het individuele niveau (per Magma-niveau). Het wordt ook opgesplitst tot het documentniveau via de **Micro Index (µI)** — het procentuele aandeel van een enkel document in de score van het niveau.

***

## De vijf Magma-niveaus

De Magma Index organiseert alle gebouwdocumentatie in 5 niveaus, elk een afzonderlijke dimensie van het gebouw vertegenwoordigend:

| Niveau           | Code  | Beschrijving                                                                                                                         |
| ---------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Genesis**      | G     | Fundamentele documenten: eigendomsrecords, juridische documentatie, financiële instrumenten en gebouwdiagnostiek.                    |
| **Structure**    | S     | Constructieve documentatie: constructieberekeningen, opmetingen, geotechnische rapporten.                                            |
| **Architecture** | A     | Architecturale documentatie: plannen, vergunningen, certificeringen (LEED, BREEAM, HQE, WELL).                                       |
| **Wired**        | W1–W5 | Technische systemen: HVAC (W1), Sanitair (W2), Elektriciteit/Verlichting (W3), Apparaten & Toestellen (W4), Leven & Veiligheid (W5). |
| **Filled**       | F     | Interieurontwerp en meubilair: afwerkingsplannen, meubelspecificaties, interieurfotos.                                               |

Elk niveau heeft een gedefinieerde set **documenttaken** — specifieke documenttypen die aanwezig moeten zijn voor een volledig gebouwrecord.

***

## Scoringsfactoren

De Magma Index is geen eenvoudige documenttelling. De bijdrage van elk document aan de index wordt gewogen door 7 scoringsfactoren:

### Factor 1 — Hoeveelheid versus verwacht

De verhouding van daadwerkelijk geüploade documenten versus het aantal verwachte documenttypen voor dit gebouw (op basis van het gebouwtype). Een gebouw met alle verwachte documenttypen scoort hoger dan een gebouw met slechts een paar.

### Factor 2 — Actorcategorie

De categorie van de stakeholder die het document heeft geüpload:

| Categorie         | Beschrijving                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| **Professioneel** | Erkende professionals (Architect, Ingenieur, Notaris, Advocaat, enz.). |
| **Amateur**       | Niet-erkende personen (Eigenaar die persoonlijk handelt, enz.).        |

Professionele actoren dragen meer bij aan de index dan amateur-actoren, omdat hun documenten een hogere geloofwaardigheid dragen.

### Factor 3 — Relevantie van de combinatie uploader/validator

Of de persoon die het document heeft geüpload en de persoon/personen die het hebben gevalideerd de meest geschikte rollen zijn voor dat specifieke documenttype. Zo scoort een verzekeringsdocument dat door een Advocaat is geüpload en door een Notaris is gevalideerd hoger dan hetzelfde document dat door een Huurder is geüpload.

### Factor 4 — Validatorvolledigheid

Of 1, 2 of 3 validators aan het document zijn toegewezen:

| Validators   | Niveau              |
| ------------ | ------------------- |
| 0 validators | Geen validatiebonus |
| 1 validator  | Niveau 1            |
| 2 validators | Niveau 2            |
| 3 validators | Niveau 3 (maximum)  |

Meer validators vergroten de geloofwaardigheid van het document en daarmee de bijdrage aan de index.

### Factor 5 — Stakeholderreputatie

De reputatiescore (geheel getal 1–5, standaard 3) van de uploader en validators. Een hogere reputatie betekent meer vertrouwen in hun bijdrage.

* Standaardreputatie voor alle stakeholders: **3**
* Reputatie neemt toe met **+1** voor elke **5 geminte validaties** (maximum **5**).
* Reputatie kan worden verlaagd door sancties die worden toegepast door een geplande cronjob (bijv. voor afgewezen validaties, inactiviteit, enz.).

### Factor 6 — Gegevensvervalpremie

Documenten met een vervaldatum die is verstreken, passen een **negatieve straf** toe op hun bijdrage. Verlopen documenten verlagen de Magma Index-score voor hun niveau. Dit stimuleert het actueel houden van tijdsgevoelige documenten.

### Factor 7 — Weging naar gebouwtype

Verschillende documenttypen hebben een verschillende intrinsieke betekenis afhankelijk van het gebouwtype. Een beveiligingsovereenkomst is bijvoorbeeld kritischer voor een Hotel dan voor een Opslaggebouw. De wegingsmatrix past de basisintroductie van elk document aan op basis van het gebouwtype.

**De 9 gebouwtypes en hun wegingsprofielen:**

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

***

## Micro Index (µI)

De **Micro Index** (afgekort **µI**) vertegenwoordigt het procentuele aandeel van een enkel document in de totale Magma Index-score van zijn niveau.

* µI wordt uitgedrukt als een percentage (bijv. een document kan 3,4% bijdragen aan de Architecture-niveauscore).
* µI is zichtbaar in het Documentinfopaneel in de Data Room.
* µI is ook zichtbaar in de sectie [Waardebijdragen](/magma-documentation/nl/functies/value-contributions.md), waar de bijdrage van elk document wordt vermeld.
* µI wordt gebruikt in de [Simulator](/magma-documentation/nl/functies/simulator.md) om de impact van een nieuw document te bekijken voordat het wordt geüpload.

Inzicht in µI helpt stakeholders prioriteit te geven aan welke documenten ze moeten uploaden of bijwerken om de totale indexscore van het gebouw te maximaliseren.

***

## Widget Gebouwindex

De widget Gebouwindex biedt een visueel overzicht van de Magma Index van het gebouw. Deze is toegankelijk via de hoofdprofielpagina van het gebouw.

### Eenvoudige weergave

Een **cirkelvormige voortgangsring** voor elk van de 5 niveaus, met:

* **Primaire kleurvulling** — Percentage gevalideerde documenten.
* **Succeskleurvulling** — Percentage te-valideren documenten (documenten die zijn geüpload maar nog niet zijn gevalideerd).

De ringen bieden een snelle weergave van hoe volledig en gevalideerd de documentatie van het gebouw is op elk niveau.

### Gedetailleerde weergave

Schakel naar de Gedetailleerde weergave voor een volledige uitsplitsing:

* Een **accordeon** voor elk niveau dat kan worden uitgevouwen.
* Binnen elke accordeon: een lijst van elke documenttaak voor dat niveau.
* Elke documenttaakrij toont:
  * **Statuspictogram** — Of het document ontbreekt, geüpload (in behandeling) of gevalideerd is.
  * **Documentnaam** — De naam van het documenttype.
  * **Avatar van uploader** — De avatar van de stakeholder die de meest recente versie heeft geüpload.
  * **Klikbaar** — Klikken op een documenttaakrij opent dat document rechtstreeks in de Data Room.

De Gedetailleerde weergave maakt het eenvoudig om te identificeren welke documenten precies ontbreken of nog wachten op validatie, zodat er onmiddellijk actie kan worden ondernomen.

***

## Certificeringen op Architecture-niveau

Het Architecture-niveau van de Magma Index volgt specifiek de certificeringen voor duurzaamheid en gebouwprestaties. Ondersteunde certificeringstypen zijn:

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

Certificeringsdocumenten die zijn geüpload onder het Architecture-niveau met het juiste documenttype worden herkend en dienovereenkomstig gewogen in de indexberekening.

***

## Hoe de Magma Index andere functies beïnvloedt

De Magma Index-score wordt op verschillende manieren gebruikt op het platform:

| Functie             | Hoe de index wordt gebruikt                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------ |
| **DTT Minting**     | De indexscore wordt weergegeven op de DTT-kaart en ingebed in de metadata van het geminte token. |
| **Beloningen**      | Documentbeloningsbedragen worden gedeeltelijk bepaald door de indexbijdrage van het document.    |
| **Dashboard**       | De index wordt weergegeven op elke gebouwkaart als een belangrijke prestatie-indicator.          |
| **Simulator**       | Bekijkt de indexbijdrage (µI) van een hypothetische documentupload voordat deze plaatsvindt.     |
| **Waardebijdragen** | Geeft de individuele bijdrage van elk document en BIM-object aan de index weer.                  |

***

## Tips voor het maximaliseren van uw Magma Index

* Begin met **Genesis-niveau** documenten — Titel, Akte en Kadaster zijn permanente documenten die vanaf dag één bijdragen en nooit verlopen.
* Geef prioriteit aan **professionele uploaders** — Documenten die zijn geüpload door erkende professionals (Architecten, Ingenieurs, Advocaten) ontvangen een hogere bonus voor de actorcategorie.
* Wijs altijd **3 validators** toe bij het uploaden van kritische documenten — de Niveau 3-bonus voor validatorvolledigheid verhoogt de bijdrage van het document aanzienlijk.
* Bouw **stakeholderreputatie** op in de loop der tijd — consistente, hoogwaardige validaties verhogen reputatiescores, die de indexbijdrage van elk volgend document versterken.
* Update regelmatig **tijdsgevoelige documenten** (Verzekering, Onroerendezaakbelasting, Auditrapporten) voordat ze verlopen om te voorkomen dat de gegevensvervalpremie uw score verlaagt.
* Gebruik de **Simulator** voordat u dure of complexe documenten uploadt om precies te bekijken hoeveel ze aan de index zullen bijdragen.


---

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