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.

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

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

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

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