# Gebäudeerstellung

Das Erstellen eines neuen Gebäudes auf Magma ist ein geführter 5-Schritt-Assistent, der alle grundlegenden Informationen sammelt, die zur Einrichtung des digitalen Profils Ihres Gebäudes, zur Konfiguration seiner Blockchain-Wallet und zur Aktivierung eines Abonnementplans erforderlich sind. Der Assistent kann vom Gebäude-Dashboard aus durch Klicken auf **+ Neues Gebäude** gestartet werden.

***

## Übersicht der Assistentenschritte

| Schritt | Name                       | Erforderlich             |
| ------- | -------------------------- | ------------------------ |
| 1       | Gebäudeidentität           | Ja                       |
| 2       | Standort & Klassifizierung | Ja                       |
| 3       | Stakeholder                | Ja                       |
| 4       | Titelbild                  | Optional (überspringbar) |
| 5       | Planauswahl & Checkout     | Ja                       |

Sie können jederzeit zu einem vorherigen Schritt zurücknavigieren, bevor Sie Schritt 5 abschließen. Die eingegebenen Daten bleiben erhalten, während Sie zwischen Schritten wechseln.

***

## Schritt 1 — Gebäudeidentität

Dieser Schritt erfasst die wesentliche Identität Ihres Gebäudes.

### Felder

| Feld                  | Typ      | Erforderlich | Hinweise                                                                     |
| --------------------- | -------- | ------------ | ---------------------------------------------------------------------------- |
| Gebäudename           | Text     | Ja           | Der öffentliche Name des Gebäudes. Wird überall auf der Plattform verwendet. |
| Gebäudebeschreibung   | Textarea | Nein         | Eine kurze Beschreibung des Gebäudes und seines Zwecks.                      |
| Baujahr               | Zahl     | Nein         | Das Jahr, in dem das Gebäude ursprünglich gebaut wurde.                      |
| Gesamtnutzfläche      | Zahl     | Nein         | Gesamtfläche in Quadratmetern oder Quadratfuß (Einheit wählbar).             |
| Anzahl der Stockwerke | Zahl     | Nein         | Gesamtanzahl der Stockwerke einschließlich Kellergeschosse.                  |

### Validierung

* **Gebäudename** ist das einzige Pflichtfeld in diesem Schritt.
* Der Gebäudename muss innerhalb Ihres Kontos eindeutig sein.

***

## Schritt 2 — Standort & Klassifizierung

Dieser Schritt erfasst die physische Adresse des Gebäudes und kategorisiert es nach Typ.

### Felder

| Feld                 | Typ     | Erforderlich | Hinweise                                       |
| -------------------- | ------- | ------------ | ---------------------------------------------- |
| Straßenadresse       | Text    | Ja           | Hausnummer und Straßenname.                    |
| Stadt                | Text    | Ja           | Stadt oder Gemeinde.                           |
| Bundesland / Provinz | Text    | Nein         | Bundesland, Region oder Provinz.               |
| Postleitzahl         | Text    | Ja           | PLZ oder Postleitzahl.                         |
| Land                 | Auswahl | Ja           | Länder-Dropdown (vollständige Länderliste).    |
| Gebäudetyp           | Auswahl | Ja           | Einer von 9 unterstützten Typen (siehe unten). |

### Gebäudetypen

Der Gebäudetyp beeinflusst direkt den Magma Index-Bewertungsalgorithmus und die Belohnungsberechnung für Dokument-Uploads und Validierungen.

| Typ          | Beschreibung                                                         |
| ------------ | -------------------------------------------------------------------- |
| Hotel        | Gastgewerbe- und Beherbergungsobjekte.                               |
| Öffentlich   | Regierungsgebäude, Schulen, Bibliotheken, öffentliche Einrichtungen. |
| Industriell  | Fabriken, Produktionsanlagen, Industriebetriebe.                     |
| Lager        | Lagerhäuser, Logistikzentren, Vertriebslager.                        |
| Mischnutzung | Objekte, die Wohn-, Gewerbe- und/oder Büronutzung kombinieren.       |
| Kommerziell  | Einzelhandel, Einkaufszentren, Ausstellungsräume.                    |
| Wohngebäude  | Apartmenthäuser, Eigentumswohnungen, Wohnanlagen.                    |
| Büro         | Firmenbüros, Geschäftszentren, Coworking-Spaces.                     |
| Medizinisch  | Krankenhäuser, Kliniken, medizinische Zentren.                       |

> **Wichtig:** Der Gebäudetyp kann nach Erstellung des Gebäudes und Minten eines DTT nicht mehr geändert werden. Wählen Sie sorgfältig.

***

## Schritt 3 — Stakeholder

