ViVBIM 6.0 — возможности и как пользоваться
Обновление

ViVBIM 6.0

Возможности приложения и как пользоваться каждым разделом: объекты и стадии, альбомы и задачи, пояснительная записка и стоимость, инженерные расчёты, скриншотер, чат, карта сообщества, база знаний и ИИ-агент «Орион».

ViVBIM 6.0 — что нового

ViVBIM — рабочее место проектировщика: объекты и стадии, альбомы и задачи, пояснительная записка и стоимость, инженерные расчёты, корпоративный чат, база знаний и ИИ-помощник. Версия 6.0 собирает всё это в одном приложении и добавляет инструменты, которые раньше приходилось держать отдельно.

Ключевые возможности версии

  • Детальный экран объекта — стадии проектирования, файловая структура, альбомы и их выдача, задачи, скриншоты, конфигуратор пояснительной записки и стоимости.
  • Инженерные расчёты — водоснабжение, подбор колодцев (включая перепадные, УГВ, сейсмику, упоры, дождеприёмники), пожаротушение, водосчётчики, земляные работы, ливневые стоки и инженерный калькулятор; результаты выгружаются в Word, PDF и Excel и передаются в пояснительную записку.
  • Пояснительная записка — генерация по нормативам, редактирование текста пунктов с сохранением правок, два варианта содержания, экспорт в PDF и Word.
  • Агент «Орион» — ИИ-помощник с доступом к нормативной базе, интернет-поиску и данным ваших объектов, расчётов и задач; формирование официальных отчётов.
  • Скриншотер, чат, карта сообщества и база знаний — встроенные сервисы для повседневной работы команды.

Как пользоваться этой страницей

Выберите нужный раздел в оглавлении. Каждый раздел построен одинаково: что это, как открыть, какие данные вводятся, что получается в результате и что полезно знать об ограничениях.

Скриншотер

Встроенный инструмент снятия скриншотов с редактором разметки: захват области, всего экрана, активного окна или отложенный снимок, аннотирование, распознавание текста (OCR), закрепление картинки поверх окон и автоматическая загрузка в облачное хранилище со ссылкой для отправки коллегам.

Как открыть

Три способа:

  • Глобальная горячая клавиша — работает, пока запущено приложение ViVBIM, даже если его окно свёрнуто или активно другое приложение: Ctrl+Shift+S — захват области, Ctrl+Shift+F — весь экран, Ctrl+Shift+W — активное окно, Ctrl+Shift+D — отложенный захват.
  • Кнопка 📷 в панели инструментов в шапке приложения (подсказка «Сделать скриншот (Ctrl+Shift+S)»).
  • Кнопка 📜 в той же панели — открывает историю скриншотов.

Как пользоваться

  1. Нажмите нужное сочетание клавиш или кнопку 📷.
  2. Для захвата области обведите мышью нужный фрагмент прямо на экране (приложение затемняет фон). Для режима «весь экран» снимок делается сразу.
  3. Для отложенного захвата выберите задержку — 3, 5, 10 или 15 секунд — и нажмите 🚀 Запустить; снимок всего экрана будет сделан через выбранное время.
  4. Откроется окно ✏️ Редактор скриншота. При необходимости разметьте изображение: выберите инструмент в списке Инструмент:, цвет, толщину линии и нанесите пометки.
  5. Нажмите 🚀 Сохранить в облако — снимок в выбранном формате загрузится в хранилище, а ссылка автоматически скопируется в буфер обмена.
  6. В окне 🔗 Скриншот загружен выберите действие: 📋 Ссылка (скопировать ссылку), 🖼 Картинка (скопировать изображение), 💾 Сохранить (сохранить локально), 📌 Закрепить (оставить поверх всех окон) или 📎 Привязать к объекту.
  7. Чтобы вернуться к ранее сделанным снимкам, откройте историю кнопкой 📜 и выберите нужную запись.

Возможности

  • Четыре режима захвата: область, весь экран, активное окно, отложенный снимок (3/5/10/15 с).
  • Инструменты разметки: 🖊 Перо, ▭ Прямоугольник, ◯ Эллипс, ╱ Линия, ➡ Стрелка, 🅰 Текст, 🧹 Ластик, ▣ Зап. прямоуг., ◉ Зап. эллипс, 💧 Размытие, 📏 Измерение.
  • Нумерация объектов на снимке (🔢 Номера, круглая или квадратная форма), пипетка 🧪 Пипетка для взятия цвета с картинки, палитра 🎨 Цвет, толщина линии от 1 до 30.
  • Отмена и повтор действий — ↶ Отменить / ↷ Повторить (Ctrl+Z, Ctrl+Y, Ctrl+Shift+Z).
  • Распознавание текста на снимке: кнопка 🔤 OCR (языки русский + английский) и режим распознавания выделенной области. Результат показывается в отдельном окне.
  • Калибровка масштаба 📏 Калибровка — чтобы результаты инструмента «Измерение» выводились в реальных единицах, а не в пикселях.
  • Сохранение локально (💾 Сохранить локально) и закрепление поверх всех окон (📌 Закрепить).
  • Форматы сохранения: PNG и WEBP — список зависит от поддержки форматов в системе.
  • Два режима окна редактора: обычное окно и безрамочный редактор ровно по выделенной области.
  • Автоматическая загрузка в хранилище и копирование ссылки в буфер обмена.
  • Привязка скриншота к карточке объекта (📎 Привязать к объекту).
  • История скриншотов: список со миниатюрами, копирование ссылки и картинки, открытие и удаление записи.

Полезно знать

  • Глобальные горячие клавиши регистрируются штатными средствами Windows, поэтому срабатывают, даже когда окно ViVBIM неактивно, — но только пока приложение запущено.
  • Комбинации можно изменить: Настройки → вкладка Интерфейс. Там же переключается режим редактора скриншотов.
  • Если комбинация уже занята другой программой, Windows не позволит её зарегистрировать. В этом случае в журнал пишется предупреждение, а снимок всегда доступен через кнопку 📷 или другое сочетание.
  • История хранится в файле screenshot_history.json рядом с папкой миниатюр и ограничена 100 последними записями; записи старше 7 дней удаляются автоматически вместе с миниатюрами.
  • Для получения ссылки нужно настроить доступ к хранилищу (S3): адрес, ключ доступа, секретный ключ и бакет. Если хранилище не настроено, при сохранении появится сообщение «Не удалось загрузить скриншот в S3».
  • Историю можно открыть и из окна редактора — через кнопку истории в шапке приложения.
  • Для работы распознавания текста необходимы библиотека pytesseract, Pillow и папка Tesseract-OCR с файлом tessdata/rus.traineddata. Если OCR недоступен, кнопка сообщит об этом и предложит инструкцию.
  • Повторный запуск захвата во время уже идущего захвата игнорируется — защита от наложения окон.

Детальный экран объекта

Детальный экран объекта — главный рабочий экран ViVBIM: в одном месте собраны данные объекта, стадии проектирования, файловая структура, альбомы и задачи, выдача альбомов, замечания, заметки, встречи, команда, поставщики и скриншоты, а также конфигуратор пояснительной записки и калькулятор стоимости. Именно здесь ведётся повседневная работа по объекту, поэтому экрану стоит уделить время при первом знакомстве.

Как открыть

  1. Откройте список объектов и щёлкните по карточке нужного объекта — откроется его детальный экран.
  2. Экран также открывается по ссылке на объект из карточки компании, из карточки альбома и из карточки встречи.
  3. С главного экрана (дашборда) объект открывается по нажатию на его плитку или строку.
  4. Вернуться назад можно кнопкой ← Назад в шапке экрана, клавишами Alt + ← или штатной кнопкой «назад» в общей шапке приложения.

Один и тот же объект присутствует в системе по разу на каждую созданную стадию проектирования: каждая стадия — отдельная запись объекта со своим идентификатором, объединённая с остальными общим идентификатором группы. Поэтому переключение стадии на детальном экране открывает данные именно этой стадии, а команда проекта и поставщики остаются общими для всех стадий.

Из чего состоит экран

Сверху вниз по экрану расположены:

  • Шапка — иконка объекта, название, селектор стадии проектирования (кнопка с названием текущей стадии), кнопка 🗺 Карта для показа объекта на карте и установки флажка расположения, а также кнопки ← Назад, 🗑️ Удалить, 🔄 Обновить и кнопка-звёздочка ☆ для добавления объекта в избранное.
  • Сводка — блоки «📋 Основные данные» (количество альбомов и задач, статус, количество встреч), «📅 Планирование» (сколько дней осталось, затраченные и запланированные часы, доля затраченного времени), «💰 Финансы» (оплачено, остаток, заработок за час — показывается только для объектов с типом работы «Подработка»), «📦 Выдача» (выдано альбомов, замечаний) и «🔗 Ресурсы» (компания, ссылка на файлы, стоимость оборудования). Здесь же находится кнопка 🌐 Опубликовать на карте сообщества.
  • Карточка «📝 Объект, ТУ ВК и пояснительная записка» — статус заполнения ПЗ, краткая сводка (название, шифр, число потребителей, признаки коммерции и парковки) и единый ряд из восьми кнопок: 🏢 Объект, 📋 ТУ, 📄 ПЗ ИОС2, 👁️ Просмотр ПЗ ИОС2, 📄 ПЗ ИОС3, 👁️ Просмотр ПЗ ИОС3, 🧮 Расчёт стоимости и 🗑️ (удаление только данных ПЗ).
  • Файловая структура, Альбомы объекта, Задачи выбранного альбома, Запланированные встречи, Выдача альбомов, Замечания, Вопросы по объекту, Заметки по объекту, Команда проекта, Скриншоты объекта и Поставщики и оборудование.

У правого края экрана расположена боковая навигация: в свёрнутом виде виден только значок ≡, при наведении панель раскрывается и показывает список разделов экрана (Сводка, Детальная информация, Файловая структура, Альбомы, Задачи, Встречи, Выдача альбомов, Замечания, Вопросы по объекту, Заметки, Команда, Скриншоты, Поставщики). Щелчок по разделу прокручивает экран к соответствующему блоку.

Каждый крупный блок можно свернуть и развернуть; состояние свёрнутости запоминается отдельно для каждого объекта.

Стадии проектирования

Стадия проектирования — это этап жизненного цикла объекта. В ViVBIM стадии не являются просто подписью: каждая стадия — это отдельная запись объекта со своими альбомами, задачами, встречами, замечаниями и собственной папкой в файловой структуре. Команда проекта и поставщики при этом общие для всех стадий объекта.

Доступны следующие стадии (в этом порядке они показываются в интерфейсе):

  • Эскиз;
  • Предварительный проект;
  • Проектная документация;
  • Рабочая документация;
  • Согласование;
  • Завершено;
  • Капитальный ремонт;
  • Реконструкция;
  • Авторский надзор;
  • Сопровождение стройки.

Как переключиться на другую стадию. Нажмите кнопку с названием текущей стадии в шапке объекта. В открывшемся меню перечислены только те стадии, которые уже созданы у этого объекта: текущая помечена как «(текущая)» и неактивна, остальные доступны для перехода. Выберите нужную — экран перезагрузится с данными этой стадии.

Как создать новую стадию.

  1. Нажмите кнопку стадии в шапке объекта.
  2. Выберите в меню пункт ➕ Добавить стадию….
  3. В окне «Добавить стадию» выберите из списка стадию, которой у объекта ещё нет, и нажмите Создать. В окне есть подсказка: «Будет создана копия объекта. Команда и поставщики общие для всех стадий».
  4. Приложение создаст копию записи объекта с новой стадией, сразу переключится на неё и покажет уведомление «Стадия «…» создана».

Что важно знать про создание стадии: копируются поля самого объекта (название, адрес, технические характеристики, ТЭП, сроки, бюджет и т. д.). Альбомы, задачи, встречи, замечания, заметки и другие связанные данные на новую стадию не переносятся — новая стадия начинается «с чистого листа», а вся история остаётся на прежней стадии. Если такая стадия у объекта уже есть, вторая не создаётся: приложение просто откроет существующую и сообщит «Стадия «…» уже существует — открываю её». Когда список стадий исчерпан, приложение сообщит: «Все возможные стадии уже созданы для этого объекта».

Как удалить текущую стадию. В том же меню выберите 🗑 Удалить текущую стадию… и подтвердите удаление. Приложение предупредит: «Все альбомы, задачи, встречи и замечания этой стадии будут потеряны безвозвратно». Единственную стадию объекта удалить нельзя — пункт меню будет недоступен с пояснением «Нельзя удалить единственную стадию объекта». После удаления текущей стадии экран автоматически переключается на первую оставшуюся стадию объекта, а если стадий не осталось — возвращает вас на предыдущий экран.

Файловая структура объекта

Карточка «📂 Файловая структура» — это встроенный файловый менеджер объекта. Папки создаются по единому шаблону: Компания → Объект (с указанием корпуса) → Стадия проектирования → рабочие папки. Для каждой стадии создаётся свой набор папок, поэтому данные разных стадий не смешиваются.

