Licentie-API · 99,98 %
Documentatie

RevitCDE — overzicht van de oplossing

Een Common Data Environment voor Revit-projecten.

RevitCDE
Voor kopers

01Wat dit is

RevitCDE is een Common Data Environment voor Revit-projecten.

Het koppelt gebruikersacties aan concrete modelobjecten.

Kernidee

Een controleerbare digitale lus bouwen.

Voor kopers

02Voor wie

RevitCDE richt zich op verschillende specifieke rollen.

BIM-coördinator / Projectmanager

Ziet de status van model, goedkeuringen, documenten en taken.

Auteur (ontwerper)

Werkt in Revit zonder constante contextwisseling.

Goedkeurder

Beoordeelt inkomende aanvragen met opname en documenten.

Lezer

Leestoegang binnen projectscope.

Calculator

Begrotingsdatabase, regelposten, niet-modelkosten.

Planningsingenieur

Planning, activiteiten, niet-modeltijdprocessen.

Beheerder

Server, gebruikers, projecten, databases, beleid.

Voor kopers

03Problemen die wij oplossen

Kloof tussen Revit en beheerprocessen

Waarom dit pijnlijk is

Goedkeuringen en taken bestaan los van het model.

Hoe wij dit oplossen

De plugin legt modelgegevens vast en koppelt aanvragen aan objecten.

Geen enkele bron van waarheid

Waarom dit pijnlijk is

Bestanden, e-mail en tabellen wijken per versie af.

Hoe wij dit oplossen

Een CDE-structuur bewaart projecten, documenten, versies en geschiedenis.

Ondoorzichtige goedkeuringen

Waarom dit pijnlijk is

Beslissingen gaan verloren en routes zijn informeel.

Hoe wij dit oplossen

ApprovalRequest, meertraps routes, alleen-toevoegen-gebeurtenissen, onveranderlijke opnames.

Modelstatus niet zichtbaar in Revit

Waarom dit pijnlijk is

De ontwerper ziet niet wat is goedgekeurd, in behandeling of afgewezen.

Hoe wij dit oplossen

Statussen worden weerspiegeld in Shared Parameters en Extensible Storage.

3D, 4D en 5D niet gekoppeld

Waarom dit pijnlijk is

Begroting en planning worden apart bijgehouden; werkzaamheden buiten het model vallen buiten beeld.

Hoe wij dit oplossen

estimate.db en schedule.db per project, WorkPackage als 4D/5D-hub.

Offline/lokaal werken zonder server

Waarom dit pijnlijk is

Losgekoppelde modellen hebben lokale opslag nodig zonder het pad naar de server te verliezen.

Hoe wij dit oplossen

Lokale modus in Extensible Storage, optionele externe eenbestandsdatabase, latere migratie naar de server.

Voor kopers

04Hoe het werkt

Drie lagen vormen één datalus.

  1. De gebruiker werkt in Revit. De plugin leest modelelementen, bladen, weergaven, specificaties en statussen.
  2. Het model wordt gekoppeld aan een project op de server. De koppeling wordt binnen het RVT-model opgeslagen via Extensible Storage.
  3. De plugin synchroniseert projectelementen, modelelementen, wijzigingen, statussen, aanvragen, taken, chats en documenten met de server.
  4. De server bewaart globale gegevens in de hoofddatabase, en vakspecifieke gegevens in databases per project: model_{guid}.db, disciplines.db, estimate.db, schedule.db.
  5. Het webkabinet biedt toegang tot projecten, documenten, goedkeuringen, taken, chats en beheer; realtime updates worden via SignalR verzonden.
  6. Beslissingen van goedkeurders, statuswijzigingen, gekoppelde documenten en taken keren terug naar Revit en worden weergegeven in de plugin en modelparameters.
Architectonisch principe

De server is de bron van waarheid voor de samenwerkingsmodus; het model bewaart nog steeds een minimale koppeling en lokale gegevens, zodat het werk behouden blijft bij het herstarten van Revit en tijdens offline periodes.

Voor kopers

