RevitCDE — ratkaisun yleiskuvaus

Ostajille

01Mitä tämä on

RevitCDE on Common Data Environment Revit-projekteille.

Se yhdistää käyttäjän toiminnot konkreettisiin malliobjekteihin.

Keskeinen ajatus

Luo digitaalinen ympäristö, joka voidaan auditoida.

Ostajille

02Kenelle

RevitCDE palvelee useita eri rooleja.

BIM-koordinaattori / projektipäällikkö

Näkee mallin, hyväksyntöjen, asiakirjojen ja tehtävien tilan.

Laatija (suunnittelija)

Työskentelee Revitissä vaihtamatta jatkuvasti kontekstia.

Hyväksyjä

Tarkistaa saapuvat pyynnöt snapshotin ja asiakirjojen kanssa.

Katselija

Lukuoikeus projektin määritetyssä laajuudessa.

Kustannuslaskija

Kustannustietokanta, rivit, mallin ulkopuoliset kustannukset.

Aikatauluinsinööri

Aikataulu, tehtävät, mallin ulkopuoliset aikaprosessit.

Ylläpitäjä

Palvelin, käyttäjät, projektit, tietokannat, käytännöt.

Ostajille

03Ratkaisemamme ongelmat

Kuilu Revitin ja johtamisprosessien välillä

Miksi se sattuu

Hyväksynnät ja tehtävät elävät erillään mallista.

Näin korjaamme sen

Lisäosa tallentaa mallidatan ja linkittää pyynnöt objekteihin.

Ei yhteistä totuuden lähdettä

Miksi se sattuu

Tiedostot, sähköpostit ja taulukot kehittyvät eri versioissa toisistaan erillään.

Näin korjaamme sen

CDE-rakenne tallentaa projektit, asiakirjat, versiot ja historian.

Läpinäkymättömät hyväksynnät

Miksi se sattuu

Päätökset katoavat ja reitit jäävät epämuodollisiksi.

Näin korjaamme sen

ApprovalRequest, monivaiheiset reitit, vain-lisäys-tapahtumat, muuttumattomat tilannevedokset.

Mallin tila ei näy Revitissä

Miksi se sattuu

Suunnittelija ei näe, mikä on hyväksytty, odottaa käsittelyä tai on hylätty.

Näin korjaamme sen

Tilat peilataan Shared Parameters -parametreihin ja Extensible Storageen.

3D, 4D ja 5D eivät ole yhteydessä toisiinsa

Miksi se sattuu

Kustannusarvio ja aikataulu toimivat erillään, ja mallin ulkopuolinen työ katoaa kokonaiskuvasta.

Näin korjaamme sen

Projektikohtaiset estimate.db- ja schedule.db-tietokannat sekä WorkPackage 4D/5D-solmuna.

Offline- tai paikallinen työ ilman palvelinta

Miksi se sattuu

Irrotetut mallit tarvitsevat paikallisen tallennuksen menettämättä myöhempää yhteysreittiä palvelimelle.

Näin korjaamme sen

Paikallinen tila Extensible Storagessa, valinnainen ulkoinen yhden tiedoston tietokanta ja myöhempi siirto palvelimelle.

Ostajille

04Miten se toimii

Kolme kerrosta muodostavat yhden yhteisen datakierron.

Käyttäjä työskentelee Revitissä. Lisäosa lukee mallielementit, arkit, näkymät, luettelot ja tilat.
Malli sidotaan palvelinprojektiin. Sidonta tallennetaan RVT-mallin sisään Extensible Storagen avulla.
Lisäosa synkronoi projektielementit, mallielementit, muutokset, tilat, pyynnöt, tehtävät, keskustelut ja asiakirjat palvelimen kanssa.
Palvelin tallentaa globaalit tiedot päätietokantaan ja tieteenalakohtaiset tiedot projektikohtaisiin tietokantoihin: model{guid}.db, disciplines.db, estimate.db ja schedule.db.
Web-portaali antaa pääsyn projekteihin, asiakirjoihin, hyväksyntöihin, tehtäviin, keskusteluihin ja hallintaan. Reaaliaikaiset päivitykset välitetään SignalR:n kautta.
Hyväksyjän päätökset, tilamuutokset, linkitetyt asiakirjat ja tehtävät palautuvat Revitiin ja näkyvät lisäosassa sekä malliparametreissa.

Arkkitehtuuriperiaate

Palvelin on yhteistyötilan totuuden lähde. Malli säilyttää samalla vähimmäissidonnan ja paikalliset tiedot, joten työ kestää Revitin uudelleenkäynnistykset ja verkkokatkokset.

Ostajille

05Mitä tekee

