API pelesenan · 99.98%

+995 574 856 856 [email protected] Kutaisi, Georgia

Dokumentasi

RevitCDE — gambaran keseluruhan penyelesaian

Persekitaran Data Bersama untuk projek Revit.

RevitCDE

Untuk pembeli

01Apa ini

RevitCDE ialah Persekitaran Data Bersama untuk projek Revit.

Ia mengikat tindakan pengguna kepada objek model konkrit.

Idea utama

Membina gelung digital yang boleh diaudit.

Untuk pembeli

02Untuk siapa

RevitCDE menangani beberapa peranan berbeza.

Penyelaras BIM / Pengurus projek

Melihat status model, kelulusan, dokumen dan tugas.

Pengarang (pereka bentuk)

Bekerja dalam Revit tanpa penukaran konteks berterusan.

Pelulus

Menyemak permintaan masuk dengan tangkapan dan dokumen.

Pemapar

Akses baca dalam skop projek.

Juruanggar

Pangkalan data anggaran, item baris, kos bukan model.

Jurutera perancangan

Jadual, aktiviti, proses masa bukan model.

Pentadbir

Pelayan, pengguna, projek, pangkalan data, polisi.

Untuk pembeli

03Masalah yang kami selesaikan

Jurang antara Revit dan proses pengurusan

Mengapa ini menyakitkan

Kelulusan dan tugas wujud secara berasingan daripada model.

Bagaimana kami menyelesaikannya

Plugin menangkap data model dan menghubungkan permintaan dengan objek.

Tiada sumber kebenaran tunggal

Mengapa ini menyakitkan

Fail, e-mel dan jadual berbeza mengikut versi.

Bagaimana kami menyelesaikannya

Struktur CDE menyimpan projek, dokumen, versi dan sejarah.

Kelulusan tidak telus

Mengapa ini menyakitkan

Keputusan hilang, dan laluan tidak formal.

Bagaimana kami menyelesaikannya

ApprovalRequest, laluan berbilang peringkat, peristiwa tambah sahaja, tangkapan tidak berubah.

Status model tidak kelihatan dalam Revit

Mengapa ini menyakitkan

Pereka bentuk tidak melihat apa yang diluluskan, sedang disemak atau ditolak.

Bagaimana kami menyelesaikannya

Status dicerminkan dalam Shared Parameters dan Extensible Storage.

3D, 4D dan 5D tidak dihubungkan

Mengapa ini menyakitkan

Anggaran dan jadual dikendalikan secara berasingan; kerja di luar model terlepas pandang.

Bagaimana kami menyelesaikannya

estimate.db dan schedule.db mengikut projek, WorkPackage sebagai hab 4D/5D.

Kerja luar talian/tempatan tanpa pelayan

Mengapa ini menyakitkan

Model yang diasingkan memerlukan storan tempatan tanpa kehilangan laluan ke pelayan.

Bagaimana kami menyelesaikannya

Mod tempatan dalam Extensible Storage, DB tempatan luaran satu fail pilihan, migrasi kemudian ke pelayan.

Untuk pembeli

04Cara ia berfungsi

Tiga lapisan membentuk satu gelung data.

Pengguna bekerja dalam Revit. Plugin membaca elemen model, helaian, pandangan, spesifikasi dan status.
Model diikat kepada projek pada pelayan. Pengikatan disimpan dalam model RVT melalui Extensible Storage.
Plugin menyegerakkan elemen projek, elemen model, perubahan, status, permintaan, tugas, sembang dan dokumen dengan pelayan.
Pelayan menyimpan data global dalam pangkalan data utama, dan data khusus dalam pangkalan data mengikut projek: model_{guid}.db, disciplines.db, estimate.db, schedule.db.
Kabinet web menyediakan akses kepada projek, dokumen, kelulusan, tugas, sembang dan pentadbiran; kemas kini masa nyata dihantar melalui SignalR.
Keputusan pelulus, perubahan status, dokumen berkaitan dan tugas kembali ke Revit dan dipaparkan dalam plugin dan parameter model.

Prinsip seni bina