Внутри папки стадии создаётся следующая структура:

  • 1. Исходные данные — «1.1 Технические условия», «1.2 Задание на проектирование», «1.3 Инженерные изыскания», «1.4 Договоры»;
  • 2. Проектирование — «2.1 Расчеты» (внутри «2.1.1 Word», «2.1.2 Excel», «2.1.3 PDF»), «2.2 RVT», «2.3 DWG», «2.4 PDF», «2.5 События», «2.6 Пояснительная записка», «2.7 Задание от смежников», «2.8 Задание смежникам», «2.9 Замечания»;
  • Разделы — папка для альбомов (разделов) этой стадии;
  • 3. Документация — с подпапкой «3.1 Выдача альбомов»;
  • 4. Чеки;
  • 5. Версии. Архив — «5.1 Предыдущие версии чертежей», «5.2 Черновики», «5.3 Резервные копии».

Внутри папки каждого альбома создаются подпапки: ГЧ, ПЗ, Word, DWG, RVT, Excel, PDF и Задачи (в последней — папка на каждую задачу альбома).

В папках компании, объекта и альбома автоматически формируется файл README.txt с основными сведениями из базы — он помогает ориентироваться в структуре при работе прямо в проводнике.

Возможности карточки файловой структуры:

  • 📂 Открыть — открыть текущую папку в проводнике Windows (в режиме Яндекс.Диска кнопка меняется на 🌐 Открыть в браузере);
  • 📤 Загрузить и 📁 Папку — загрузить файлы или целую папку;
  • ➕ Папка — создать вложенную папку; 🔄 — обновить список;
  • кнопка создания структуры: 📁 Создать структуру объекта (для объекта), 🏢 Создать структуру компании или 🗂️ Создать всю базу — в зависимости от того, откуда открыта карточка;
  • 🗑️ Корзина, 💾 Бэкап, ☁️ В облако (отправка в облако) и кнопка ⚙ настроек облака;
  • строки «Расположение:» с кнопкой Изменить… (выбор базовой папки), «Текущий путь:» и «хлебные крошки» для перехода по уровням;
  • панель «👁 Предпросмотр» справа — быстрый просмотр выбранного файла и кнопка 🔍 Открыть полностью;
  • горячие клавиши внутри карточки: F5 — обновить, Delete — удалить выбранное.

Правая кнопка мыши по файлу или папке открывает меню с действиями: «📂 Открыть», «📤 Загрузить файлы», «📁 Загрузить папку», «➕ Создать папку» («➕ Создать подпапку»), «📦 Переместить в…», «📋 Копировать в…», «🗄️ В архив», «📦 Упаковать в zip», «✏️ Переименовать», «🗑️ Удалить», «📋 Скопировать путь», «🚀 Открыть в системе» и другими.

Связь со стадиями прямая: в шапке карточки и в пути всегда видна стадия, к которой относится содержимое. Переключение стадии на экране объекта переключает и файловую структуру на папку соответствующей стадии.

Выдача альбомов

Альбом — это раздел проекта (например, ВК, НВК, ЭОМ) в рамках одной стадии объекта. Альбомы — основа работы: к ним привязываются задачи, для них создаются папки и по ним ведётся учёт выдачи документации.

Список альбомов объекта находится в блоке «📁 Альбомы объекта». Таблица показывает: №, Название, Статус, Приоритет. Если альбомов нет, выводится надпись «Нет альбомов».

Как создать альбом.

  1. Нажмите ➕ Создать альбом — справа выедет панель создания.
  2. На вкладке «📝 Основная информация» заполните Название альбома (обязательно) и Описание альбома.
  3. На вкладке «⚙️ Детали альбома» задайте Статус, Приоритет, Дату начала, Дату окончания, Бюджет и Фактические затраты.
  4. Сохраните — альбом появится в списке и будет сразу выбран, а под таблицей альбомов откроются задачи этого альбома.

Возможные статусы альбома: Черновик, Запланирован, В работе, На паузе, Завершён, Отменён. Приоритеты: Низкий, Средний, Высокий, Критический.

Правая кнопка мыши по строке альбома открывает меню: ✏️ Редактировать, 🗑️ Удалить, 📂 Перейти к задачам.

Выдача альбомов — отдельный блок «📦 Выдача альбомов». Запись о выдаче фиксирует, какие альбомы и в каких форматах переданы, когда выданы и когда проверены. Таблица выдач показывает: №, Альбом(ы), Дата выдачи, Дата проверки, Формат(ы), Проверен, Ссылка. Кнопки блока: ➕ Добавить выдачу, ✏️ Редактировать, 🗑️ Удалить.

В окне выдачи заполняются: список альбомов объекта (можно выбрать несколько), Дата выдачи, Дата проверки (появляется при отметке «проверен»), Формат(ы) — PDF, DWG, RVT, WORD, EXCEL — и поле папки выдачи. Кнопка 📁 Создать папку формирует папку выдачи по адресу 3. Документация/3.1 Выдача альбомов/ГГГГ.ММ.ДД_Название объекта, внутри — папка на каждый выбранный альбом и подпапки выбранных форматов. Кнопка 📂 рядом открывает созданную папку. Сами файлы при создании папки не копируются — формируется только структура, а упаковать её в zip можно через контекстное меню файловой структуры («📦 Упаковать в zip»). Количество выданных альбомов отражается в сводке экрана.

Задачи

Блок «✅ Задачи выбранного альбома» показывает задачи того альбома, который выбран в таблице альбомов. Пока альбом не выбран, выводится подсказка «Выберите альбом» (или «Нет альбомов», если альбомов у объекта нет). Таблица задач показывает: №, Название, Статус, Приоритет, Срок, Описание.

Как создать задачу — нажмите ➕ Создать задачу в блоке задач (перед этим выберите альбом) или воспользуйтесь пунктом Создать задачу в блоке быстрых действий. Откроется панель формы задачи:

  • вкладка «📝 Основная»: Альбом (в который входит задача), Название (обязательно), Описание, Статус, Приоритет, Начало, Окончание, Оценка времени в часах;
  • вкладка «📎 Дополнительно»: Теги, Заметки, Ссылка на файлы;
  • кнопка сохранения — Создать задачу (при редактировании — Сохранить изменения), рядом Отменить.

Статусы задачи: Новая, В работе, На контроле, Завершена, Отложена, Отменена. Приоритеты — те же четыре, что и у альбома. Связь задач с альбомами прямая: задача всегда принадлежит конкретному альбому, и список задач на экране объекта фильтруется по выбранному альбому. Дополнительно к задаче можно приложить теги, заметки и ссылку на файлы.

Правая кнопка мыши по строке задачи открывает меню: ✏️ Редактировать, 🗑️ Удалить, ✅ Завершить и 📁 В архив (для неархивных задач) либо 📂 Восстановить из архива (для архивных), а также 📄 Открыть задачу — переход на детальный экран задачи. Двойной щелчок по строке также открывает задачу.

Обратите внимание: подзадачи в текущей версии не используются — форма задачи создаёт и редактирует только сами задачи.

Сохранение скриншотов

Блок «📸 Скриншоты объекта» хранит снимки экрана, привязанные к объекту, — удобно для фиксации интерфейсов, ошибок и промежуточных решений.

Как добавить скриншот.

  1. Нажмите ➕ Добавить скриншот в блоке скриншотов, либо выберите этот же пункт в контекстном меню таблицы (правая кнопка мыши по пустому месту таблицы).
  2. Запустится инструмент захвата экрана с редактором пометок. Захват области доступен по глобальной комбинации Ctrl + Shift + S, полного экрана — Ctrl + Shift + F, активного окна — Ctrl + Shift + W, захват с задержкой — Ctrl + Shift + D (комбинации настраиваются в параметрах приложения).
  3. После подтверждения снимка откроется окно «Добавить скриншот», где нужно заполнить Название * (обязательно) и Описание, затем нажать Сохранить.

Файл изображения загружается в облачное хранилище (S3), а в базе сохраняется ссылка на него. Если ссылку получить не удалось, приложение сообщит: «Не удалось получить ссылку на скриншот».

Что видно в таблице. Колонки: №, Название, Описание (длинное описание сокращается), Дата и колонка действий с двумя кнопками: кнопка открытия (с подсказкой «Открыть скриншот») и кнопка 💾 («Скачать скриншот на компьютер»).

Работа со скриншотом по правой кнопке мыши:

  • 📖 Открыть — просмотр во встроенном окне «Просмотр скриншота» с кнопками ➕ Увеличить, ➖ Уменьшить, ⟳ По размеру, ⛶ На весь экран, 💾 Сохранить;
  • 🌐 Открыть в браузере — открыть ссылку в системном браузере;
  • 💾 Скачать на компьютер… — сохранить файл на диск;
  • 🔗 Копировать ссылку — положить ссылку на скриншот в буфер обмена (при успехе появится уведомление «Ссылка скопирована в буфер обмена»);
  • 🖼 Копировать картинку — положить само изображение в буфер обмена;
  • ✏️ Изменить название и описание… — открыть окно «Изменить название и описание» и отредактировать Название * и Описание; изменения сохраняются в базе, поле названия обязательно;
  • 🗑️ Удалить — удаление с подтверждением «Удалить выбранный скриншот безвозвратно?».

Если щёлкнуть правой кнопкой по пустому месту таблицы, кроме добавления скриншота доступен пункт 🔄 Обновить список. Внизу блока есть также кнопка 🗑️ Удалить выбранный для удаления строки, выбранной в таблице. Двойной щелчок по строке открывает просмотр скриншота.

Конфигуратор ПЗ (пояснительной записки)

Конфигуратор ПЗ — это единый редактор данных объекта, технических условий и пояснительной записки. Из него формируется готовый документ ПЗ с титульными листами, штампами, содержанием и приложениями.

Как открыть редактор. В карточке «📝 Объект, ТУ ВК и пояснительная записка» предусмотрены отдельные кнопки: 🏢 Объект — данные объекта, 📋 ТУ — технические условия ВК, 📄 ПЗ ИОС2 — пояснительная записка ИОС2. Все три кнопки открывают один и тот же редактор, но в разных режимах: в режиме только ПЗ отображаются вкладки записки, в режиме ТУ — только технические условия, в режиме объекта — данные объекта. Нумерация вкладок при этом пересчитывается так, что первая видимая вкладка всегда «1».

Из каких вкладок состоит редактор (в режиме показа всех вкладок):

  1. Объект — основные данные, адрес, технические характеристики, ТЭП, планирование, бюджет, прочее;
  2. ТУ ВК — номер и дата выдачи ТУ, исполнитель, срок действия, источник водоснабжения и водоотведения, адреса и координаты подключения, диаметры и материалы труб, давление, расчётные расходы (среднесуточный, максимальный суточный, часовой, секундный, пожаротушение), узлы учёта, особые требования, дополнительная информация;
  3. Титул и штампы — титульные листы, шифры и состав, подписи и даты, лист регистрации изменений, содержание пунктов ПЗ, содержание тома, приложения;
  4. Общие сведения ПЗ — дополнительные сведения об объекте, встроенные помещения общественного назначения, подземная автостоянка;
  5. Водоснабжение — категории и напоры, зонная система, системы здания;
  6. Расчётные расходы — потребители воды, итоговые расходы (загружаются из расчёта водоснабжения), пожаротушение, детали ВПВ и установки пожаротушения;
  7. Напор и насосы — расчёт требуемого напора и насосные установки;
  8. Материалы труб — трубопроводы ХВС/ГВС/подводки, противопожарный водопровод и парковка, изоляция, крепления, сейсмика;
  9. Учёт и ГВС — учёт водопотребления, горячее водоснабжение, качество воды, годовой расход;
  10. Баланс и спец. — баланс водопотребления и водоотведения, спецификация оборудования, нормативные документы;
  11. Примечания — дополнительные примечания к разделам записки;
  12. Текст ПЗ — готовые разделы документа с возможностью правки.

Сохраняются введённые данные кнопкой 💾 Сохранить всё (в режиме только ТУ — 💾 Сохранить ТУ), закрыть без сохранения — Отмена.

Титул, шифры и подписи. На вкладке «Титул и штампы» задаются: заказчик, крупное название, номер тома, часть (подзаголовок), ГИП, генеральный директор; шифр проекта, номер тома СП, отдельный шифр для СП, признак включения строки СО и примечание к ней, включение листа регистрации изменений (форма 9); подписи и даты «Разработал», «Проверил», «Н.контр.», «ГИП»; строки листа регистрации изменений; содержание тома (таблица ГЧ); приложения.

Два варианта содержания. В группе «Содержание пунктов ПЗ» выбирается вариант: «Отдельным листом» — содержание пунктов записки печатается отдельным листом, или «В содержании тома» — пункты записки включаются в содержание тома. Этот же выбор доступен и в окне просмотра (поле Содержание:), причём выбранный вариант запоминается и применяется при следующих экспортах. Перед выгрузкой документа стоит проверить, что выбран нужный вариант содержания: от него зависит состав выходного файла.