Toiminnallinen kokonaiskuva yhdellä silmäyksellä.

Projektit

Projektin asetukset, jäsenet, roolit, standardit, osa-alueet, vaiheet, paketit.

Malli

RVT-sidonta, synkronointi, tunnisteet, sormenjälki, tilat, muutosten seuranta.

Hyväksynnät

Pyynnöt, reitit, tilannevedokset, päätökset, peruutus, loki, reaaliaika.

Asiakirjat

CDE-asiakirjat, versiot, lataus/nouto, SHA-256, WIP→Shared→Published→Archived.

Tehtävät

Kanban, Gantt, tärkeysjärjestys, tilat, vastuuhenkilöt, tehtävien väliset suhteet.

Viestintä

Projektikeskustelut, viestit, reaktiot, kirjeenvaihto, sähköpostiintegraatio.

Ylläpito

Käyttäjät, roolit, palvelimen parametrit, tietokannat, tila, käyttöoikeuskäytännöt.

4D/5D

Kustannusarvio, aikataulu, WorkPackage, määrätilannevedokset, EVM/CPM.

Paikallinen työ

Extensible Storage, valinnainen ulkoinen paikallinen tietokanta ja myöhempi siirto palvelimelle.

Lokalisointi

Keskitetty käyttöliittymän lokalisointi, 22 kieltä tiekartan mukaan.

Ostajille

06Käyttöskenaariot

Lähetä arkki tai näkymä hyväksyttäväksi

Vaihe 1
Vaihe 2
Vaihe 3
Vaihe 4
Vaihe 5
Vaihe 6

Asiakirja WIP-tilasta julkaisuun

Vaihe 1
Vaihe 2
Vaihe 3
Vaihe 4
Vaihe 5

Mallin, kustannusarvion ja aikataulun yhdistäminen

Vaihe 1
Vaihe 2
Vaihe 3
Vaihe 4
Vaihe 5

Ostajille

07Usein kysytyt kysymykset

Kysymys 1

Vastaus 1

Kysymys 2

Vastaus 2

Kysymys 3

Vastaus 3

Kysymys 4

Vastaus 4

Kysymys 5

Vastaus 5

Kysymys 6

Vastaus 6

Kysymys 7

Vastaus 7

Kysymys 8

Vastaus 8

Kysymys 9

Vastaus 9

Kysymys 10

Vastaus 10

Tekniset tiedot

08Ratkaisun rakenne

Komponentti	Tarkoitus	Teknologia
`RevitCDE.Addin`	Revit-lisäosan aloituspiste, mallin sidonta ja komentojen rekisteröinti.	C# /.NET Framework, Autodesk Revit API
`RevitCDE.UI`	Työpöytäpaneelit, komennot ja käyttäjän vuorovaikutus Revitin sisällä.	WPF / MVVM
`RevitCDE.Core`	Sovelluspalvelut, synkronointi, paikallinen tallennus ja palvelinyhteys.	C#-palvelut, HTTP-asiakkaat, SQLite
`RevitCDE.Domain`	Jaetut toimialamallit, tunnisteet, tilat ja liiketoimintasäännöt.	netstandard2.0-kirjasto
`RevitCDE.Server`	Keskitetty API, todennus, projektidata ja integraatiopalvelut.	ASP.NET Core 8, EF Core, PostgreSQL
`RevitCDE.Cabinet`	Web-portaali projekteille, asiakirjoille, hyväksynnöille, tehtäville, keskusteluille ja hallinnalle.	TypeScript / React-verkkokäyttöliittymä
`RevitCDE.Localization`	Keskitetyt käännössanakirjat ja kielen vaihto koko näkyvälle käyttöliittymälle.	JSON-sanakirjat, jaetut i18n-avaimet

Tekniset tiedot

09Paikallinen ja palvelintila

RevitCDE tukee kahta käyttötilaa.

Paikallinen tila

Tiedot tallennetaan mallin Extensible Storageen.

Ulkoinen paikallinen tallennustila

Erillinen tietokantatiedosto jokaiselle RVT-mallille.

Palvelintila

Aktiivinen data tallennetaan palvelimelle.

Paikallinen ja palvelintila

Säännöt siirtymiselle paikallisesta palvelinpohjaiseen tilaan.

Tekniset tiedot

10Tallennusarkkitehtuuri