Pelayan adalah sumber kebenaran untuk mod kolaboratif; model masih menyimpan pengikatan minimum dan data tempatan supaya kerja dikekalkan semasa Revit dimulakan semula dan dalam tempoh luar talian.

Untuk pembeli

05Apa fungsinya

Peta fungsi sekali pandang.

Projek

Persediaan projek, peserta, peranan, piawaian, disiplin, peringkat, set.

Model BIM

Pengikatan RVT, penyegerakan, pengecam, fingerprint, status, penjejakan perubahan.

Kelulusan

Permintaan, laluan, tangkapan, keputusan, penarikan balik, log, masa nyata.

Dokumen

Dokumen CDE, versi, muat naik/muat turun, SHA-256, WIP→Shared→Published→Archived.

Tugasan

Kanban, Gantt, kepentingan, status, pelaksana, hubungan tugas.

Komunikasi

Sembang projek, mesej, reaksi, surat-menyurat, integrasi e-mel.

Pentadbiran

Pengguna, peranan, parameter pelayan, pangkalan data, status sistem, polisi kebenaran.

4D/5D

Anggaran, jadual, WorkPackage, tangkapan volum, EVM/CPM.

Kerja tempatan

Extensible Storage, DB tempatan luaran pilihan, migrasi ke pelayan.

Penyetempatan

Penyetempatan UI berpusat, 22 bahasa mengikut roadmap.

Untuk pembeli

06Senario penggunaan

Penghantaran helaian atau pandangan untuk kelulusan

Langkah 1
Langkah 2
Langkah 3
Langkah 4
Langkah 5
Langkah 6

Dokumen dari WIP hingga penerbitan

Langkah 1
Langkah 2
Langkah 3
Langkah 4
Langkah 5

Pengikatan model, anggaran dan jadual

Langkah 1
Langkah 2
Langkah 3
Langkah 4
Langkah 5

Untuk pembeli

07Soalan lazim

Soalan 1

Jawapan 1

Soalan 2

Jawapan 2

Soalan 3

Jawapan 3

Soalan 4

Jawapan 4

Soalan 5

Jawapan 5

Soalan 6

Jawapan 6

Soalan 7

Jawapan 7

Soalan 8

Jawapan 8

Soalan 9

Jawapan 9

Soalan 10

Jawapan 10

Butiran teknikal

Di bawah adalah lapisan teknikal untuk pembaca yang ingin melihat bagaimana RevitCDE dibina.

Butiran teknikal

08Komposisi penyelesaian

Komponen	Tujuan	Teknologi
`RevitCDE.Addin`	Titik masuk plugin Revit, pengikatan model dan pendaftaran perintah.	C# /.NET Framework, Autodesk Revit API
`RevitCDE.UI`	Panel desktop, perintah dan interaksi pengguna dalam Revit.	WPF / MVVM
`RevitCDE.Core`	Perkhidmatan aplikasi, penyegerakan, storan tempatan dan komunikasi pelayan.	Perkhidmatan C#, klien HTTP, SQLite
`RevitCDE.Domain`	Model domain kongsi, pengecam, status dan peraturan perniagaan.	Perpustakaan netstandard2.0
`RevitCDE.Server`	API pusat, pengesahan, data projek dan perkhidmatan integrasi.	ASP.NET Core 8, EF Core, PostgreSQL
`RevitCDE.Cabinet`	Kabinet web untuk projek, dokumen, kelulusan, tugas, sembang dan pentadbiran.	TypeScript / React web UI
`RevitCDE.Localization`	Kamus terjemahan pusat dan penukaran bahasa untuk semua UI yang kelihatan.	Kamus JSON, kunci i18n kongsi

Butiran teknikal

09Mod tempatan dan pelayan

RevitCDE menyokong dua mod runtime.

Mod tempatan

Data disimpan dalam Extensible Storage model.

Storan tempatan luaran

Fail pangkalan data berasingan bagi setiap model RVT.

Mod pelayan

Data aktif disimpan pada pelayan.

Mod tempatan & pelayan

Peraturan migrasi dari mod tempatan ke mod pelayan.

Butiran teknikal

10Seni bina storan