Вкладка «Текст ПЗ». Здесь показаны разделы уже сформированного документа ПЗ в виде сворачиваемых блоков: заголовок раздела с кнопкой ▼/▲, текст раздела и кнопка ↩ Сбросить к сгенерированному. Текст можно править прямо в блоке; изменённые разделы помечаются отметкой «✏️ изменено». Правки сохраняются в базе вместе с остальными данными ПЗ. Над блоками расположены строка состояния (сколько разделов построено и в скольких есть правки) и кнопка 🔄 Обновить разделы, которая заново снимает разделы с документа; если есть несохранённые правки, приложение предупредит об их потере и попросит подтверждение.

Просмотр и экспорт. Кнопки 👁️ Просмотр ПЗ ИОС2 и 👁️ Просмотр ПЗ ИОС3 открывают окно «Пояснительная записка — предпросмотр» со встроенным просмотром документа. В окне доступны: выбор варианта содержания, 🖨️ Печать, 💾 Сохранить PDF, 📝 Сохранить Word, 🌐 Открыть в браузере и Закрыть. Сохранение PDF выполняется с контролем готовности документа: приложение дожидается, пока шаблон построит все листы, проверяет формат A4 и при необходимости предлагает компактную печать. Экспорт в Word формирует файл .docx и требует установленного модуля python-docx. Если встроенный просмотр недоступен, приложение предложит открыть документ во внешнем браузере.

Удалить данные записки можно кнопкой 🗑️ в карточке — с подтверждением «Удалить все данные пояснительной записки для этого объекта?».

ПЗ ИОС3 «Система водоотведения»

Записка по системе водоотведения ведётся в отдельном окне (кнопка 📄 ПЗ ИОС3, просмотр — 👁️ Просмотр ПЗ ИОС3). Окно содержит восемь вкладок: «1. Общие и титул», «2. а) Источники и системы канализации», «3. б) Объёмы и состав сточных вод», «4. в) Отходы», «5. г) Прокладка трубопроводов», «6. д) Ливневая канализация (К2)», «7. е) Дренажные воды (К13н)» и «8. Текст ПЗ» — с такими же сворачиваемыми блоками разделов, как в ИОС2. Данные ИОС2 и ИОС3 хранятся раздельно, правки разделов одного документа не затрагивают другой.

Конфигуратор стоимости

Кнопка 🧮 Расчёт стоимости открывает окно «Калькулятор стоимости проектирования» — расчёт стоимости и сроков проектирования по объекту.

Окно состоит из блоков:

  • «📝 Данные объекта» — наименование объекта, город, заказчик, шифр проекта, общая площадь, этажность и секции, количество квартир, парковочных мест, стадийность (значения из карточки объекта подставляются автоматически и доступны для правки);
  • «⚙️ Параметры расчёта» — часов в месяц на одного человека, буфер на правки в процентах, налог в процентах;
  • «👥 Команда проекта» — список проектировщиков с индивидуальными ставками ₽/час (кнопка + Добавить проектировщика);
  • «📊 Детальный расчёт по блокам ТЗ» — работы по разделам с количеством, человеко-часами, исполнителем, стадией, ставкой и стоимостью; строки и разделы можно добавлять и удалять, выводятся итоги по разделу и строка «ВСЕГО (без налога)» с налогом;
  • «💰 Сводная стоимость и сроки» и «💵 Кто сколько заработает» — итоговые показатели и распределение заработка по исполнителям;
  • «📄 Смета для заказчика» — редактируемая смета с кнопками ↻ Заполнить из расчёта и ✕ Очистить смету.

Расчёт запускается кнопкой 🔄 Рассчитать, после чего становятся доступны 🖨️ Печать расчёта (расчёт печатается на A4 в ландшафтной ориентации) и 📄 Смета PDF (смета — A4 в портретной ориентации).

Кнопка 💾 Записать стоимость и время переносит результат расчёта в карточку объекта: плановый бюджет записывается со стоимостью с налогом, фактические затраты — со стоимостью без налога, а также сохраняются запланированные трудозатраты (часы). Даты при этом рассчитываются так: начало (план) берётся из карточки объекта, а если оно не задано — подставляется текущая дата; окончание (план) — начало плюс срок расчёта в месяцах (месяцы переводятся в дни). После сохранения приложение показывает итоговое сообщение с бюджетом, часами, сроком и датами. Все записанные значения затем видны в сводке и карточке объекта.

Встречи, заметки и другие блоки экрана

  • «📅 Запланированные встречи» — таблица №, Название, Дата, Время, Статус, Описание. Завершённые встречи выделены приглушённым фоном и серо-зелёным текстом, отменённые — нейтральным тёмно-серым фоном, серым курсивом; обычные строки идут светлым текстом. Двойной щелчок открывает детальный экран встречи.
  • «📝 Заметки по объекту» — таблица №, Название, Дата создания, Действие с кнопками ➕ Добавить заметку и 📋 Все заметки объекта; кнопка 📖 Открыть в строке открывает заметку целиком.
  • «Вопросы по объекту» — вопросы, связанные с альбомами (аналог вопросов ГИП). Таблица №, Альбом, Вопрос, Дата создания, Ответ; кнопки ➕ Добавить вопрос, ✏️ Редактировать, 🗑️ Удалить, двойной щелчок — открыть вопрос.
  • «📝 Замечания» — таблица №, Дата получения, Раздел, Название, Доп. информация, Примечание, Ответ, Статус, Есть решение, Ссылка, Шифр; кнопки ➕ Добавить замечание, ✏️ Редактировать, 🗑️ Удалить. В форме замечания можно приложить файл — он копируется в папку 2. Проектирование/2.9 Замечания стадии объекта (кнопки 📤 Загрузить файл и ✖ для очистки). Статусы замечаний: План, В работе, Завершено, Принято, Не принято; раздел замечания выбирается из альбомов объекта.
  • «👥 Команда проекта» — таблица ФИО, Должность, Компания, Телефон, Email, Специализация; кнопки ➕ Добавить участника (выбор проектировщика и системного пользователя) и 🗑️ Удалить. Команда общая для всех стадий объекта.
  • «📦 Поставщики и оборудование» — таблица поставщиков Название, Менеджер, Телефон, Email, Оборудование (кнопка с количеством позиций открывает окно «Оборудование поставщика»), таблица оборудования Поставщик, Название, Модель, Кол-во, Цена/ед., Сумма; кнопки ➕ Добавить поставщика и 🗑️ Отвязать. Общая стоимость оборудования выводится в сводке объекта. Двойной щелчок по строке оборудования открывает окно «Детали оборудования».
  • Оплаты. Отдельного блока платежей на детальном экране объекта нет: суммы «Оплатили», «Осталось» и «Заработок за час» показываются в сводке (для типа работы «Подработка»), а сами платежи добавляются через пункт Добавить оплату блока быстрых действий.

Быстрые действия

В боковой панели приложения есть блок «▸ БЫСТРЫЕ ДЕЙСТВИЯ ◂» — он позволяет создавать записи, не покидая текущий экран:

  • Добавить заметку — создать заметку;
  • Добавить оплату — добавить платёж по объекту;
  • Запись в журнал — внести запись в бортовой журнал работ;
  • Записать вопрос — зафиксировать вопрос;
  • Создать задачу — создать задачу;
  • Создать событие — создать встречу (событие).

Выбор объекта в этих формах выполняется в самом диалоге, поэтому быстрые действия удобно использовать, когда вы уже находитесь на детальном экране объекта.

Полезно знать

  • Горячие клавиши приложения: Ctrl + Q — закрыть приложение, Ctrl + H — главный экран, Ctrl + P — профиль, Ctrl + K — экран калькуляторов, Ctrl + Alt + C — инженерный калькулятор, Ctrl + C — чат, Alt + ← — назад. Комбинации Ctrl + C и Alt + ← работают только вне полей ввода: внутри текстового поля Ctrl + C остаётся обычным копированием.
  • Скриншоты: глобальные комбинации Ctrl + Shift + S (область), Ctrl + Shift + F (полный экран), Ctrl + Shift + W (окно), Ctrl + Shift + D (с задержкой). Они работают независимо от того, активно ли окно приложения, и настраиваются в параметрах.
  • Внутри файловой структуры: F5 — обновить список, Delete — удалить выбранное.
  • Для загрузки файлов и скриншотов нужен доступ к хранилищу. Параметры хранилища (S3) задаются в одном из источников: переменные окружения S3_ENDPOINT, S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET, S3_REGION; файл .env в корне программы; секция s3 в файле db_settings.json; либо таблица app_secrets (ключи s3_endpoint, s3_access_key, s3_secret_key, s3_bucket, s3_region). Если хранилище не настроено, приложение сообщает: «S3 не настроен: задайте S3_ENDPOINT/S3_ACCESS_KEY/S3_SECRET_KEY/S3_BUCKET». Уточните параметры у администратора системы.
  • Файловая структура работает либо с локальной папкой (по умолчанию — ProjectsDatabase в папке пользователя; путь можно изменить кнопкой Изменить…), либо с Яндекс.Диском после авторизации — тогда вместо открытия проводника используется открытие в браузере, а папки создаются на Диске.
  • Экспорт ПЗ в Word требует установленного модуля работы с документами Word (python-docx). Экспорт в PDF требует встроенного средства просмотра; при его отсутствии документ открывается во внешнем браузере, где PDF можно сохранить средствами браузера.
  • Свёрнутые блоки экрана запоминаются отдельно для каждого объекта, поэтому экран открывается в том виде, в котором вы его оставили.
  • Удаление объекта выполняется кнопкой 🗑️ Удалить в шапке; если у объекта несколько стадий, используйте удаление стадии через меню стадии — так вы удалите только одну стадию, а не весь объект.

Расчёт водоснабжения

Калькулятор считает расходы воды и тепловую нагрузку ГВС по СП 30.13330.2020 «Внутренний водопровод и канализация зданий»: секундные, часовые (максимальный и минимальный), суточные и средние часовые расходы, три формы баланса водопотребления и водоотведения и расчётные расходы теплоты. Нормы берутся из таблицы А.2 СП 30.13330.2020 и доступны для ручной правки.

Как открыть

Боковая панель → Расчеты. Экран расчётов разбит на вкладки: Внутренние, Наружные, Трубы, Общие. Карточка «Расчёт водоснабжения (СП 30.13330)» находится на вкладке Внутренние. Внутри калькулятора — свои вкладки: ⚙️ Параметры, 👥 Потребители, 📊 Результаты, 🗂 История и экспорт и 🧪 Свой потребитель.

Что вводится

  • Общие параметры (вкладка «Параметры»): Объект (из базы приложения, кнопка ⟳ — обновить список, кнопка 🔍 — диагностика, если список пуст), Альбом (проект) выбранного объекта, Адрес объекта (подставляется по объекту, только для чтения), Исполнитель (имя и фамилия из профиля пользователя, кнопка ⟳ подставляет заново).
  • Параметры ГВС: Δt, °C (по умолчанию 60 — разность 65 − 5 °C), коэффициент перевода ккал/ч → Вт (по умолчанию 1,16).
  • Тепловые потери ГВС: режим Не учитывать / Абсолютные, кВт / Процент от расхода теплоты, % и числовое значение.
  • Потребители: строки добавляются кнопкой ➕ Добавить потребителя. В каждой строке — выпадающий список водопотребителей, сгруппированный по категориям таблицы А.2 (всего 62 позиции в 26 группах, от «1 Жилые дома квартирного типа» до «26 Расход воды на поливку»), измеритель, поля U, потребителей, N хол., N гор., T, ч, U ч, k, флажок по приборам и три блока норм — ❄️ Холодная вода, 🔥 Горячая вода, 💧 Общая (Х+Г) (в каждом q_u, q0, q_hr,u, q0,hr). Для потребителей общепита (п. 15 табл. А.2) дополнительно показывается блок «🍽 Общепит (п.15)»: посадочных мест n, посадок m (2 — кафе, 3 — студенческие и промышленные, 1,5 — рестораны), ψ и кнопка → блюда в сутки / в час.
  • Свой потребитель (вкладка «🧪 Свой потребитель»): пользовательские потребители с выбором методики расчёта: по вероятности (приложение Б СП 30.13330.2020), детерминированная (душевые сетки, q = N·q0), технологические нужды (q = U·q0), по технологическим данным (расходы задаются напрямую), полив (только суточный объём), пополнение бассейна, общепит по блюдам. Свои потребители попадают в отдельную категорию «★ …» и работают так же, как позиции таблицы А.2.

Что считается

Секундный расход — q = 5·q₀·α (п. 5.3, 5.4); вероятность действия приборов P = q_hr,u·U_ч·k / (q₀·N·3600), произведение NP = q_hr,u·U_ч·k / (q₀·3600); часовой расход — P_hr = q_hr,u·U_ч·k / (q₀,hr·N) и q_hr = 0,005·q₀,hr·α_hr (п. 5.9, 5.10); суточный и средний часовой — Qсут = q_u·U·k/1000, qT = Qсут/T (п. 5.6, 5.11); минимальный часовой — q_hr,min = K_hr,min·qT (формула 11а, таблица 5.3). Коэффициенты α и α_hr определяются по приложению Б: таблица Б.1 (заложена полностью, строки N = 2…200, билинейная интерполяция по N и P) — при P (P_hr) > 0,1 и N ≤ 200, иначе таблица Б.2 (NP от 0,015 до 2000, линейная интерполяция). Для системы в целом применяются формулы п. 5.2 и 5.4 б): P = Σ(q_hr,u,i·U_i)/(3600·Σ(q₀,i·N_i)), q₀ = Σ(N_i·P_i·q₀,i)/Σ(N_i·P_i); детерминированные потребители (душевые сетки, кабины, бани — примечание 3 к п. 5.3) считаются как q = N·q₀ и прибавляются отдельно. Тепловая нагрузка ГВС — Q = k_пер·q·Δt·(1 + p/100) + Q_ht (п. 5.12).

