RevitCDE — огляд рішення

Для покупців

01Що це

RevitCDE — середовище спільних даних для проєктів Revit.

Вона зв'язує дії користувачів з конкретними об'єктами моделі.

Ключова ідея

Побудувати перевірюваний цифровий контур.

Для покупців

02Для кого

RevitCDE закриває потреби кількох ролей.

BIM-координатор / керівник проєкту

Бачить стан моделі, погоджень, документів і завдань.

Автор (проєктувальник)

Працює в Revit без постійного перемикання контексту.

Согласующий

Перевіряє вхідні заявки зі snapshot і документами.

Наблюдатель

Доступ на читання в рамках проєкту.

Сметчик

Кошторисна база, позиції, немодельовані витрати.

Інженер-планувальник

Графік, активності, немодельовані чазві процеси.

Администратор

Сервер, користувачі, проєкти, бази даних, політики.

Для покупців

03Які проблеми вирішує

Розрив між Revit і процесами управління

Чому це болісно

Погодження та завдання живуть окремо від моделі.

Як ми це вирішуємо

Плагін захоплює дані моделі та зв'язує заявки з об'єктами.

Немає єдиного джерела істини

Чому це болісно

Файли, e-mail і таблиці розходяться за версіями.

Як ми це вирішуємо

Структура CDE зберігає проєкти, документи, версії та історію.

Непрозорі погодження

Чому це болісно

Рішення губляться, а маршрути неформальні.

Як ми це вирішуємо

ApprovalRequest, багатоетапні маршрути, події лише на додавання, незмінні знімки.

Статус моделі не видно в Revit

Чому це болісно

Проєктувальник не бачить, що погоджено, на розгляді або відхилено.

Як ми це вирішуємо

Статуси відображаються в Shared Parameters і Extensible Storage.

3D, 4D і 5D не пов'язані

Чому це болісно

Кошторис і графік ведуться окремо; роботи поза моделлю випадають з поля зору.

Як ми це вирішуємо

estimate.db і schedule.db за проєктами, WorkPackage як хаб 4D/5D.

Офлайн/локальна робота без сервера

Чому це болісно

Від'єднаним моделям потрібне локальне сховище без втрати шляху до сервера.

Як ми це вирішуємо

Локальний режим в Extensible Storage, опціональна зовнішня однофайлова БД, подальша міграція на сервер.

Для покупців

04Як працює

Три шари утворюють єдиний контур даних.

Користувач працює в Revit. Плагін читає елементи моделі, листи, види, специфікації та статуси.
Модель прив'язується до проєкту на сервері. Прив'язка зберігається усіредині RVT-моделі через Extensible Storage.
Плагін синхронізує елементи проєкту, елементи моделі, зміни, статуси, заявки, завдання, чати та документи з сервером.
Сервер зберігає глобальні дані в основній базі даних, а предметні дані — у базах за проєктами: model_{guid}.db, disciplines.db, estimate.db, schedule.db.
Веб-кабінет надає доступ до проєктів, документів, погоджень, завдань, чатів та адміністрування; оновлення в реальному часі передаються через SignalR.
Рішення погоджувальників, зміни статусів, пов'язані документи та завдання повертаються в Revit і відображаються в плагіні та параметрах моделі.

Архітектурний принцип

Сервер є джерелом істини для спільного режиму роботи; модель, як і раніше, зберігає мінімальну прив'язку та локальні дані, щоб робота зберігалася під час перезапуску Revit і в офлайн-періоди.

Для покупців

05Що робить

Функціональна карта в короткому вигляді.

Проєкти

Налаштування проєкту, учасники, ролі, стандарти, дисципліни, стадії, комплекти.

Модель

Прив'язка RVT, синхронізація, ідентифікатори, fingerprint, статуси, відстеження змін.

Погодження

Заявки, маршрути, знімки, рішення, відкликання, журнал, реальний час.

Документи

Документи CDE, версії, завантаження/вивантаження, SHA-256, WIP→Shared→Published→Archived.

Завдання

Канбан, Гант, важливість, статуси, виконавці, зв'язки завдань.

Комунікації

Проєктні чати, повідомлення, реакції, листування, інтеграція з e-mail.

Адміністрування

Користувачі, ролі, параметри сервера, бази даних, стан системи, політики авторизації.

4D/5D

Кошторис, графік, WorkPackage, знімки обсягів, EVM/CPM.

Локальна робота

Extensible Storage, опціональна зовнішня локальна БД, міграція на сервер.

Локалізація

Централізована локалізація інтерфейсу, 22 мови за дорожньою картою.

Для покупців

06Сцінарії використання

Відправлення листа або виду на погодження

Крок 1
Крок 2
Крок 3
Крок 4
Крок 5
Крок 6

