# Data Room

De Data Room is de centrale hub voor documentbeheer van het Magma-platform. Het biedt veilige, gestructureerde opslag voor alle gebouwgerelateerde documenten, met ondersteuning voor documentversiebeheer, cryptografische hashing, delen met betrokkenen, annotaties, validatieworkflows en blockchain-minting.

***

## Lay-outmodi

De Data Room biedt twee lay-outmodi, te schakelen via de werkbalk:

### Uitgebreide (3-koloms) modus

De standaardweergave. Drie panelen worden naast elkaar weergegeven:

1. **Linkerpaneel** — Navigatie via documentboom/lijst.
2. **Middenpaneel** — Documentrijen voor de geselecteerde categorie.
3. **Rechterpaneel** — Documentinfopaneel voor het geselecteerde document.

Deze modus is ideaal voor het werken met een specifiek document, het beoordelen van de metadata en het beheren van delen of validatie.

### Compacte modus

Het rechter infopaneel is ingeklapt. Documenten worden weergegeven in een breder lijst-/rasterformaat, waardoor het gemakkelijker is om grote verzamelingen te doorzoeken zonder op één document te focussen. Als u op een documentrij klikt, wordt het infopaneel geopend als een overlay of wordt de lay-out tijdelijk uitgebreid.

***

## Navigatiestructuur

Documenten zijn georganiseerd in een strikte hiërarchie die de **Magma Index-boom** wordt genoemd:

```
Niveau (Genesis / Structure / Architecture / Wired / Filled)
  └── Categorie (bijv. Eigendom, Juridisch, Verzekering)
        └── Documentdefinitie (bijv. Eigendomsakte, Kadastrale informatie)
              └── IFC-submap (voor van toepassing zijnde documenttypen)
```

### Boomweergave

Het linkerpaneel toont deze hiërarchie als een uitbreidbare boom. Als u op een knooppunt klikt, worden de onderliggende elementen uitgevouwen of ingeklapt. Als u op een **Documentdefinitie**-knooppunt klikt, worden de documenten in het middenpaneel geladen.

### Lijstweergave

Een alternatieve platte weergave die alle documenten van alle categorieën in één scrollbare lijst weergeeft, zonder hiërarchische groepering. Handig voor het snel doorzoeken van alle documenten ongeacht niveau of categorie.

### IFC-submappen

Bepaalde documentdefinities ondersteunen IFC (Industry Foundation Classes)-bestanden. Deze definities tonen een **IFC-submap** in de documentboom. Binnen een IFC-submap zijn twee actieknoppen beschikbaar:

* **Openen in BIM** — Opent het IFC-bestand in de [BIM 3D-viewer](/magma-documentation/nl/functies/bim-3d-viewer.md).
* **Openen in Scan** — Opent de bijbehorende scan in de [Scan Viewer](/magma-documentation/nl/functies/scan-viewer.md).

***

## Documentrij

Elk document wordt weergegeven als een rij in het middenpaneel. De rij bevat de volgende elementen:

| Element                | Beschrijving                                                              |
| ---------------------- | ------------------------------------------------------------------------- |
| Statuspictogram        | Visuele indicator van de huidige status van het document (zie hieronder). |
| Documentnaam           | De leesbare naam van de documentdefinitie.                                |
| Versie                 | Het huidige versienummer (bijv. v1, v2, v3).                              |
| Originele bestandsnaam | De werkelijke bestandsnaam van het geüploade bestand.                     |
| Categorie              | De categorie van het document binnen de Magma Index.                      |
| Bestandsgrootte        | Grootte van het geüploade bestand.                                        |
| Eigenaar-avatar        | Profielfoto van de uploader van het document (eigenaar).                  |
| Validator-avatars      | Profielfoto's van toegewezen validators (maximaal 3).                     |
| Laatst gewijzigd       | Relatieve of absolute tijdstempel van de meest recente wijziging.         |

***

## Documentstatus

Documenten doorlopen een gedefinieerde levenscyclus, aangegeven door een statusbadge:

| Status                          | Beschrijving                                                                     |
| ------------------------------- | -------------------------------------------------------------------------------- |
| **Concept**                     | Document is geüpload maar nog niet ingediend voor validatie.                     |
| **In afwachting van validatie** | Document is ingediend en wacht op beoordeling door de validator.                 |
| **Gevalideerd**                 | Alle toegewezen validators hebben het document goedgekeurd.                      |
| **Gemint**                      | Het document is opgenomen in een DTT-minting op de blockchain.                   |
| **Actie vereist**               | Het document vereist aandacht — doorgaans omdat het is afgewezen of verlopen is. |