Результаты

  • Отчёт «Расходы воды» — три блока таблиц (холодная, горячая, Х+Г) с колонками: водопотребитель, измеритель, обоснование, U, U ч, k, N, T, q_u, q₀, P (в сутки и в час), NP, α, часовые нормы, расчётные расходы (Qсут, м³/сут; q_hr, м³/ч; q, л/с; q, м³/ч). Внизу — строка ИТОГО и строка «Система в целом (п. 5.4 б)».
  • Три формы баланса: «Баланс (краткая форма)», «Баланс (с разделением)», «Баланс водопотребления и водоотведения» — с колонками технологического процесса, качества воды, источников водоснабжения (городской водопровод, артезианские скважины, технический водопровод, оборотно-повторные системы), безвозвратных потерь и водоотведения.
  • «Расчётные расходы теплоты» — таблица исходных данных (температура горячей воды 65 °С, температура холодной, коэффициент перевода, тепловые потери) и расчёт максимального и среднего часового расхода теплоты с расшифровкой формулы, значениями в кВт, ккал/ч и Гкал/ч.
  • Блок «📐 Методика» — все использованные формулы с пунктами СП и пояснением выбора таблиц Б.1/Б.2.
  • В шапке каждого отчёта — объект, адрес, автор и дата формирования.
  • На экране предупреждений/нормоконтроля нет: расчёт выдаёт справочные таблицы. В таблицах расходов явно помечается случай, когда число приборов не задано — N (=U).

Полезно знать

  • Сохранение расчёта. Вкладка 🗂 История и экспорт: поле Название расчёта (по умолчанию «Расчёт расходов воды»), кнопки 💾 Сохранить расчёт, ⟳ Обновить список, 📂 Загрузить выбранный, 🗑 Удалить выбранный. Таблица сохранённых расчётов содержит колонки Дата, Название, Объект, Альбом, Qсут (м³/сут), q_hr (м³/ч), q (л/с), Q ГВС (кВт); двойной щелчок по строке загружает расчёт.
  • Расчёт сохраняется только с привязкой к объекту и альбому: если объект не выбран, появится предупреждение «Выберите объект на вкладке «Параметры»».
  • Выгрузка: кнопки 📄 Word (.docx) (Times New Roman 9 пт, альбомная ориентация, все четыре отчёта), 🖨 PDF (A3, альбомная ориентация), 📎 Экспорт в Excel (листы «Расходы воды (Х)», «Расходы воды (Г)», «Расходы воды (Х+Г)», «Баланс (краткая форма)», «Баланс водопотребления», «Расчётные расходы теплоты») и 🖨️ Печать / PDF на вкладке результатов.
  • Передача в ПЗ. Кнопка 📋 Вставить в ПЗ ИОС2 (раздел «г») (дублируется кнопкой 📥 Записать в объект в нижней панели) записывает в данные пояснительной записки объекта блок потребителей и итоговые расходы: суммарный расход Х+Г (м³/сут, м³/ч, л/с) и расход горячей воды. Заполненные вручную другие поля ПЗ не затрагиваются.
  • Если не добавлен ни один потребитель, кнопка ⟳ Пересчитать выводит в отчёты подсказку добавить водопотребителя; экспорт и запись в ПЗ требуют выполненного расчёта.
  • Число приборов N можно не заполнять — по примечанию 1 к п. 5.4 и примечанию к п. 5.6 СП 30.13330.2020 принимается N = U; период потребления T задаётся индивидуально для каждого потребителя, прочерк в таблице А.2 означает, что значение задаёт проектировщик.
  • Список объектов подтягивается автоматически при каждом открытии экрана; кнопка 🔍 показывает диагностику (пользователь, источник данных, состояние базы) и записывает её в файл water_supply.log, если список объектов пуст.

Подбор колодцев

Калькулятор собирает канализационный, водопроводный, дренажный, дождеприёмный или перепадный колодец из типовых изделий: подбирает кольца рабочей части и горловины, плиты, люк, лестницу или скобы, считает фактическую высоту с учётом швов, объёмы бетона, сталь, вес, стоимость и спецификацию, а также выполняет нормативные проверки по СП 32.13330.2018 и СП 31.13330.2021. Результат показывается сводной таблицей и чертежом разреза колодца.

Как открыть

Боковая панель → Расчеты → вкладка Наружные → карточка «Расчет элементов колодца». Кнопки нижней панели: 🧮 Рассчитать, 💾 Сохранить (активна после расчёта), 📋 История, 📤 Экспорт (Excel, активна после расчёта), ← Назад, 📺 Полный экран. В заголовке показывается индикатор «Расхождение: N мм».

Что вводится

Панель ввода — одиннадцать групп.

ГруппаПоля
🏗️ Тип колодцаНазвание колодца (или автогенерация «Колодец_<тип>_<диаметр>мм»); Тип колодца — канализационный, водопроводный, напорная канализация, дренажный, дождеприемный, перепадный; для дождеприёмного — подтип «лотковый / осадочный»
📊 Характеристики колодцаДиаметр колодца (мм) — 1000, 1250, 1500, 2000; Проектная отметка земли (м), по умолчанию 0.000; Глубина колодца по профилю (мм) — 1000…10000, шаг 100, по умолчанию 3000; флажок «Дорожная плита (тяжелый люк)»
🔧 Рабочая частьКомбинация рабочей части (подбор по диаметру), справочно выводятся высота и состав комбинации из колец
↘️ ПерепадВысота перепада (мм), Расход стока (л/с), Тип стока (автоматически / канализационный / поверхностный сток), Диаметр стояка (мм; 0 — автоподбор), флажок «Задать отметки лотков вручную» → Отметка подводящего лотка (низ левой трубы) и Отметка отводящего лотка (низ правой трубы), флажок «Учитывать элементы перепада в общей высоте»
🔩 ГорловинаЦементный добор (мм), Количество опорных колец КО-6, Колец горловины КС7-3, Колец горловины КС7-9, Шов между кольцами (мм, по умолчанию 30), Шов у люка/плиты (мм, по умолчанию 20)
🚰 Подключение трубЧетыре трубы (правая, левая, передняя, задняя): материал — чугунные, бетонные безнапорные, бетонные напорные, полиэтилен (ПНД), стальные сварные — и диаметр; «Проход через стенку» — гильза (+10 мм) или стальной футляр (+200 мм)
⚙️ Элементы колодцаВид доступа (лестница / скобы), Тип люка/решетки (лёгкий А15, пластиковый, средний В125, тяжёлый С250, магистральный Д400, сверхтяжёлый, решётки — для дождеприёмного), Внутренняя гидроизоляция, Внешняя гидроизоляция, Гидроизоляция стыков, флажок «Камера узла учёта (водопроводный колодец)»
🧱 Опорные элементыВерх горловины по СК 2201-88 (автоподбор либо один из трёх вариантов: КП-12, К-1, ОП-7 + ПК-7с) и отметка конкретных марок из справочника изделий (список с чекбоксами) с указанием количества для выделенной марки; отдельный флажок «Опорная плита ОП-7»
🌊 Грунтовые воды и сейсмикаФлажок «Задать уровень грунтовых вод» + абсолютная отметка УГВ (м); Сейсмичность (баллы, 0 — не учитывать)
🧱 УпорыУглы поворота, град (список через запятую или пробел), флажки «Есть изменение диаметра», «Есть глухой конец (концевой участок)»; Давление в трубопроводе (МПа); Материал труб — сталь / стеклокомпозит / иное (раструб/муфта/полимер)
🌧️ ДождеприёмникФлажок «Расчёт дождеприёмника» (при выборе дождеприёмного колодца параметры передаются автоматически): тип решётки ДМ (малый горизонтальный) / ДБ (большой вертикальный), глубина воды в лотке (м), ширина потока (м), расстояние до смотрового колодца (м), ширина улицы (м), уклон

Справочники. Состав колодца берётся из справочника изделий app/screens/db/elements.py: плиты днища и перекрытия, стеновые кольца (КС), кольца горловины, кольца горловины конические, опорные кольца (КО-6, КО-7, К-1, КОД), поворотное кольцо ПК-7с, опорные плиты ОП-7 и КП-12, люки (лёгкий А15, средний В125, тяжёлый С250, магистральный Д400, сверхтяжёлый Е600, специальный Ф900), дождеприёмные решётки, скобы МН-1 и СК-1, лестницы С1-01…С1-16, гидроизоляционные материалы, элементы перепадов (приёмная воронка, стояк, водобойный приямок, металлическая плита, водосливная стенка, отбойно-водосливная стенка, водобойная решётка, направляющее колено), уплотнительные кольца фальцевых стыков, наружные муфты, полимерная футеровка, стеклокомпозитный колодец, упоры трубопровода, дождеприёмники ДБ/ДМ/ДК, рабочая камера ВД-8. У каждого элемента есть марка, наименование, альбом, размеры, масса, бетон, арматура, материал, класс нагрузки, назначение, где применяется и цена — всё это показывается во всплывающей подсказке. Комбинации высот рабочей части — из таблицы подбора work_part_selection_table, трубы — из справочника труб pipes_db.

Что считается

Калькулятор собирает колодец снизу вверх из конкретных изделий и считает:

  • высоту рабочей части как сумму высот подобранных колец и общую высоту колодца с учётом швов между элементами (межкольцевые швы и швы у люка/плиты — настраиваемые, по СК 2201-88 это 30 и 20 мм);
  • расхождение фактической и заданной по профилю высоты — допуск 50 мм, в заголовке индикатор зелёный при ±20 мм, оранжевый до ±50 мм, красный свыше 50 мм;
  • глубину лотка и геометрию лотка по типу колодца, диаметру и подключённым трубам; для дождеприёмного лоткового типа — разноуровневое размещение труб;
  • объём цементного добора, поверхности гидроизоляции (внутренняя, внешняя, стыки), сталь в кольцах, количество и вес скоб, общий вес изделий, объёмы бетона и полную стоимость по ценам справочника (бетон 2817 руб/м³, гидроизоляция 350 руб/м², арматура 65 руб/кг);
  • подбор люка по типу колодца и дорожным условиям, дорожной плиты, лестницы по глубине (если лестницу установить нельзя, тип доступа автоматически меняется на скобы);
  • перепадный колодец: классификацию по СП 32.13330.2018 п. 6.4 — перепад в смотровом колодце (до 0,5 м при диаметре до 600 мм), водослив практического профиля (Ø 600 мм и более, до 3 м), стояк или вертикальные стенки-растекатели (Ø до 500 мм включительно, до 6 м), водосливный и водобойный типы для поверхностного стока по п. 6.4.2 (до 1 м, 1–3 м с одной решёткой, 3–4 м с двумя); высота перепада может задаваться высотой либо разностью отметок лотков (ΔH = отметка подводящего лотка − отметка отводящего лотка), при расхождении с заданной высотой более 20 мм расчёт идёт по отметкам;
  • нормативные проверки габаритов по СП 32.13330.2018 п. 6.3.1 и 6.3.2 (см. ниже).

В коде прямо указаны: СП 32.13330.2018 (п. 6.3.1, 6.3.2, 6.3.3, 6.3.4, 6.3.8, 6.4, 6.4.1, 6.4.2, 6.5.1–6.5.3, 6.9.2, 5.5.1, И.14, 6.1.3, табл. 6), СП 31.13330.2021 (п. 11.60, 11.61, 17.1, 17.3, 17.4), СК 2201-88 (швы, варианты верха горловины, решётки), ГОСТ 8020-2016 и серия 3.900.1-14 (кольца, плиты перекрытия и днища), ГОСТ 3634-2019 (люки), ГОСТ 26008-83 и РК 2201-82, а для перепадных колодцев — типовые решения ТП 902-9-1 вып. V альб. 1 и 2, ТМП 902-09-46.88 альб. V, СК 2409-93 (при этом в альбоме СК 2201-88 перепадных колодцев нет — это явно оговорено в коде).

