RevitCDE — løsningsoversigt

For købere

01Hvad løsningen er

RevitCDE er et Common Data Environment til Revit-projekter.

Det knytter brugerhandlinger til konkrete modelobjekter.

Hovedidé

Skab et digitalt kredsløb, der kan revideres.

For købere

02Målgrupper

RevitCDE er udviklet til flere forskellige roller.

BIM-koordinator / projektleder

Ser status for model, godkendelser, dokumenter og opgaver.

Forfatter (designer)

Arbejder i Revit uden hele tiden at skifte kontekst.

Godkender

Gennemgår indkommende anmodninger med øjebliksbillede og dokumenter.

Læser

Læseadgang inden for projektets omfang.

Kalkulatør

Kalkulationsdatabase, poster og omkostninger uden model.

Planlægningsingeniør

Tidsplan, aktiviteter og tidsprocesser uden model.

Administrator

Server, brugere, projekter, databaser og politikker.

For købere

03Problemer, vi løser

Afstand mellem Revit og ledelsesprocesser

Hvorfor det skaber problemer

Godkendelser og opgaver ligger adskilt fra modellen.

Sådan løser vi det

Pluginet registrerer modeldata og knytter anmodninger til objekter.

Ingen fælles sandhedskilde

Hvorfor det skaber problemer

Filer, e-mails og regneark udvikler sig i forskellige versioner.

Sådan løser vi det

En CDE-struktur gemmer projekter, dokumenter, versioner og historik.

Uigennemsigtige godkendelser

Hvorfor det skaber problemer

Beslutninger går tabt, og ruterne er uformelle.

Sådan løser vi det

ApprovalRequest, ruter i flere trin, append-only-hændelser og uforanderlige øjebliksbilleder.

Modelstatus er usynlig i Revit

Hvorfor det skaber problemer

Designeren kan ikke se, hvad der er godkendt, afventer eller er afvist.

Sådan løser vi det

Statusser spejles i Shared Parameters og Extensible Storage.

3D, 4D og 5D er ikke forbundet

Hvorfor det skaber problemer

Kalkulation og tidsplan kører hver for sig, og arbejde uden for modellen forsvinder fra overblikket.

Sådan løser vi det

estimate.db og schedule.db pr. projekt samt WorkPackage som 4D/5D-knudepunkt.

Offline eller lokalt arbejde uden server

Hvorfor det skaber problemer

Frakoblede modeller har brug for lokal lagring uden at miste forbindelsesvejen til serveren.

Sådan løser vi det

Lokal tilstand i Extensible Storage, valgfri ekstern database i én fil og senere migrering til serveren.

For købere

04Sådan fungerer det

Tre lag danner ét samlet datakredsløb.

Brugeren arbejder i Revit. Pluginet læser modelelementer, ark, visninger, skemaer og statusser.
Modellen knyttes til et serverprojekt. Tilknytningen gemmes inde i RVT-modellen via Extensible Storage.
Pluginet synkroniserer projektelementer, modelelementer, ændringer, statusser, anmodninger, opgaver, chats og dokumenter med serveren.
Serveren opbevarer globale data i hoveddatabasen og fagdata i databaser pr. projekt: model_{guid}.db, disciplines.db, estimate.db og schedule.db.
Webportalen giver adgang til projekter, dokumenter, godkendelser, opgaver, chats og administration. Opdateringer i realtid sendes via SignalR.
Godkenderens beslutninger, statusændringer, tilknyttede dokumenter og opgaver føres tilbage til Revit og vises i pluginet og modelparametrene.

Arkitekturprincip

Serveren er sandhedskilden i samarbejdstilstand. Modellen bevarer samtidig den minimale tilknytning og lokale data, så arbejdet overlever genstart af Revit og perioder uden netværk.

For købere

05Hvad det gør

Det funktionelle overblik på ét sted.

Projekter

Projektopsætning, medlemmer, roller, standarder, fagdiscipliner, faser og pakker.