05Wat het doet

De functionele kaart in één oogopslag.

Projecten

Projectinstelling, deelnemers, rollen, normen, disciplines, fasen, sets.

Model

RVT-koppeling, synchronisatie, identifiers, fingerprint, statussen, wijzigingsregistratie.

Goedkeuringen

Aanvragen, routes, opnames, beslissingen, intrekking, logboek, realtime.

Documenten

CDE-documenten, versies, uploaden/downloaden, SHA-256, WIP→Shared→Published→Archived.

Taken

Kanban, Gantt, belangrijkheid, statussen, uitvoerders, taakrelaties.

Communicatie

Projectchats, berichten, reacties, correspondentie, e-mailintegratie.

Beheer

Gebruikers, rollen, serverparameters, databases, systeemstatus, autorisatiebeleid.

4D/5D

Begroting, planning, WorkPackage, hoeveelheidsopnames, EVM/CPM.

Lokaal werken

Extensible Storage, optionele externe lokale database, migratie naar de server.

Lokalisatie

Gecentraliseerde UI-lokalisatie, 22 talen volgens de roadmap.

Voor kopers

06Gebruiksscenario's

Een blad of weergave indienen voor goedkeuring

  1. Stap 1
  2. Stap 2
  3. Stap 3
  4. Stap 4
  5. Stap 5
  6. Stap 6

Een document van WIP tot publicatie

  1. Stap 1
  2. Stap 2
  3. Stap 3
  4. Stap 4
  5. Stap 5

Koppeling van model, begroting en planning

  1. Stap 1
  2. Stap 2
  3. Stap 3
  4. Stap 4
  5. Stap 5
Voor kopers

07Veelgestelde vragen

Vraag 1

Antwoord 1

Vraag 2

Antwoord 2

Vraag 3

Antwoord 3

Vraag 4

Antwoord 4

Vraag 5

Antwoord 5

Vraag 6

Antwoord 6

Vraag 7

Antwoord 7

Vraag 8

Antwoord 8

Vraag 9

Antwoord 9

Vraag 10

Antwoord 10

Technische details

Hieronder de technische laag voor lezers die willen zien hoe RevitCDE is opgebouwd.

Technische details

08Samenstelling van de oplossing

Component Doel Technologie
RevitCDE.AddinToegangspunt van de Revit-plugin, modelkoppeling en commandoregistratie.C# /.NET Framework, Autodesk Revit API
RevitCDE.UIDesktoppanelen, commando's en gebruikersinteractie binnen Revit.WPF / MVVM
RevitCDE.CoreApplicatieservices, synchronisatie, lokale opslag en servercommunicatie.C#-services, HTTP-clients, SQLite
RevitCDE.DomainGedeelde domeinmodellen, identifiers, statussen en bedrijfsregels.netstandard2.0-bibliotheek
RevitCDE.ServerCentrale API, authenticatie, projectgegevens en integratiediensten.ASP.NET Core 8, EF Core, PostgreSQL
RevitCDE.CabinetWebkabinet voor projecten, documenten, goedkeuringen, taken, chats en beheer.TypeScript / React web-UI
RevitCDE.LocalizationCentrale vertaalwoordenboeken en taalwisseling voor alle zichtbare UI.JSON-woordenboeken, gedeelde i18n-sleutels
Technische details

09Lokale en servermodi

RevitCDE ondersteunt twee runtime-modi.

Lokale modus

Gegevens worden opgeslagen in de Extensible Storage van het model.

Externe lokale opslag

Een apart databasebestand voor elk RVT-model.

Servermodus

Actieve gegevens worden op de server opgeslagen.

Lokale & servermodi

Migratieregels van lokale modus naar servermodus.

Technische details

10Opslagarchitectuur