***

## Documentinfopaneel

Als u een documentrij selecteert, wordt het documentinfopaneel aan de rechterkant van het scherm geopend (of als overlay in de compacte modus). Dit paneel biedt volledige details over het geselecteerde document:

### Uploadersinformatie

* **Avatar**, **volledige naam** en **platformrol** van de uploader (bijv. Architect, Eigenaar).

### Statusbadges

Speciale statusbadges verschijnen indien van toepassing:

* **VERVANGEN** — Deze documentversie vervangt een oudere versie via een totaalvervanging.
* **GECORRIGEERD** — Deze documentversie vervangt een oudere versie via een correctie.

### Metadata

| Veld            | Beschrijving                                                                                                                                                             |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Bestandsgrootte | Grootte van het huidige documentbestand.                                                                                                                                 |
| Uploaddatum     | Datum en tijd waarop het bestand is geüpload.                                                                                                                            |
| Validatiedatum  | Datum waarop het document de status Gevalideerd heeft bereikt (indien van toepassing).                                                                                   |
| Vervaldatum     | De datum waarna de geldigheid van het document verloopt (varieert per documenttype — zie Geldigheidsperioden).                                                           |
| Document-hash   | Een cryptografische hash van de bestandsinhoud. Deze hash wordt ook opgeslagen op de blockchain tijdens minting en kan worden gebruikt om de authenticiteit te bewijzen. |

### Recentste activiteitenlog

Een chronologische feed van alle gebeurtenissen met betrekking tot dit document, inclusief:

* Bestand geüpload
* Verzonden voor validatie
* Validator goedgekeurd / afgewezen
* Document vervangen of gecorrigeerd
* Document gemint
* Toegang verleend / ingetrokken

### Lijst van geautoriseerde gebruikers

Een lijst van alle betrokkenen en gasten aan wie toegang is verleend tot dit specifieke document. Elk item toont:

* Gebruiker-avatar en naam
* Hun rol of toegangstype (Gebouwbetrokkene, Niet-geregistreerde gast, Magma-gastgebruiker)
* Een knop **Intrekken** om hun toegang onmiddellijk te verwijderen

### Versiegeschiedenis

Een lijst van alle vorige versies van dit document, in omgekeerde chronologische volgorde. Elk versiepunt is klikbaar en laadt de metadata en het bestand van die versie. Versies tonen:

* Versienummer
* Uploaddatum
* Status op het moment van vervanging
* Vervangingstype (Totaalvervanging of Correctie)

***

## Filters en sorteren

### Zoeken

Een volledig tekstzoekveld bovenaan de documentlijst. Zoekt over documentnamen, bestandsnamen en categorieën.

### Statusfilter

Documenten filteren op hun huidige status:

* Concept
* In afwachting van validatie
* Gevalideerd
* Gemint
* Actie vereist

Meerdere statussen kunnen tegelijkertijd worden geselecteerd.

### Niveaufilter

Documenten filteren op hun Magma Index-niveau:

* Genesis
* Structure
* Architecture
* Wired (W1 tot en met W5)
* Filled

### Rolfilter

Schakelen tussen:

* **Mijn rol** — Toont alleen documenten die relevant zijn voor uw toegewezen rol (bijv. documenten die u moet valideren of heeft geüpload).
* **Alle** — Toont alle documenten ongeacht roltoewijzing.

### Sorteeropties

| Sorteren          | Beschrijving                                                      |
| ----------------- | ----------------------------------------------------------------- |
| Alfabetisch       | Sorteert documenten van A tot Z op naam van de documentdefinitie. |
| Nieuwste          | Meest recent geüploade documenten eerst.                          |
| Oudste            | Oudste geüploade documenten eerst.                                |
| Laatste wijziging | Meest recent gewijzigde of bijgewerkte documenten eerst.          |

***

## Bladwijzerzijbalk

De **Bladwijzer**-zijbalk is een 312 px breed paneel dat aan de rechterkant van het scherm inschuift (onafhankelijk van het infopaneel). Hiermee kunt u veelgebruikte documenten opslaan en snel openen.

* **Een document als bladwijzer markeren** — Klik op het bladwijzerpictogram op een documentrij om het aan uw bladwijzers toe te voegen.
* **Bladwijzers openen** — Klik op het bladwijzerpictogram in de Data Room-werkbalk om de zijbalk in te schuiven.
* **Een bladwijzer verwijderen** — Klik opnieuw op het bladwijzerpictogram op een document met bladwijzer, of verwijder het vanuit de zijbalk.