Model

RVT-tilknytning, synkronisering, identifikatorer, fingeraftryk, statusser og registrering af ændringer.

Godkendelser

Anmodninger, ruter, øjebliksbilleder, beslutninger, tilbagetrækning, journal og realtid.

Dokumenter

CDE-dokumenter, versioner, upload/download, SHA-256, WIP→Shared→Published→Archived.

Opgaver

Kanban, Gantt, vigtighed, statusser, ansvarlige og relationer mellem opgaver.

Kommunikation

Projektchats, beskeder, reaktioner, korrespondance og e-mailintegration.

Administration

Brugere, roller, serverparametre, databaser, systemstatus og godkendelsespolitikker.

4D/5D

Kalkulation, tidsplan, WorkPackage, mængdeøjebliksbilleder, EVM/CPM.

Lokalt arbejde

Extensible Storage, valgfri ekstern lokal database og senere migrering til serveren.

Lokalisering

Centraliseret lokalisering af brugerfladen, 22 sprog i køreplanen.

For købere

06Brugsscenarier

Send et ark eller en visning til godkendelse

Trin 1
Trin 2
Trin 3
Trin 4
Trin 5
Trin 6

Et dokument fra WIP til publicering

Trin 1
Trin 2
Trin 3
Trin 4
Trin 5

Sammenknytning af model, kalkulation og tidsplan

Trin 1
Trin 2
Trin 3
Trin 4
Trin 5

For købere

07Ofte stillede spørgsmål

Spørgsmål 1

Svar 1

Spørgsmål 2

Svar 2

Spørgsmål 3

Svar 3

Spørgsmål 4

Svar 4

Spørgsmål 5

Svar 5

Spørgsmål 6

Svar 6

Spørgsmål 7

Svar 7

Spørgsmål 8

Svar 8

Spørgsmål 9

Svar 9

Spørgsmål 10

Svar 10

Tekniske detaljer

08Løsningens opbygning

Komponent	Formål	Teknologi
`RevitCDE.Addin`	Indgangspunkt for Revit-tilføjelsen, modeltilknytning og registrering af kommandoer.	C# /.NET Framework, Autodesk Revit API
`RevitCDE.UI`	Skrivebordspaneler, kommandoer og brugerinteraktion inde i Revit.	WPF / MVVM
`RevitCDE.Core`	Programtjenester, synkronisering, lokal lagring og kommunikation med serveren.	C#-tjenester, HTTP-klienter, SQLite
`RevitCDE.Domain`	Fælles domænemodeller, identifikatorer, statusser og forretningsregler.	netstandard2.0-bibliotek
`RevitCDE.Server`	Central API, godkendelse, projektdata og integrationstjenester.	ASP.NET Core 8, EF Core, PostgreSQL
`RevitCDE.Cabinet`	Webportal til projekter, dokumenter, godkendelser, opgaver, chats og administration.	TypeScript-/React-brugerflade til web
`RevitCDE.Localization`	Centrale oversættelsesordbøger og sprogskift for hele den synlige brugerflade.	JSON-ordbøger og fælles i18n-nøgler

Tekniske detaljer

09Lokal- og servertilstande

RevitCDE understøtter to driftstilstande.

Lokal tilstand

Data gemmes i modellens Extensible Storage.

Ekstern lokal lagring

En separat databasefil for hver RVT-model.

Servertilstand

Aktive data opbevares på serveren.

Lokal- og servertilstande

Regler for migrering fra lokal til serverbaseret tilstand.

Tekniske detaljer

10Lagringsarkitektur