Документ від WIP до публікації

Крок 1
Крок 2
Крок 3
Крок 4
Крок 5

Зв'язування моделі, кошторису та графіка

Крок 1
Крок 2
Крок 3
Крок 4
Крок 5

Для покупців

07Часті запитання

Запитання 1

Відповідь 1

Запитання 2

Відповідь 2

Запитання 3

Відповідь 3

Запитання 4

Відповідь 4

Запитання 5

Відповідь 5

Запитання 6

Відповідь 6

Запитання 7

Відповідь 7

Запитання 8

Відповідь 8

Запитання 9

Відповідь 9

Запитання 10

Відповідь 10

Технічні деталі

08Склад рішення

Компонент	Назначення	Технология
`RevitCDE.Addin`	Точка входу Revit-плагіна, прив'язка моделі та реєстрація команд.	C# /.NET Framework, Autodesk Revit API
`RevitCDE.UI`	Панелі, команди та взаємодія користувача усіредині Revit.	WPF / MVVM
`RevitCDE.Core`	Прикладні сервіси, синхронізація, локальне зберігання та зв'язок із сервером.	C# сервіси, HTTP-клієнти, SQLite
`RevitCDE.Domain`	Загальні доменні моделі, ідентифікатори, статуси та бізнес-правила.	Бібліотека netstandard2.0
`RevitCDE.Server`	Центральний API, автентифікація, проєктні дані та інтеграційні сервіси.	ASP.NET Core 8, EF Core, PostgreSQL
`RevitCDE.Cabinet`	Веб-кабінет для проєктів, документів, погоджень, завдань, чатів та адміністрування.	TypeScript / React web UI
`RevitCDE.Localization`	Центральні словники перекладів і перемикання мови для всього видимого UI.	JSON-словники, спільні i18n-ключі

Технічні деталі

09Локальний і серверний режими

RevitCDE підтримує два режими роботи.

Локальний режим

Дані зберігаються в Extensible Storage моделі.

Зовнішнє локальне сховище

Окремий файл бази даних на кожну RVT-модель.

Серверний режим

Активні дані зберігаються на сервері.

Локальний і серверний режими

Правила міграції з локального режиму на серверний.

Технічні деталі

10Архітектура зберігання

Хранабоще	Що зберігає	Чому так влаштовано
Основна БД сервера	Користувачі, організації, проєкти, ролі, глобальні налаштування та дані ліцензій.	Наскрізні проєктні дані зберігаються в одній авторитетній серверній базі.
model_{guid}.db	Елементи моделі, листи, види, специфікації, обсяги та прив'язки моделі.	Великі модельні дані ізольовані за RVT-моделлю заради продуктивності та обслуговування.
disciplines.db	Дисципліни проєкту, стадії, комплекти та структура документації за стандартом.	Стандарти проєкту можуть розвиватися без зміни глобальної схеми.
estimate.db	Кошторисні документи, позиції, немодельовані витрати, зв'язки обсягів і WorkPackage.	Дані вартості мають власний життєвий цикл і включають позиції поза моделлю.
schedule.db	Активності графіка, залежності, немодельовані процеси часу та зв'язки WorkPackage.	Планування потребує CPM/Gantt-логіки і може посилатися на модель і кошторис.
Extensible Storage	Мінімальна прив'язка моделі, технічні ідентифікатори та локальні резервні дані усіредині RVT.	Модель залишається самоідентифікованою навіть поза серверним середовищем.
Зовнішня локальна БД	Опціональна однофайлова локальна БД для чатів, погоджень, документів, завдань та інших локальних даних.	Від'єднані/локальні моделі можуть зберігати більше даних без роздування Extensible Storage.

Технічні деталі

11Безпека та доступ

Безпека побудована навколо учасників, ролей, JWT і довірених режимів.

Автентифікація JWT.
Безпечні хеші паролів; створення адміністратора під час первинного налаштування.
Вхід за іменем користувача, e-mail або телефоном, якщо налаштовано.
Вхід користувача — основний режим.
Опціональний режим робочої станції без пароля.
Дії з визким рівнем довіри усі одно вимагають справжнього входу.
Read / Write / Manage / Admin у рамках проєкту.

Технічні деталі

12Погодження — устрій процесу

Формалізований і відтворюваний процес.

Отправка на зглазвание

Создаьот запрос на зглазвание вибранной версії модели або комплекта документов.

Неизменяемий снимок

Фиксирует точное стан модели і документов, чтоби прийнятоое рішення можна било воспроизвести.

Маршрути зглазвания

Определяет последовательние або параллельние етапи проверки, відповідьственних і обязательние рішення.

Зафиксированние рішення

Хранит зглазвания, отклонения, возврати і комментарии вместе з автором і временем.

История збитий

