01Wat dit is
RevitCDE is een Common Data Environment voor Revit-projecten.
Het koppelt gebruikersacties aan concrete modelobjecten.
Een controleerbare digitale lus bouwen.
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.
03Problemen die wij oplossen
Kloof tussen Revit en beheerprocessen
Goedkeuringen en taken bestaan los van het model.
De plugin legt modelgegevens vast en koppelt aanvragen aan objecten.
Geen enkele bron van waarheid
Bestanden, e-mail en tabellen wijken per versie af.
Een CDE-structuur bewaart projecten, documenten, versies en geschiedenis.
Ondoorzichtige goedkeuringen
Beslissingen gaan verloren en routes zijn informeel.
ApprovalRequest, meertraps routes, alleen-toevoegen-gebeurtenissen, onveranderlijke opnames.
Modelstatus niet zichtbaar in Revit
De ontwerper ziet niet wat is goedgekeurd, in behandeling of afgewezen.
Statussen worden weerspiegeld in Shared Parameters en Extensible Storage.
3D, 4D en 5D niet gekoppeld
Begroting en planning worden apart bijgehouden; werkzaamheden buiten het model vallen buiten beeld.
estimate.db en schedule.db per project, WorkPackage als 4D/5D-hub.
Offline/lokaal werken zonder server
Losgekoppelde modellen hebben lokale opslag nodig zonder het pad naar de server te verliezen.
Lokale modus in Extensible Storage, optionele externe eenbestandsdatabase, latere migratie naar de server.
04Hoe het werkt
Drie lagen vormen één datalus.
- De gebruiker werkt in Revit. De plugin leest modelelementen, bladen, weergaven, specificaties en statussen.
- Het model wordt gekoppeld aan een project op de server. De koppeling wordt binnen het RVT-model opgeslagen via Extensible Storage.
- De plugin synchroniseert projectelementen, modelelementen, wijzigingen, statussen, aanvragen, taken, chats en documenten met de server.
- De server bewaart globale gegevens in de hoofddatabase, en vakspecifieke gegevens in databases per project: model_{guid}.db, disciplines.db, estimate.db, schedule.db.
- Het webkabinet biedt toegang tot projecten, documenten, goedkeuringen, taken, chats en beheer; realtime updates worden via SignalR verzonden.
- Beslissingen van goedkeurders, statuswijzigingen, gekoppelde documenten en taken keren terug naar Revit en worden weergegeven in de plugin en modelparameters.
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.
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.
06Gebruiksscenario's
Een blad of weergave indienen voor goedkeuring
- Stap 1
- Stap 2
- Stap 3
- Stap 4
- Stap 5
- Stap 6
Een document van WIP tot publicatie
- Stap 1
- Stap 2
- Stap 3
- Stap 4
- Stap 5
Koppeling van model, begroting en planning
- Stap 1
- Stap 2
- Stap 3
- Stap 4
- Stap 5
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
Hieronder de technische laag voor lezers die willen zien hoe RevitCDE is opgebouwd.
08Samenstelling van de oplossing
| Component | Doel | Technologie |
|---|---|---|
RevitCDE.Addin | Toegangspunt van de Revit-plugin, modelkoppeling en commandoregistratie. | C# /.NET Framework, Autodesk Revit API |
RevitCDE.UI | Desktoppanelen, commando's en gebruikersinteractie binnen Revit. | WPF / MVVM |
RevitCDE.Core | Applicatieservices, synchronisatie, lokale opslag en servercommunicatie. | C#-services, HTTP-clients, SQLite |
RevitCDE.Domain | Gedeelde domeinmodellen, identifiers, statussen en bedrijfsregels. | netstandard2.0-bibliotheek |
RevitCDE.Server | Centrale API, authenticatie, projectgegevens en integratiediensten. | ASP.NET Core 8, EF Core, PostgreSQL |
RevitCDE.Cabinet | Webkabinet voor projecten, documenten, goedkeuringen, taken, chats en beheer. | TypeScript / React web-UI |
RevitCDE.Localization | Centrale vertaalwoordenboeken en taalwisseling voor alle zichtbare UI. | JSON-woordenboeken, gedeelde i18n-sleutels |
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.
Migratieregels van lokale modus naar servermodus.
10Opslagarchitectuur
| Opslag | Wat het opslaat | Waarom het zo werkt |
|---|---|---|
| Hoofddatabase van de server | Gebruikers, organisaties, projecten, rollen, globale instellingen en licentiegegevens. | Bewaart projectoverstijgende gegevens in één gezaghebbende serverdatabase. |
| model_{guid}.db | Modelelementen, bladen, weergaven, schema's, hoeveelheden en koppelingen op modelniveau. | Grote modelgegevens zijn geïsoleerd per RVT-model voor prestaties en onderhoud. |
| disciplines.db | Projectdisciplines, fasen, pakketten en normspecifieke documentatiestructuur. | Projectnormen kunnen zich ontwikkelen zonder het globale schema te wijzigen. |
| estimate.db | Begrotingsdocumenten, posities, niet-modelkosten, hoeveelheidkoppelingen en WorkPackage-koppelingen. | Kostengegevens hebben hun eigen levenscyclus en moeten items bevatten die niet in het model aanwezig zijn. |
| schedule.db | Planningsactiviteiten, afhankelijkheden, niet-modeltijdprocessen en WorkPackage-koppelingen. | Planningsgegevens vereisen CPM/Gantt-logica en kunnen zowel naar model- als begrotingsgegevens verwijzen. |
| Extensible Storage | Minimale modelkoppeling, technische identifiers en lokale terugvalgegevens binnen RVT. | Het model blijft zelfidentificerend, zelfs buiten de serveromgeving. |
| Externe lokale database | Optionele eenbestandsdatabase voor chats, goedkeuringen, documenten, taken en andere lokale gegevens. | Losgekoppelde/lokale modellen kunnen rijkere gegevens bewaren zonder Extensible Storage op te blazen. |
11Beveiliging en toegang
Beveiliging is opgebouwd rond lidmaatschap, rollen, JWT en vertrouwensmodi.
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.
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. |
Projectdatabases zijn verdeeld naar vakgebied.
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.
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.
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.
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.