Результаты

  • Вкладка «🎨 Визуализация» — чертёж разреза колодца: небо и линия земли с полосой травы, плита днища, стеновые кольца рабочей части, плита перекрытия, горловина, цементный добор, люк или решётка, дорожная плита, лоток и трубы с выносками, швы между кольцами, лестница или скобы. Управление видом: колесо мыши — масштаб, Ctrl+колесо — ускоренный зум, ЛКМ — панорамирование, кнопки ➕ Увеличить, ➖ Уменьшить, ↻ Сброс вида, полный экран, экспорт изображения в PNG/JPEG/BMP.
  • Условные обозначения на чертеже (блок «Условные обозначения»): штриховая линия «УГВ — уровень грунтовых вод», штриховка «футеровочное покрытие стен и днища ниже УГВ», ромб «уплотнение межкольцевого стыка (сейсмика)», обозначение «упор трубопровода (СП 31 п.11.60)», решётка дождеприёмника, камера узла учёта (2 отсека, стены ≥ 100 мм), гильза/футляр в стенке колодца. На чертёж наносятся вертикальные и общие размеры, абсолютные отметки и уровни.
  • Вкладка «📋 Сводная таблица» — 20 строк: Название колодца, Тип колодца, Диаметр, Глубина по профилю, Расчетная глубина, Расхождение высот, Рабочая высота, Сталь в кольцах, Сталь всего, Скобы МН-1, Скобы СК-1, Вес скоб, Общий вес, Общая стоимость, Отметка земли, Отметка дна (расчет), Отметка дна (профиль), Глубина лотка, Цементный добор, Тип доступа. Выше таблицы — панель предупреждений.
  • Кнопка «📋 Подробные таблицы» открывает диалог с вкладками: 💰 Стоимость (Элемент, Количество, Цена за ед., руб., Стоимость, руб., Примечание), 📏 Высоты (Элемент, Высота (мм), Примечание), 🏗️ Бетон (Тип объема, Объем, Ед. изм.), 📋 Спецификация (Элемент, Марка, Количество, Высота (мм)), 🔩 Материалы, 🚰 Трубы. В историю расчётов те же таблицы выводятся дополнительно с вкладками «Элементы конструкции», «Подключенные трубы», «Лоток».
  • Спецификация формируется по позициям: днище, стеновые кольца (каждое отдельной строкой), кольца горловины, элементы опорного узла горловины, элементы перепадного колодца, плита перекрытия, дорожная плита, люк или решётка, лестница (или скобы), трубы с материалом и диаметром, цементный добор — с маркой, количеством, высотой и массой.

Нормативные предупреждения

Предупреждения собираются из двух независимых блоков и выводятся в панели предупреждений, в сводной таблице и в Excel — каждое со ссылкой на пункт и страницу нормы.

  • Габариты колодца (встроенная проверка, СП 32.13330.2018 п. 6.3.1, 6.3.2): требуемый диаметр колодца по диаметру наибольшей подключённой трубы (до 600 мм — 1000 мм; 700 мм — не менее 1250 мм; 800–1000 мм — 1500 мм; 1200 мм и более — 2000 мм) — если выбранный диаметр меньше, выдаётся предупреждение (для Ø1250 дополнительно перечисляются имеющиеся в справочнике кольца К-12-5, К-12-10, К7/12,5-10); габариты в плане (до 600 мм — 1000 × 1000 мм; 700 мм и более — D+400 × D+500 мм) и ширина при высоте рабочей части менее 1200 мм (D+300 мм, но не менее 1000 мм); высота рабочей части не менее 1800 мм при заложении колодца более 2 м. Заложение принимается наибольшим из заданного и фактически собранного.
  • Дополнительные блоки (модуль нормативных проверок): Грунтовые воды — СП 32 п. 6.3.8: если УГВ выше дна колодца, требуется железобетон с футеровочным полимерным покрытием и фальцевым соединением либо стеклокомпозитный колодец с герметичными соединениями; Сейсмичность — СП 32 п. 6.3.1 прим. 4: при 7 баллах и более кольца применяются с фальцевыми торцами и резиновыми уплотнителями, швы заполняются эластичными герметиками; Водопроводный колодец — СП 31 п. 11.61: зазоры от стенок труб (0,3/0,5/0,7 м), от плоскости фланца (0,3/0,5 м), от края раструба (0,4/0,5 м), от низа трубы до дна (0,25/0,3/0,35 м), от верха штока (0,3 м), от маховика (0,5 м), высота рабочей части не менее 1,5 м; Камера узла учёта — СП 31 п. 17.1–17.4: толщина стен, перегородок и днища не менее 100 мм, два отсека, зазоры 0,3/0,25/0,3 м, герметизация проходов; Упоры — СП 31 п. 11.60: на сварных трубопроводах упоры нужны при поворотах в колодцах, для стеклокомпозитных труб — на всех углах, на раструбных и муфтовых допускается не предусматривать при давлении до 1 МПа и углах до 10°, обязательно при изменении диаметра и на каждом глухом конце; Дождеприёмники — СП 32 п. 6.5.1–6.5.3 и табл. 6: глубина воды в лотке не более 12 см, ширина потока не более 2 м, расстояние до смотрового колодца не более 40 м и не более одного промежуточного дождеприёмника, присоединение не менее 200 мм при уклоне 0,02, расстояния между дождеприёмниками по таблице 6 (50/60/70/80 м), при ширине улицы более 30 м — не более 60 м, вертикальные и комбинированные дождеприёмники запрещены в лотках улиц с продольным уклоном.
  • В строках интерфейса каждая проверка помечается вердиктом: «в норме», «превышает норму», «не соответствует норме» или «требует решения».
  • Если параметр не задан (УГВ не включён, сейсмичность 0, колодец не водопроводный, дождеприёмник не рассчитывается, углы поворота не введены), соответствующий блок помечается как неприменённый, предупреждений не выдаёт и на расчёт не влияет.
  • При отсутствии диаметра подводящей или отводящей трубы тип перепада не определяется — расчёт прямо сообщает «требуется уточнение диаметра трубы»; диапазон диаметров 501–599 мм нормой СП 32 п. 6.4.1 не покрыт, о чём тоже выдаётся предупреждение. При перепаде более 1 м и расходе более 50 л/с над стояком требуется специальное вытяжное устройство (СП 32 п. 6.9.2).
  • Отдельно предупреждает о нехватке места: если высота перепада с водобойным приямком превышает высоту рабочей части, предлагается увеличить глубину колодца.

Полезно знать

  • Сохранение. Кнопка 💾 Сохранить сначала предлагает выбрать объект и альбом в общем диалоге выбора (привязка всегда подтверждается пользователем, «текущий» объект главного окна молча не наследуется), затем открывается диалог сохранения с названием и описанием. Расчёт сохраняется в базу вместе с результатами.
  • История. Кнопка 📋 История загружает до 1000 расчётов пользователя; в диалоге можно просмотреть детали (те же таблицы плюс элементы конструкции, подключённые трубы и лоток), загрузить расчёт обратно в калькулятор (заполняются поля ввода и чертёж) и удалить расчёт.
  • Экспорт. Кнопка 📤 Экспорт сохраняет отчёт в Excel (.xlsx) — титульный лист и листы по таблицам. Для экспорта нужны установленные pandas и openpyxl; если их нет, выводится подсказка установить зависимости. Изображение чертежа сохраняется в PNG, JPEG или BMP.
  • Обязательные данные: диаметр колодца, глубина по профилю, тип колодца и корректная комбинация рабочей части. Если для выбранного диаметра комбинации нет или нет данных для диаметра, расчёт завершается ошибкой «Нет данных для диаметра … мм» или «Не найдены элементы для выбранной высоты рабочей части».
  • Для сохранения и истории нужна авторизация: без пользователя кнопка сохранения выдаёт «Для сохранения расчетов необходимо авторизоваться». Сохранение и загрузка из истории привязываются к объекту и альбому.
  • Марки и цены, отсутствующие в справочнике изделий, помечаются в результатах как условные и подлежащие уточнению по прайсу или типовому альбому.

Расчёт пожаротушения

Калькулятор определяет расход воды на наружное и внутреннее пожаротушение, проверяет необходимость внутреннего противопожарного водопровода, считает пожарный объём и число резервуаров, требуемый напор пожарного насоса, скорость в трубопроводе и давление у пожарных кранов, а также параметры автоматического пожаротушения. Расчёт ведётся по СП 8.13130.2020, СП 10.13130.2020, СП 485.1311500.2020 и СП 486.1311500.2020.

Как открыть

Боковая панель → Расчеты → вкладка Общие → карточка «Пожаротушение (СП 8, СП 10)». Экран имеет две вкладки: ⚙️ Параметры и 📊 Результаты и отчёты. Сверху — кнопки просмотра таблиц нормативов: Табл. 7.1, Табл. 7.2, Табл. 7.3 (СП 10.13130, ВПВ) и Табл. 2, Табл. 3, Табл. 4 (СП 8.13130, наружное).

Что вводится

  • Параметры здания: Длина (м), Ширина (м), Высота (м), Этажей; Назначение — восемь вариантов (многоквартирные жилые дома Ф1.3; общежития коридорного типа Ф1.2; театры, кинотеатры, цирки Ф2.1; музеи, выставочные залы, торговля Ф2.2/Ф3.1; административные, офисные, гостиницы, поликлиники; больницы, дома престарелых Ф1.1; библиотеки, архивы, лаборатории, мастерские, спортсооружения; производственные и складские здания Ф5). Для отдельных назначений появляются дополнительные поля: длина коридора, вместимость зрительного зала, а для зданий Ф5 — степень огнестойкости, класс конструктивной пожарной опасности, категория пожарной опасности и наличие фонарей.
  • Внутреннее пожаротушение (СП 10): высота компактной струи (6…20 м), диаметр ствола (13/16/19 мм), длина рукава (10/15/20 м), тип клапана (DN 50 / DN 65).
  • Расчётные параметры пожара: число одновременных пожаров, продолжительность наружного тушения (ч), продолжительность работы ВПВ (ч), флажки «ВПВ совмещён с хозяйственно-питьевым», «Населённый пункт до 5 тыс. жителей», «Дошкольная образовательная организация», «Здание оборудовано хозяйственно-питьевым (производственным) водопроводом», «Подставлять 2 ч для жилых и общественных зданий I–II ст. огн. класса С0», «Учитывать населённый пункт (таблица 1 СП 8)» с полями числа жителей (тыс. чел.) и высоты застройки.
  • Напор и трубопровод: длина трубопровода до диктующего ПК-с (м), геометрическая высота диктующего ПК-с (м), материал трубы (Сталь ВГП, Полипропилен, ПНД, Электросварная) и внутренний диаметр.
  • Пожарные краны малой производительности (ПК-м): флажок «Учитывать ПК-м (малорасходные краны, 0,2–1,8 л/с)», расход ПК-м и количество одновременно используемых ПК-м.
  • Запас воды: срок восстановления пожарного объёма — населённый пункт свыше 5 тыс. чел. (24 ч), предприятие категорий А, Б, В (24 ч), предприятие категорий Г, Д (36 ч), населённый пункт до 5 тыс. чел. (72 ч), сельскохозяйственное предприятие (72 ч).
  • Автоматическое пожаротушение: флажок учёта АУП, группа помещений (1, 2, 3, 4.1, 4.2, 5, 6, 7), огнетушащее вещество (вода или раствор пенообразователя), высота складирования (м).
  • Привязка: объект и альбом из базы приложения.

Что считается

Расход на наружное пожаротушение — по таблице 2 СП 8.13130.2020 для зданий классов Ф1–Ф4 (по этажности и объёму) и по таблицам 3 и 4 для Ф5 (таблица 4 — без фонарей при ширине 60 м и более), с учётом степени огнестойкости, класса конструктивной пожарной опасности и категории. Для населённых пунктов работает таблица 1 СП 8 (расход и число одновременных пожаров, столбцы «не более 2 этажей» и «3 этажа и выше»), а для населённых пунктов до 5 тыс. жителей — сноска к таблице 2 (допускается 5 л/с для зданий не более 2 этажей объёмом до 1 тыс. м³).

Расход внутреннего пожаротушения — по таблицам 7.1 и 7.2 СП 10 (число струй и минимальный расход на струю), фактический расход — по таблице 7.3: Q = число ПК-с × расход по таблице для сочетания «клапан / диаметр ствола / высота компактной струи», с давлением у ПК-с. Если сочетания в таблице 7.3 нет (прочерк), внутреннее пожаротушение в расчёт не включается и выдаётся предупреждение с предложением выбрать другой ствол; дополнительно параметры могут подтягиваться из таблицы гидравлических параметров базы. Для зданий выше 50 м применяется специальное правило п. 7.13. Проверяется необходимость ВПВ по п. 1.4 и 1.5 СП 10 (дошкольные организации, здания без хозяйственно-питьевого водопровода) и соответствие фактической высоты струи нормативной по п. 7.15.

Дальше считаются: суммарный расход как сумма наружного (с числом одновременных пожаров) и внутреннего с ПК-м; пожарный объём W = Q_наружн·t_наружн·n + Q_ВПВ·t_ВПВ + АУП и минимальное число резервуаров; срок восстановления объёма по п. 5.18 СП 8; необходимое число гидрантов к расчётной точке и ориентировочно на сети, максимальная длина рукавных линий по п. 8.9–8.11; минимальный диаметр труб по п. 8.13; скорость в трубопроводе с проверкой нормы не более 10 м/с (СП 10 п. 14.1.4); потери напора (с учётом местных сопротивлений, рукавных линий по h = S·n·q² и давления у ПК) и требуемый напор пожарного насоса как сумма геометрической высоты, потерь, потерь в рукавах и напора у ПК; давление у ПК-с с проверкой предельного значения 0,45 МПа для совмещённого ВПВ и 0,9 МПа для самостоятельного (СП 10 п. 6.2.18 и 6.2.20) и подбор диаметра диафрагмы, если давление превышено. По СП 486.1311500.2020 выполняется проверка необходимости АУП и СПС. Параметры АУП (интенсивность, расход, площадь, продолжительность) берутся по таблицам 6.1 и 6.2 СП 485.1311500.2020 в зависимости от группы помещения, огнетушащего вещества и высоты складирования, с проверкой применимости спринклерных АУП до 20 м.