Dieser Schritt ermöglicht es Ihnen, das anfängliche Stakeholder-Team für das Gebäude einzuladen und zuzuweisen. Mindestens eine Stakeholder-Rolle muss konfiguriert sein, bevor Sie fortfahren können.

### Verfügbare Rollen

Stakeholdern wird eine der definierten Rollen der Plattform zugewiesen, die ihre Berechtigungen für alle Gebäudefunktionen steuern:

* **Eigentümer** — Vollständiger administrativer Zugriff auf alle Funktionen.
* **Account Manager (AM)** — Verwaltungszugriff; kann Stakeholder, Abonnements und Einstellungen verwalten.
* **Hausverwalter** — Zugriff auf operative Funktionen einschließlich Data Room, Lotaufteilung und Fluid Synoptic.
* **Architekt** — Zugriff auf BIM-bezogene Funktionen und den Data Room.
* **Ingenieur** — Technischer Zugriff für BIM und Scan Viewer.
* **Notar** — Schwerpunktmäßiger Zugriff auf rechtliche und eigentumsrechtliche Dokumente im Data Room.
* **Rechtsanwalt** — Zugriff auf rechtliche Dokumente und den Data Room.
* **Auftragnehmer** — Zugriff auf relevante technische Dokumentation.
* **Mieter** — Eingeschränkter Zugriff auf relevante Mietdokumente.
* **Inspektor** — Lesezugriff für Validierungs- und Compliance-Dokumente.

### Einen Stakeholder hinzufügen

1. Klicken Sie auf **+ Stakeholder hinzufügen**.
2. Geben Sie die E-Mail-Adresse des Stakeholders ein.
3. Wählen Sie seine Rolle aus dem Dropdown aus.
4. Weisen Sie ihn optional als Dokumentenvalidator für bestimmte Dokumenttypen zu.
5. Klicken Sie auf **Hinzufügen**.

Der Stakeholder erhält eine E-Mail-Einladung, dem Gebäude auf Magma beizutreten. Wenn er noch kein Magma-Konto hat, wird er durch die Registrierung geführt.

### Hinweise

* Sie (der Ersteller) werden automatisch die Rolle **Eigentümer** zugewiesen und können in diesem Schritt nicht entfernt werden.
* Sie können so viele Stakeholder hinzufügen, wie Ihr Abonnementplan erlaubt (siehe Schritt 5 für Planlimits).
* Stakeholder können auch nach der Gebäudeerstellung über das Stakeholder-Verwaltungspanel hinzugefügt, geändert oder entfernt werden.

***

## Schritt 4 — Titelbild (Optional)

Dieser Schritt ermöglicht es Ihnen, ein Titelfoto für das Gebäude hochzuladen. Das Titelbild erscheint auf der Gebäudekarte im Dashboard, oben auf der Gebäudeprofilseite und auf der DTT-Karte.

### Felder

| Feld      | Typ          | Hinweise                                                                             |
| --------- | ------------ | ------------------------------------------------------------------------------------ |
| Titelbild | Datei-Upload | Drag-and-Drop oder klicken zum Durchsuchen. Akzeptiert: JPG, PNG. Max. Größe: 100MB. |

### Diesen Schritt überspringen

Schritt 4 ist der einzige Schritt im Assistenten, der übersprungen werden kann. Klicken Sie auf **Überspringen**, um ohne Hochladen eines Titelbilds zu Schritt 5 zu gelangen. Ein Standard-Platzhalter wird verwendet, bis später über die [Galerie](/magma-documentation/de/funktionen/gallery.md) ein Titelbild festgelegt wird.

### Das Titelbild später ändern

Sie können das Titelbild des Gebäudes jederzeit nach der Erstellung in der Galerie aktualisieren. Wenn Sie das Titelbild ändern, wird das vorherige Titelbild automatisch in die Galerie verschoben und nicht gelöscht.

***

## Schritt 5 — Planauswahl & Checkout

Der letzte Schritt wählt einen Abonnementplan aus, zeigt ein Preisangebot an, richtet die Blockchain-Wallet des Gebäudes ein und initiiert die Zahlung über Stripe.

### Abonnementpläne

Es stehen drei Pläne zur Verfügung:

| Funktion                  | Essential     | Premium | Infinity   |
| ------------------------- | ------------- | ------- | ---------- |
| Stakeholder               | Begrenzt      | Mehr    | Unbegrenzt |
| Speicher                  | Begrenztes GB | Mehr GB | Maximum GB |
| API-Operationen           | Begrenzt      | Mehr    | Unbegrenzt |
| E-Mail-Benachrichtigungen | Begrenzt      | Mehr    | Unbegrenzt |
| Prioritäts-Support        | Nein          | Ja      | Ja         |
| DTT-Minting               | Ja            | Ja      | Ja         |
| BIM 3D-Viewer             | Ja            | Ja      | Ja         |
| Scan Viewer               | Ja            | Ja      | Ja         |
| Belohnungen               | Ja            | Ja      | Ja         |