Ведьот неизменяемую хронологию отправок, назначений, решений і изменений статузв.

Синхронизация статуса

Возвращает подтверждьонний статус зглазвания об’єктам проєкту і связанному процессу Revit.

Обновления в реальном времени

Передаьот зміни зглазвания подключьонним клиентам без ручного оновлення сторінки.

Технічні деталі

13WorkPackage — центр 4D/5D

Центральний об'єкт, що зв'язує модель, обсяги, кошторис, графік і прогрес.

`ModelElement`	Связивает пакет работ з BIM-елементами і их устойчивими идентификаторами.
`QuantityItem`	Хранит измеренние об’єми і джерело получения каждого значения.
`EstimateItem`	Связивает об’єми з позициями смети, единичними расценками і расчьотной стоимостью.
`WorkPackage`	Об’единяет об’єм работ, модель, стоимость, график, відповідьственность і доказательную базу.
`ScheduleActivity`	Связивает пакет работ з операциями графика, датами, зависимостями і критическим путьом.
`ProgressSnapshot`	Хранит фактический прогресс, показатели освоенного об’єма і данние звітного периода.

Why no cross-DB FK

Бази даних проєктів розділені за предметними областями.

Технічні деталі

14Стандарти, дисципліни, стадії, комплекти

Стандарт проєкту визначає формати документації, кошторису та графіка.

`ProjectStandard`

Определяет действующие правила проєкту, правила именования і обязательную структуру данних.

`Дисципліна`

Ведьот классификатор дисциплин проєкту і відповідьственность по каждой дисциплине.

`PackageType`

Определяет повторно используемие структури пакетов для проєктирования, закупок і строительства.

`ProjectStage`

Управляет стадиями проєкту, переходами між ними і зставом данних на каждой стадии.

`ProjectRole`

Определяет відповідьственность, права доступа і полномочия зглазвания в проєкте.

`StandardPreset`

Применяет готовий набор стандартов, дисциплин, стадий, ролей і типов пакетов.

Технічні деталі

15REST API — основні групи

REST API за предметними областями, з JWT-автентифікацією.

`/api/auth/*` · Аутентификация, сеанси учьотних записей, восстановление пароля і токени доступа.
`/api/approvals/*` · Запроси на зглазвание, маршрути, рішення, комментарии і зміни статузв.
`/api/cde/*` · Проєкти, модели, документи, замечания і общие данние проєкту.
`/api/chats/*` · Проєктние обсуждения, участники, зобщения і вложения.
`/api/tasks/*` · Задачи, исполнители, сроки, приоритети і зстояния виполнения.
`/api/standards/*` · Стандарти проєкту, дисциплини, стадии, роли і шаблони пакетов.
`/api/45d/*` · Пакети работ, об’єми, смети, календарние операции і фактический прогресс.
`/api/admin/*` · Администрирование, налаштування, диагностика і контролируемие операции обслуживания.

Технічні деталі

16Глоссарий

CDE: Среда общих данних — управляемое просторіво для проєктной інформації, коммуникаций і решений.
Extensible Storage: Механизм Revit для хранения структурированних данних застосунку усіредині модели.
Shared Parameters: Общие параметри Revit, используемие в проєктух і семействах через единий файл определений.
ProjectElement: Запись на стороне проєкту, представляющая BIM-елемент вне документа Revit.
ModelElement: Устойчивая ссилка на елемент в конкретной модели і версії модели.
Snapshot: Неизменяемая фиксация точного зстояния проєктних данних для проверки або зглазвания.
ApprovalRequest: Формальний запрос, направляющий определьонний об’єм данних по маршруту зглазвания.
WorkPackage: Центральний об’єкт 4D/5D, об’единяющий об’єм работ, количества, стоимость, график і відповідьственность.
EVM: Керування освоенним об’ємом: оценка прогресса по плановой, освоенной і фактической стоимости.
CPM: Метод критического пути: анализ графика по зависимостям операций і доступному резерву времени.

Технічні деталі

17Що далі

Поточна реалізація має робоче ядро; нижче — напрямки розвитку.

Расширенная локализация

Полная терминологическая перевірка і профессиональние формулировки для усіх поддерживаемих моваов.

Документооборот

Версионние реестри документов, передачи, комплекти на проверку і цепочки доказательств.

Углубльонние 4D/5D

Детальное планирование пакетов работ, контроль стоимости, прогнозирование і анализ освоенного об’єма.

Совместимость з BCF

Обмен замечаниями і точками обзора з другими BIM-застосункуми по стандарту BCF.

Координация пов’язаних моделей

Керування связанними моделями, відповідьственностью, версіями і межмодельними зависимостями.

Наблюдаемость

Операционние панели, показатели аудита, диагностика і контроль зстояния сервизв.