Tallennuspaikka	Mitä se tallentaa	Miksi rakenne on tehty näin
Palvelimen päätietokanta	Käyttäjät, organisaatiot, projektit, roolit, globaalit asetukset ja lisenssitiedot.	Kokoaa projektien väliset yhteiset tiedot yhteen auktoritatiiviseen palvelintietokantaan.
model_{guid}.db	Mallielementit, arkit, näkymät, luettelot, määrät ja mallitasoiset linkit.	Suuri mallidata eristetään RVT-mallikohtaisesti suorituskyvyn ja ylläpidon vuoksi.
disciplines.db	Projektin tieteenalat, vaiheet, paketit ja standardikohtainen dokumentaatiorakenne.	Projektistandardit voivat kehittyä muuttamatta globaalia skeemaa.
estimate.db	Kustannusarvioasiakirjat, nimikkeet, mallin ulkopuoliset kustannukset, määrälinkit ja WorkPackage-sidonnat.	Kustannusdatalla on oma elinkaarensa, ja sen on katettava myös nimikkeet, joita mallissa ei ole.
schedule.db	Aikataulutoiminnot, riippuvuudet, mallin ulkopuoliset aikatehtävät ja WorkPackage-linkit.	Aikatauludata tarvitsee CPM-/Gantt-logiikkaa ja voi viitata sekä malli- että kustannusdataan.
Extensible Storage	Mallin vähimmäissidonta, tekniset tunnisteet ja paikallinen fallback-data RVT:ssä.	Malli pystyy edelleen tunnistamaan itsensä palvelinympäristön ulkopuolella.
Ulkoinen paikallinen tietokanta	Valinnainen paikallinen yhden tiedoston tietokanta keskusteluille, hyväksynnöille, asiakirjoille, tehtäville ja muulle paikalliselle datalle.	Irrotetut ja paikalliset mallit voivat tallentaa laajempaa dataa kuormittamatta Extensible Storagea.

Tekniset tiedot

11Turvallisuus ja käyttöoikeudet

Tietoturva perustuu jäsenyyksiin, rooleihin, JWT:hen ja luottamustiloihin.

JWT-todennus.
Turvallinen salasanahash; ensimmäinen ylläpitäjä luodaan alkuasetusten yhteydessä.
Kirjautuminen käyttäjänimellä, sähköpostilla tai puhelinnumerolla, jos se on määritetty.
Käyttäjäkirjautuminen on ensisijainen tila.
Valinnainen työasematila ilman salasanaa.
Korotetun luottamustason toiminnot edellyttävät edelleen oikeaa kirjautumista.
Projektikohtaiset Read / Write / Manage / Admin -oikeudet.

Tekniset tiedot

12Hyväksynnät — konepellin alla

Muodollinen, toistettava ja dokumentoitava prosessi.

Lähetä hyväksyttäväksi

Luo hyväksyntäpyynnön valitulle mallirevisiolle tai asiakirjapaketille.

Muuttumaton tilannevedos

Tallentaa tarkasteltavan mallin ja asiakirjojen täsmällisen tilan, jotta päätös voidaan myöhemmin toistaa ja todentaa.

Hyväksyntäreitit

Määrittää peräkkäiset tai rinnakkaiset tarkastusvaiheet, vastuulliset osallistujat ja vaadittavat päätökset.

Kirjatut päätökset

Tallentaa hyväksynnät, hylkäykset, palautukset ja kommentit yhdessä tekijän ja aikaleiman kanssa.

Tapahtumahistoria

Säilyttää append-only-aikajanan lähetyksistä, määrityksistä, päätöksistä ja tilamuutoksista.

Tilan synkronointi

Kirjoittaa vahvistetun hyväksyntätilan takaisin projektiobjekteihin ja siihen liittyvään Revit-työnkulkuun.

Reaaliaikaiset päivitykset

Julkaisee hyväksyntämuutokset yhdistetyille asiakkaille ilman sivun manuaalista päivittämistä.

Tekniset tiedot

13WorkPackage — 4D/5D-solmukohta

Keskeinen objekti, joka yhdistää mallin, määrät, kustannusarvion, aikataulun ja edistymisen.

`ModelElement`	Yhdistää työpaketin BIM-elementteihin ja niiden vakaisiin tunnisteisiin.
`QuantityItem`	Tallentaa mitatut määrät ja lähteen, josta kukin määrä on saatu.
`EstimateItem`	Yhdistää määrät kustannusarvion nimikkeisiin, yksikköhintoihin ja laskettuihin kustannuksiin.
`WorkPackage`	Toimii keskeisenä objektina, joka yhdistää laajuuden, mallin, kustannukset, aikataulun, vastuut ja dokumentaation.
`ScheduleActivity`	Yhdistää työpaketin suunniteltuihin toimintoihin, päivämääriin, riippuvuuksiin ja kriittisen polun tietoihin.
`ProgressSnapshot`	Tallentaa toteutuneen edistymän, ansaitun arvon tunnusluvut ja raportointikauden tosiasiat.