> Für aktuelle Preise und genaue Limits pro Plan beachten Sie die Magma-Preisseite oder kontaktieren Sie Ihren Kundenbetreuer.

### Preisangebot

Vor der Bestätigung zeigt der Assistent eine vollständige Preiszusammenfassung an:

* **Ausgewählter Planname und Abrechnungszeitraum** (monatlich oder jährlich).
* **Basis-Abonnementpreis** — Wiederkehrender Betrag pro Abrechnungszyklus.
* **Anwendbare Steuern** — Berechnet basierend auf Ihrem Rechnungsland.
* **Heute fälliger Gesamtbetrag** — Der Betrag, der sofort bei Bestätigung belastet wird.
* **Nächstes Abrechnungsdatum** — Wann die nächste automatische Abbuchung erfolgt.

Wenn Sie ein Gebäude auf einem bestehenden Konto erstellen, das bereits eine gespeicherte Zahlungsmethode hat, wird die gespeicherte Zahlungsmethode angezeigt und Sie können ohne erneute Karteneingabe fortfahren.

### Erstellung der Gebäude-Wallet

Als Teil der Gebäudeerstellung stellt Magma automatisch eine **Gebäude-Wallet** auf der VeChain-Blockchain über den Venly-Wallet-Anbieter bereit. Diese Wallet:

* Fungiert als Smart-Contract-Eigentümer für alle mit dem Gebäude verbundenen DTT (Digital Twin Token)-Verträge.
* Hält den ERC-1155 DTT-Vertrag, der beim ersten Minting eingesetzt wird.
* Unterscheidet sich von Ihrer persönlichen **Stakeholder-Wallet**, die MRT-Belohnungstoken erhält.

Die Gebäude-Wallet wird automatisch erstellt — Sie müssen nichts unternehmen. Die Wallet-Adresse wird in den Gebäudeeinstellungen nach der Erstellung angezeigt und ist auch auf der öffentlichen DTT-Seite verlinkt.

### Stripe-Checkout

Die Zahlung wird über **Stripe**, den Zahlungsanbieter von Magma, abgewickelt. Der Checkout-Ablauf:

1. **Preiszusammenfassung in Schritt 5 überprüfen**.
2. **Zahlungsdetails eingeben** — Kartennummer, Ablaufdatum und CVV. Das sichere Formular von Stripe ist direkt in die Seite eingebettet (keine Weiterleitung auf eine externe Seite).
3. **Rechnungsadresse** — Für die Kartenverarbeitung erforderlich.
4. **Bestätigen und Bezahlen** — Klicken Sie auf die Bestätigungsschaltfläche zum Abschließen.

Bei erfolgreicher Zahlung:

* Das Gebäude wird erstellt und erscheint sofort in Ihrem Dashboard.
* Alle eingeladenen Stakeholder erhalten ihre E-Mail-Einladungen.
* Die Gebäude-Wallet wird auf der Blockchain bereitgestellt.
* Sie werden zum Hauptbildschirm des neu erstellten Gebäudes weitergeleitet.

### Zahlungsfehler beim Checkout

Wenn die Zahlung während der Gebäudeerstellung fehlschlägt:

* Das Gebäude wird **nicht** erstellt — kein Teilstatus wird gespeichert.
* Im Stripe-Formular wird eine Fehlermeldung angezeigt, die den Grund angibt (z. B. Karte abgelehnt, unzureichende Mittel).
* Sie können Ihre Kartendaten aktualisieren und erneut versuchen, ohne die Gebäudeinformationen ab Schritt 1 erneut eingeben zu müssen.

***

## Nach der Erstellung

Sobald Ihr Gebäude erstellt ist, können Sie sofort:

* Dokumente in den [Data Room](/magma-documentation/de/funktionen/data-room.md) hochladen.
* IFC-Dateien in den [BIM 3D-Viewer](/magma-documentation/de/funktionen/bim-3d-viewer.md) hochladen.
* Weitere Stakeholder einladen.
* Die Magma Index-Einstellungen für Ihren Gebäudetyp konfigurieren.
* Die Abschnitte Lotaufteilung und Fluid Synoptic einrichten.

> **Tipp:** Beginnen Sie mit dem Data Room, indem Sie Genesis-Dokumente hochladen (Eigentumsurkunde, Grundbuchauszug), um die Grundschicht Ihres Magma Index aufzubauen.


---

# 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/funktionen/building-creation.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.