# Documentlevenscyclus

Elk document op Magma doorloopt een reeks vastgestelde statussen, van de eerste upload tot de permanente blockchain-registratie.

## Statusverloop

```
Upload
  └─ DRAFT
       └─ Indienen voor validatie
              └─ PENDING_VALIDATION
                    ├─ Alle validators keuren goed
                    │      └─ VALIDATED ──────────────── Minting ──► MINTED
                    │                                             └─ Tijd verstrijkt ──► EXPIRED
                    │                                             └─ Nieuwe versie ──► REPLACED
                    └─ Een validator wijst af
                           └─ REQUIRING_ACTION
                                  └─ Uploader corrigeert & dient opnieuw in
                                         └─ CORRECTED → PENDING_VALIDATION (cyclus herhaalt zich)
```

### Bijzondere gevallen

* **DUPLICATED**: Het systeem heeft gedetecteerd dat het geüploade bestand identiek is aan een reeds gevalideerd bestand in hetzelfde documenttype
* **REVERTED\_TO\_DRAFT**: De toegewezen validators van een ingediend document hebben de toegang tot het gebouw verloren (bijv. hun overeenkomst is ingetrokken). Het document keert terug naar Draft zodat nieuwe validators kunnen worden toegewezen voordat het opnieuw wordt ingediend

***

## Statusbeschrijvingen

| Status                 | Kleur  | Betekenis                                                                           | Wat te doen                                                                                    |
| ---------------------- | ------ | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Draft**              | Grijs  | Geüpload maar nog niet ingediend. Alleen u kunt het zien.                           | Indienen wanneer gereed — validators kiezen en op Indienen klikken                             |
| **Pending Validation** | Oranje | Ingediend en wacht op stemmen van validators                                        | Wacht op validators. U wordt op de hoogte gesteld wanneer zij handelen.                        |
| **Validated**          | Groen  | Alle geconfigureerde validators hebben goedgekeurd                                  | In aanmerking voor minting. Geen actie vereist.                                                |
| **Requiring Action**   | Rood   | Minimaal één validator heeft afgewezen                                              | Controleer de afwijzingsreden in het documentvenster, corrigeer het bestand en dien opnieuw in |
| **Corrected**          | —      | Een gecorrigeerde versie heeft een eerder afgewezen document vervangen              | De gecorrigeerde versie treedt in Pending Validation                                           |
| **Duplicated**         | —      | De bestandsinhoud komt overeen met een reeds gevalideerd document                   | Upload een ander bestand of neem contact op met support als dit een fout is                    |
| **Reverted to Draft**  | Grijs  | Validators zijn na indiening uit het gebouw verwijderd                              | Wijs nieuwe validators toe en dien opnieuw in                                                  |
| **Minted**             | Blauw  | Vastgelegd op de blockchain. De hash van het document is opgeslagen in HashStorage. | Geen verdere actie vereist. Het document staat permanent on-chain.                             |
| **Expired**            | Rood   | De geldigheidsperiode van het document is verstreken                                | Upload een nieuwe versie. Er wordt een taak aan u toegewezen.                                  |
| **Replaced**           | —      | Een nieuwere versie is gevalideerd en vervangt deze                                 | De nieuwere versie is nu het actieve document. Oude versie blijft in de versiegeschiedenis.    |

***

## Meerstapsvalidatie

Elk documenttype kan tot **drie validatorniveaus** hebben:

| Niveau               | Verplicht?                 | Opmerkingen                                         |
| -------------------- | -------------------------- | --------------------------------------------------- |
| Primaire validator   | Ja (indien geconfigureerd) | Moet goedkeuren om het document voort te laten gaan |
| Secundaire validator | Indien geconfigureerd      | Moet ook goedkeuren                                 |
| Tertiaire validator  | Indien geconfigureerd      | Optionele aanvullende bevestiging                   |

**Alle geconfigureerde validators moeten goedkeuren.** Een enkele afwijzing door een willekeurige validator stuurt het document terug naar Requiring Action, ongeacht hoeveel anderen hebben goedgekeurd.

Wanneer een validator afwijst, moet deze een reden opgeven. De uploader ziet deze reden en kan dienovereenkomstig handelen voordat het document opnieuw wordt ingediend.

***

## Documentvervanging

Wanneer u een al ingediend of gevalideerd document moet bijwerken, uploadt u een **vervanging** in plaats van een nieuw bestand. Er zijn twee typen:

| Type             | Wanneer te gebruiken                                                                          | Effect                                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Total Update** | Het document is fundamenteel gewijzigd — nieuwe inhoud, nieuwe versie, ingrijpende herziening | Oude versie wordt gemarkeerd als REPLACED. Nieuwe versie treedt in Pending Validation met een nieuwe cyclus. |
| **Correction**   | Kleine correctie — typefout, opmaak, kleine fout                                              | Oude versie wordt gemarkeerd als CORRECTED. Nieuwe versie treedt in Pending Validation.                      |

Beide typen vereisen een **reden** (minimaal 5 tekens) die verklaart waarom de vervanging wordt gemaakt. Deze reden wordt opgeslagen in het activiteitenlogboek voor auditdoeleinden.

***

## Geldigheidsperioden van documenten

Sommige documenttypen verlopen automatisch na een vastgestelde periode. Wanneer een document verloopt:

1. De status verandert in **Expired**
2. De Magma Index-score voor de categorie van dat document wordt verlaagd
3. Een **UPDATE\_EXPIRED\_DOCUMENT**-taak wordt toegewezen aan de oorspronkelijke uploader
4. Het gebouwoverzicht en het taakcentrum markeren het verlopen document

| Geldigheidsperiode              | Documenten                                                                                                                   |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **1 Jaar**                      | Gebouwverzekering, Hypotheekstatus, Winst- en Verliesrekeningen, Beveiligingsdienstverlenerovereenkomst, Beveiligingslogboek |
| **1 Maand**                     | Onroerendezaakbelasting, Auditrapporten, Budget/Operationele Kostenraming, Beveiligingsplan                                  |
| **Totdat het gebouw gereed is** | Gebruikscertificaat, Bouwkostenraming                                                                                        |
| **Permanent**                   | Eigendomstitel, Akte, Kadaster, en de meeste juridische, diagnose- en technische documenten                                  |

***

## Versiegeschiedenis

Elk document beschikt over een volledige versiegeschiedenis die toegankelijk is via het documentinformatievenster. U kunt:

* Alle vorige versies bekijken met hun uploaddatums en statussen
* Op een willekeurige versie klikken om die versie te bekijken
* Zien welke versie momenteel actief is (gemarkeerd als primair)
* REPLACED- en CORRECTED-statusbadges zien op vervangen versies

De cryptografische hash van elke versie is zichtbaar in het documentvenster en wordt na minting on-chain geregistreerd. Hierdoor is het mogelijk de exacte inhoud van elke historische versie op elk moment in de toekomst te verifiëren.


---

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