Why no cross-DB FK

Projektin tietokannat on erotettu tieteenaloittain.

Tekniset tiedot

14Standardit, osa-alueet, vaiheet, paketit

Projektistandardi ohjaa dokumentaation, kustannusarvion ja aikataulun rakenteita.

`ProjectStandard`

Määrittää aktiiviset projektisäännöt, nimeämiskäytännöt ja vaaditun tietorakenteen.

`Osa-alue`

Ylläpitää projektin tieteenalaluetteloa ja tieteenalakohtaisia vastuualueita.

`PackageType`

Määrittää uudelleenkäytettävät pakettirakenteet suunnitteluun, hankintaan ja toteutukseen.

`ProjectStage`

Ohjaa projektivaiheita, vaiheiden välisiä siirtymiä ja kussakin vaiheessa odotettavia tietoja.

`ProjectRole`

Määrittää vastuut, oikeudet ja hyväksyntävaltuudet projektissa.

`StandardPreset`

Ottaa käyttöön uudelleenkäytettävän kokoelman standardeja, tieteenaloja, vaiheita, rooleja ja pakettityyppejä.

Tekniset tiedot

15REST-rajapinta — pääryhmät

REST-rajapinta aihealueittain, JWT-todennettu.

`/api/auth/*` · Todennus, tili-istunnot, salasanan palautus ja käyttöoikeustunnukset.
`/api/approvals/*` · Hyväksyntäpyynnöt, reitit, päätökset, kommentit ja tilamuutokset.
`/api/cde/*` · Projektit, mallit, asiakirjat, ongelmat ja yhteiset projektitiedot.
`/api/chats/*` · Projektikeskustelut, osallistujat, viestit ja liitteet.
`/api/tasks/*` · Tehtävät, vastuuhenkilöt, määräajat, prioriteetit ja valmistumistilat.
`/api/standards/*` · Projektistandardit, tieteenalat, vaiheet, roolit ja pakettien esiasetukset.
`/api/45d/*` · Työpaketit, määrät, kustannusarviot, aikataulutoiminnot ja edistyminen.
`/api/admin/*` · Hallinta, konfigurointi, diagnostiikka ja hallitut ylläpitotoimenpiteet.

Tekniset tiedot

16Sanasto

CDE: Common Data Environment — hallittu ympäristö projektitiedoille, viestinnälle ja päätöksille.
Extensible Storage: Revit-mekanismi jäsennellyn sovellusdatan tallentamiseen mallin sisään.
Jaetut parametrit: Revit-parametrit, joita jaetaan projektien ja perheiden välillä yhteisen määrittelytiedoston kautta.
ProjectElement: Projektitietue, joka edustaa BIM-elementtiä Revit-asiakirjan ulkopuolella.
ModelElement: Vakaa viittaus elementtiin tietyssä mallissa ja mallirevisiossa.
Tilannevedos: Muuttumaton tallenne tarkasta projektidatan tilasta, jota käytettiin tarkastuksessa tai hyväksynnässä.
ApprovalRequest: Muodollinen pyyntö, joka lähettää rajatun kokonaisuuden hyväksyntäreitin läpi.
WorkPackage: Keskeinen 4D/5D-objekti, joka yhdistää laajuuden, määrät, kustannukset, aikataulun ja vastuun.
EVM: Earned Value Management — edistymisen mittaaminen suunnitellun arvon, ansaitun arvon ja toteutuneiden kustannusten avulla.
CPM: Critical Path Method — aikataulun analyysi tehtävien riippuvuuksien ja käytettävissä olevan liikkumavaran perusteella.

Tekniset tiedot

17Seuraavaksi tiekartalla

Nykyisessä toteutuksessa on toimiva ydin. Alla ovat seuraavat kehitysvaiheet.

Laajennettu lokalisointi

Täysi terminologinen tarkastus ja toimialakohtainen muotoilu jokaiselle tuetulle kielelle.

Asiakirjatyönkulut

Versioidut asiakirjarekisterit, luovutukset, tarkastuspaketit ja jäljitysketjut.

Syvempi 4D/5D

Työpakettien yksityiskohtaisempi aikataulutus, kustannusten hallinta, edistymisennusteet ja earned value -analyysi.

BCF-yhteentoimivuus

Ongelmien ja näkymien vaihto muiden BIM-ohjelmistojen kanssa BCF-standardin avulla.

Linkitettyjen mallien koordinointi

Linkitettyjen mallien, omistajuuden, revisioiden ja mallien välisten riippuvuuksien koordinointi.

Havainnoitavuus

Käyttödashboardit, auditointimittarit, diagnostiikka ja palveluiden tilan valvonta.