Stor	Apa yang disimpan	Mengapa ia berfungsi begini
DB utama pelayan	Pengguna, organisasi, projek, peranan, tetapan global dan data lesen.	Mengekalkan data merentas projek dalam satu pangkalan data pelayan yang berkuasa.
model_{guid}.db	Elemen model, helaian, pandangan, jadual, kuantiti dan pengikatan peringkat model.	Data model besar diasingkan mengikut model RVT untuk prestasi dan penyelenggaraan.
disciplines.db	Disiplin projek, peringkat, pakej dan struktur dokumentasi khusus piawaian.	Piawaian projek boleh berkembang tanpa mengubah skema global.
estimate.db	Dokumen anggaran, kedudukan, kos bukan model, pautan kuantiti dan pengikatan WorkPackage.	Data kos mempunyai kitaran hayat sendiri dan mesti termasuk item yang tidak terdapat dalam model.
schedule.db	Aktiviti jadual, kebergantungan, proses masa bukan model dan pautan WorkPackage.	Data perancangan memerlukan logik CPM/Gantt dan boleh merujuk kepada kedua-dua data model dan anggaran.
Extensible Storage	Pengikatan model minimum, pengecam teknikal dan data sandaran tempatan dalam RVT.	Model kekal mengenal pasti diri walaupun di luar persekitaran pelayan.
DB tempatan luaran	Pangkalan data tempatan satu fail pilihan untuk sembang, kelulusan, dokumen, tugas dan data tempatan lain.	Model yang diasingkan/tempatan boleh menyimpan data yang lebih kaya tanpa membengkakkan Extensible Storage.

Butiran teknikal

11Keselamatan dan akses

Keselamatan dibina di sekitar keahlian, peranan, JWT dan mod kepercayaan.

Pengesahan JWT.
Hash kata laluan selamat; penciptaan pentadbir semasa persediaan awal.
Log masuk melalui nama pengguna, e-mel atau telefon, jika dikonfigurasikan.
Log masuk pengguna — mod utama.
Mod stesen kerja pilihan tanpa kata laluan.
Tindakan tahap kepercayaan tinggi masih memerlukan log masuk sebenar.
Read / Write / Manage / Admin dalam skop projek.

Butiran teknikal

12Kelulusan — di sebalik tabir

Proses yang diformalkan dan boleh diulang.

Hantar untuk kelulusan

Mencipta permintaan kelulusan untuk semakan model atau pakej dokumen yang dipilih.

Tangkapan tidak berubah

Merekod keadaan tepat model dan dokumen yang disemak supaya keputusan boleh dihasilkan semula.

Laluan kelulusan

Mentakrifkan langkah semakan berurutan atau selari, peserta yang bertanggungjawab dan keputusan yang diperlukan.

Keputusan direkodkan

Menyimpan kelulusan, penolakan, pemulangan dan ulasan bersama pengarang serta cap masa.

Sejarah peristiwa

Menyimpan garis masa tambah-sahaja bagi penyerahan, tugasan, keputusan dan perubahan status.

Penyegerakan status

Mengembalikan status kelulusan yang disahkan kepada objek projek dan aliran kerja Revit yang bersambung.

Kemas kini masa nyata

Menerbitkan perubahan kelulusan kepada klien yang bersambung tanpa memerlukan muat semula halaman secara manual.

Butiran teknikal

13WorkPackage — hab 4D/5D

Objek pusat yang menghubungkan model, kuantiti, anggaran, jadual dan kemajuan.

`ModelElement`	Menghubungkan pakej kerja kepada elemen BIM dan pengecam stabilnya.
`QuantityItem`	Menyimpan kuantiti terukur dan sumber asal setiap kuantiti.
`EstimateItem`	Menghubungkan kuantiti dengan item anggaran, kadar unit dan kos yang dikira.
`WorkPackage`	Bertindak sebagai objek pusat yang menghubungkan skop, model, kos, jadual, tanggungjawab dan bukti.
`ScheduleActivity`	Menghubungkan pakej kerja kepada aktiviti terancang, tarikh, kebergantungan dan data laluan kritikal.
`ProgressSnapshot`	Menyimpan kemajuan sebenar, penunjuk nilai diperoleh dan fakta tempoh pelaporan.