Bladwijzers zijn persoonlijk en worden niet gedeeld met andere betrokkenen.

***

## Mijn Kluis

De schakelaar **Mijn Kluis** filtert de Data Room zodat alleen documenten worden weergegeven die u persoonlijk heeft geüpload, die u bezit of waarvoor u specifieke toegangsrechten heeft. Dit is handig om snel uw eigen bijdragen te vinden zonder door de volledige documentlijst te scrollen.

***

## Documenten uploaden

### Vereisten

* **Maximale bestandsgrootte:** 150 MB per bestand.
* **Bestanden per upload:** Tussen 1 en 6 bestanden per documentdefinitie (afhankelijk van de configuratie van de definitie).
* **Uploadmethode:** Bestanden via drag-and-drop op de uploadzone plaatsen, of klikken om uw bestandssysteem te doorzoeken.

### Uploadformuliervelden

| Veld        | Beschrijving                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Bestand(en) | Selecteer 1–6 bestanden. Drag-and-drop ondersteund.                                                                                                    |
| Validators  | Wijs maximaal 3 validators toe. Validators met de badge **Aanbevolen** zijn degenen wiens rol het beste aansluit bij het documenttype.                 |
| Vervaldatum | Stel optioneel een vervaldatum in. Sommige documenttypen hebben vaste geldigheidsperioden (zie hieronder) en dit veld kan automatisch worden ingevuld. |

### Aanbevolen-badge

Naast elk validatorselectievak verschijnt een **Aanbevolen**-badge naast betrokkenen wiens professionele rol het meest geschikt is voor het valideren van dit specifieke documenttype. Dit helpt uploaders de meest geloofwaardige validators te selecteren, wat de Magma Index-score positief beïnvloedt.

### Geldigheidsperioden

Bepaalde documenttypen hebben door het platform gedefinieerde vaste geldigheidsperioden:

| Geldigheidsperiode            | Documenttypen                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------ |
| **1 Jaar**                    | Verzekering, Hypotheek, Winst & Verlies, Zekerheidsovereenkomst / Veiligheidslogboek |
| **1 Maand**                   | Onroerendezaakbelasting, Auditverslagen, Budget, Veiligheidsplan                     |
| **Zodra het gebouw klaar is** | Gebruiksvergunning                                                                   |
| **Permanent**                 | Eigendomsakte, Kadastrale informatie                                                 |

***

## Documentvervanging

Wanneer een document moet worden bijgewerkt, moet u de vervangingsworkflow gebruiken in plaats van te verwijderen en opnieuw te uploaden. Dit bewaart de versiegeschiedenis en het auditspoor.

### Vervangingstypen

| Type                 | Beschrijving                                                                                                                          |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **TOTAALVERVANGING** | Een volledige vervanging van het document. Gebruikt wanneer de inhoud fundamenteel is veranderd (bijv. een nieuwe verzekeringspolis). |
| **CORRECTIE**        | Een kleine correctie op een bestaand document (bijv. het herstellen van een typefout, het bijwerken van een handtekening).            |

### Vervangingsworkflow

1. Open het infopaneel van het document.
2. Klik op de knop **Vervangen**.
3. Selecteer het vervangingstype: **Totaalvervanging** of **Correctie**.
4. Voer een **reden** voor de vervanging in (minimaal 5 tekens — verplicht).
5. Upload het nieuwe bestand.
6. Indienen.

De oude versie wordt gearchiveerd in de versiegeschiedenis en gemarkeerd met de badge **VERVANGEN** of **GECORRIGEERD**. De nieuwe versie wordt het huidige actieve document en begint de validatieworkflow opnieuw als er validators zijn toegewezen.

***

## Documenten delen

U kunt afzonderlijke documenten delen met mensen die nog geen deel uitmaken van het betrokkensteam van het gebouw. Delen is toegankelijk via de knop **Delen** in het documentinfopaneel.

### Deeltypen

| Type                         | Beschrijving                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Gebouwbetrokkene**         | Delen met een bestaande betrokkene van het gebouw. Selecteer uit een lijst van huidige betrokkenen.     |
| **Niet-geregistreerde gast** | Delen met iemand die geen Magma-account heeft. Voer hun e-mailadres in; zij ontvangen een toegangslink. |
| **Magma-gastgebruiker**      | Delen met een Magma-gebruiker die geen betrokkene is bij dit gebouw. Zoeken op naam of e-mail.          |