Результаты

  • Блок «Результаты расчёта» с строками: Наружное пожаротушение (СП 8) — с расшифровкой «здание / населённый пункт» и числом пожаров; Внутреннее пожаротушение (СП 10) — с расшифровкой числа ПК-с, расхода по таблице 7.3, минимума по таблице, давления у ПК-с и учтённых ПК-м; Общий расход; Резервуар (объём и «не менее N резервуаров по V м³»); Восстановление объёма; Гидранты; Требуемый напор насоса с разложением на геометрию, потери, рукава и напор у ПК; Скорость в трубе; Давление у ПК-с; Диафрагма; Высота компактной струи; Проверка ВПВ; АУП (СП 485); Требования СП 486.
  • Предупреждения выводятся прямо в строках результатов со знаком ⚠: расход ниже нормы по таблице 7.3, скорость более 10 м/с, диаметр менее минимального по СП 8 п. 8.13, давление у ПК-с выше предельного, несоответствие высоты струи нормативной, отсутствие данных в таблице 6.1–6.2 СП 485 для выбранной группы и вещества, необходимость уточнения по СП 486.
  • Таблица сохранённых расчётов: Название, Дата, Наружн., Внутр., Общий и кнопка удаления строки.

Полезно знать

  • Сохранение. Кнопка 💾 Сохранить расчёт запрашивает название и сохраняет параметры и результаты с привязкой к выбранному объекту и альбому; список сохранённых расчётов обновляется сразу. Удаление — кнопкой ✖ в строке таблицы с подтверждением.
  • Экспорт: 📄 Экспорт в PDF (A4, таблицы исходных данных и результатов) и 📊 Экспорт в Excel (листы «Исходные данные» и «Результаты»). Excel-экспорт требует установленных pandas/openpyxl.
  • Передача в ПЗ. Кнопка 📥 Записать в ПЗ объекта записывает в пояснительную записку объекта сводку: наружное пожаротушение, ВПВ, общий расход, пожарный объём с числом и объёмом резервуаров, требуемый напор насоса. Остальные разделы ПЗ не изменяются; без выбранного объекта запись невозможна.
  • Кнопки экспорта, сохранения и записи в ПЗ активируются только после выполненного расчёта; кнопка Сбросить очищает результаты.
  • Просмотр таблиц нормативов открывает изображения из папки resources\Fire; если папка или файл таблицы не найдены, выводится список проверенных путей.

Подбор водосчётчиков (узлы учёта)

Отдельный калькулятор подбора счётчика воды по расчётному расходу: считает потери напора на счётчике и проверяет три условия подбора, после чего показывает подходящие модели и рекомендует два экономически целесообразных диаметра.

Как открыть

Боковая панель → Расчеты → вкладка Внутренние → карточка «Подбор водосчетчиков». Вкладки внутри: ⚙️ Параметры, 🔧 Подбор счётчика, 🗂 История и экспорт.

Что вводится

  • Объект (из базы) и Альбом; блок «Привязанные счётчики» с кнопкой 🗑 Отвязать.
  • Тип счётчика: Крыльчатые (DN 15–50) или Турбинные (DN 50–250).
  • Расчётный расход воды, л/с (подсказка: значение можно взять из расчёта водоснабжения).
  • Название расчёта (по умолчанию «Расчёт 1»).

Что считается

Расход переводится в м³/ч (Q = л/с × 3,6). Для каждого счётчика с заданным гидравлическим сопротивлением S считаются потери Δh = S · Q² и проверяются три условия: Q ≤ Qmax, Δh ≤ Δh_доп (5 м для крыльчатых, 2,5 м для турбинных) и Q ≥ Qmin (точность). Из подходящих выбираются минимально возможный диаметр и следующий за ним — дальнейшее увеличение диаметра удорожает узел без выигрыша по потерям. Ход расчёта показывается в сворачиваемой карточке «📐 Расчёт потерь напора» с подстановкой чисел.

Результаты

  • Строка результата: «✅ Рекомендован <модель> (DN …), Δh = … м» и второй подходящий диаметр, если он есть; если ничего не подошло — «❌ Подходящих счётчиков не найдено».
  • Карточки подходящих моделей: наименование, DN, Qmin, Qmax, S, потери, цена и другие характеристики модели с изображением.
  • Кнопка Выбрать эту модель привязывает счётчик к выбранному объекту и сохраняет привязку в базе.

Полезно знать

  • Справочник счётчиков берётся из базы приложения (метод get_water_meters с фильтром по типу). Если в базе нет счётчиков с заданным гидравлическим сопротивлением, выводится соответствующее предупреждение.
  • Сохранение расчёта — кнопка 💾 Сохранить расчёт (требует выбранного объекта); в истории таблица с колонками Объект, Альбом, Название, Тип, Расход, Счётчик, Потери, Дата. Двойной щелчок по строке переименовывает расчёт, кнопка 🗑 Удалить выбранный удаляет.
  • Экспорт — 📄 Экспорт PDF для выбранной строки истории; требует библиотеки reportlab, иначе кнопка заблокирована с подсказкой.
  • Добавление нового счётчика в справочник доступно только администратору — кнопка ➕ Добавить счётчик с полями характеристик (диаметр, Qmin, Qt, Qn, Qmax, S, давление, вес, цена, срок службы, гарантия).

Земляные работы: котлованы и траншеи

Два отдельных калькулятора: объём грунта под котлован колодца и объём земляных работ по траншее между колодцами, с подушками, обратной засыпкой, излишками грунта, визуализацией и экспортом.

Как открыть

Боковая панель → Расчеты → вкладка Наружные → карточки «Расчет земляных работ котлована» и «Расчет земляных работ траншеи».

Что вводится

  • Котлован («Расчет земляных работ для колодцев»): название расчёта, объект и альбом (справочно), название котлована, диаметр колодца (мм), глубина колодца (мм), толщина песчаной подушки (мм), рабочая зона (мм), тип грунта, ручная разработка (%), укрепление откосов, а для пользовательского грунта — коэффициент откоса, коэффициент разрыхления, плотность грунта (т/м³) и несущая способность (кПа).
  • Траншея («Калькулятор траншей»): параметры вводятся по каждой траншее: начальный и конечный колодец (отметки земли), длина (м), ширина по дну (м), труба (тип и наружный диаметр — ширина по дну может подбираться по трубе), грунт, ручная разработка (%). Вкладки: Параметры, Визуализация, Результаты, Формулы, История. Кнопки: Добавить траншею, Рассчитать все, Сбросить, Сохранить расчет, Экспорт.

Что считается

Объём грунта с учётом откосов, песчаные подушки (нижняя 0,15 м и верхняя 0,3 м), песок вокруг трубы, объём трубы, обратная засыпка, объём с разрыхлением, излишки грунта и их вес, механизированная и ручная разработка, стоимость работ. В траншеях используются типы грунтов с коэффициентом откоса, коэффициентом разрыхления и плотностью: глина (0,5 / 1,25 / 1,8), песок (0,67 / 1,15 / 1,6), суглинок (0,5 / 1,2 / 1,7), «Ваш грунт» (0,5 / 1,15 / 1,5). На вкладке Формулы приводятся расчётные зависимости, обозначения переменных, практические рекомендации и нормативная база: СП 45.13330.2022 «Земляные сооружения, основания и фундаменты», СП 22.13330.2023, СП 48.13330.2021, СП 12-131-1503-2024, ГОСТ 25100-2023 «Грунты. Классификация», ГОСТ 22733-2016.

Результаты

  • Котлован: результаты по каждому котловану, сводка по всем котлованам сессии (число котлованов, объём грунта, стоимость) и сохранение всех котлованов сессии.
  • Траншея: таблица результатов по каждой траншее (общий объём грунта, объём с разрыхлением, нижняя подушка, песок вокруг трубы, верхняя подушка, объём трубы, обратная засыпка, излишки грунта и их вес, механизированная и ручная разработка) и итоги по всем траншеям; чертёж траншей (вид сбоку) с отметками и масштабом; диалог деталей расчёта с вкладками «📋 Расчет», «📦 Траншеи», «⚙️ Детали траншеи», «📊 Сводная».

Полезно знать

  • Траншеи: экспорт в Excel (.xlsx) с титульным листом и листами по траншеям, грунтам и сводной, экспорт всех расчётов из истории, а также экспорт в Word (.docx) — требует python-docx, при отсутствии библиотеки предлагается установить её.
  • Траншеи: сохранение расчёта в базу с обязательным названием и необязательной привязкой к объекту и описанием; история расчётов позволяет просматривать, экспортировать и удалять расчёты.
  • Визуализацию траншей и котлованов можно экспортировать изображением и открывать в полноэкранном режиме.

Ливневые стоки и поверхностный сток

Два калькулятора по СП 32.13330.2018: быстрый расчёт объёма дождевых вод методом максимального суточного слоя осадков hₐ и полный расчёт поверхностного стока — годовой сток (дождевой, талый, поливомоечный), расчётные расходы, гидравлика и объём ливневых ёмкостей.

Как открыть

Боковая панель → Расчеты → вкладка Наружные → карточки «Расчёт поверхностного стока (СП 32.13330)» (полный расчёт) и «Калькулятор ливневых стоков (метод hₐ)» (быстрый расчёт).

Что вводится

  • Ливневые стоки (метод hₐ): максимальный суточный слой осадков hₐ (мм) с кнопкой 🌐 Найти hₐ, число расчётных дождей N, коэффициенты β и γ, площади поверхностей в гектарах по семи типам (асфальтобетонные покрытия Ψ = 0,95; бетонные 0,90; щебёночные 0,50; грунтовые 0,30; газоны и растительность 0,10; кровли зданий 0,95; промышленные территории 0,80), привязка к объекту и альбому. Справочная таблица коэффициентов стока выводится рядом.
  • Поверхностный сток: слой осадков за тёплый период h_д (мм), за холодный период h_т (мм), максимальный суточный слой дождя hₐ (мм) — все с кнопками поиска значений; тип сточных вод (1-го типа — жилые и общественно-деловые зоны; 2-го типа — производственные зоны и транспорт); эффективность уборки снега K_у (%); в сворачиваемом блоке «Дополнительные параметры» — коэффициент K₁ (считается автоматически), климатический коэффициент C (с кнопкой 🌐 Найти C), период однократного превышения для очистных сооружений P_оч, коэффициент α снеготаяния, количество поливов m, удельный расход на полив, доля поливомоечных площадей; таблица поверхностей водосбора; в отдельном блоке — параметры гидравлики (A, q₂₀, n, mr, γ, P) и параметры для расчёта по таблицам Лукиных.

Что считается

Ливневые стоки: W = 10 · hₐ · β · γ · Ψmid · F · N, где Ψmid — средневзвешенный коэффициент стока (Ψmid = Σ(Ψᵢ·Fᵢ)/ΣFᵢ), плюс детализация стока по каждому типу поверхности и рекомендуемый объём ёмкости. Поверхностный сток: годовой дождевой сток 10·h_д·Ψср·F, сток от очистки 10·hₐ·Ψср·F, годовой талый сток 10·h_т·0,7·F, суточный талый 10·20·F·α·0,7·K_у, годовой поливомоечный 10·m·k·Ψж·Fж, общий годовой объём как их сумма и объём для очистки — 70 % годового стока; расчётный расход Qr = Z_mid·A^1,2·Fr/(tr^(1,2n−0,1))·K, расход на очистные Q_оч = K₁·K₂·Qr с коэффициентами K₁ и K₂ по P_оч, C и n; отдельно гидравлический расчёт по приложению Ж и расчёт по таблицам Лукиных.

Результаты

  • Ливневые стоки: общий объём дождевых вод, рекомендуемый объём ёмкости, средневзвешенный коэффициент стока, общая площадь водосбора; таблица детализации «Тип поверхности / Площадь (га) / Ψ / Сток (м³)»; столбчатая диаграмма распределения стока по поверхностям; подстановка формулы в текстовом виде.
  • Поверхностный сток: годовой дождевой сток, сток от очистки, годовой талый, суточный талый, годовой поливомоечный, общий годовой объём и объём для очистки, расчётный расход Qr (л/с) и расход на очистные Q_оч (л/с и м³/ч); детали расчёта с формулами и подстановкой; блок гидравлического расчёта по таблицам Лукиных; рекомендации по СП 32; отдельная группа «🌧️ Расчёт ливневых емкостей» с результатами по объёму от дождя и своей таблицей детализации.