Opslag Wat het opslaat Waarom het zo werkt
Hoofddatabase van de serverGebruikers, organisaties, projecten, rollen, globale instellingen en licentiegegevens.Bewaart projectoverstijgende gegevens in één gezaghebbende serverdatabase.
model_{guid}.dbModelelementen, bladen, weergaven, schema's, hoeveelheden en koppelingen op modelniveau.Grote modelgegevens zijn geïsoleerd per RVT-model voor prestaties en onderhoud.
disciplines.dbProjectdisciplines, fasen, pakketten en normspecifieke documentatiestructuur.Projectnormen kunnen zich ontwikkelen zonder het globale schema te wijzigen.
estimate.dbBegrotingsdocumenten, posities, niet-modelkosten, hoeveelheidkoppelingen en WorkPackage-koppelingen.Kostengegevens hebben hun eigen levenscyclus en moeten items bevatten die niet in het model aanwezig zijn.
schedule.dbPlanningsactiviteiten, afhankelijkheden, niet-modeltijdprocessen en WorkPackage-koppelingen.Planningsgegevens vereisen CPM/Gantt-logica en kunnen zowel naar model- als begrotingsgegevens verwijzen.
Extensible StorageMinimale modelkoppeling, technische identifiers en lokale terugvalgegevens binnen RVT.Het model blijft zelfidentificerend, zelfs buiten de serveromgeving.
Externe lokale databaseOptionele eenbestandsdatabase voor chats, goedkeuringen, documenten, taken en andere lokale gegevens.Losgekoppelde/lokale modellen kunnen rijkere gegevens bewaren zonder Extensible Storage op te blazen.
Technische details

11Beveiliging en toegang

Beveiliging is opgebouwd rond lidmaatschap, rollen, JWT en vertrouwensmodi.

  • JWT-authenticatie.
  • Veilige wachtwoordhashes; creatie van de beheerder bij eerste installatie.
  • Inloggen via gebruikersnaam, e-mail of telefoon, indien geconfigureerd.
  • Gebruikerslogin — primaire modus.
  • Optionele werkstationmodus zonder wachtwoord.
  • Acties met een hoog vertrouwensniveau vereisen nog steeds een echte login.
  • Read / Write / Manage / Admin binnen het project.
Technische details

12Goedkeuringen — onder de motorkap

Een geformaliseerd, reproduceerbaar proces.

Ter goedkeuring indienen

Maakt een goedkeuringsverzoek voor de geselecteerde modelrevisie of het documentpakket.

Onveranderlijke momentopname

Legt de exacte model- en documentstatus vast die wordt beoordeeld, zodat het besluit reproduceerbaar blijft.

Goedkeuringsroutes

Definieert opeenvolgende of parallelle beoordelingsstappen, verantwoordelijke deelnemers en vereiste besluiten.

Vastgelegde besluiten

Slaat goedkeuringen, afwijzingen, retouren en opmerkingen op, inclusief auteur en tijdstip.

Gebeurtenisgeschiedenis

Bewaart een alleen-aanvulbare tijdlijn van inzendingen, toewijzingen, besluiten en statuswijzigingen.

Statussynchronisatie

Schrijft de bevestigde goedkeuringsstatus terug naar projectobjecten en de gekoppelde Revit-workflow.

Realtime-updates

Publiceert wijzigingen in goedkeuringen naar verbonden clients zonder handmatig vernieuwen.

Technische details

13WorkPackage — de 4D/5D-hub

Het centrale object dat model, hoeveelheden, begroting, planning en voortgang koppelt.

ModelElement Koppelt het werkpakket aan BIM-elementen en hun stabiele identifiers.
QuantityItem Slaat gemeten hoeveelheden en de bron van elke hoeveelheid op.
EstimateItem Verbindt hoeveelheden met begrotingsposten, eenheidsprijzen en berekende kosten.
WorkPackage Dient als centraal object dat scope, model, kosten, planning, verantwoordelijkheid en bewijs verbindt.
ScheduleActivity Koppelt het werkpakket aan geplande activiteiten, datums, afhankelijkheden en kritieke-padgegevens.
ProgressSnapshot Slaat werkelijke voortgang, earned-value-indicatoren en feiten per rapportageperiode op.
Waarom geen databaseoverschrijdende externe sleutel