Lager	Hvad det gemmer	Hvorfor det er opbygget sådan
Serverens hoveddatabase	Brugere, organisationer, projekter, roller, globale indstillinger og licensdata.	Samler data på tværs af projekter i én autoritativ serverdatabase.
model_{guid}.db	Modelelementer, ark, visninger, skemaer, mængder og tilknytninger på modelniveau.	Store modeldata isoleres pr. RVT-model af hensyn til ydeevne og vedligeholdelse.
disciplines.db	Projektets fagdiscipliner, faser, pakker og standardspecifikke dokumentationsstruktur.	Projektstandarder kan udvikles uden at ændre det globale skema.
estimate.db	Kalkulationsdokumenter, poster, omkostninger uden model, mængdelinks og WorkPackage-tilknytninger.	Omkostningsdata har deres egen livscyklus og skal også omfatte poster, der ikke findes i modellen.
schedule.db	Planlægningsaktiviteter, afhængigheder, tidsprocesser uden model og WorkPackage-links.	Planlægningsdata kræver CPM-/Gantt-logik og kan referere til både model- og kalkulationsdata.
Extensible Storage	Minimal modeltilknytning, tekniske identifikatorer og lokale fallback-data i RVT.	Modellen kan stadig identificere sig selv uden for servermiljøet.
Ekstern lokal database	Valgfri lokal database i én fil til chats, godkendelser, dokumenter, opgaver og andre lokale data.	Frakoblede og lokale modeller kan gemme mere omfattende data uden at overbelaste Extensible Storage.

Tekniske detaljer

11Sikkerhed og adgang

Sikkerheden bygger på medlemskab, roller, JWT og tillidstilstande.

JWT-godkendelse.
Sikre adgangskodehash; første administrator oprettes ved den indledende opsætning.
Login med brugernavn, e-mail eller telefonnummer, hvis det er konfigureret.
Brugerlogin er den primære tilstand.
Valgfri arbejdsstationstilstand uden adgangskode.
Handlinger med højt tillidsniveau kræver stadig et rigtigt login.
Projektbegrænset Read / Write / Manage / Admin.

Tekniske detaljer

12Godkendelser — under motorhjelmen

En formaliseret proces, der kan gentages og dokumenteres.

Send til godkendelse

Opretter en godkendelsesanmodning for den valgte modelrevision eller dokumentpakke.

Uforanderligt øjebliksbillede

Registrerer den præcise model- og dokumenttilstand, der gennemgås, så beslutningen kan reproduceres.

Godkendelsesruter

Definerer sekventielle eller parallelle kontroltrin, ansvarlige deltagere og krævede beslutninger.

Registrerede beslutninger

Gemmer godkendelser, afvisninger, tilbagesendelser og kommentarer sammen med forfatter og tidsstempel.

Hændelseshistorik

Bevarer en skrivebeskyttet tidslinje over indsendelser, tildelinger, beslutninger og statusændringer.

Statussynkronisering

Skriver den bekræftede godkendelsesstatus tilbage til projektobjekterne og den tilknyttede Revit-arbejdsgang.

Opdateringer i realtid

Sender ændringer i godkendelser til tilsluttede klienter uden manuel genindlæsning af siden.

Tekniske detaljer

13WorkPackage — 4D/5D-knudepunktet

Det centrale objekt, der forbinder model, mængder, kalkulation, tidsplan og fremdrift.

`ModelElement`	Knytter arbejdspakken til BIM-elementer og deres stabile identifikatorer.
`QuantityItem`	Gemmer målte mængder og kilden, som hver mængde er hentet fra.
`EstimateItem`	Forbinder mængder med kalkulationsposter, enhedspriser og beregnede omkostninger.
`WorkPackage`	Fungerer som det centrale objekt, der forbinder omfang, model, omkostninger, tidsplan, ansvar og dokumentation.
`ScheduleActivity`	Knytter arbejdspakken til planlagte aktiviteter, datoer, afhængigheder og data om den kritiske vej.
`ProgressSnapshot`	Gemmer faktisk fremdrift, earned-value-indikatorer og fakta for rapporteringsperioden.

Why no cross-DB FK

Projektets databaser er opdelt efter fagområde.

Tekniske detaljer

