Dokumentation

RaumReport – Anwenderhandbuch

Version 2.9 · Stand Mai 2026

1. Überblick

RaumReport ist eine webbasierte Anwendung zur Erstellung, Verwaltung und Weitergabe von Raumbüchern auf Basis von Archicad-Exporten.

Kernfunktionen

Funktion Beschreibung
TAB-Import Import der Raumliste direkt aus dem Archicad-Export (TAB-getrennte Textdatei)
Delta-Import Manuell geänderte Felder bleiben beim Reimport erhalten
Importprotokoll Jeder Import zeigt: neue, aktualisierte, unveränderte Räume
PDF-Export Einzelraum-PDF oder vollständiges Raumbuch mit Deckblatt, Inhaltsverzeichnis, Abschlussblatt
Excel-Export Alle Räume als XLSX-Tabelle
JSON / Python Datenexport für den Reimport in Archicad
Projektarchiv Vollständige Projektsicherung als ZIP (inkl. Fotos, Vorlagen, Daten)
Leistungsphasen Felder pro HOAI-Phase ein-/ausblenden
Raumtypen Felder nach Raumtyp selektiv ein-/ausblenden
Auswahllisten Dropdown-Wertelisten für Felder
Revisionen Versionsstände einfrieren und als PDF archivieren
Freigaben Feldänderungen kommentieren und freigeben
Verteiler Protokollierung der Raumbuch-Weitergabe
Grundriss-Import SVG-Grundrisse automatisch zu Räumen zuordnen

Technische Basis

Laravel 12 · PHP 8.4 · SQLite · mPDF · Alpine.js · Tailwind CSS

2. Anmelden und Oberfläche

2.1 Anmelden

Rufen Sie die Anwendung im Browser auf. Die Anmeldeseite erscheint automatisch.

  • E-Mail: Ihre Login-Adresse
  • Passwort: Ihr Passwort

2.2 Oberfläche

Die Oberfläche besteht aus drei Bereichen:

Linke Seitenleiste

  • Navigation: Dashboard · Projekte · Layout-Vorlagen · Benutzer · Einstellungen
  • Zeigt im Projektkontext den Projektnamen

Kopfzeile

  • Links: Anwendungsname
  • Mitte: LP-Schnellumschalter (nur sichtbar, wenn Leistungsphasen aktiviert sind)
  • Rechts: Sprache wechseln (DE/EN) · Benutzername · Abmelden

Hauptbereich

  • Breadcrumb-Navigation oben
  • Seiteninhalt

2.3 Dark Mode

Oben rechts in der Fußzeile der Seitenleiste: Dunkler Modus / Heller Modus umschalten. Die Einstellung wird im Browser gespeichert.

2.4 Sprache wechseln

Kopfzeile rechts: Buttons DE / EN. Die Sprache wird für Ihren Account gespeichert.

3. Dashboard

Das Dashboard erscheint nach dem Login. Es zeigt:

Statistik-Kacheln

Kachel Inhalt
Projekte Anzahl aller zugänglichen Projekte
Räume Gesamtzahl aller Räume
Importe Anzahl durchgeführter Importe
Offene Freigaben Anzahl Feldänderungen, die noch nicht freigegeben sind (gelb hervorgehoben bei > 0)

Aktuelle Projekte

Die zuletzt aktualisierten Projekte mit:

  • Projektname, Projektnummer
  • Raumanzahl, letzter Import-Zeitstempel
  • Direktlink zur Projektübersicht

Klick auf „Alle Projekte" führt zur vollständigen Projektliste.

4. Projekte verwalten

4.1 Projektliste

Navigation → Projekte

Die Tabelle zeigt alle Projekte, auf die Sie Zugriff haben:

  • Projektname, Projektnummer
  • Auftraggeber, Standort
  • Raumanzahl
  • Status (Ampelfarbe)

Spalte rechts: Öffnen (zur Projektübersicht) · Projektdetails (Bearbeitungsformular, nur Admin)

4.2 Neues Projekt anlegen (Admin)

Schaltfläche Neues Projekt oben rechts.

Feld Beschreibung
Projektname Pflichtfeld. Erscheint in PDF-Kopfzeilen
Projektnummer Freitext, z. B. P-2026-001
Auftraggeber Name des Bauherrn
Adresse Auftraggeber Mehrzeiliger Text für das Abschlussblatt
Standort Bauvorhaben-Adresse
Beschreibung Interne Notiz
Architekt Name des Architekturbüros
Adresse Architekt / Ersteller Mehrzeiliger Text für das Abschlussblatt
Bearbeiter Name des verantwortlichen Bearbeiters
Planungsphase Freitext, z. B. Entwurfsplanung LP 3
Baugenehmigung Datum oder Aktenzeichen
Planungsstand Datum des letzten Planungsstands
Logo PNG/JPG, max. 4 MB – erscheint auf Deckblatt und in Kopfzeilen
Massenänderung Status Erlaubt das gleichzeitige Setzen aller gefilterten Räume auf einen Status

4.3 Projektübersicht

Klick auf ein Projekt öffnet die Projektübersicht.

Kopfbereich (Schaltflächen oben rechts):

  • Alle Räume – zur Raumliste
  • Räume importieren – neuen TAB-Import starten (Admin)
  • Projektdetails – Projektfelder bearbeiten (Admin)

Einstellungsleiste (Zeile 1):

  • LP-Einstellungen · Raumtypen · Grundriss-Import · Auswahllisten · Verteiler

Exportleiste (Zeile 2, nur wenn Räume vorhanden):

  • Exporte (Übersichtsseite) · PDF Raumbuch · ZIP · Excel · Archiv

Hauptbereich:

  • Liste der letzten 10 Räume mit Ampel, Raumnummer, Name, Status
  • Link „Alle Räume →"

Seitenleiste:

  • Projektinformationen
  • Geschossverteilung (falls erkannt)
  • Import-Verlauf (letzte 5 Importe)

4.4 Projekt löschen (Admin)

Projektdetails → Abschnitt Gefahrenbereich → Projekt löschen → Bestätigen.

Achtung: Löscht alle Räume, Fotos, Importe und Revisionen unwiderruflich.

5. Import aus Archicad

5.1 Exportdatei aus Archicad erzeugen

In Archicad:

  1. Ablage → Sichern als ... → Tab Text
  2. Erste Zeile: Spaltenköpfe (Hauptkopfzeile verbergen)

5.2 Spaltenstruktur und Suffixe

RaumReport erkennt besondere Spalten-Suffixe im Spaltenkopf:

Suffix Bedeutung Rückschreibbar
[BI] Archicad Built-in Property (Ebene 0) ✓
[BI1] Built-in Property, Ebene 1 ✓
[P] Benutzerdefinierte Property (Ebene 0) ✓
[P1] Property, Ebene 1 ✓
[GDL] GDL-Parameter (nur lesend) –
(kein Suffix) Berechneter Wert (nur lesend) –
[H] Header: Überschrift Ebene 0 -
[H1] Header: Überschrift Ebene 1 -

Felder ohne Suffix oder mit [GDL] werden im Bearbeiten-Formular als schreibgeschützt angezeigt.

Abschnittsspalten: Spalten, deren Datenzellen in allen Zeilen leer sind und das Suffix [H] oder [H1] usw. enthalten, werden automatisch als Abschnittsköpfe erkannt (z. B. „Abmessungen", „Oberflächen").

GUID-Spalte: Wenn eine Spalte mit dem Kopf Eindeutige ID (oder Unique ID, GUID) vorhanden ist und UUID-Werte enthält, wird sie automatisch als Archicad-GUID erkannt und intern gespeichert – sie erscheint nicht in der Raumliste.

5.3 Empfohlenes Spaltenformat

Eindeutige ID    Allgemeines [H]    Raumname [BI]    Raumnummer [BI]    Wandbelag [P]    GDL-Param [GDL]    Fläche
  • Spalte 0: GUID (intern, nicht angezeigt)
  • [BI]-Felder: direkt rückschreibbar via Archicad Built-in Properties
  • [P]-Felder: rückschreibbar via User Defined Properties
  • [GDL], kein Suffix: nur lesend importiert

5.4 Import durchführen