Полезно знать

  • Оба калькулятора сохраняют расчёты в базу с привязкой к объекту и альбому; у поверхностного стока сохранение раздельное для годового стока и для объёма ливневых ёмкостей.
  • Экспорт: у ливневых стоков — PDF; у поверхностного стока — HTML-отчёты (полный, с возможностью выделения текста, и по отдельным разделам) и экспорт в Excel (в том числе отдельно по ливневым ёмкостям).
  • Если не задана площадь ни одной поверхности, расчёт ливневых стоков останавливается с предупреждением «Укажите площадь хотя бы одной поверхности».

Инженерный калькулятор

Отдельное окно-калькулятор для инженерных вычислений с расширенным набором функций, памятью и историей операций.

Как открыть

Кнопка калькулятора в шапке приложения (сигнал calculator_clicked главного окна) или сочетание клавиш, назначенное на вызов инженерного калькулятора. Окно открывается отдельно, заголовок — «🚀 ViVBIM - Инженерный калькулятор».

Что вводится

  • Числа и знаки операций с кнопок, поле выражения и строка состояния с текущей операцией.
  • Функции: sin, cos, tan, asin, acos, atan, log₁₀, ln, квадратный корень, x², x³, 10ˣ, eˣ, 1/x, факториал, модуль, константы π и e, скобки.
  • Память: очистка, вызов, прибавление, вычитание, сохранение значения.

Что считается

Обычные арифметические операции и перечисленные математические функции; результат округляется и выводится в поле, выражение с результатом попадает в историю операций.

Результаты

  • Значение результата и строка выражения с историей последней операции.
  • Отдельное окно «📜 История операций» с полным списком, количеством операций и возможностью очистить историю.
  • Справка по калькулятору — отдельное окно.

Полезно знать

  • История операций сохраняется в файл и загружается при следующем открытии калькулятора.
  • Окно без системной рамки: есть собственные кнопки свернуть, развернуть и закрыть, перетаскивание за заголовок.
  • Калькулятор не связан с объектами и расчётами проекта — это универсальный инструмент.

Прочие калькуляторы

В разделе «Расчеты» дополнительно доступны ещё несколько инструментов.

Как открыть

Боковая панель → Расчеты: карточки распределены по вкладкам Внутренние, Наружные, Трубы, Общие; над карточками есть строка поиска по названию и описанию.

Что вводится и что считается

  • Расчёт предприятий общепита (СП 30.13330) — расчёт посадочных мест и блюд в час и в сутки.
  • Расчёт потерь напора — линейные и местные потери, подбор насоса.
  • Расчёт объёма трубы — объём и масса трубы в зависимости от материала и жидкости, с визуализацией.
  • Расчёт уклона трубопровода — уклон, угол, длина и перепад высот, с визуализацией.
  • Гидроудар (СП 399) — расчёт повышения давления при гидравлическом ударе по СП 399.1325800.2018.
  • Расчёт покрытия труб — расход грунтовки и эмали с учётом типа трубы и норм расхода.
  • Расчет П-образных компенсаторов — параметры компенсаторов для полипропиленовых труб по СП 40-101-96.
  • Расчёт теплоизоляции труб (СП 61.13330) — толщина изоляции по температуре поверхности или теплопотерям.
  • Гидравлический расчёт по таблицам Лукиных — скорость и наполнение для диаметров 50–2500 мм.
  • Конвертер величин — пересчёт расхода, давления, объёма и скорости в различных единицах.

Полезно знать

  • Каждый калькулятор открывается в общем стеке экранов раздела «Расчеты»; кнопка ← Назад возвращает к списку карточек, а состояние созданных калькуляторов сохраняется до выхода из приложения (экраны создаются один раз, при первом открытии).
  • Названия и описания карточек заданы в коде раздела «Расчеты» и используются строкой поиска — искать можно по словам, например «уклон», «покрытие», «компенсатор».

Бортовой журнал

Бортовой журнал — это учёт затраченного времени: часы, потраченные на альбомы и объекты, с разбивкой по датам, альбомам, стадиям проектирования и дням недели. По журналу строятся диаграмма по объектам, календарь записей и шесть графиков.

Как открыть

  1. Боковая панель → Проекты (хаб проектов).
  2. Карточка Бортовой журнал с описанием «Анализ времени, затраченного на объекты и альбомы».
  3. Внутри экрана три вкладки: 📊 Диаграмма, 📅 Календарь, 📈 Графики.
  4. Быстрая запись без перехода на экран: боковая панель, блок «БЫСТРЫЕ ДЕЙСТВИЯ» → кнопка Запись в журнал.

Что вводится

  • Запись времени (диалог «Запись времени на альбом» из быстрых действий): Компания, Объект, Альбом, Дата, Затрачено часов (от 0,1 до 24, шаг 0,5 ч), Описание (необязательно).
  • Запись из календаря (диалог «Новая запись времени»): Компания, Объект (в списке объекты показываются вместе со стадией проектирования), Альбом, Дата, Часы, Описание. При редактировании существующей записи показываются альбом и объект, а меняются дата, часы и описание.
  • Фильтры на вкладке «Диаграмма»: выпадающий список Период — «Все месяцы» и месяцы, по которым есть записи; кнопка 🔄 Обновить.
  • Фильтры на вкладке «Графики»: Месяц, Год, кнопка 🔄 Обновить, а для детализации по стадиям — выпадающий список Объект.
  • Редактирование времени по объекту (открывается щелчком по объекту на диаграмме): таблица с колонками Альбом, Дата, Часы, Описание, Действия, кнопка ➕ Добавить запись и кнопки ✏️ / 🗑️ в каждой строке.

Что считается

Записи хранятся по альбомам: каждая запись — пользователь, альбом, дата, часы и описание. Часы агрегируются (суммируются) по объектам; логическим объектом считается объединение стадий одного объекта. На экране считаются: сумма часов за выбранный период и число объектов; сумма часов по альбомам внутри объекта; сумма часов по стадиям проектирования; динамика по месяцам года; распределение часов по дням недели; рейтинг объектов по времени. Никаких нормативов в журнале не применяется — это учётный, а не расчётный раздел.

Результаты

  • Вкладка «📊 Диаграмма»: столбчатая диаграмма «Время на проекты (по объектам)» с подписью внизу «Всего затрачено за <период>: N ч. Объектов: M»; щелчок по объекту открывает редактирование его записей. Если записей нет — «Нет данных о затраченном времени за выбранный период».
  • Вкладка «📅 Календарь»: календарь с легендой «Есть записи» (зелёный) и «Нет записей» (красный), строка информации по выбранному дню, кнопки 🔄 Обновить и 📌 Сегодня. Двойной щелчок по дню открывает список записей за дату с возможностью их править и удалять.
  • Вкладка «📈 Графики»: шесть карточек — «🍩 Распределение времени» (круговая диаграмма с легендой «Nч · M%»), «📶 Рейтинг объектов по времени», «📈 Динамика по месяцам», столбчатая диаграмма по альбомам внутри объекта, распределение по дням недели и детализация по стадиям проектирования выбранного объекта (Фильтр «Объект»).
  • Если данных за период нет, каждая карточка выводит «Нет данных за выбранный период».

Полезно знать

  • Часы ограничены диапазоном от 0,1 до 24 за одну запись; при попытке сохранить нулевые часы выводится «Часы должны быть больше 0». При добавлении записи обязательно выбрать альбом.
  • Все операции записи требуют авторизации: без входа в систему выводится «Пользователь не авторизован».
  • Запись можно добавить тремя путями: кнопкой в быстрых действиях боковой панели (Компания → Объект → Альбом), кнопкой ➕ Добавить запись в диалоге редактирования времени по объекту и из календаря при выборе дня.
  • Запись можно изменить (дата, часы, описание) и удалить — с подтверждением удаления.
  • В журнале свои данные видит только текущий пользователь: все выборки идут с фильтром по нему.
  • Экспорта журнала в файлы (Word, PDF, Excel) в коде нет — доступны только просмотр, диаграммы и правка записей.

Чат

Корпоративный мессенджер внутри ViVBIM: групповые чаты и личные переписки, вложения, ответы и цитирование, реакции, опросы, поиск по сообщениям, отметки о прочтении и уведомления.

Как открыть

Раздел Чат в левом боковом меню приложения (раздел навигации, рядом с пунктами «Новости», «Главный экран», «Проекты», «События», «Расчеты», «Заметки», «Карта сообщества»).

Как пользоваться

  1. Выберите чат-комнату в списке слева. Список разделён на групповые чаты и блок — Личные сообщения —; заглушённые комнаты помечены значком 🔇.
  2. Для новой переписки с человеком откройте список пользователей (кнопка ⋯ в шапке чата → окно Пользователи) и выберите собеседника.
  3. Для группового чата нажмите 👥 Создать группу, укажите название, описание и отметьте участников; нажмите ✅ Создать.
  4. Введите текст в поле ввода. Enter — отправить сообщение, Shift+Enter — перенос строки. Для отметки коллеги начните вводить @ и выберите имя из подсказки.
  5. Прикрепите файлы кнопкой 📎 — откроется диалог выбора файлов, выбранные файлы появятся в виде списка над полем ввода с возможностью убрать любой из них.
  6. Для ответа на конкретное сообщение наведите на него курсор и нажмите Ответить; для набора нескольких сообщений используйте кнопку 💬 Ответить всем и режим мульти-цитирования.
  7. Поставьте реакцию: кнопка 👍 на сообщении или клик по уже существующей реакции. Доступны 👍, ❤️, 😄, 😮, 😢, 😡.
  8. Используйте значок ⋯ в шапке для списка участников онлайн; нажмите на участника, чтобы открыть личный чат.
  9. Найдите нужное сообщение через поле 🔍 Поиск по сообщениям... в шапке чата — результаты открываются отдельным списком, по клику выполняется переход к сообщению.

Возможности

  • Личные и групповые чаты, а также отдельная комната 📊 Опросы для голосований.
  • Отправка сообщений, ответы (в том числе на несколько сообщений сразу), пересылка сообщений, закрепление сообщений (панель закреплённых), редактирование и удаление своих сообщений.
  • Реакции из фиксированного набора из шести эмодзи.
  • Вложения: выбор из фильтров Все файлы (*), Изображения (*.png *.jpg *.jpeg), Документы (*.pdf *.docx *.xlsx), Архивы (*.zip *.rar). Файлы загружаются в S3 с индикатором прогресса; изображения открываются во встроенном просмотрщике, PDF — во встроенном PDF-просмотрщике с навигацией по страницам и масштабом, остальные типы скачиваются.
  • Опросы: кнопка ➕ Создать опрос, вопрос и варианты ответа, голосование, показ результатов, удаление опроса (все голоса теряются), автообновление результатов раз в 30 секунд. Один пользователь может проголосовать один раз.
  • Отметки о прочтении (✓ / ✓✓, окно «Кто прочитал»), счётчики непрочитанного и всплывающие уведомления о новых сообщениях.
  • Список онлайн-пользователей со статусами «В сети» / «Был(а) сегодня в …» / «Был(а) вчера в …».
  • Управление группой: окно Участники группы с поиском пользователей, приглашением выбранного и удалением выбранного участника.
  • Настройки отображения в чате (какие поля профиля показывать) и заглушение отдельных каналов (🔇).
  • Автодополнение упоминаний по @ и подсветка упоминаний в тексте сообщений.
  • Кнопка ⬇ для быстрой прокрутки вниз к последним сообщениям.

Полезно знать

  • Новые сообщения подтягиваются опросом сервера: 3 секунды для активной комнаты, 5 секунд для счётчиков непрочитанного и статусов прочтения. Мгновенной доставки «по событию» (push) нет.
  • Вложения хранятся в объектном хранилище (S3). Без настроенного хранилища (адрес, ключ доступа, секретный ключ, бакет) загрузка файлов невозможна — в журнал пишется «S3 не настроен».
  • Смена аватара в чате ограничена размером файла 5 МБ: при превышении выводится «Размер файла превышает 5 MB».
  • Жёсткого ограничения размера для обычных вложений в коде нет, но загрузка идёт через облачное хранилище — учитывайте это при отправке больших файлов.
  • Комната «Опросы» работает в особом режиме: писать обычные сообщения в ней нельзя, доступны только голосование и создание опросов.
  • Реакция на сообщение приходит автору как уведомление, упоминание через @ — тоже отдельное уведомление, но не в заглушённых каналах.
  • Редактирование и удаление доступны для своих сообщений; удаление опроса доступно автору или администратору.
  • Порядок комнат в списке зависит от времени последнего сообщения; для части служебных комнат задан приоритетный порядок.

Карта сообщества

Гео-карта опубликованных объектов сообщества: на карте флажками показываются объекты, которые их владельцы отметили как опубликованные и для которых заданы координаты. Экран работает только на просмотр — редактирование и переход к карточке объекта с карты отключены.

Как открыть

Раздел Карта сообщества в левом боковом меню приложения (после пункта Чат). Данные загружаются автоматически при первом открытии экрана.

