01Was das ist
RevitCDE ist eine Common-Data-Environment-Lösung für Revit-Projekte.
Es bindet Nutzeraktionen an konkrete Modellobjekte.
Einen prüfbaren digitalen Kreislauf aufbauen.
02Für wen
RevitCDE adressiert mehrere unterschiedliche Rollen.
BIM-Koordinator / Projektleiter
Sieht den Zustand von Modell, Genehmigungen, Dokumenten und Aufgaben.
Autor (Planer)
Arbeitet in Revit ohne ständigen Kontextwechsel.
Freigebender
Prüft eingehende Anfragen mit Snapshot und Dokumenten.
Betrachter
Lesezugriff im Rahmen des Projekts.
Kalkulator
Kostenvoranschlagsdatenbank, Positionen, modellunabhängige Kosten.
Planungsingenieur
Zeitplan, Aktivitäten, modellunabhängige Zeitprozesse.
Administrator
Server, Nutzer, Projekte, Datenbanken, Richtlinien.
03Gelöste Probleme
Lücke zwischen Revit und Verwaltungsprozessen
Genehmigungen und Aufgaben existieren getrennt vom Modell.
Das Plugin erfasst Modelldaten und verknüpft Anfragen mit Objekten.
Keine einzige zuverlässige Datenquelle
Dateien, E-Mails und Tabellen weichen in ihren Versionen voneinander ab.
Eine CDE-Struktur speichert Projekte, Dokumente, Versionen und Verlauf.
Undurchsichtige Genehmigungen
Entscheidungen gehen verloren, und Routen sind informell.
ApprovalRequest, mehrstufige Routen, nur anfügende Ereignisse, unveränderliche Snapshots.
Modellstatus in Revit nicht sichtbar
Der Planer sieht nicht, was genehmigt, in Bearbeitung oder abgelehnt ist.
Status werden in Shared Parameters und Extensible Storage gespiegelt.
3D, 4D und 5D nicht verbunden
Kostenvoranschlag und Zeitplan werden getrennt geführt; Arbeiten außerhalb des Modells geraten aus dem Blick.
estimate.db und schedule.db je Projekt, WorkPackage als 4D/5D-Hub.
Offline-/lokale Arbeit ohne Server
Getrennte Modelle benötigen lokalen Speicher, ohne den Weg zum Server zu verlieren.
Lokaler Modus in Extensible Storage, optionale externe einzeldateibasierte DB, spätere Migration zum Server.
04Funktionsweise
Drei Schichten bilden einen einzigen Datenkreislauf.
- Der Nutzer arbeitet in Revit. Das Plugin liest Modellelemente, Blätter, Ansichten, Stücklisten und Status.
- Das Modell wird an ein Serverprojekt gebunden. Die Bindung wird über Extensible Storage in der RVT-Datei gespeichert.
- Das Plugin synchronisiert Projektelemente, Modellelemente, Änderungen, Status, Anfragen, Aufgaben, Chats und Dokumente mit dem Server.
- Der Server speichert globale Daten in der Hauptdatenbank und fachliche Daten in projektbezogenen Datenbanken: model_{guid}.db, disciplines.db, estimate.db, schedule.db.
- Das Web-Cabinet bietet Zugriff auf Projekte, Dokumente, Genehmigungen, Aufgaben, Chats und Verwaltung; Echtzeitaktualisierungen laufen über SignalR.
- Entscheidungen der Genehmigenden, Statusänderungen, verknüpfte Dokumente und Aufgaben kehren zu Revit zurück und werden im Plugin und in den Modellparametern angezeigt.
Der Server ist die maßgebliche Quelle für den kollaborativen Modus; das Modell speichert weiterhin die minimale Bindung und lokale Daten, damit die Arbeit bei Revit-Neustarts und in Offline-Phasen erhalten bleibt.
05Funktion
Die Funktionsübersicht auf einen Blick.
Projekte
Projekteinrichtung, Mitglieder, Rollen, Standards, Fachrichtungen, Phasen, Pakete.
Modell
RVT-Bindung, Synchronisierung, Kennungen, Fingerprint, Status, Änderungsverfolgung.
Freigaben
Anfragen, Routen, Snapshots, Entscheidungen, Rückzug, Protokoll, Echtzeit.
Dokumente
CDE-Dokumente, Versionen, Hoch-/Herunterladen, SHA-256, WIP→Shared→Published→Archived.
Aufgaben
Kanban, Gantt, Wichtigkeit, Status, Zuständige, Aufgabenbeziehungen.
Kommunikation
Projektchats, Nachrichten, Reaktionen, Korrespondenz, E-Mail-Integration.
Administration
Nutzer, Rollen, Serverparameter, Datenbanken, Systemzustand, Autorisierungsrichtlinien.
4D/5D
Kostenvoranschlag, Zeitplan, WorkPackage, Mengensnapshots, EVM/CPM.
Lokale Arbeit
Extensible Storage, optionale externe lokale DB, Migration zum Server.
Lokalisierung
Zentralisierte UI-Lokalisierung, 22 Sprachen laut Roadmap.
06Nutzungsszenarien
Einreichung eines Blatts oder einer Ansicht zur Genehmigung
- Schritt 1
- Schritt 2
- Schritt 3
- Schritt 4
- Schritt 5
- Schritt 6
Ein Dokument von WIP bis zur Veröffentlichung
- Schritt 1
- Schritt 2
- Schritt 3
- Schritt 4
- Schritt 5
Verknüpfung von Modell, Kostenvoranschlag und Zeitplan
- Schritt 1
- Schritt 2
- Schritt 3
- Schritt 4
- Schritt 5
07Häufig gestellte Fragen
Frage 1
Antwort 1
Frage 2
Antwort 2
Frage 3
Antwort 3
Frage 4
Antwort 4
Frage 5
Antwort 5
Frage 6
Antwort 6
Frage 7
Antwort 7
Frage 8
Antwort 8
Frage 9
Antwort 9
Frage 10
Antwort 10
Nachfolgend die technische Ebene für Leser, die den Aufbau von RevitCDE sehen möchten.
08Zusammensetzung der Lösung
| Komponente | Zweck | Technologie |
|---|---|---|
RevitCDE.Addin | Einstiegspunkt des Revit-Add-ins, Modellbindung und Befehlsregistrierung. | C# /.NET Framework, Autodesk Revit API |
RevitCDE.UI | Desktop-Panels, Befehle und Nutzerinteraktion innerhalb von Revit. | WPF / MVVM |
RevitCDE.Core | Anwendungsdienste, Synchronisierung, lokale Speicherung und Serverkommunikation. | C#-Dienste, HTTP-Clients, SQLite |
RevitCDE.Domain | Gemeinsame Domänenmodelle, Kennungen, Status und Geschäftsregeln. | netstandard2.0-Bibliothek |
RevitCDE.Server | Zentrale API, Authentifizierung, Projektdaten und Integrationsdienste. | ASP.NET Core 8, EF Core, PostgreSQL |
RevitCDE.Cabinet | Web-Cabinet für Projekte, Dokumente, Genehmigungen, Aufgaben, Chats und Verwaltung. | TypeScript / React Web-UI |
RevitCDE.Localization | Zentrale Übersetzungswörterbücher und Sprachumschaltung für die gesamte sichtbare UI. | JSON-Wörterbücher, gemeinsame i18n-Schlüssel |
09Lokaler und Servermodus
RevitCDE unterstützt zwei Laufzeitmodi.
Lokaler Modus
Daten werden in der Extensible Storage des Modells gespeichert.
Externer lokaler Speicher
Eine separate Datenbankdatei pro RVT-Modell.
Servermodus
Aktive Daten werden auf dem Server gespeichert.
Migrationsregeln vom lokalen zum Servermodus.
10Speicherarchitektur
| Speicher | Was gespeichert wird | Warum es so funktioniert |
|---|---|---|
| Haupt-DB des Servers | Nutzer, Organisationen, Projekte, Rollen, globale Einstellungen und Lizenzdaten. | Hält projektübergreifende Daten in einer maßgeblichen Serverdatenbank. |
| model_{guid}.db | Modellelemente, Blätter, Ansichten, Stücklisten, Mengen und Bindungen auf Modellebene. | Umfangreiche Modelldaten sind aus Performance- und Wartungsgründen pro RVT-Modell isoliert. |
| disciplines.db | Projektfachrichtungen, Phasen, Pakete und standardspezifische Dokumentationsstruktur. | Projektstandards können sich weiterentwickeln, ohne das globale Schema zu ändern. |
| estimate.db | Kostenvoranschlagsdokumente, Positionen, modellunabhängige Kosten, Mengenverknüpfungen und WorkPackage-Bindungen. | Kostendaten haben einen eigenen Lebenszyklus und müssen Positionen enthalten, die nicht im Modell vorhanden sind. |
| schedule.db | Zeitplanaktivitäten, Abhängigkeiten, modellunabhängige Zeitprozesse und WorkPackage-Verknüpfungen. | Planungsdaten benötigen CPM/Gantt-Logik und können sich sowohl auf Modell- als auch auf Kostenvoranschlagsdaten beziehen. |
| Extensible Storage | Minimale Modellbindung, technische Kennungen und lokale Ersatzdaten innerhalb der RVT-Datei. | Das Modell bleibt auch außerhalb der Serverumgebung selbst identifizierbar. |
| Externe lokale DB | Optionale einzeldateibasierte lokale Datenbank für Chats, Genehmigungen, Dokumente, Aufgaben und andere lokale Daten. | Getrennte/lokale Modelle können umfangreichere Daten speichern, ohne die Extensible Storage aufzublähen. |
11Sicherheit und Zugriff
Die Sicherheit basiert auf Mitgliedschaft, Rollen, JWT und Vertrauensmodi.
12Genehmigungen — im Detail
Ein formalisierter, reproduzierbarer Prozess.
Zur Freigabe einreichen
Erstellt eine Freigabeanfrage für die ausgewählte Modellrevision oder das ausgewählte Dokumentpaket.
Unveränderlicher Schnappschuss
Erfasst den exakten geprüften Modell- und Dokumentstand, damit die Entscheidung nachvollziehbar bleibt.
Freigabewege
Definiert sequenzielle oder parallele Prüfschritte, verantwortliche Beteiligte und erforderliche Entscheidungen.
Erfasste Entscheidungen
Speichert Freigaben, Ablehnungen, Rückgaben und Kommentare zusammen mit Autor und Zeitstempel.
Ereignisverlauf
Führt eine nur erweiterbare Zeitleiste von Einreichungen, Zuweisungen, Entscheidungen und Statusänderungen.
Statussynchronisierung
Überträgt den bestätigten Freigabestatus zurück an die Projektobjekte und den verbundenen Revit-Arbeitsablauf.
Echtzeitaktualisierungen
Übermittelt Freigabeänderungen an verbundene Clients, ohne dass die Seite manuell aktualisiert werden muss.
13WorkPackage — der 4D/5D-Hub
Das zentrale Objekt, das Modell, Mengen, Kostenvoranschlag, Zeitplan und Fortschritt verknüpft.
ModelElement |
Verknüpft das Arbeitspaket mit BIM-Elementen und deren stabilen Kennungen. |
QuantityItem |
Speichert gemessene Mengen und die Quelle, aus der jede Menge ermittelt wurde. |
EstimateItem |
Verknüpft Mengen mit Kostenpositionen, Einheitspreisen und berechneten Kosten. |
WorkPackage |
Dient als zentrales Objekt, das Umfang, Modell, Kosten, Terminplan, Verantwortung und Nachweise verbindet. |
ScheduleActivity |
Verknüpft das Arbeitspaket mit geplanten Vorgängen, Terminen, Abhängigkeiten und Daten des kritischen Pfads. |
ProgressSnapshot |
Speichert tatsächlichen Fortschritt, Earned-Value-Kennzahlen und Fakten des Berichtszeitraums. |
Projektdatenbanken sind nach Fachbereichen unterteilt.
14Standards, Fachrichtungen, Phasen, Pakete
Der Projektstandard bestimmt die Formate für Dokumentation, Kostenvoranschlag und Zeitplan.
ProjectStandard
Definiert die aktiven Projektregeln, Benennungskonventionen und die erforderliche Informationsstruktur.
Discipline
Verwaltet den Katalog der Projektfachdisziplinen und die fachspezifischen Verantwortlichkeiten.
PackageType
Definiert wiederverwendbare Paketstrukturen für Planung, Beschaffung und Bauausführung.
ProjectStage
Steuert Projektphasen, Phasenübergänge und die in jeder Phase erwarteten Daten.
ProjectRole
Definiert Verantwortung, Berechtigungen und Freigabekompetenz innerhalb des Projekts.
StandardPreset
Wendet ein wiederverwendbares Paket aus Standards, Fachdisziplinen, Phasen, Rollen und Pakettypen an.
15REST API — Hauptgruppen
REST API nach Fachbereich, JWT-authentifiziert.
-
`/api/auth/*`· Authentifizierung, Kontositzungen, Passwortwiederherstellung und Zugriffstoken. -
`/api/approvals/*`· Freigabeanfragen, Freigabewege, Entscheidungen, Kommentare und Statusänderungen. -
`/api/cde/*`· Projekte, Modelle, Dokumente, Probleme und gemeinsam genutzte Projektdaten. -
`/api/chats/*`· Projektunterhaltungen, Beteiligte, Nachrichten und Anhänge. -
`/api/tasks/*`· Aufgaben, Verantwortliche, Fälligkeitstermine, Prioritäten und Erledigungsstatus. -
`/api/standards/*`· Projektstandards, Fachdisziplinen, Phasen, Rollen und Paketvorgaben. -
`/api/45d/*`· Arbeitspakete, Mengen, Kostenschätzungen, Terminplanvorgänge und Fortschritt. -
`/api/admin/*`· Administration, Konfiguration, Diagnose und kontrollierte Wartungsvorgänge.
16Glossar
CDE- Common Data Environment — ein kontrollierter Raum für Projektinformationen, Kommunikation und Entscheidungen.
Extensible Storage- Revit-Mechanismus zum Speichern strukturierter Anwendungsdaten innerhalb eines Modells.
Gemeinsame Parameter- Revit-Parameter, die über eine gemeinsame Definitionsdatei projekt- und familienübergreifend genutzt werden.
ProjectElement- Ein projektseitiger Datensatz, der ein BIM-Element außerhalb des Revit-Dokuments repräsentiert.
ModelElement- Ein stabiler Verweis auf ein Element in einem bestimmten Modell und einer bestimmten Modellrevision.
Momentaufnahme- Ein unveränderlicher Datensatz des exakten Projektinformationsstands, der für Prüfung oder Freigabe verwendet wurde.
ApprovalRequest- Eine formelle Anfrage, die einen festgelegten Umfang durch einen Freigabeprozess leitet.
WorkPackage- Das zentrale 4D/5D-Objekt, das Umfang, Mengen, Kosten, Terminplan und Verantwortung verbindet.
EVM- Earned Value Management — Fortschrittsmessung anhand von Planwert, Fertigstellungswert und Istkosten.
CPM- Critical Path Method — Terminplananalyse auf Grundlage von Vorgangsabhängigkeiten und verfügbarem Puffer.
17Was als Nächstes kommt
Die aktuelle Implementierung verfügt über einen funktionierenden Kern; nachfolgend die Weiterentwicklungsrichtungen.
Erweiterte Lokalisierung
Vollständige Terminologieprüfung und fachspezifische Formulierungen für jede unterstützte Sprachversion.
Dokumenten-Workflows
Versionierte Dokumentregister, Übermittlungen, Prüfpakete und Nachweisketten.
Vertiefte 4D/5D-Funktionen
Detailliertere Arbeitspaketplanung, Kostenkontrolle, Fortschrittsprognose und Earned-Value-Analyse.
BCF-Interoperabilität
Tauschen Sie Probleme und Standpunkte über den BCF-Standard mit anderen BIM-Anwendungen aus.
Koordination verknüpfter Modelle
Verknüpfte Modelle, Zuständigkeiten, Revisionen und modellübergreifende Abhängigkeiten koordinieren.
Beobachtbarkeit
Operative Dashboards, Audit-Kennzahlen, Diagnosen und Überwachung des Dienstzustands.