14Standarder, fagdiscipliner, faser og pakker

Projektstandarden styrer formaterne for dokumentation, kalkulation og tidsplan.

`ProjectStandard`

Definerer aktive projektregler, navngivningskonventioner og den krævede informationsstruktur.

`Disciplin`

Vedligeholder projektets katalog over fagdiscipliner og disciplinspecifikke ansvarsområder.

`PackageType`

Definerer genanvendelige pakkestrukturer til projektering, indkøb og udførelse.

`ProjectStage`

Styrer projektfaser, overgange mellem faser og de data, der forventes i hver fase.

`ProjectRole`

Definerer ansvar, rettigheder og godkendelseskompetence i projektet.

`StandardPreset`

Anvender en genanvendelig samling af standarder, fagdiscipliner, faser, roller og pakketyper.

Tekniske detaljer

15REST API — hovedgrupper

REST API opdelt efter fagområde med JWT-godkendelse.

`/api/auth/*` · Godkendelse, kontosessioner, gendannelse af adgangskoder og adgangstokens.
`/api/approvals/*` · Godkendelsesanmodninger, ruter, beslutninger, kommentarer og statusændringer.
`/api/cde/*` · Projekter, modeller, dokumenter, issues og fælles projektdata.
`/api/chats/*` · Projektsamtaler, deltagere, beskeder og vedhæftede filer.
`/api/tasks/*` · Opgaver, ansvarlige, frister, prioriteter og færdiggørelsesstatus.
`/api/standards/*` · Projektstandarder, fagdiscipliner, faser, roller og pakkeforvalg.
`/api/45d/*` · Arbejdspakker, mængder, kalkulationer, planlægningsaktiviteter og fremdrift.
`/api/admin/*` · Administration, konfiguration, diagnosticering og kontrollerede vedligeholdelsesopgaver.

Tekniske detaljer

16Ordliste

CDE: Common Data Environment — et kontrolleret rum til projektoplysninger, kommunikation og beslutninger.
Extensible Storage: Revit-mekanisme til lagring af strukturerede programdata inde i en model.
Shared Parameters: Revit-parametre, der deles mellem projekter og familier gennem en fælles definitionsfil.
ProjectElement: En projektpost, der repræsenterer et BIM-element uden for Revit-dokumentet.
ModelElement: En stabil reference til et element i en bestemt model og modelrevision.
Snapshot: En uforanderlig registrering af den præcise projektdata-tilstand, der blev brugt ved kontrol eller godkendelse.
ApprovalRequest: En formel anmodning, der sender et afgrænset omfang gennem en godkendelsesrute.
WorkPackage: Det centrale 4D/5D-objekt, der forbinder omfang, mængder, omkostninger, tidsplan og ansvar.
EVM: Earned Value Management — måling af fremdrift ved hjælp af planlagt værdi, optjent værdi og faktiske omkostninger.
CPM: Critical Path Method — analyse af tidsplanen ud fra aktivitetsafhængigheder og tilgængeligt slæk.

Tekniske detaljer

17Det næste på køreplanen

Den nuværende implementering har en fungerende kerne. Nedenfor vises de næste udviklingstrin.

Udvidet lokalisering

Fuld terminologisk gennemgang og fagspecifik formulering for hvert understøttet sprog.

Dokumentarbejdsgange

Versionsstyrede dokumentregistre, transmittals, kontrolpakker og dokumentationskæder.

Dybere 4D/5D

Mere detaljeret planlægning af arbejdspakker, omkostningsstyring, prognoser for fremdrift og earned-value-analyse.

BCF-interoperabilitet

Udveksling af issues og synspunkter med andre BIM-programmer via BCF-standarden.

Koordinering af tilknyttede modeller

Koordiner tilknyttede modeller, ejerskab, revisioner og afhængigheder på tværs af modeller.

Observerbarhed

Driftsdashboards, revisionsmålinger, diagnosticering og overvågning af tjenesternes tilstand.