# Dokument-Lebenszyklus Jedes Dokument auf Magma durchläuft eine definierte Reihe von Statuswerten, vom ersten Upload bis zum permanenten Blockchain-Eintrag. ## Statusablauf ``` Upload └─ DRAFT └─ Zur Validierung einreichen └─ PENDING_VALIDATION ├─ Alle Validatoren stimmen zu │ └─ VALIDATED ──────────────── Minting ──► MINTED │ └─ Zeit vergeht ──► EXPIRED │ └─ Neue Version ──► REPLACED └─ Ein Validator lehnt ab └─ REQUIRING_ACTION └─ Uploader korrigiert & reicht erneut ein └─ CORRECTED → PENDING_VALIDATION (Zyklus wiederholt sich) ``` ### Sonderfälle * **DUPLICATED**: Das System hat erkannt, dass die hochgeladene Datei identisch mit einer bereits validierten Datei im selben Dokumenttyp ist * **REVERTED\_TO\_DRAFT**: Die zugewiesenen Validatoren eines eingereichten Dokuments haben den Zugang zum Gebäude verloren (z. B. wurde ihre Vereinbarung widerrufen). Das Dokument kehrt in den Draft-Status zurück, damit neue Validatoren zugewiesen werden können, bevor es erneut eingereicht wird *** ## Statusbeschreibungen | Status | Farbe | Bedeutung | Was zu tun ist | | ---------------------- | ------ | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **Draft** | Grau | Hochgeladen, aber noch nicht eingereicht. Nur Sie können es sehen. | Einreichen, wenn bereit – Validatoren auswählen und auf „Einreichen" klicken | | **Pending Validation** | Orange | Eingereicht und wartet auf Validator-Abstimmung | Auf Validatoren warten. Sie werden benachrichtigt, wenn diese handeln. | | **Validated** | Grün | Alle konfigurierten Validatoren haben zugestimmt | Für Minting geeignet. Keine Maßnahme erforderlich. | | **Requiring Action** | Rot | Mindestens ein Validator hat abgelehnt | Ablehnungsgrund im Dokumentfeld prüfen, Datei korrigieren und erneut einreichen | | **Corrected** | — | Eine korrigierte Version hat ein zuvor abgelehntes Dokument ersetzt | Die korrigierte Version tritt in den Pending Validation-Status ein | | **Duplicated** | — | Der Dateiinhalt stimmt mit einem bereits validierten Dokument überein | Andere Datei hochladen oder Support kontaktieren, wenn dies ein Fehler ist | | **Reverted to Draft** | Grau | Validatoren wurden nach der Einreichung vom Gebäude entfernt | Neue Validatoren zuweisen und erneut einreichen | | **Minted** | Blau | Auf der Blockchain erfasst. Der Hash des Dokuments wird in HashStorage gespeichert. | Keine weiteren Maßnahmen erforderlich. Das Dokument ist dauerhaft on-chain. | | **Expired** | Rot | Die Gültigkeitsdauer des Dokuments ist abgelaufen | Neue Version hochladen. Ihnen wird eine Aufgabe dafür zugewiesen. | | **Replaced** | — | Eine neuere Version wurde validiert und ersetzt diese | Die neuere Version ist nun das aktive Dokument. Ältere Version verbleibt im Versionsverlauf. | *** ## Mehrstufige Validierung Jeder Dokumenttyp kann bis zu **drei Validator-Stufen** haben: | Stufe | Erforderlich? | Hinweise | | ----------------- | ---------------------- | ------------------------------------------------ | | Primärvalidator | Ja (wenn konfiguriert) | Muss zustimmen, damit das Dokument fortschreitet | | Sekundärvalidator | Wenn konfiguriert | Muss ebenfalls zustimmen | | Tertiärvalidator | Wenn konfiguriert | Optionale zusätzliche Bestätigung | **Alle konfigurierten Validatoren müssen zustimmen.** Eine einzelne Ablehnung durch einen beliebigen Validator schickt das Dokument zurück in den Status „Requiring Action", unabhängig davon, wie viele andere zugestimmt haben. Wenn ein Validator ablehnt, muss er einen Grund angeben. Der Uploader sieht diesen Grund und kann entsprechend handeln, bevor er das Dokument erneut einreicht. *** ## Dokumentersatz Wenn Sie ein bereits eingereichtes oder validiertes Dokument aktualisieren müssen, laden Sie einen **Ersatz** hoch, keine neue Datei. Es gibt zwei Typen: | Typ | Wann zu verwenden | Wirkung | | ---------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | **Total Update** | Das Dokument hat sich grundlegend verändert – neuer Inhalt, neue Version, wesentliche Überarbeitung | Alte Version wird als REPLACED markiert. Neue Version tritt mit einem neuen Zyklus in Pending Validation ein. | | **Correction** | Kleinere Korrektur – Tippfehler, Formatierung, kleiner Fehler | Alte Version wird als CORRECTED markiert. Neue Version tritt in Pending Validation ein. | Beide Typen erfordern einen **Grund** (mindestens 5 Zeichen), der erklärt, warum der Ersatz vorgenommen wird. Dieser Grund wird im Aktivitätsprotokoll für Prüfungszwecke gespeichert. *** ## Gültigkeitszeiträume von Dokumenten Einige Dokumenttypen laufen nach einer festgelegten Frist automatisch ab. Wenn ein Dokument abläuft: 1. Sein Status ändert sich zu **Expired** 2. Der Magma Index-Score für die Kategorie dieses Dokuments wird reduziert 3. Eine **UPDATE\_EXPIRED\_DOCUMENT**-Aufgabe wird dem ursprünglichen Uploader zugewiesen 4. Die Gebäudeübersicht und das Aufgabenzentrum heben das abgelaufene Dokument hervor | Gültigkeitszeitraum | Dokumente | | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | **1 Jahr** | Gebäudeversicherung, Hypothekenstatus, Gewinn- und Verlustrechnung, Sicherheitsdienstleistungsvertrag, Sicherheitsprotokoll | | **1 Monat** | Grundsteuer, Prüfberichte, Budget/Betriebskostenschätzung, Sicherheitsplan | | **Bis zur Fertigstellung des Gebäudes** | Nutzungsgenehmigung, Baukostenschätzung | | **Dauerhaft** | Grundbuchurkunde, Notariatsakt, Grundbuch und die meisten rechtlichen, Diagnose- und technischen Dokumente | *** ## Versionsverlauf Jedes Dokument führt einen vollständigen Versionsverlauf, der über das Dokumentinformationsfeld zugänglich ist. Sie können: * Alle früheren Versionen mit ihren Upload-Daten und Statusangaben einsehen * Auf eine beliebige Version klicken, um diese anzuzeigen * Sehen, welche Version derzeit aktiv ist (als primär markiert) * REPLACED- und CORRECTED-Statusbadges auf veralteten Versionen sehen Der kryptografische Hash jeder Version ist im Dokumentfeld sichtbar und wird nach dem Minting on-chain aufgezeichnet. Dadurch kann der genaue Inhalt jeder historischen Version jederzeit in der Zukunft verifiziert werden. --- # 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/de/referenz/document-lifecycle.md?ask= ``` 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.