Как устроен ClashFlow: контур заказчика, сервисы IT4BIM, цикл от модели
до коллизий, диаграмма развёртывания (кто с кем общается) и кто чем
пользуется.
Диаграммы совместимы с Mermaid 8.8 (Wiki.js).
Данные и работа команды — у заказчика. Снаружи — сервисы IT4BIM:
обновления, лицензия, централизованные логи.
| У заказчика | От IT4BIM |
|---|---|
| Модели, NWC/NWF, отчёты, статусы, БД | — |
| Keycloak площадки (вход сотрудников) | Временно учётки для внедрения / лицензии |
| Core, Worker, плагины на ПК | Обновления: GitLab (Core), SoftInstaller (Worker / add-in) |
| Исходящий доступ к сервисам IT4BIM | Сервер лицензий, Seq |
Подробнее про поставку — Внедрение.
Ресурсы CPU/RAM/диск и сборка Worker — Железо.
Сверху вниз: контур заказчика (рабочие места → Kubernetes → Windows Server),
затем сервисы IT4BIM. Внутри контура всё ходит в один API;
тяжёлая работа с моделями — на Windows Server у шары.
Связь API ↔ службы Worker двусторонняя: Core вызывает HTTP-службы
Worker (дерево моделей, очередь NWC, отчёт); агенты забирают задания
из API и после прогона Navisworks загружают результат (коллизии,
картинки) обратно.
| Блок | Где | Что внутри |
|---|---|---|
| Рабочие места | ПК сотрудников | Браузер, плагины, Power BI |
| Kubernetes (Core) | Linux / K8s / Docker | Frontend, API, Keycloak, PostgreSQL, MinIO |
| Windows Server | Отдельная машина у шары | Службы Inventory / NWC / Report, Navisworks, Updater |
| IT4BIM | Снаружи контура | Seq, SoftInstaller, лицензии, GitLab |
| От | К | Зачем |
|---|---|---|
| Браузер | Frontend → API | UI, диспетчеры, коллизии |
| Плагины | API (+ Keycloak) | Список коллизий, статусы, экспорт |
| Power BI / скрипты | API | Отчёты и автоматизация |
| API | PostgreSQL / MinIO | Данные и картинки |
| API ↔ службы Worker | двусторонне | Core ходит к Inventory / NWC / Report; агенты забирают задания из API и загружают отчёты обратно |
| Службы Worker | Navisworks + шара | Выгрузка NWC и проверка |
| WorkerUpdater | SoftInstaller | Обновление служб |
| Контур | Seq / лицензии / GitLab | Логи, подписка, образы Core |
Состав железа Windows Server и ресурсы Core —
Железо и контур.
Три блока: Core хранит и отдаёт, Worker готовит NWC и гоняет
проверку, клиенты смотрят и правят статусы.
| Часть | Где | Зачем |
|---|---|---|
| Core | Linux / Docker / K8s | Веб, API, хранение отчётов и настроек; вход — Keycloak площадки |
| Windows Worker | ВМ / сервер с Autodesk | Дерево моделей, NWC, Clash Detective, загрузка результата. Нужен Navisworks Manage тех же годов, что Revit на объекте |
| Клиенты | ПК пользователей | Браузер, плагины Revit/Tekla/Navis; обновления через SoftInstaller / установщики |
Версии Autodesk на Worker. NWC и проверка идут через Navisworks Manage.
Пример: на объекте Revit 2023 и 2025 — на Worker нужны Manage 2023 и
2025 (Automation / batch). Диапазон поставки — 2020–2026.
Расписание — диспетчер задач; ручной запуск —
из диспетчера моделей или политики.
Все клиенты ходят в один API. Плагины и веб не ведут «свои» списки
коллизий отдельно от Core.
| Клиент | Типичная роль | Что делает |
|---|---|---|
| Веб | BIM-координатор, менеджер | Серверы и выгрузка, дерево, расписания, коллизии в браузере |
| Revit и Tekla | Проектировщик | Список в модели, переход к элементам, статусы |
| Navisworks | Координатор / автоматика | Отправка результатов Clash Detective в API |
| API / Power BI | Аналитик, IT | Дашборды и автоматизация |
Вход — Keycloak (веб и desktop). Роли —
Роли и сценарии.
| Понятие | Простыми словами |
|---|---|
| NWC | Выгрузка модели для Navisworks; ClashFlow актуализирует при изменении исходника |
| NWF | Сборка нескольких моделей для совместной проверки |
| Отчёт / job | Полный прогон: NWC → проверка → загрузка коллизий |
| Политика актуализации | Какие NWF и когда запускать — диспетчер задач |
| Core | Сервер заказчика: API, веб, хранилище |
| Worker | Windows-часть: NWC и проверка в Navisworks |
Чеклист — приёмка.