Gedeelde toegang is documentspecifiek. Gedeelde gebruikers verschijnen in de lijst van geautoriseerde gebruikers in het infopaneel en hun toegang kan op elk moment worden ingetrokken.

***

## Annotaties

Annotaties stellen betrokkenen in staat opmerkingen, verzoeken of redacties direct op documentpagina's in de Data Room-viewer achter te laten.

### Een annotatie aanmaken

1. Open een document in de viewer.
2. Klik en sleep op het paginagebied om de annotatiezone te definiëren.
3. Er verschijnt een opmerkingenpop-up.

### Opmerking-annotaties

* Schrijf uw opmerkingtekst.
* Voeg **emoji-reacties** toe om snel te erkennen of te reageren.
* Gebruik **@vermeldingen** om specifieke betrokkenen te notificeren.
* **Bijlagen toevoegen** (afbeeldingen of documenten) aan de opmerking.
* **Geordende antwoorden** — Andere betrokkenen kunnen direct binnen dezelfde annotatiethread antwoorden.

### Redactie-annotaties

Redacties stellen u in staat zwarte vakken te tekenen over gevoelige inhoud op documentpagina's:

1. Selecteer het **Redigeren**-gereedschap in de annotatiewerkbalk.
2. Teken zwarte vakken over alle inhoud die u wilt redigeren.
3. Klik op **Opslaan**.

Het opslaan van een redactie maakt een **nieuwe versie** van het document met de permanent toegepaste geredigeerde inhoud. De originele (niet-geredigeerde) versie wordt bewaard in de versiegeschiedenis voor geautoriseerde gebruikers met de juiste rechten.

### Annotatietypen

| Type      | Beschrijving                                                                                    |
| --------- | ----------------------------------------------------------------------------------------------- |
| Opmerking | Een algemene opmerking, vraag of notitie gekoppeld aan een specifiek gebied van het document.   |
| Redigeren | Een zwart-vak-redactie getekend over gevoelige inhoud. Opslaan maakt een nieuwe documentversie. |

***

## Toegangsverzoekstroom

Als een betrokkene of externe gebruiker probeert een document te bekijken waartoe hij geen toegang heeft, kan hij een **Toegangsverzoek** indienen:

1. De gebruiker klikt op **Toegang aanvragen** op het beperkte document.
2. Optioneel voegt hij een bericht toe dat uitlegt waarom hij toegang nodig heeft.
3. De documenteigenaar en gebouwbeheerders ontvangen een melding in de [Activiteitsfeed](/magma-documentation/nl/functies/activity-feed.md) met een actieknop **Verzoek beoordelen**.
4. De beoordelaar keurt het verzoek goed of weigert het.
5. Bij goedkeuring wordt de verzoekende gebruiker toegevoegd aan de lijst van geautoriseerde gebruikers en ontvangt hij een toegangsmelding.

***

## Cryptografische document-hash

Elk document dat naar de Data Room wordt geüpload ontvangt een **cryptografische hash** (SHA-256 of equivalent) berekend uit de binaire inhoud van het bestand. Deze hash:

* Wordt weergegeven in het documentinfopaneel voor transparantie.
* Wordt opgeslagen op de blockchain tijdens DTT-minting (via het HashStorage-slimme contract).
* Kan onafhankelijk worden geverifieerd door elke partij om de authenticiteit van het document te bevestigen en manipulatie te detecteren.

De hash is onveranderlijk — als de bestandsinhoud verandert (zelfs met één byte), verandert de hash en moet er een nieuwe versie worden aangemaakt.

***

## Tips en best practices

* Wijs waar mogelijk **3 validators** toe — een volledig gevalideerd document ontvangt de hoogste Magma Index-bijdrage en de maximale beloning.
* Gebruik de **Aanbevolen-badge** om validators te selecteren wiens rol het beste aansluit bij het documenttype voor optimale scoring.
* Stel vervaldatums nauwkeurig in — verlopen documenten verlagen uw Magma Index-score via de gegevensvervallingsboete.
* Gebruik de **Bladwijzerzijbalk** om snel toegang te krijgen tot documenten die u regelmatig raadpleegt.
* Gebruik **Annotaties** voor gezamenlijke documentbeoordeling voordat u finaliseert en mint.
* Vervang documenten met behulp van de juiste **Vervangingsworkflow** in plaats van te verwijderen en opnieuw te uploaden — dit bewaart uw auditspoor en versiegeschiedenis.


---

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