Projectdatabases zijn verdeeld naar vakgebied.

Technische details

14Normen, disciplines, fasen, sets

De projectnorm bepaalt de formaten voor documentatie, begroting en planning.

ProjectStandard

Definieert actieve projectregels, naamgevingsconventies en de vereiste informatiestructuur.

Discipline

Beheert de projectdisciplinelijst en disciplinespecifieke verantwoordelijkheden.

PackageType

Definieert herbruikbare pakketstructuren voor ontwerp-, inkoop- en uitvoeringswerk.

ProjectStage

Beheert projectfasen, faseovergangen en de gegevens die per fase worden verwacht.

ProjectRole

Definieert verantwoordelijkheid, rechten en goedkeuringsbevoegdheid binnen het project.

StandardPreset

Past een herbruikbare bundel van standaarden, disciplines, fasen, rollen en pakkettypen toe.

Technische details

15REST API — belangrijkste groepen

REST API per vakgebied, JWT-geauthenticeerd.

  • `/api/auth/*` · Authenticatie, accountsessies, wachtwoordherstel en toegangstokens.
  • `/api/approvals/*` · Goedkeuringsverzoeken, routes, besluiten, opmerkingen en statuswijzigingen.
  • `/api/cde/*` · Projecten, modellen, documenten, issues en gedeelde projectgegevens.
  • `/api/chats/*` · Projectgesprekken, deelnemers, berichten en bijlagen.
  • `/api/tasks/*` · Taken, verantwoordelijken, deadlines, prioriteiten en voltooiingsstatussen.
  • `/api/standards/*` · Projectstandaarden, disciplines, fasen, rollen en pakketpresets.
  • `/api/45d/*` · Werkpakketten, hoeveelheden, ramingen, planningsactiviteiten en voortgang.
  • `/api/admin/*` · Beheer, configuratie, diagnostiek en gecontroleerde onderhoudswerkzaamheden.
Technische details

16Woordenlijst

CDE
Common Data Environment — een gecontroleerde omgeving voor projectinformatie, communicatie en besluiten.
Extensible Storage
Revit-mechanisme om gestructureerde toepassingsgegevens in een model op te slaan.
Shared Parameters
Revit-parameters die via één definitiebestand tussen projecten en families worden gedeeld.
ProjectElement
Een projectrecord dat een BIM-element buiten het Revit-document vertegenwoordigt.
ModelElement
Een stabiele verwijzing naar een element in een specifiek model en een specifieke modelrevisie.
Snapshot
Een onveranderlijk record van de exacte projectgegevensstatus die voor beoordeling of goedkeuring is gebruikt.
ApprovalRequest
Een formeel verzoek dat een afgebakende scope door een goedkeuringsroute stuurt.
WorkPackage
Het centrale 4D/5D-object dat scope, hoeveelheden, kosten, planning en verantwoordelijkheid verbindt.
EVM
Earned Value Management — voortgangsmeting met geplande waarde, verdiende waarde en werkelijke kosten.
CPM
Critical Path Method — planningsanalyse op basis van activiteitafhankelijkheden en beschikbare speling.
Technische details

17Wat eraan komt

De huidige implementatie heeft een werkende kern; hieronder wat we vervolgens ontwikkelen.

Uitgebreide lokalisatie

Volledige terminologiecontrole en domeinspecifieke formuleringen voor elke ondersteunde taal.

Documentworkflows

Geversioneerde documentregisters, transmittals, beoordelingspakketten en bewijsketens.

Verdiepte 4D/5D

Gedetailleerdere werkpakketplanning, kostenbeheersing, voortgangsprognoses en earned-value-analyse.

BCF-interoperabiliteit

Issues en gezichtspunten uitwisselen met andere BIM-toepassingen via de BCF-standaard.

Coördinatie van gekoppelde modellen

Gekoppelde modellen, eigenaarschap, revisies en modeloverschrijdende afhankelijkheden coördineren.

Observeerbaarheid

Operationele dashboards, auditstatistieken, diagnostiek en bewaking van de servicestatus.