Why no cross-DB FK

Pangkalan data projek dibahagikan mengikut bidang subjek.

Butiran teknikal

14Piawaian, disiplin, peringkat, set

Piawaian projek menentukan format dokumentasi, anggaran dan jadual.

`ProjectStandard`

Mentakrifkan peraturan projek aktif, konvensyen penamaan dan struktur maklumat yang diperlukan.

`Disiplin`

Mengekalkan katalog disiplin projek dan tanggungjawab khusus disiplin.

`PackageType`

Mentakrifkan struktur pakej boleh guna semula untuk kerja reka bentuk, perolehan dan pembinaan.

`ProjectStage`

Mengawal peringkat projek, peralihan peringkat dan data yang dijangka pada setiap peringkat.

`ProjectRole`

Mentakrifkan tanggungjawab, kebenaran dan kuasa kelulusan dalam projek.

`StandardPreset`

Menggunakan set boleh guna semula bagi piawaian, disiplin, peringkat, peranan dan jenis pakej.

Butiran teknikal

15REST API — kumpulan utama

REST API mengikut bidang subjek, disahkan JWT.

`/api/auth/*` · Pengesahan, sesi akaun, pemulihan kata laluan dan token akses.
`/api/approvals/*` · Permintaan kelulusan, laluan, keputusan, ulasan dan perubahan status.
`/api/cde/*` · Projek, model, dokumen, isu dan data projek yang dikongsi.
`/api/chats/*` · Perbualan projek, peserta, mesej dan lampiran.
`/api/tasks/*` · Tugasan, penerima tugas, tarikh akhir, keutamaan dan keadaan penyelesaian.
`/api/standards/*` · Piawaian projek, disiplin, peringkat, peranan dan pratetap pakej.
`/api/45d/*` · Pakej kerja, kuantiti, anggaran, aktiviti jadual dan kemajuan.
`/api/admin/*` · Pentadbiran, konfigurasi, diagnostik dan operasi penyelenggaraan terkawal.

Butiran teknikal

16Glosari

CDE: Common Data Environment — ruang terkawal untuk maklumat projek, komunikasi dan keputusan.
Extensible Storage: Mekanisme Revit untuk menyimpan data aplikasi berstruktur di dalam model.
Shared Parameters: Parameter Revit yang dikongsi merentas projek dan keluarga melalui fail definisi bersama.
ProjectElement: Rekod di sisi projek yang mewakili elemen BIM di luar dokumen Revit.
ModelElement: Rujukan stabil kepada elemen dalam model dan semakan model tertentu.
Snapshot: Rekod tidak berubah bagi keadaan tepat data projek yang digunakan untuk semakan atau kelulusan.
ApprovalRequest: Permintaan rasmi yang menghantar skop tertentu melalui laluan kelulusan.
WorkPackage: Objek pusat 4D/5D yang menghubungkan skop, kuantiti, kos, jadual dan tanggungjawab.
EVM: Earned Value Management — pengukuran kemajuan menggunakan nilai terancang, nilai diperoleh dan kos sebenar.
CPM: Critical Path Method — analisis jadual berdasarkan kebergantungan aktiviti dan apungan yang tersedia.

Butiran teknikal

17Apa yang akan datang

Pelaksanaan semasa mempunyai teras yang berfungsi; di bawah adalah apa yang sedang kami kembangkan seterusnya.

Penyetempatan diperluas

Semakan terminologi lengkap dan istilah khusus domain untuk setiap lokal yang disokong.

Aliran kerja dokumen

Daftar dokumen berversi, penghantaran, pakej semakan dan rantaian bukti.

4D/5D lebih mendalam

Perancangan pakej kerja yang lebih terperinci, kawalan kos, ramalan kemajuan dan analisis nilai diperoleh.

Saling kendali BCF

Bertukar isu dan sudut pandang dengan aplikasi BIM lain melalui standard BCF.

Penyelarasan model terpaut

Menyelaras model terpaut, pemilikan, semakan dan kebergantungan antara model.

Kebolehcerapan

Papan pemuka operasi, metrik audit, diagnostik dan pemantauan kesihatan perkhidmatan.