Projektseite → Räume importieren

  1. TAB-Datei per Drag & Drop oder Dateiauswahl hochladen
  2. Optionale Notiz eingeben (z. B. „Planungsstand 24.02.2026")
  3. Import starten

Nach dem Import erscheint die Import-Detailseite:

Kachel Bedeutung
Gesamt Alle in der Datei enthaltenen Räume
Neu (grün) Räume mit neuer Raumnummer, erstmals angelegt
Aktualisiert (gelb) Räume, bei denen sich mindestens ein Feld geändert hat
Unverändert (grau) Räume ohne Änderung im Vergleich zum letzten Stand

Darunter: aufklappbares Importprotokoll mit Status pro Raum.

5.5 Delta-Import (Reimport)

Beim erneuten Import desselben Projekts:

  • Manuell überschriebene Felder (erkennbar am ✎-Symbol) bleiben unverändert
  • Nicht-überschriebene Felder werden mit den neuen Archicad-Werten aktualisiert
  • Neue Raumnummern: neuer Raum wird angelegt
  • Nicht mehr vorhandene Raumnummern: Raum bleibt erhalten (kein automatisches Löschen)
  • Geschoss-Zuordnung wird immer aus dem Import übernommen (nicht manuell überschreibbar)

5.6 Import-Verlauf

Projektübersicht → Seitenleiste Import-Verlauf: Die letzten 5 Importe mit Dateiname, Datum, Raumanzahl und Status.

Klick auf einen Import-Eintrag öffnet die Import-Detailseite.

6. Raumliste

6.1 Öffnen

Projektseite → Alle Räume

6.2 Ansicht

Wenn das Projekt Geschossdaten enthält (Spalte Geschoss im Import), werden die Räume in aufklappbaren Geschoss-Gruppen angezeigt. Ein Klick auf den Geschoss-Kopf klappt die Gruppe auf/zu.

Ohne Geschossdaten: einfache flache Tabelle.

Spalten der Tabelle:

  • Ampel (Vollständigkeits-Score)
  • Raumnummer (Monospace)
  • Raumname
  • Nettofläche
  • Status-Badge
  • Links: Ansehen · Editieren · PDF (öffnet in neuem Tab)

6.3 Suchen und Filtern

Suchfeld oben: Suche nach Raumnummer oder Raumname (Live-Suche)

Statusfilter: Dropdown Alle Status → Einzelnen Status wählen

Checkbox Hat manuelle Überschreibungen: Zeigt nur Räume mit manuell geänderten Feldern

6.4 Schnellexport aus der Raumliste

Oben rechts:

  • PDF Raumbuch – alle angezeigten (gefilterten) Räume als PDF (neuer Tab)
  • Excel – alle gefilterten Räume als XLSX

6.5 Massenänderung Status

Wenn in den Projekteinstellungen „Massenänderung Status erlauben" aktiviert ist, erscheint am unteren Rand der Raumliste ein Bereich:

  1. Gewünschten Zielstatus wählen
  2. Bestätigen → Alle aktuell gefilterten Räume erhalten den neuen Status

7. Raumdetail

7.1 Öffnen

Klick auf einen Raum in der Raumliste öffnet die Raumdetailseite.

7.2 Aufbau der Seite

Kopfbereich:

  • Raumnummer, Raumname
  • Status-Badge
  • Schaltflächen: PDF · Raum bearbeiten

Felder (nach Abschnitten gegliedert):

  • Alle importierten Felder nach Abschnitt
  • Leere Felder werden ausgegraut mit – angezeigt
  • Manuell überschriebene Felder: orange Badge Manuell
  • Archicad-Originalwert: durchgestrichen unter dem manuellen Wert
  • Archicad-Felder (nicht überschrieben): grauer Badge AC
  • Freigegebene Felder: grüner Haken ✓

Datenherkunft-Karte (Seitenleiste):

  • Geschoss
  • Archicad-GUID (falls vorhanden)
  • Import-Datum und Dateiname
  • Anzahl manueller Überschreibungen
  • Link zum Änderungsprotokoll für diesen Raum

Fotos (Seitenleiste):

  • Vorschau aller hochgeladenen Fotos

Anmerkungen / Interne Notizen:

  • Anmerkungen: erscheinen im PDF
  • Interne Notizen: nicht im PDF

7.3 Status-Badge

Badge Farbe Bedeutung
Entwurf Grau Initialer Zustand nach Import
In Bearbeitung Blau Aktiv in Bearbeitung
Freigegeben Grün Geprüft und freigegeben
Archiviert Gelb Nicht mehr aktiv

7.4 Vollständigkeits-Ampel

Die Ampel (Kreis oben links in jeder Raumzeile) berechnet einen Score:

  • Grün: ≥ 80 % der Pflichtfelder befüllt
  • Gelb: 40–79 %
  • Rot: < 40 %

8. Räume bearbeiten

8.1 Bearbeiten-Formular öffnen

Raumdetail → Raum bearbeiten oder in der Raumliste → Editieren.

8.2 Felder bearbeiten

Das Formular gliedert alle Felder in Abschnitte.

Feldtypen:

Darstellung Bedeutung
Normales Eingabefeld Manuell überschreibbar ([P] oder [BI])
Dropdown Feld hat eine Auswahlliste
Kursiv, schreibgeschützt Nur-Lese-Feld ([GDL] oder kein Suffix)

Felder mit Auswahlliste ([P]):

  • Dropdown öffnet die konfigurierten Werte
  • „Freitext eingeben" erscheint wenn die Liste Freitext erlaubt hat
  • Aktueller Archicad-Wert erscheint im Dropdown, falls noch nicht in der Liste

8.3 Änderungshistorie und Kommentare

Neben jedem bearbeitbaren Feld:

  • Uhr-Symbol → Öffnet Verlauf: alle bisherigen Änderungen mit Datum, Benutzer, altem und neuem Wert sowie Kommentaren
  • Sprechblasen-Symbol → Öffnet Kommentar-Textarea: Kommentar wird zusammen mit der Änderung gespeichert (erscheint im Änderungsprotokoll)

8.4 Überschreibungen zurücksetzen

Ein überschriebenes Feld auf den importierten Wert zurücksetzen:

  • Eingabefeld leeren → Speichern
  • Das Feld wird aus den manuellen Überschreibungen entfernt

8.5 Standard-Felder

Oben im Formular:

  • Status (Dropdown)
  • Anmerkungen (Textarea, erscheint im PDF)
  • Interne Notizen (Textarea, nicht im PDF)

8.6 Abschnittsbadge

Wenn in einem Abschnitt mindestens ein Feld manuell überschrieben ist, erscheint am Abschnittskopf ein oranges ✎ geändert-Badge.

8.7 Benutzerdefinierte Eigenschaften

Unterhalb der importierten Archicad-Felder finden Sie im Bearbeiten-Formular den Bereich „Benutzerdefinierte Eigenschaften" (grün hervorgehoben). Hier können Sie eigene Felder, Header und Kategoriebereiche anlegen, die nicht aus Archicad importiert wurden. Diese Felder erscheinen in der Raumansicht und im PDF an der gewünschten Position.

Anwendungsfälle:

  • Notizen, die nicht im Archicad-Modell stehen sollen (z. B. Bauherrenwünsche)
  • Zusätzliche Kategorien für Detail-Erfassung (z. B. „Akustik-Anforderungen", „Smart-Home")
  • Felder, die nur für einen oder wenige Räume relevant sind

Was lässt sich anlegen?

Typ Bedeutung
Kategoriebereich (Section-Header) Neue Hauptüberschrift im Raumbuch, ähnlich einem [H]-Abschnitt aus Archicad
Eigenschaftsfeld Einzelnes Feld unter einem bestehenden Archicad- oder eigenen Kategoriebereich

Anlegen eines Kategoriebereichs:

  1. Bereich „Benutzerdefinierte Eigenschaften" → Neuer Kategoriebereich
  2. Bezeichnung eingeben (z. B. „Akustik")
  3. „Einfügen nach" — Position relativ zu bestehenden Abschnitten wählen (oder „Am Ende")
  4. Anlegen

Anlegen eines Eigenschaftsfelds:

  1. Innerhalb eines Abschnitts (Archicad-Abschnitt oder eigenem Bereich) → + Eigenschaft hinzufügen
  2. Die Eingabemaske öffnet sich mit vier Feldern:
Feld Bedeutung
Typ Eigenschaft für ein normales Wertefeld mit Bezeichnung+Wert+Einheit. Header für eine reine Überschrift ohne Wert (gliedert lange Sektionen).
Ebene Hierarchie-Tiefe: 0 – Haupt (auf Section-Ebene), 1 – Sub 1 (eingerückt), 2 – Sub 2, 3 – Sub 3. Wirkt sich auf die Einrückung in der PDF aus und auf die Nummerierung (z. B. 1.2.3).
Bezeichnung (Pflicht) Name des Felds, z. B. „Bodenfarbe", „Akustik-Anforderung". Wird im PDF als Label vor dem Wert angezeigt. Doppelte Bezeichnungen innerhalb derselben Sektion werden mit roter Warnung markiert.
Wert (nur bei Typ Eigenschaft) Inhalt des Felds, z. B. „Linoleum hell" oder „65 dB".
Einheit (nur bei Typ Eigenschaft) Maßeinheit hinter dem Wert, z. B. m², Stk, °C, Lux, dB. Frei eingebbar.
Einfügen nach Position relativ zu den anderen Feldern dieser Sektion (Dropdown listet vorhandene Felder; „– Am Ende –" als Standard).
  1. Anlegen

Beispiele:

Typ Ebene Bezeichnung Wert Einheit Anzeige im PDF
Eigenschaft 0 Bodenfarbe Linoleum hell — Bodenfarbe: Linoleum hell
Eigenschaft 0 Schallschutz Wand 47 dB Schallschutz Wand: 47 dB
Header 0 Brandschutz — — Brandschutz (fettgedruckte Überschrift)
Eigenschaft 1 Wandbekleidung F30, gem. DIN 4102 — eingerückt unter „Brandschutz"

Bearbeiten und Löschen:

  • Stift-Symbol neben jedem benutzerdefinierten Feld öffnet die Inline-Bearbeitung
  • Mülleimer-Symbol löscht das Feld (mit Bestätigung)
  • Reihenfolge per „Einfügen nach"-Dropdown anpassbar

Wichtig:

  • Benutzerdefinierte Felder sind pro Raum angelegt — nicht projektweit
  • Sie werden im Änderungsprotokoll wie Archicad-Felder protokolliert
  • Sie werden nicht zurück nach Archicad geschrieben (das wäre nicht sinnvoll, da sie dort nicht existieren)
  • Beim Excel-Rückschreib-Export erscheinen sie als bearbeitbare Spalten — Änderungen werden beim Re-Import zurück in RaumReport übernommen

9. Fotos und Grundrisse

9.1 Foto-Slots

Jeder Raum hat vordefinierte Foto-Slots. Die Slots sind im Layout-Template definiert. Standard-Slots:

Slot-Schlüssel Beschreibung
grundriss Grundriss-Zeichnung
ansicht_1 Erste Raumansicht
detail_1 Detailaufnahme

Jeder Slot nimmt ein Bild auf. Wird ein neues Bild hochgeladen, ersetzt es das vorhandene.

9.2 Foto hochladen

Raumdetail → Raum bearbeiten → Abschnitt Foto-Slots (unten):

  1. Auf Datei auswählen klicken (oder Drag & Drop)
  2. Format: JPEG, PNG, WebP – max. 10 MB
  3. Hochladen

Das Foto erscheint sofort in der Vorschau und im Raumdetail.

9.3 Foto löschen

Unter dem Vorschaubild: Entfernen → Bestätigung mit JavaScript-Dialog.

9.4 Foto-Größe im PDF

Die Darstellungsgröße wird zentral pro Layout-Vorlage festgelegt (Layout-Vorlage → Stil-Einstellungen):

Einstellung Standard Wirkung
photo_width_mm 160 mm Breite regulärer Fotos
grundriss_width_mm 160 mm Breite Grundriss-Fotos (kann abweichen)

Eine individuelle Größe pro Foto beim Upload ist derzeit nicht implementiert.

9.5 Grundriss-Import (SVG aus DXF)

Für die automatische Zuordnung von Grundrissen aus DXF-Plänen.

Wichtig: Der Workflow nutzt zwei Python-Scripts. Eines greift auf Archicad zu (über das offizielle Python-Add-On), das andere läuft auf Ihrem Rechner im Terminal. Beide werden benötigt.

Script Wo Zweck
archicad_grundriss_svg.py Terminal (verbindet sich mit dem geöffneten Archicad) Liest Raumdaten aus dem Modell → JSON mit Bounding-Boxen pro Raum
archicad_dxf_crop.py Terminal (eigenständig, ohne Archicad-Verbindung) Nutzt JSON + DXF → schneidet jeden Raum als SVG zu, packt alles in ZIP

Schritt 1 – Einmalige Vorbereitung

Drei Python-Bibliotheken im Terminal installieren:

pip3 install archicad ezdxf matplotlib

In Archicad muss das offizielle Python Add-On aktiviert sein (Optionen → Arbeitsumgebung → Add-Ons-Verwaltung). Die Verbindung läuft über die Archicad JSON-API, kein Tapir nötig.

Schritt 2 – DXF aus Archicad exportieren

Pro Geschoss eine DXF-Datei: Ablage → Sichern als → DXF. Z. B. EG.dxf, OG.dxf, Spitzboden.dxf.

Schritt 3 – JSON aus Archicad exportieren (Python Add-On)

Archicad muss geöffnet sein und das Projekt geladen. Im Terminal:

python3 archicad_grundriss_svg.py

Das Script verbindet sich automatisch mit der laufenden Archicad-Instanz, liest alle Raumstempel mit ihren Bounding-Boxen aus und erzeugt:

  • archicad_grundriss.json ← wird gebraucht für Schritt 5
  • svg/gebaeude.svg und svg/raum_*.svg ← einfache Bounding-Box-Skizzen, werden nicht gebraucht (kann ignoriert oder gelöscht werden)

Hinweis: Falls die Meldung „pip install archicad" erscheint, fehlt die archicad-Python-Bibliothek — dann den Befehl aus Schritt 1 nochmal ausführen.

Schritt 4 – Alle Dateien in einen Ordner

In einen gemeinsamen Ordner legen:

mein-projekt/
  ├── archicad_dxf_crop.py
  ├── archicad_grundriss.json   ← aus Schritt 3
  ├── EG.dxf                     ← aus Schritt 2
  ├── OG.dxf
  └── Spitzboden.dxf

Schritt 5 – Crop-Script ausführen

Im Terminal (Archicad muss hier nicht laufen):

cd /Pfad/zum/Ordner
python3 archicad_dxf_crop.py

Erzeugt:

  • svg/raum_*.svg — hochwertige DXF-Renderings (Wände, Schraffuren, Maße) für die Web-Ansicht
  • png/raum_*.png — PNG-Versionen für den PDF-Export (mPDF kann matplotlib-SVGs nicht direkt rendern)
  • archicad_grundrisse.zip — enthält automatisch beide Formate plus eine Meta-JSON. Das ist die Datei, die in RaumReport hochgeladen wird.

Schritt 6 – ZIP in RaumReport importieren

  • Gebäudeseite → Einstellungsleiste → Grundriss-Import
  • ZIP-Datei hochladen → Importieren
  • RaumReport ordnet die SVGs automatisch per Raumnummer zu (Slot: grundriss)

Häufige Fehler:

Fehler Ursache Lösung
FEHLER: pip install ezdxf matplotlib Python-Bibliotheken fehlen pip3 install ezdxf matplotlib
FEHLER: Kein JSON mit Raum-BBoxen gefunden Schritt 3 wurde übersprungen archicad_grundriss.json aus Archicad exportieren und in den Ordner legen
FEHLER: pip install archicad Python-Bibliothek archicad fehlt pip3 install archicad
Verbindung zu Archicad scheitert Archicad ist nicht geöffnet oder Python-Add-On nicht aktiv Archicad öffnen, Modell laden, Add-On aktivieren

10. Revisionen

Revisionen dokumentieren freigegebene Versionsstände eines Raums.

10.1 Revision anlegen

Raumdetail → Abschnitt Revisionen → Neue Revision

Feld Beschreibung
Revisions-Index Z. B. 00, 01, A, B (wird automatisch vorgeschlagen)
Datum Revisionsdatum
Autor Verantwortliche Person
Beschreibung Kurze Beschreibung der Änderungen

10.2 Revision einfrieren

Offene Revisionen können eingefroren werden:

Revisionsliste → Einfrieren neben der Revision

  • Der aktuelle Raumstand wird als unveränderlicher Snapshot gespeichert
  • Ein Revisions-PDF wird erzeugt und archiviert
  • Eingefrorene Revisionen können nicht mehr verändert oder gelöscht werden

Eingefrorene Revisionen erscheinen im PDF-Revisionsstempel.

10.3 Revisions-PDF herunterladen

Revisionsliste → PDF neben einer eingefrorenen Revision (öffnet in neuem Tab).

10.4 Revision verteilen

Nach dem Einfrieren kann die Revision verteilt werden:

Revisionsliste → Verteilen → Empfänger aus dem Verteiler wählen oder manuell eingeben → Speichern

Der Verteilungsvorgang wird im Verteilerprotokoll festgehalten.

11. Exporte

11.1 Export-Übersichtsseite

Gebäudeseite → Exportleiste → Exporte

Fünf Export-Kacheln mit Download-Button und Hinweis auf den letzten Export:

Kachel Format Beschreibung
PDF Raumbuch PDF Vollständiges Raumbuch aller Räume
Excel-Übersicht XLSX Alle Räume tabellarisch (reine Auswertung)
Excel Rückschreib-Export / Import XLSX Bearbeitungs-Excel mit nur editierbaren Feldern — kann nach Excel-Bearbeitung wieder zurückgeladen werden
JSON (Reimport) JSON Daten für Reimport via Python-Script (nur mit GUIDs)
Python Script .py Fertig konfiguriertes Reimport-Script (nur mit GUIDs)

Unter den Kacheln erscheint nach dem ersten Export das Exportprotokoll mit den jüngsten Exporten (Datum, Typ, Dateiname, Raumanzahl, Benutzer). Bei einem neuen Gebäude ohne Exporte ist die Tabelle ausgeblendet.

11.2 PDF Raumbuch (Gesamt)

Erzeugt ein durchgängiges PDF aller Räume des Projekts.

Inhalt (abhängig von Layout-Vorlage):

  • Optionales Deckblatt mit Logo, Projektdaten, Datum
  • Optionales Inhaltsverzeichnis
  • Optionaler Revisionsindex (Tabelle aller Revisionen)
  • Raumseiten (nach Abschnitten gegliedert, mit Fotos)
  • Optionales Abschlussblatt (Statistik, Flächenübersicht, Freigabe-Unterschriftsblock)

Die PDF-Erzeugung dauert je nach Projektgröße 15–90 Sekunden.

11.3 Einzelraum-PDF

Raumdetail oder Raumliste → PDF (öffnet in neuem Tab).

Enthält nur den jeweiligen Raum mit allen Feldern, Fotos und Revisionsstempel.

11.4 ZIP-Export

Projektseite → ZIP (Einzelräume)

Lädt ein ZIP-Archiv herunter, das für jeden Raum ein einzelnes PDF enthält. Dateiname pro Raum: {Raumnummer}_{Raumname}.pdf

11.5 Excel-Übersicht

Gebäudeseite → Exporte → Excel-Übersicht

  • Eine Zeile pro Raum, eine Spalte pro Feld
  • Enthält importierte Werte, ggf. überschrieben durch manuelle Werte
  • Alle Abschnitte in einem Tabellenblatt
  • Nützlich für externe Auswertung oder Weitergabe an Beteiligte ohne RaumReport-Zugang

11.6 Excel Rückschreib-Export / Import

Gebäudeseite → Exporte → Excel Rückschreib-Export / Import

Praktischster Workflow für umfangreiche Datenbearbeitung in Excel.

Download („Bearbeitungs-Excel herunterladen"):

  • Enthält nur editierbare Felder: Archicad-[P]-Properties, Status, Notizen, benutzerdefinierte Felder
  • Schreibgeschützte Felder ([BI], [GDL], berechnete Werte) sind in der Tabelle gesperrt
  • Interne Maschinenschlüssel (Spaltenreihenfolge, Raum-IDs) bleiben in der Datei erhalten

Bearbeiten:

  • Datei in Excel öffnen, Werte ändern, speichern
  • Spaltenreihenfolge nicht verändern, Maschinenschlüssel nicht löschen

Re-Import („Datei wählen → Importieren"):

  • Nur Dateien, die ursprünglich aus dieser Anwendung exportiert wurden, können wieder hochgeladen werden
  • Änderungen werden wie manuelle Eingaben behandelt — inklusive Änderungsprotokoll
  • Felder mit veränderten Werten erhalten den orangen ✎-Marker

11.7 JSON-Export (für Reimport)

Nur wenn GUIDs importiert wurden. Enthält pro Raum:

{
  "guid": "01F43BDB-...",
  "raumnummer": "EG 01",
  "raumname": "Diele",
  "properties": {
    "Oberflächen:Wandbelag [P]": "Farbe weiß",
    "Raumname [BI]": "Diele"
  }
}

Nur [P]- und [BI]-Felder werden exportiert (rückschreibbar). Der Abschnittsname wird als Präfix mitgeführt (→ Archicad Property-Gruppe).

11.8 Python-Script-Export

Lädt ein fertig konfiguriertes .py-Script herunter, das:

  • Das JSON-File einliest (muss im selben Ordner liegen)
  • Eine Verbindung zum laufenden Archicad aufbaut (via Archicad Connection API)
  • Alle Raum-Properties per GUID zurückschreibt
  • Nur geänderte Werte schreibt (Vergleich mit Archicad-Istwert)
  • Einen Bericht der vorgenommenen Änderungen ausgibt

Voraussetzung: Archicad muss beim Ausführen des Scripts geöffnet und die Datei geladen sein.

12. Reimport nach Archicad

12.1 Voraussetzung (einmalig pro Rechner)

Auf dem Rechner muss Python 3.9 oder höher installiert sein.

  • macOS: reicht die System-Version oder eine Homebrew-Installation (brew install python3)
  • Windows: python.org Installer herunterladen, beim Setup unbedingt „Add python.exe to PATH" anhaken
  • Linux: über den Paketmanager (apt, dnf, …)

Alles Weitere — insbesondere die archicad-Python-Bibliothek — installiert das Script beim ersten Aufruf automatisch.

12.2 Reimport durchführen (Anwender-Workflow)

In RaumReport vorbereitet: Felder bearbeitet, Werte sind gespeichert.

Dann auf dem Rechner:

  1. JSON herunterladen (Exporte-Seite → JSON)
  2. Python-Script herunterladen (Exporte-Seite → Python Script) — beide Dateien in denselben Ordner legen
  3. Archicad starten und das Projekt öffnen
  4. Script ausführen im Terminal:
# macOS / Linux:
python3 raumbuch_reimport.py

# Windows:
python raumbuch_reimport.py

Das war's. Archicad aktualisiert automatisch alle Raum-Properties mit den RaumReport-Werten. Ein Log wird neben dem Script geschrieben (raumbuch_reimport_log.txt).

12.3 Was beim ersten Aufruf passiert

Wenn das Script zum ersten Mal in einem Ordner läuft, richtet es sich automatisch ein:

[1/3] Erstelle isolierte Python-Umgebung (.raumreport_venv) ...
[2/3] Installiere 'archicad' Modul (einmalig, ca. 30 Sekunden) ...
[3/3] Starte Reimport ...

Bei jedem weiteren Aufruf in demselben Ordner entfällt der Setup-Schritt — der Reimport startet sofort.

12.4 Was rückgeschrieben wird

Suffix in TAB-Spalte Im PDF Reimport nach Archicad
[BI], [BI1], … ✓ ✓ rückschreibbar
[P], [P1], … ✓ ✓ rückschreibbar
[GDL] ✓ – nur lesend
Kein Suffix (berechnet) ✓ – nur lesend

Verschachtelte Strukturen mit [H1]-Sub-Sections und Continuation-Gruppen werden korrekt aufgelöst — alle Properties unter einer Top-Section landen in derselben Archicad-Gruppe.

12.5 Workflow als Diagramm

RaumReport                              Rechner                      Archicad
─────────                              ──────                       ────────
Felder bearbeiten
       │
       └── JSON ──┐
       └── .py ───┤
                  ▼
               Ordner mit
               beiden Dateien
                  │
                  └── python3 script.py ──────────────▶ Reimport
                       (1. Lauf: Setup + Reimport)         │
                       (Weitere Läufe: nur Reimport)       ▼
                                                    Properties
                                                    aktualisiert

12.6 Bauteile-Import (Fenster, Türen, Objekte)

Über den klassischen TAB-Import hinaus kann RaumReport auch Bauteile aus Archicad raumweise importieren: Fenster, Türen, Objekte und optional Lichtquellen. Sie werden im Raumdetail in einem separaten Bauteile-Tab angezeigt und erscheinen im PDF.

Stand April 2026 · Ergänzung zu HANDBUCH.md

12.6.1 Überblick

Der Bauteile-Import ergänzt das klassische Raumbuch um eine automatische Auswertung aller bauraumrelevanten Elemente direkt aus Archicad: Fenster, Türen, Objekte und Lichtquellen werden raumweise erfasst, in RaumReport gespeichert und im PDF ausgegeben.

Datenfluss
Archicad-Modell
      │
      │  Python-Script (Sync)
      ▼
RaumReport-Datenbank
      │
      ├─► Bauteile-Tab im Raum (Anzeige + Bearbeitung)
      ├─► PDF-Ausgabe (Einzelraum + Gesamt-Raumbuch)
      │
      │  Python-Script (Writeback)
      ▼
Archicad-Modell (geänderte Properties zurückschreiben)
Was wird importiert?
Typ Quelle in Archicad Zuordnung zum Raum
Fenster Alle Fenster im Projekt Per Von Raum-Nummer (BI-Property)
Türen Alle Türen im Projekt Per Von Raum-Nummer / Zu Raum-Nummer (optional: Property „Tür zu Raum")
Objekte Alle Objekte per GetElementsRelatedToZones Automatisch durch Archicad-Zonenzuweisung
Lichtquellen Alle Lampen per GetElementsRelatedToZones Automatisch (standard: deaktiviert)

12.6.2 Voraussetzungen

Archicad
  • Archicad 27 oder neuer
  • Das Projekt muss Zonen (Raum-Stempel) enthalten
  • Räume müssen in RaumReport bereits per TAB-Import vorhanden sein und eine Archicad-GUID tragen (Spalte Raumnummer [BI] oder Zone GUID im TAB-Export)
Python-Umgebung

Das Script läuft in der Archicad Python-Palette oder im Terminal. Das offizielle archicad-Paket ist erforderlich:

pip install archicad

Kein Tapir erforderlich. Keine externen Bibliotheken außer dem archicad-Paket.

RaumReport
  • RaumReport muss erreichbar sein (lokal über Herd/MAMP oder online)
  • Ein API-Token muss für das Projekt vorhanden sein (wird automatisch erzeugt)

12.6.3 Einrichtung in RaumReport

Bauteile-Import-Seite aufrufen

Auf der Projektübersicht: Schaltfläche „Bauteile-Import" → die Konfigurations-Seite öffnet sich.

API-Token

Der API-Token authentifiziert das Python-Script gegenüber RaumReport. Er wird automatisch beim ersten Aufruf der Konfigurations-Seite erzeugt.

  • Token anzeigen: linke Spalte der Konfigurations-Seite
  • Token neu generieren: Schaltfläche „Neuen Token generieren" (nur Redakteur/Admin). Achtung: Nach der Neugenerierung müssen alle Scripts neu heruntergeladen werden.
Script herunterladen

Schaltfläche „Script herunterladen" auf der Konfigurations-Seite. Das heruntergeladene Script enthält bereits:

  • Server-URL (RAUMBUCH_URL)
  • API-Token (RAUMBUCH_TOKEN)
  • Projekt-ID (PROJECT_ID)
  • Modus (MODE = "sync")

Das Script muss nach jeder Token-Neugenerierung erneut heruntergeladen werden.

12.6.4 Das Python-Script (Sync)

Datei

raumbuch_elements_42.py (die Zahl = Projekt-ID)

Konfigurationsabschnitt

Am Anfang der Datei:

RAUMBUCH_URL   = "https://meinserver.de"   # Adresse RaumReport
RAUMBUCH_TOKEN = "abc123..."               # API-Token
PROJECT_ID     = 42                        # Projekt-ID

MODE = "sync"       # "discovery" oder "sync"
OUTPUT_FILE = None  # None = POST an Server; Pfad = JSON-Datei

ELEMENT_FILTER = {
    "Window": True,    # Alle Fenster
    "Door":   True,    # Alle Türen
    "Lamp":   False,   # Lichtquellen (deaktiviert)
    "Object": True,    # Alle Objekte im Raum
    # Alternativ: nur bestimmte Klassifikationen:
    # "Object": {
    #     "Haustechnik": True,
    #     "Sanitär":     True,
    # }
}
Ausführung

Aus der Archicad Python-Palette: Script in der Palette öffnen → Ausführen-Button. Archicad übergibt den Port automatisch.

Im Terminal:

python raumbuch_elements_42.py sync
python raumbuch_elements_42.py discovery
python raumbuch_elements_42.py sync --output elemente.json  # lokal speichern, kein POST

12.6.5 Discovery-Modus

Der Discovery-Modus scannt das Projekt ohne Import und zeigt:

  • Erkanntes Archicad-Klassifikationssystem
  • Anzahl Elemente pro Typ (Window / Door / Lamp / Object)
  • Alle Objekt-Klassifikationen mit Anzahl (wichtig für selektiven ELEMENT_FILTER)

Ergebnis wird auf der Konsole ausgegeben und als raumbuch_elements_discovery.json gespeichert.

Wann verwenden?

  • Beim ersten Einrichten: um zu sehen, welche Objektklassifikationen im Modell vorhanden sind
  • Wenn ELEMENT_FILTER["Object"] auf einzelne Klassifikationen eingeschränkt werden soll

Beispiel-Output:

OBJEKT-KLASSIFIKATIONEN (für ELEMENT_FILTER['Object']):
  [ ] ARCHICAD-Klassifizierung — Haustechnik    : 12 Elemente
  [ ] ARCHICAD-Klassifizierung — Möbel          :  8 Elemente
  [ ] ARCHICAD-Klassifizierung — Sanitär        :  5 Elemente

Gewünschte Einträge dann in ELEMENT_FILTER['Object'] mit True eintragen.

12.6.6 Sync-Modus: Import in RaumReport

Ablauf
  1. Script verbindet sich mit Archicad
  2. Alle Zonen (Räume) werden gelesen
  3. Fenster + Türen: werden projektübergreifend geladen, dann per Raumnummer den Zonen zugeordnet
  4. Objekte + Lichtquellen: werden per GetElementsRelatedToZones raumweise geladen
  5. Elemente werden aggregiert (gleicher Typ + Name + Maße + Element-ID → eine Zeile mit count)
  6. JSON-Payload wird per HTTPS an RaumReport gesendet
  7. RaumReport löscht alle bisherigen Elemente des Projekts und speichert die neuen
Türen-Zuordnung

Türen liegen topologisch in der Wand zwischen zwei Räumen. Die Zuordnung erfolgt per Von Raum-Nummer:

  • Standard: Tür wird dem Raum zugeordnet, von dem sie aufgeht (Von Raum-Nummer)
  • Optional: Archicad-Property „Tür zu Raum" (Boolean, User-Property) anlegen:
    • Wahr → Tür gehört zu dem Raum, in den sie schlägt (Zu Raum-Nummer)
    • Falsch → Tür gehört zu Von Raum-Nummer
    • Nicht gesetzt → Standard (kein Wechsel)
GUID-Abgleich mit Räumen

RaumReport ordnet importierte Elemente dem passenden Raum zu, wenn der Raum eine Archicad-GUID besitzt. Die GUID kommt aus dem TAB-Import (Spalte mit Suffix [BI], die die Zone-GUID enthält). Räume ohne GUID werden trotzdem importiert, bleiben aber keinem Raum in der Datenbank zugeordnet.

Overrides bleiben erhalten?

Nein. Jeder Sync überschreibt alle Elemente des Projekts vollständig. Gesetzte Property-Overrides gehen verloren, wenn dasselbe Element beim nächsten Sync wieder importiert wird (da es eine neue Datenbankzeile erhält).

Empfehlung: Overrides vor einem erneuten Sync per Writeback-Script nach Archicad zurückschreiben (→ Kapitel 11), dann erneut syncen.

12.6.7 Bauteile-Konfiguration

Konfigurations-Seite

Navigation: Projektübersicht → „Bauteile-Import"

Die rechte Spalte zeigt alle importierten Properties gruppiert nach Elementtyp (Türen, Fenster, Objekte …).

Sichtbare Properties auswählen

Per Checkbox bestimmen, welche Properties im Bauteile-Tab und im PDF angezeigt werden.

  • Fett + „AC": read-only in Archicad (Geometrie, Topologie, Built-in). Können in RaumReport nicht bearbeitet werden.
  • Normal: User-Properties ([P]). In RaumReport editierbar.

Ohne Auswahl werden alle verfügbaren Properties angezeigt.

Anzeigelayout pro Elementtyp

Rechts neben jedem Typnamen: Layout-Toggle mit zwei Optionen:

Symbol Modus Empfehlung
Spalten (⊞) Element = Zeile, Property = Spalte Wenige Properties (bis ~8), viele Elemente
Zeilen (≡) Property = Zeile, Element = Spalte Viele Properties (>8), wenige Elemente (bis ~5)

Die Einstellung wird pro Typ gespeichert und wirkt sich auf Tab-Ansicht und PDF aus.

Änderungen speichern

Schaltfläche „Speichern" unten rechts. Die Konfiguration gilt für alle Nutzer des Projekts.

12.6.8 Bauteile im Raum anzeigen

Bauteile-Tab

In der Raumdetailansicht: Tab „Bauteile" (mit Anzahl-Badge). Der Tab erscheint nur, wenn Elemente für diesen Raum importiert wurden.

Layout-Umschalter

Jeder Elementtyp hat einen Toggle „Spalten / Zeilen" oben rechts im Abschnitt-Header. Der Toggle gilt nur für die aktuelle Anzeige (nicht dauerhaft gespeichert). Für dauerhaftes Speichern: Konfigurations-Seite verwenden.

Elementbezeichnung

Als Bezeichner wird der Wert der Element-ID-Property verwendet (Archicad-Property „Element ID"). Fallback: Bibliothekselement-Name → Klassifikation → „—".

12.6.9 Properties bearbeiten (Overrides)

Nur User-Properties (keine „AC"-Markierung) sind editierbar.

Wert bearbeiten

Im Bauteile-Tab: Auf den Wert klicken oder das ✎-Symbol rechts davon. Ein Inline-Textfeld erscheint.

  • Enter oder ✓: Wert speichern
  • Escape oder ✕: Abbrechen

Geänderte Werte werden orange dargestellt.

Override zurücksetzen

Neben einem überschriebenen Wert: ↺-Symbol → setzt den Wert auf den Archicad-Originalwert zurück.

Technisches

Overrides werden in room_elements.property_overrides als JSON gespeichert. Der Original-Archicad-Wert bleibt in room_elements.properties erhalten und ist jederzeit wiederherstellbar.

12.6.10 Bauteile im PDF

Einzelraum-PDF

Bauteile erscheinen am Ende des Raumblatts, nach den Raumeigenschaften und Fotos. Je Elementtyp eine Tabelle.

Gesamt-Raumbuch

Bauteile erscheinen auf jedem Raumblatt (wie Einzelraum-PDF).

Layouts im PDF

Das konfigurierte Layout (Spalten/Zeilen) wird exakt so ins PDF übernommen.

Spaltenweise (Elemente als Zeilen):

#   Bezeichnung       Breite  Höhe    Feuerwiderstand
1×  F-01              885     2100    EI30
1×  F-02              1200    2100    EI30

Zeilenweise (Properties als Zeilen, ideal bei vielen Properties):

Eigenschaft           F-01        F-02        F-03
Breite                885         1200        900
Höhe                  2100        2100        2100
Feuerwiderstand       EI30        EI30        EI60
Overrides im PDF

Manuell in RaumReport geänderte Werte erscheinen im PDF in orangeroter Schrift.

12.6.11 Overrides nach Archicad zurückschreiben

Überblick

Das Writeback-Script liest alle in RaumReport gesetzten Property-Overrides und schreibt sie in die entsprechenden Archicad-Elemente zurück.

Einschränkung: Nur User-Properties ([P]) können gesetzt werden. Geometrie, Topologie und Built-in-Properties ([BI]) sind in Archicad schreibgeschützt — der Schreibversuch wird von Archicad abgelehnt und übersprungen.

Script herunterladen

Auf der Bauteile-Import-Konfigurations-Seite: Karte „Overrides → Archicad" → Schaltfläche „Writeback-Script herunterladen".

Die Karte zeigt auch die aktuelle Anzahl der Elemente mit Overrides.

Ausführung

Gleiche Vorgehensweise wie das Sync-Script: in der Archicad Python-Palette öffnen und ausführen.

Ausgabe-Beispiel:

============================================================
RAUMBUCH ELEMENTS — WRITEBACK
============================================================

Lade Overrides von RaumReport ...
  Projekt:  Bürogebäude Musterstraße
  Stand:    2026-04-15T10:30:00+00:00
  Elemente: 5 mit Overrides

Lade Property-IDs aus Archicad ...
  187 Properties gefunden
Lade Element-GUIDs aus Archicad ...
  36 Elemente gefunden

Schreibe Properties zurück ...
------------------------------------------------------------
  OK  Window    F-01                              (Büro 1.01)  1 Properties x 1 Element(e)
  OK  Door      T-01                              (Büro 1.01)  2 Properties x 1 Element(e)
------------------------------------------------------------

Fertig:
     3  Properties gesetzt
     0  übersprungen
     0  Fehler
============================================================
Empfohlener Workflow bei Modellaktualisierung
  1. Overrides in RaumReport setzen und prüfen
  2. Writeback-Script ausführen → Werte in Archicad übernommen
  3. Modell in Archicad weiterbearbeiten (Geometrie, neue Elemente etc.)
  4. Sync-Script erneut ausführen → RaumReport wird vollständig aktualisiert

12.6.12 Aggregation und Element-ID

Aggregationsregel

Mehrere physisch einzelne Elemente in Archicad werden zu einer Zeile zusammengefasst, wenn alle folgenden Kriterien übereinstimmen:

Kriterium Spalte
Elementtyp element_type
Archicad-Klassifikation classification
Bibliothekselement-Name element_name
Abmessungsschlüssel (Breite × Höhe × Tiefe) intern aus properties
Element-ID properties['Element ID']

Unterscheidet sich die Element-ID, werden die Elemente immer als separate Zeilen geführt — auch wenn alle anderen Kriterien identisch sind.

Warum Element-ID als Kriterium?

Der Architekt vergibt Element-IDs bewusst, um gleichartige Elemente zu unterscheiden (z.B. gleiche Fenstergröße, aber unterschiedliche Anforderungen). Die ID-basierte Trennung verhindert, dass solche Elemente unkontrolliert zusammengefasst werden.

count-Spalte

Werden Elemente zusammengefasst, zeigt count die Anzahl. Im Bauteile-Tab und im PDF erscheint sie als 2×, 3× usw.

12.6.13 Häufige Fragen und Fehler

„Nur X von Y Zonen enthalten Elemente"

Ursache: Fenster und Türen werden per Von Raum-Nummer zugeordnet. Räume ohne gesetzten Raumnummer-Stempel in Archicad oder Elemente ohne Raum-Verknüpfung werden nicht zugeordnet.

Lösung: In Archicad sicherstellen, dass alle relevanten Räume Zonen mit eindeutiger Raumnummer haben und die Fenster/Türen korrekt verknüpft sind.

„Keine Bauteile importiert" im Bauteile-Tab des Raums

Ursache: GUID-Abgleich schlägt fehl — der Raum in RaumReport hat keine archicad_guid, oder die GUID unterscheidet sich in Groß-/Kleinschreibung.

Lösung: Sicherstellen, dass der TAB-Import die GUID-Spalte ([BI]-Suffix) enthält. RaumReport vergleicht GUIDs intern case-insensitiv.

HTTP 401 beim Sync

Ursache: Token ungültig oder falsch eingebettet.

Lösung: Auf der Konfigurations-Seite den aktuellen Token prüfen. Script neu herunterladen.

HTTP 500 / UNIQUE constraint failed

Ursache: Veraltete Datenbankstruktur (Migration nicht durchgeführt).

Lösung: php artisan migrate im RaumReport-Verzeichnis ausführen.

Property nicht gefunden beim Writeback

Meldung: 'PropertyName' nicht in Archicad gefunden — übersprungen

Ursache: Der Property-Name in RaumReport stimmt nicht exakt mit dem in Archicad überein (Tippfehler, Umlaute, Leerzeichen).

Lösung: Property-Name im Bauteile-Tab des Raums mit der Archicad-Property-Definition vergleichen.

Read-only Properties können nicht zurückgeschrieben werden

Erklärung: Geometrische Werte (Breite, Höhe, Nominale B×H) und topologische Properties (Von/Zu Raum, Ebene) sind in Archicad schreibgeschützt. Archicad lehnt den Schreibversuch ab. Das Script überspringt diese Properties und meldet sie als Fehler.

Lösung: Nur User-Properties ([P]) in RaumReport bearbeiten. Die Kennzeichnung „AC" in der Bauteile-Konfiguration zeigt read-only Properties an.

Dieses Kapitel gehört zum RaumReport-Handbuch. Stand: April 2026.

13. Projektarchiv – Speichern unter und Wiederherstellen

Das Projektarchiv ermöglicht eine vollständige Projektsicherung inklusive aller Daten.

13.1 Projekt exportieren (Archiv erstellen)

Projektseite → Exportleiste → Archiv

Lädt eine ZIP-Datei herunter, die enthält:

  • Projektmetadaten (Name, Nummer, Beschreibung etc.)
  • Alle Räume mit allen Feldern und manuellen Überschreibungen
  • Alle Fotos (nach Raumnummer/Slot geordnet)
  • Spaltenstruktur des letzten Imports
  • Layout-Vorlagen
  • Auswahllisten
  • Verteiler-Kontakte
  • LP- und Raumtyp-Einstellungen

13.2 Projekt importieren (Archiv wiederherstellen)

Projektliste → Importieren (oben, nur Admin)

  1. ZIP-Archivdatei auswählen
  2. Optionalen neuen Projektnamen eingeben (leer = aus Archiv übernehmen)
  3. Projekt importieren

Das Projekt wird als neues Projekt angelegt (das ursprüngliche bleibt erhalten).

Anwendungsfälle:

  • Backup / Wiederherstellung
  • Migration auf einen neuen Server
  • Kopie eines Projekts als Vorlage

14. Leistungsphasen (HOAI)

Die Leistungsphasen-Funktion erlaubt es, Felder je nach aktiver HOAI-Phase ein- oder auszublenden.

14.1 Aktivieren

Projektseite → Einstellungsleiste → LP-Einstellungen

Ganz oben: Checkbox Leistungsphasen aktivieren → Speichern.

Nur wenn aktiviert:

  • Erscheint der LP-Schnellumschalter in der Kopfzeile
  • Werden Felder im Raumdetail und PDF nach Phase gefiltert

14.2 LP-Einstellungsmatrix

Die Tabelle zeigt alle importierten Felder (ohne Abschnittsköpfe) mit Checkboxen für jede Leistungsphase:

Phase Bezeichnung
LP 0 Bauherr (Vorinformation)
LP 1–2 Grundlagenermittlung, Vorplanung
LP 3–4 Entwurfs-, Genehmigungsplanung
LP 5 Ausführungsplanung
LP 6–7 Vorbereitung/Mitwirkung Vergabe
LP 8 Objektüberwachung
LP 9 Objektbetreuung
LP 10 Betrieb

Checkbox gesetzt = Feld ist in dieser Phase sichtbar.

Schnellaktionen (Kopfzeile der Tabelle):

  • Pro Spalte: ✓ alle setzen / ✗ alle löschen
  • Pro Zeile (rechts): ✓ alle Phasen / ✗ alle löschen
  • Gesamt: Alle ✓ / ✗

14.3 Leistungsphase umschalten

Wenn Leistungsphasen aktiv sind, erscheint in der Kopfzeile der Anwendung ein LP-Schnellumschalter.

Klick öffnet ein Dropdown mit allen Phasen:

  • Alle anzeigen: kein Filter aktiv
  • LP 1–10 auswählen: nur Felder dieser Phase werden angezeigt

Der Schalter zeigt bei gesetztem Filter einen orangefarbenen Hintergrund mit der aktiven Phase.

Der LP-Filter gilt pro Projekt und bleibt auch nach dem Abmelden erhalten.

15. Raumtypen

Die Raumtypen-Funktion blendet Felder und Abschnitte je nach Raumtyp selektiv ein oder aus.

15.1 Voraussetzung

Die TAB-Datei muss eine Spalte Raumtyp oder Zone Type enthalten.

15.2 Aktivieren

Projektseite → Einstellungsleiste → Raumtypen

Ganz oben: Checkbox Raumtypen aktivieren → Speichern.

Der Button in der Einstellungsleiste erhält einen farbigen Rahmen, wenn aktiviert: Raumtypen (aktiv).

15.3 Zuweisungsmatrix

Die Tabelle zeigt alle importierten Felder (inkl. Abschnittsköpfe) mit einer Spalte pro Raumtyp.

  • Checkbox gesetzt = Feld wird für diesen Raumtyp angezeigt
  • Checkbox leer = Feld wird ausgeblendet
  • Abschnittszeilen (grau, fett): Abschnitt für diesen Raumtyp komplett ein-/ausblenden

⚠ Flächen-Warnung: Wenn für einen Raumtyp alle Flächen-Felder deaktiviert sind, erscheint ein Warndreieck in der Spaltenüberschrift.

Schnellaktionen:

  • Pro Raumtyp-Spalte: ✓ / ✗
  • Pro Zeile: ✓ / ✗
  • Gesamt: Alle ✓ / ✗

16. Auswahllisten

Auswahllisten definieren Dropdown-Werte für Felder mit [P]-Suffix.

16.1 Öffnen

Projektseite → Einstellungsleiste → Auswahllisten

16.2 Aufbau

Jede Liste ist einem Feld zugeordnet (identifiziert durch Abschnitt::Feldname).

Projektlisten gelten nur für das aktuelle Projekt. Globale Listen (nur Admin) gelten für alle Projekte, wenn keine Projektliste vorhanden.

16.3 Liste anlegen und bearbeiten

  1. Auf ein Feld klicken, das noch keine Liste hat → Neue Liste
  2. Werte eingeben (einer pro Zeile) und Reihenfolge per Drag & Drop festlegen
  3. Freitext erlauben: Wenn aktiviert, kann der Benutzer zusätzlich zu den Listenwerten einen freien Text eingeben
  4. Speichern

16.4 Werte aus Import übernehmen

Beim Import werden alle vorhandenen Feldwerte automatisch als [Archicad]-Einträge in der Liste vorgemerkt. Admins sehen diese Werte in der Listenverwaltung und können sie dauerhaft in die Liste aufnehmen.

16.5 Globale Auswahllisten (Admin)

Navigation → Layout-Vorlagen → Sidebar: Globale Auswahllisten (alternativ direkt erreichbar)

Globale Listen sind projektübergreifend und nützlich für standardisierte Wertemengen (z. B. genormte Bodenbelag-Typen).

Aus Projektliste zu global befördern: In der Projektliste → Global machen – die Liste steht dann allen Projekten zur Verfügung.

17. Layout-Vorlagen

Layout-Vorlagen bestimmen Aussehen und Inhalt der PDF-Exporte.

17.1 Übersicht

Navigation → Layout-Vorlagen

Die Tabelle zeigt alle Vorlagen mit Name, Projektbindung und Standard-Markierung.

17.2 Globale vs. Projektvorlagen

Typ Verwendung
Global Gilt für alle Projekte ohne eigene Vorlage
Projektspezifisch Gilt nur für das zugeordnete Projekt

Beim PDF-Export gilt immer die als Standard markierte Vorlage des Projekts. Gibt es keine, wird die globale Standard-Vorlage verwendet.

17.3 Themes (seit Version 2.9.0)

RaumReport bringt mehrere PDF-Themes mit. Ein Theme bestimmt das gesamte Layout der gerenderten PDF (Struktur, Tabellen, Header/Footer). Die Detail-Einstellungen pro Vorlage (Akzentfarbe, Schriften, Foto-Slots) bleiben theme-unabhängig.

Theme Beschreibung
Classic Das ursprüngliche RaumReport-Layout — Default. Alle Vorlagen, die vor Version 2.9.0 angelegt wurden, sind automatisch auf „Classic" eingestellt.
RAS 0550 Bundes-Standard nach Vorlage „VERBINDLICHE PLANUNGSVORGABE · FEUERWACHEN DER BUNDESWEHR" — mit oranger Akzentleiste, 4-spaltiger Raumkopf-Tabelle, DIN-276-Tabellen getrennt nach Baukonstruktion (3xx) und Technischen Anlagen (4xx), optional GWiNr- und NC-KFA-Spalten.

Theme-Wechsel ist jederzeit möglich (Vorlagen-Detail → Theme): Theme-spezifische Optionen werden zurückgesetzt, generische Settings (Farben, Schriften, Foto-Slots) bleiben erhalten.

Wichtig für RAS 0550: Die DIN-276-Codes werden aus den Archicad-Property-Namen erkannt. Empfohlenes Format: <Code> <Bezeichnung>, getrennt durch ein Leerzeichen — also 320 Bodenbeläge [H] oder 325 Bahnenware, R9 [P]. Properties ohne Code-Präfix erscheinen normal, aber nicht in der DIN-Spalte.

17.4 Layout-Wizard (seit Version 2.9.0)

Der Wizard führt Schritt für Schritt durch das Anlegen einer neuen Vorlage — empfohlen für Erstanwender oder Vorlagen, die nicht ganz dem Standard entsprechen.

Einstieg:

  • Layout-Vorlagen → Schaltfläche „Vorlage via Wizard" (primär)
  • Oder: Gebäudeseite → Hinweis-Banner „Eigenes Layout erstellen" → Wizard starten

Die fünf Schritte:

Schritt Inhalt
1. Theme Auswahl Classic oder RAS 0550 mit Thumbnail-Vorschau
2. Identität Name, Geltungsbereich (global/projekt) und Wasserzeichen; bei RAS 0550 zusätzlich Header-Titel, Untertitel, Stand
3. Akzente Akzentfarbe (Picker + 6 Presets), Schriftpaarung, Body-Größe
4. Foto-Slots Voreinstellung (1/3/6 Slots oder eigene) und Standard-Breite
5. PDF-Optionen + Live-Vorschau Deckblatt/TOC/Abschluss/Revision an/aus, DIN-276-Anzeige, theme-spezifische Optionen wie GWiNr-Spalte. Live-Vorschau-Button rendert ein Beispiel-Raum-PDF im Browser. „Vorlage erstellen" speichert.

Die Schritte 2-4 dürfen mit „Überspringen" übersprungen werden — dann gelten die Theme-Defaults.

Nach dem Speichern wird die neue Vorlage geöffnet, weitere Details können direkt im Detail-Formular bearbeitet werden.

17.5 Neue Vorlage manuell erstellen

Layout-Vorlagen → Neue Vorlage

Tipp: Für die meisten Fälle ist der Wizard (17.4) der schnellere Weg. Das manuelle Formular zeigt alle Optionen auf einen Blick — ideal für erfahrene Anwender.

Grundeinstellungen

  • Name der Vorlage
  • Projektbindung: global oder ein bestimmtes Projekt

Seiteneinstellungen

  • Format: A4, A3, Letter
  • Ausrichtung: Hochformat / Querformat
  • Ränder oben / unten / links / rechts (mm)

Kopf- und Fußzeile (Freitext mit Variablen):

Variable Inhalt
{projekt} Projektname
{projektnummer} Projektnummer
{raumnummer} Raumnummer des aktuellen Raums
{raumname} Raumname
{datum} Heutiges Datum (TT.MM.JJJJ)
{revision} Aktiver Revisions-Index
{seite} Aktuelle Seitennummer
{seiten} Gesamtseitenzahl des Dokuments

Abschnittseinstellungen

  • Nummerierungsschema: 1.1.1 · A.1.1 · Keine Nummern
  • Leere Felder anzeigen / ausblenden

Foto-Slots

  • Welche Slots im PDF erscheinen und in welcher Reihenfolge

Stil-Einstellungen

  • Überschriften-Farbe (Hex-Code, z. B. #1e40af)
  • Trennlinien-Farbe
  • Wasserzeichen-Text (z. B. ENTWURF – leer = kein Wasserzeichen)
  • Deckblatt anzeigen
  • Inhaltsverzeichnis anzeigen
  • Revisionsindex im PDF einbetten
  • Abschlussblatt anzeigen

17.6 Als Standard setzen

Vorlagenliste → Als Standard verwenden → Bestätigen.

18. Änderungsprotokoll und Freigaben

18.1 Änderungsprotokoll öffnen

Navigation → Freigaben & Änderungen (in der Seitenleiste)

Das Protokoll zeigt alle Feldänderungen, Kommentare und Freigaben des gesamten Systems.

18.2 Einträge filtern

  • Typ: Alle · Änderungen · Kommentare · Freigaben · Offen
  • Raum: Direkt aus dem Raumdetail verlinkt (?room_id=…)
  • Projekt: Alle oder ein bestimmtes Projekt

18.3 Typen von Einträgen

Typ Bedeutung
Änderung Feld wurde von einem Benutzer geändert (alter und neuer Wert)
Kommentar Kommentar ohne Wertänderung
Kombination Änderung mit gleichzeitigem Kommentar
Freigabe (Status) Raum-Status wurde auf „Freigegeben" gesetzt

18.4 Feld freigeben (Admin)

Im Änderungsprotokoll → Spalte Freigabe: Schaltfläche Freigeben neben einer nicht-freigegebenen Änderung.

Nach der Freigabe:

  • Eingetragener Wert gilt als geprüft
  • Im Raumdetail erscheint ein grüner Haken ✓ neben dem Feld
  • Freigegebene Einträge werden grün hervorgehoben

19. Verteiler und Kontakte

Der Verteiler hat zwei Ebenen mit unterschiedlichem Zweck:

Ebene Zugang Zweck
Kontakte + Gesamtverteiler Gebäudeseite → Einstellungsleiste → Verteiler Empfängerliste pflegen; Ausgabe des vollständigen Raumbuchs protokollieren
Einzelraum-Revision Raumdetail → Revisionen → Button „Verteiler" Ausgabe einer eingefrorenen Raumversion protokollieren

Wenn Versandmethode E-Mail gewählt wird und der Empfänger eine E-Mail-Adresse hat, versendet RaumReport automatisch eine Benachrichtigungsmail. Bei Revisionen wird das Revisions-PDF als Anhang mitgeschickt.

19.1 E-Mail-Versand einrichten

Navigation → Einstellungen → Abschnitt E-Mail-Versand (nur Admin)

Feld Beschreibung
Versandmethode log = kein Versand, Ausgabe in Logdatei (lokal/Test); smtp = eigene Zugangsdaten; sendmail = Serverversand ohne Zugangsdaten (all-inkl.com)
Absender-E-Mail Adresse, die als Absender erscheint
Absender-Name Z. B. „RaumReport Musterbüro"
SMTP-Host Z. B. w01234.kasserver.com (nur bei Methode smtp)
SMTP-Port 587 (TLS) oder 465 (SSL)
Benutzername / Passwort E-Mail-Zugangsdaten

Schaltfläche Test-E-Mail senden schickt eine einfache Testnachricht an die eigene Login-Adresse zur Überprüfung der Konfiguration.

19.2 Kontakte verwalten

Gebäudeseite → Einstellungsleiste → Verteiler

Gebäudebezogene Liste von Personen/Firmen, die das Raumbuch regelmäßig erhalten.

Feld Beschreibung
Name Pflichtfeld
Firma Optional
Funktion Z. B. „Bauherrenvertreter"
E-Mail Optional — wird für automatischen E-Mail-Versand benötigt

Kontakte können per Drag & Drop sortiert werden. Sie stehen in beiden Verteiler-Ebenen zur Auswahl.

19.3 Gesamtverteiler (vollständiges Raumbuch-PDF)

Auf der gleichen Seite (Einstellungsleiste → Verteiler) befindet sich das Gesamtverteiler-Protokoll. Hier dokumentieren Sie, wer das vollständige Raumbuch erhalten hat.

Bei Methode „E-Mail" und vorhandener Empfänger-Adresse wird automatisch eine Benachrichtigungsmail versendet (ohne PDF-Anhang — das Gesamt-PDF ist zu groß für einen Anhang).

Statistik-Anzeige: Anzahl Verteilungen gesamt · Zuletzt verteilt am

19.4 Einzelraum-Revision verteilen

Raumdetail → Revisionen → Button „Verteiler" (erscheint nur bei eingefrorenen Revisionen)

Klick öffnet ein Panel mit dem Verteilungsformular und dem Protokoll bisheriger Ausgaben dieser Revision.

Bei Methode „E-Mail" und vorhandener Empfänger-Adresse: automatischer Versand mit dem eingefrorenen Revisions-PDF als Anhang.

20. Benutzerverwaltung

(Nur für Administratoren)

20.1 Benutzer anlegen

Navigation → Benutzer → Neuer Benutzer

Feld Beschreibung
Name Anzeigename
E-Mail Eindeutig (= Login)
Passwort Mindestens 8 Zeichen
Rolle Admin · Redakteur · Fachredakteur · Betrachter
Sprache Deutsch / Englisch
Aktiv Deaktiviert → kein Login möglich

20.2 Rollen

Rolle Beschreibung
Admin Vollzugriff: Projekte, Benutzer, Einstellungen, Import, Export
Redakteur Kann Räume bearbeiten, importieren, exportieren; keine Benutzerverwaltung
Fachredakteur Wie Redakteur, aber nur für zugewiesene Abschnitte
Betrachter Nur lesen und exportieren

20.3 Abschnittszuweisungen (Fachredakteur)

Bei der Rolle „Fachredakteur" erscheint ein zusätzlicher Bereich Bearbeitbare Abschnitte.

Wählen Sie die Abschnittsnamen aus, die dieser Benutzer bearbeiten darf (z. B. „Oberflächen", „Ausstattung"). Im Bearbeiten-Formular sind alle anderen Abschnitte gesperrt.

20.4 Projektzugang

Für Redakteure und Fachredakteure muss der Projektzugang explizit freigeschaltet werden.

Benutzerliste → Benutzer bearbeiten → Abschnitt Projektzugang → Checkboxen für die erlaubten Projekte setzen.

Admins haben automatisch Zugang zu allen Projekten.

20.5 Benutzer bearbeiten und löschen

  • Bearbeiten: Stift-Symbol → Felder ändern. Passwort-Felder leer lassen = kein Passwort-Wechsel.
  • Löschen: Löschen-Symbol → Bestätigen (der eigene Account kann nicht gelöscht werden).

21. Einstellungen

(Nur für Administratoren)

Navigation → Einstellungen

Einstellung Beschreibung
App-Name Erscheint im Browser-Titel und in der Kopfleiste
Standard-Sprache Deutsch oder Englisch
PDF-Wasserzeichen Standardtext auf allen PDFs (z. B. ENTWURF). Leer = kein Wasserzeichen.

Systeminformationen (schreibgeschützt):

  • PHP-Version
  • Datenbankdatei und Größe
  • Speichernutzung (Fotos, Logos)

22. Demo-Modus

Der Demo-Modus ermöglicht anonyme Test-Sitzungen ohne Installation.

22.1 Demo starten

Rufen Sie die Domain auf ohne angemeldet zu sein → Klick auf Demo starten.

  • Es wird automatisch eine isolierte Datenbank für die Sitzung erstellt
  • Anmeldung als Demo-Admin erfolgt automatisch
  • Demo-Daten: Projekt „Bürogebäude Musterstraße 12" mit 13 Räumen

22.2 Demo-Banner

Im Demo-Modus erscheint oben ein gelbes Banner mit:

  • Verbleibende Zeit (Countdown, max. 60 Minuten)
  • Schaltfläche Sitzung beenden

22.3 Einschränkungen

  • Max. 10 gleichzeitige Demo-Sitzungen
  • Alle Änderungen werden nach 60 Minuten automatisch gelöscht
  • DEMO_MODE=true in der .env-Datei muss aktiviert sein

23. Mehrere Gebäude verwalten

Version 1.0 · Stand April 2026

23.1 Konzept: Ein Code, viele Gebäude

RaumReport ist für den Einsatz an realen Bauvorhaben ausgelegt – jedes Gebäude bekommt seine eigene App-Instanz. Das klingt nach viel Aufwand, ist es aber nicht:

  • Ein Codepaket (ZIP) für alle Gebäude – immer derselbe Stand
  • Pro Gebäude: eigener Ordner auf dem Server, eigene URL, eigene Datenbank
  • Keine gegenseitige Beeinflussung: Gebäude A sieht die Daten von Gebäude B nie
  • Updates: Neue Version einmal herunterladen, pro Gebäude ~2 Minuten per FTP einspielen
Server
├── /www/musterstrasse12/     ← Gebäude 1 (komplette App)
├── /www/lindenallee5/        ← Gebäude 2 (komplette App)
└── /www/neubaugebiet-sued/   ← Gebäude 3 (komplette App)

23.2 Erstes Gebäude installieren

→ Siehe INSTALLATION.md für den vollständigen Ablauf.

Kurzfassung:

  1. ZIP entpacken und per FTP hochladen
  2. Domain aufrufen → Installer öffnet sich automatisch
  3. App-Name, URL, Admin-Zugangsdaten eingeben → fertig

23.3 Weiteres Gebäude anlegen

Jedes neue Gebäude ist eine eigenständige Kopie der App.

Schritt 1 – Verzeichnis einrichten

Lege auf dem Server ein neues Verzeichnis an (z. B. /www/lindenallee5/) und richte dafür eine Subdomain oder ein Unterverzeichnis ein:

lindenallee5.raumbuch.deine-domain.de

Bei All-Inkl.: Hosting-Panel → Domains → Subdomain hinzufügen → Document Root auf das neue Verzeichnis zeigen lassen.

Schritt 2 – Dateien kopieren

Wichtig: Kopiere nicht das bereits installierte Gebäude, sondern immer das saubere ZIP-Paket der aktuellen Version.

Entpacke das ZIP und lade alle Dateien per FTP in das neue Verzeichnis hoch.

Die Datei database/database.sqlite ist nach der Installation gebäudespezifisch und darf nicht von einer anderen Instanz kopiert werden.

Schritt 3 – Browser aufrufen und installieren

Rufe die neue URL auf:

https://lindenallee5.raumbuch.deine-domain.de

Der Installer öffnet sich automatisch. Trage ein:

  • App-Name: z. B. RaumReport – Lindenallee 5
  • URL: wird automatisch erkannt
  • Admin-Zugangsdaten: können pro Gebäude identisch oder unterschiedlich sein

Der Installer legt eine neue, leere Datenbank an.

Schritt 4 – Benutzer einrichten (optional)

Melde dich als Admin an und lege unter Benutzer Redakteure und Betrachter für dieses Gebäude an.

Tipp: Benutzerkonten sind nicht instanzübergreifend. Jede App-Instanz hat ihre eigene Benutzerverwaltung. Wenn du für alle Gebäude dieselben Zugangsdaten verwenden möchtest, lege sie in jeder Instanz einmal an.

23.4 Update einspielen

Wenn eine neue RaumReport-Version erscheint, wird jede Gebäude-Instanz einzeln aktualisiert. Pro Gebäude dauert der Update-Vorgang ca. 2–3 Minuten.

Was beim Update erhalten bleibt

Inhalt Speicherort Erhalten?
Raumdaten, Benutzer, Einstellungen database/database.sqlite ✅ Ja
Fotos und Logos storage/app/public/ ✅ Ja
Import-Dateien (TAB) storage/app/private/ ✅ Ja
Konfiguration .env ✅ Ja
App-Code alle anderen Dateien ♻️ wird ersetzt

Update-Ablauf

Schritt 1 – Sicherung anlegen

Vor dem Update die gebäudespezifischen Daten sichern:

database/database.sqlite   ← Datenbank
storage/app/public/        ← Fotos und Logos
.env                       ← Konfiguration

Per FTP herunterladen oder im Hosting-Panel archivieren.

Schritt 2 – Neue Dateien hochladen

Entpacke das neue ZIP-Paket. Lade alle Dateien per FTP hoch und überschreibe dabei alles – mit zwei Ausnahmen:

Datei/Ordner Aktion
database/database.sqlite Nicht überschreiben (enthält Raumdaten)
storage/app/public/ Nicht überschreiben (enthält Fotos)
storage/app/private/ Nicht überschreiben (enthält Importe)
.env Nicht überschreiben (enthält Konfiguration)
Alle anderen Dateien Normal überschreiben

Bei FTP-Programmen wie FileZilla: Im Upload-Dialog „Überschreiben" wählen, aber vorher die vier oben genannten Pfade aus der Auswahl entfernen.

Schritt 3 – Migrationen ausführen

Nach dem Hochladen muss einmalig die Datenbank auf den neuen Stand gebracht werden.

Option A – Im Browser (empfohlen für Shared Hosting):

Rufe die Gebäude-URL auf:

https://lindenallee5.raumbuch.deine-domain.de

Falls Datenbankänderungen vorliegen, erscheint automatisch ein Hinweis. Die App führt ausstehende Migrationen beim ersten Aufruf durch.

Hinweis: Diese automatische Migration ist ab Version 2.5 aktiv.

Option B – Per SSH (falls verfügbar):

cd /pfad/zum/gebaeude
php artisan migrate --force
php artisan config:clear
php artisan cache:clear

Schritt 4 – Prüfen

  • Seite aufrufen und einloggen
  • Raumliste aufrufen und prüfen ob Daten vorhanden
  • Eine PDF-Vorschau aufrufen

Dasselbe für jedes weitere Gebäude wiederholen.

Update-Checkliste (schnelle Referenz)

☐ Sicherung anlegen (database.sqlite + storage/ + .env)
☐ Neues ZIP entpacken
☐ FTP: alle Dateien hochladen AUSSER database/ + storage/ + .env
☐ Browser: Gebäude-URL aufrufen → Migrationen laufen automatisch
☐ Login testen
☐ Nächstes Gebäude → von vorne

23.5 Gebäude löschen

Das Löschen einer Gebäude-Instanz ist endgültig und kann nicht rückgängig gemacht werden.

Schritt 1 – Backup (empfohlen)

Bevor Du löschst, die Daten sichern:

  • database/database.sqlite herunterladen
  • storage/app/public/ herunterladen (Fotos)

Schritt 2 – Verzeichnis löschen

Lösche das gesamte Verzeichnis des Gebäudes auf dem Server, z. B. /www/lindenallee5/.

Bei All-Inkl.: Hosting-Panel → FTP & Dateimanager → Verzeichnis markieren und löschen.

Schritt 3 – Subdomain entfernen (optional)

Falls eine eigene Subdomain vergeben war: Hosting-Panel → Domains → Subdomain löschen.

23.6 Daten zwischen Gebäuden übertragen

Wenn Räume, Benutzer oder Einstellungen von einer Instanz in eine andere übertragen werden sollen, gibt es zwei Wege:

Weg A – Archiv-Export/Import

In der Quell-Instanz: Exporte → Gebäudearchiv herunterladen (ZIP)

In der Ziel-Instanz: Oben rechts auf der Gebäude-Übersicht: Gebäude aus Archiv importieren

Das Archiv enthält alle Raumdaten, Fotos, Revisionen und Einstellungen des Gebäudes.

Weg B – Datenbank direkt kopieren

Nur für Fortgeschrittene und nur zwischen identischen Versionen.

  1. In der Quell-Instanz: database/database.sqlite herunterladen
  2. In der Ziel-Instanz: bestehende database.sqlite ersetzen
  3. Browser: neue URL aufrufen, Migrationen werden automatisch ausgeführt (falls nötig)

Achtung: Benutzerkonten und App-Einstellungen sind in der Datenbank enthalten und werden mitkopiert.

23.7 Tipps für All-Inkl.

Subdomains für jedes Gebäude

All-Inkl. unterstützt beliebig viele Subdomains im Hosting-Paket. Empfohlene Namenskonvention:

musterstrasse12.raumbuch.deine-domain.de
lindenallee5.raumbuch.deine-domain.de

Oder als Unterverzeichnisse (ohne eigene Subdomain):

deine-domain.de/raumbuch/musterstrasse12/
deine-domain.de/raumbuch/lindenallee5/

Speicherplatz

Jede Instanz benötigt:

  • App-Code: ~50 MB
  • Datenbank: ~1–5 MB (wächst kaum)
  • Fotos: je nach Projekt, typisch 10–200 MB

Bei 10 Gebäuden ca. 600 MB–2 GB Gesamtbedarf — das All-Inkl.-Paket „All-Inkl. Plus" (10 GB) reicht problemlos.

PHP-Version

Alle Instanzen müssen dieselbe PHP-Version nutzen. PHP 8.2 einstellen: Hosting-Panel → PHP & MySQL → PHP-Version 8.2

23.8 Häufige Fragen

Kann ich alle Gebäude mit demselben Admin-Passwort verwalten? Ja. Da die Benutzerdaten in jeder Instanz separat gespeichert sind, musst Du das Passwort nur einmal pro Gebäude setzen. Es empfiehlt sich, für alle Instanzen denselben Admin-Benutzernamen und dasselbe Passwort zu verwenden, damit Du Dich nicht jedes Mal etwas anderes merken musst.

Kann ich ein Gebäude umbenennen? Ja. Als Admin: Gebäudedetails → Name ändern und speichern.

Muss ich nach dem Update die Python-Scripts neu herunterladen? Nur wenn sich das Script-Format geändert hat (steht in den Update-Hinweisen). Im Zweifel: unter Bauteile-Import → Script herunterladen das Script einmalig neu herunterladen.

Was passiert, wenn ich beim Update versehentlich die Datenbank überschreibe? Die vorhandene Sicherung einspielen: leere database.sqlite aus dem ZIP löschen, gesicherte Datei hochladen, Migrationen erneut ausführen (Schritt 3 oben).

Gibt es eine zentrale Verwaltung für alle Gebäude? Nein – jede Instanz ist bewusst eigenständig. Eine übergreifende Verwaltungs-Oberfläche ist nicht geplant.

24. Rollen und Rechte im Überblick

Funktion Betrachter Redakteur Fachredakteur Admin
Dashboard und Projekte ansehen ✓ ✓ ✓ ✓
Räume ansehen, PDF/Excel/ZIP exportieren ✓ ✓ ✓ ✓
Räume bearbeiten – ✓ ✓ (Abschnitte) ✓
Fotos hochladen / löschen – ✓ ✓ ✓
Revisions anlegen / einfrieren – ✓ ✓ ✓
Verteiler pflegen – ✓ ✓ ✓
Import starten – – – ✓
LP-/Raumtyp-Einstellungen – ✓ – ✓
Auswahllisten bearbeiten – ✓ – ✓
Projekte anlegen / bearbeiten / löschen – – – ✓
Grundriss-Import – ✓ – ✓
Projektarchiv exportieren / importieren – – – ✓
JSON / Python exportieren – ✓ – ✓
Feldänderungen freigeben – – – ✓
Globale Auswahllisten – – – ✓
Layout-Vorlagen bearbeiten – ✓ – ✓
Benutzerverwaltung – – – ✓
Einstellungen – – – ✓

25. Häufige Fragen

Import

Die Datei wird nicht akzeptiert. → Prüfen Sie, ob die Datei TAB-getrennt (nicht Komma oder Semikolon) und als .txt gespeichert ist. Öffnen Sie sie in einem Texteditor und prüfen Sie, ob Spalten durch Tabs getrennt sind.

Räume fehlen nach dem Import. → Die Raumnummer-Spalte wurde nicht erkannt. Stellen Sie sicher, dass eine Spalte Raumnummer oder Zone Number existiert und in jeder Zeile befüllt ist.

Manuell geänderte Werte wurden beim Reimport überschrieben. → Das kann vorkommen, wenn der Wert über das Bearbeiten-Formular nicht gespeichert wurde. Nur Felder mit dem ✎-Symbol sind geschützt.

Wo finde ich die Import-Protokolldetails? → Projektseite → Seitenleiste Import-Verlauf → Klick auf den Import → Aufklappbares Protokoll auf der Import-Detailseite.

PDF

Das PDF ist leer / zeigt keine Fotos. → Fotos müssen über das Bearbeiten-Formular hochgeladen werden. Prüfen Sie, ob der Speicher-Symlink gesetzt ist: php artisan storage:link im Projektverzeichnis.

Das PDF dauert sehr lange. → Bei > 50 Räumen kann der Export 30–120 Sekunden dauern. Das ist normal. Nutzen Sie den ZIP-Export für einzelne Räume.

Das Wasserzeichen soll nicht erscheinen. → Einstellungen → PDF-Wasserzeichen leeren → Speichern. Oder in der Layout-Vorlage das Wasserzeichen-Feld leeren.

Benutzer

Ich habe mein Passwort vergessen. → Admin kann das Passwort in der Benutzerverwaltung zurücksetzen (Benutzer bearbeiten → neues Passwort eingeben).

Ich bin der einzige Admin und habe mich ausgesperrt. → Passwort via Kommandozeile zurücksetzen:

php artisan tinker
\App\Models\User::where('email','ihre@email.de')->first()->update(['password'=>bcrypt('neues-passwort')]);

Ein Redakteur sieht kein Projekt. → Admin → Benutzer → Benutzer bearbeiten → Abschnitt Projektzugang → Projekt aktivieren.

Leistungsphasen

Der LP-Schnellumschalter erscheint nicht in der Kopfzeile. → Leistungsphasen müssen erst aktiviert werden: Projektseite → LP-Einstellungen → Checkbox Leistungsphasen aktivieren → Speichern.

Felder verschwinden, obwohl Leistungsphasen nicht aktiv sein sollen. → Prüfen Sie, ob in den LP-Einstellungen versehentlich Haken gesetzt wurden. Leistungsphasen-Filter wirken sich nur aus, wenn ein bestimmter LP ausgewählt ist. Bei „Alle anzeigen" sind alle Felder sichtbar.

Reimport

Das Python-Script findet Archicad nicht. → Archicad muss beim Ausführen des Scripts geöffnet und die Projektdatei muss geladen sein. Die Archicad Connection API muss aktiviert sein (Archicad → Voreinstellungen → Verbindungen).

„Kein Reimport möglich" – Kacheln grau. → Die ursprüngliche TAB-Exportdatei enthielt keine Archicad-GUIDs. Exportieren Sie in Archicad erneut mit der Spalte Eindeutige ID und importieren Sie in RaumReport neu.

RaumReport · Technische Basis: Laravel 12 · PHP 8.2 · SQLite · mPDF · Alpine.js · Tailwind CSS

© b-prisma · Joachim Sühlo · raumreport.de
Stand 19.05.2026 · Version 2.9.0