Как пользоваться

  1. Откройте раздел — карта загрузит опубликованные объекты и автоматически подберёт масштаб и центр так, чтобы были видны все флажки.
  2. Перетаскивайте карту мышью, чтобы сдвинуть её к нужному району.
  3. Меняйте масштаб колесом мыши или кнопками + и - в верхней панели.
  4. Нажмите 🗺 Показать все, чтобы снова вернуть в кадр все флажки.
  5. Нажмите 🔄 Обновить, чтобы перечитать список опубликованных объектов.
  6. Следите за нижней строкой: там показано количество флажков на карте, текущий зум и число загруженных тайлов.

Возможности

  • Подложка — карта OpenStreetMap, диапазон масштаба от 3 до 19, стартовый центр — Владивосток. Если основной сервер тайлов недоступен, подставляются зеркала; тайлы кэшируются на диск и в памяти (до 400 тайлов на виджет).
  • Отображение объектов флажками по координатам (широта/долгота). Объект попадает на карту только при выполнении двух условий: он опубликован в сообществе и у него заполнены координаты.
  • Из данных объекта на карте используются наименование, город, адрес, стадия проектирования, статус, дата обновления, название компании-заказчика.
  • Кнопка 🗺 Показать все — автоматический подбор зума и центра под все флажки.
  • Нижняя панель со счётчиком флажков, текущим зумом и диагностикой загрузки тайлов (в том числе сообщением «тайлы не загрузились — проверьте доступ к серверам карт»).
  • Подсказка по управлению внизу экрана: «Перетаскивание — сдвинуть карту · Колесо — масштаб».

Полезно знать

  • Экран намеренно работает только на просмотр: сигналы клика по карте и по флажку не подключены, поэтому с карты нельзя открыть карточку объекта или изменить координаты.
  • Заголовок на экране — КАРТА ОБЪЕКТОВ СООБЩЕСТВА, пункт меню — Карта сообщества.
  • Объект появляется на карте только после публикации в сообществе и только при наличии координат. Как задать координаты — в карточке объекта при работе с картой объектов.
  • Для отображения карты нужен доступ в интернет к серверам тайлов OpenStreetMap (или их зеркалам). Без сети карта останется без подложки, а в нижней панели появится предупреждение о незагруженных тайлах.
  • Обратите внимание: подпись метода загрузки объектов в коде говорит о «своих опубликованных объектах», однако сам SQL-запрос возвращает все опубликованные объекты сообщества, без фильтра по текущему пользователю. Описанное здесь поведение соответствует фактическому запросу.

База знаний

Раздел для хранения проектных материалов по разделам проектирования и категориям: нормативы, файлы, шаблоны и учебные материалы с деревом папок, предпросмотром, тегами, избранным, статистикой, комментариями и поиском.

Как открыть

Кнопка База данных в блоке ▸ ИНСТРУМЕНТЫ ◂ левого бокового меню приложения. Экран открывается под заголовком БАЗА ДАННЫХ. Категория знаний открывается кликом по плитке категории.

Как пользоваться

  1. На экране БАЗА ДАННЫХ выберите Раздел проектирования: — доступны ВК, ОВ, СС, ЭС, АР, КР, ГИП, ГП. Без выбранного раздела переход в категорию не выполняется.
  2. Выберите категорию: AutoCAD, Revit, Excel, Word, Учебные пособия, Инженерные программы. Откроется проводник базы знаний по этой категории.
  3. В проводнике слева — дерево папок и файлов, справа — предпросмотр изображения, описание, теги и статистика (просмотры, скачивания, избранное, комментарии). Папки и файлы можно перетаскивать между папками.
  4. Нажмите ⬇ Скачать, чтобы сохранить файл на компьютер; ❤ В избранное — чтобы добавить файл в избранное; 💬 Комментарии — чтобы открыть обсуждение.
  5. Для поиска начните вводить текст в поле 🔍 Поиск по дереву.... Поддерживаются специальные запросы: #123 — поиск по номеру, @тег — поиск по тегу.
  6. Администратор может создавать структуру: + Папка, + Файлы, а также переименовывать, редактировать метаданные (название, описание, изображение), управлять тегами и удалять элементы через контекстное меню.
  7. Для возврата на уровень выше используйте ← Назад или хлебные крошки в верхней части проводника.

Возможности

  • Восемь разделов проектирования и шесть предустановленных категорий материалов.
  • Дерево папок и файлов с хлебными крошками, раскрытием узлов и перетаскиванием (drag and drop) между папками.
  • Правая панель: предпросмотр изображения, наименование, размер, описание, теги, счётчики просмотров, скачиваний, избранного и комментариев.
  • Загрузка одиночных файлов и пакетная загрузка нескольких файлов сразу (с индикатором прогресса и общей формой метаданных).
  • Галерея дополнительных изображений у файла: ◀, ▶, + Фото.
  • Теги: диалог Редактирование тегов с добавлением (➕ Добавить), удалением и сохранением (✅ Сохранить).
  • Избранное — персональный список файлов.
  • Комментарии с ответами: окно Комментарии: {название ресурса}, кнопки ↩ Ответить, Отправить, редактирование (✎) и удаление (✕) своих комментариев.
  • Поиск по имени, по номеру (#123) и по тегу (@тег) с выводом результатов отдельным списком.
  • Скачивание и открытие файлов во встроенном просмотрщике.
  • Разграничение прав: создание и загрузка папок и файлов доступны только администраторам (+ Папка и + Файлы скрыты для обычных пользователей).

Полезно знать

  • Файлы хранятся в объектном хранилище (S3). Если хранилище не настроено, загрузка, скачивание и предпросмотр работать не будут.
  • Перед переходом в категорию обязательно выберите раздел проектирования — иначе появится сообщение «Сначала выберите раздел проектирования».
  • Выбранный раздел запоминается: при следующем открытии подставляется сохранённый раздел, а если его нет — раздел из профиля пользователя.
  • Существует два варианта экрана категории. Фактически используется проводник базы знаний с деревом файлов, превью и статистикой; отдельный экран с плитками карточек ресурсов в текущей навигации не открывается, но его компоненты (диалог комментариев, карточка ресурса) задействованы в проводнике.
  • Ссылка на файл в карточке ресурса задаётся вручную (поле Ссылка на файл), а изображение ресурса загружается в хранилище и подтягивается оттуда.
  • Проверка орфографии подключена в полях названия и описания, но не в поле ссылки на файл и не в строке поиска.

Агент Орион

Орион — встроенный ИИ-помощник ViVBIM для проектировщиков: отвечает на вопросы по разделам АР, КР, ВК, ОВ, ГП, ЭОМ и СС, умеет искать в локальной нормативной базе и цитировать нормативы, искать в интернете, обращаться к вашим объектам, проектам, задачам и сохранённым расчётам, а также формировать официальные отчёты.

Как открыть

Кнопка Агент Орион в шапке приложения. Окно одно на приложение: повторное нажатие поднимает уже открытое окно. Заголовок окна — Орион — ИИ-агент ViVBIM.

Как пользоваться

  1. Откройте окно агента кнопкой Агент Орион.
  2. Проверьте статусную строку внизу: она показывает состояние нормативной базы (например, «Нормативная база загружена (N чанков)»).
  3. При необходимости включите нужные инструменты чекбоксами в левой панели: 🌐 Интернет-поиск, 📚 Нормативная база, 📄 Режим отчёта.
  4. Введите вопрос в поле «Введите ваш вопрос по проектированию...» и отправьте: Enter — отправить, Shift+Enter — перенос строки. Ответ печатается постепенно, кнопкой ⬛ генерацию можно прервать.
  5. Для голосового ввода нажмите 🎙️, продиктуйте вопрос и завершите запись — распознанный текст подставится в поле ввода.
  6. Для официального ответа включите 📄 Режим отчёта и отправьте вопрос — агент сформирует документ со структурой: краткий ответ, нормативное обоснование с дословными цитатами, практическая рекомендация, дополнительные замечания, что нужно уточнить, список источников.
  7. Работайте с историей в левой панели 📋 История диалогов: ✨ Новый диалог, выбор диалога из списка, ⬇ Загрузить ещё, 🗑️ Удалить выбранный.
  8. Экспортируйте результат кнопкой 📤 Экспорт или через контекстное меню области диалога.

Возможности

  • Чат с ИИ-моделью со потоковой выдачей ответа, разметкой Markdown и отображением математических формул (LaTeX).
  • Несколько системных режимов работы: обычный ответ по нормативам, аналитический режим с обязательным поиском и дословным цитированием нормативной базы, режим формирования официального отчёта.
  • История диалогов с постраничной загрузкой, созданием нового диалога, удалением выбранного диалога и восстановлением последнего диалога при открытии.
  • Редактирование и удаление отдельных сообщений прямо в диалоге, повтор последнего запроса.
  • Экспорт диалога в форматы Markdown (*.md), Текст (*.txt), PDF (*.pdf), DOCX (*.docx), HTML-презентация (*.html); копирование всего диалога в буфер обмена.
  • Голосовой ввод: запись с микрофона и распознавание речи.
  • Доступные агентy инструменты (включаются чекбоксами в левой панели):
ИнструментЧто делаетПараметрыСостояние
search_knowledge_baseСемантический поиск по локальной нормативной базе, возвращает дословные фрагменты с именем файлаquery, top_k (по умолчанию 2)Включён по умолчанию
search_webПоиск актуальной информации в интернетеquery, max_results (по умолчанию 3)Включён по умолчанию
get_user_objectsСписок объектов пользователя—Выключен по умолчанию
get_user_projectsСписок проектов пользователя—Выключен по умолчанию
get_user_tasksСписок задач пользователя—Выключен по умолчанию
get_trench_calculationsСписок сохранённых расчётов траншей—Выключен по умолчанию
get_well_calculationsСписок сохранённых расчётов колодцев—Выключен по умолчанию
get_earthwork_calculationsСписок сохранённых расчётов котлованов—Выключен по умолчанию
  • Откуда берутся знания: нормативные документы (СП, ГОСТ, СанПиН, СНиП) в формате Markdown в локальной папке knowledge_base_designer индексируются — текст разбивается на фрагменты (по 512 символов с перекрытием 100), для каждого считается векторное представление, индекс хранится в базе. При запросе выполняется семантический поиск по сходству, после чего лучшие фрагменты дополнительно переранжируются, и только потом попадают в ответ.
  • Статус нормативной базы, количество проиндексированных фрагментов и диагностика сбоев отображаются в статусной строке окна.
  • Список доступных нормативных документов выводится в выпадающем списке 📄 Доступные СП:.
  • Учёт токенов: в статусной строке отображается израсходованный объём и лимит за месяц (например, «Токены: 12 345 / 50 000 (24.7%)»). При исчерпании 80% индикатор меняет цвет; для администраторов лимит не ограничен.
  • Отдельно показывается счётчик вопросов в текущем диалоге (Вопросы: 0/10).
  • Подсказки-автодополнение при вводе, включая названия документов и сохранённых шаблонов запросов.
  • Контекст диалога ограничен по объёму: при переполнении ранние части истории опускаются, о чём в диалоге появляется отметка.

Полезно знать

  • Для работы агента нужен ключ доступа к сервису ИИ. Ключ может быть задан переменной окружения AITUNNEL_API_KEY (или OPENAI_API_KEY) либо храниться в таблице секретов приложения под именем aitunnel_api_key или openai_api_key.
  • Если ключ не задан или не установлена библиотека работы с ИИ, окно всё равно открывается: доступны история диалогов, переключение сессий, просмотр сообщений и экспорт, но отправка новых запросов блокируется с понятным пояснением причины.
  • Нормативная база не входит в поставку. Чтобы Орион мог цитировать нормативы, документы нужно положить в папку knowledge_base_designer в формате Markdown и выполнить индексацию. Если база пуста, семантический поиск и цитирование работать не будут — агент честно сообщит, что в загруженных документах ответ не найден.
  • При включённой нормативной базе агент по правилам обязан сначала выполнить поиск по ней и не должен подменять нормативные ссылки собственными знаниями или интернетом.
  • Использовать интернет-поиск и нормативную базу одновременно можно, но ответ должен явно разделять источники: сначала вывод по базе, затем — «Дополнительно из интернета».
  • Режим отчёта применяется к следующему отправленному сообщению.
  • Прикрепление файлов к вопросу в текущей сборке недоступно: кнопка вложения в окне отсутствует, хотя код чтения вложений (PDF, DOCX, TXT, MD, изображения) в проекте есть. Диалог управления шаблонами запросов также не вызывается из интерфейса — шаблоны, сохранённые в системе, подставляются через автодополнение при вводе.
  • Ограничения по объёму: один результат инструмента обрезается до 100 000 символов; контекст запроса ограничен — при его переполнении ранняя история опускается.
  • Агент предупреждает, если отвечает не по базе и не по интернету, а по собственным знаниям модели, — такие ответы следует перепроверять.
  • Если нормативной базы нет или она не проиндексирована, кнопка обновления базы доступна только администратору, а обычному пользователю выводится рекомендация обратиться к администратору.
  • Орион — помощник, а не замена проверке: ответы, особенно без явной ссылки на пункт норматива, требуют проверки инженером.
ViVBIM 6.0 — руководство пользователя Документ обновляется вместе с приложением
↑ Наверх