Инструкция пользователя программы для ЭВМ «ГидроВэб»
О документе
1. Регистрация
1.1 Регистрация по email
| Поле | Поведение |
|---|---|
| Имя | текстовое, обязательное; отображается как приветствие («Добро пожаловать, …!») и как имя автора в отчётах |
| проверяется на формат на лету (сообщение «Некорректный email» появляется прямо под полем, до отправки формы) | |
| Пароль | минимум 8 символов; под полем — индикатор надёжности («Слабый/Надёжный» и цветные сегменты), обновляется по мере ввода |
| Согласия (три отдельных чекбокса) | обязательны два: «Принимаю условия лицензионного соглашения (оферты)» и «Даю согласие на обработку персональных данных» (рядом — ссылки на лицензионное соглашение, согласие и политику обработки персональных данных; открываются в новой вкладке); третий, «Согласен(на) получать информационные и рекламные материалы», необязателен и по умолчанию не отмечен. Без обязательных отметок кнопка «Зарегистрироваться» не отправляет форму; выбор и версия документов фиксируются на сервере. Те же документы доступны на экране входа и в меню аватара (пункт «Документы»), там же — руководства пользователя и разработчика и контрольные задачи. |
После отправки формы аккаунт создаётся сразу, но доступ в программу не открывается — появляется экран «Подтвердите почту»:
1.2 Вход через Яндекс ID
Кнопка «Продолжить с Яндекс ID» выполняет переход на страницу авторизации провайдера (OAuth-редирект на GET /api/auth/oauth/yandex и обратный вызов). Адрес электронной почты в этом случае считается подтверждённым провайдером, и экран подтверждения почты не отображается. Кнопка входа через Яндекс ID показывается, если способ включён на сервере. Вход через VK ID пока не подключён.
2. Вход и сессия
Вход по email — на той же форме, переключателем «Войти» вместо «Зарегистрироваться»: email и пароль, кнопка «Войти».
После успешного входа новый аккаунт сразу спрашивает о роли — это не отдельная регистрация, а шаг адаптации (onboarding), который можно пропустить кнопкой «Пропустить»:
Выбор роли ни разу не запросил дополнительных обязательных полей — «Продолжить» становится активной сразу после выбора одной из шести карточек.
2.1 Срок действия сессии
Сессия хранится в защищённой httpOnly-куке браузера и недоступна для чтения средствами JavaScript на странице. Срок действия токена в текущей конфигурации — 720 часов (30 суток); значение задаётся константой TOKEN_EXPIRE_HOURS и переопределяется переменной окружения HYDROWEB_TOKEN_EXPIRE_HOURS.
2.2 Выход
Выход из учётной записи выполняется через меню аккаунта, которое открывается кликом по круглому аватару с инициалом в правом верхнем углу. В заголовке меню выводятся имя пользователя и адрес электронной почты, ниже — пункт «Мои проекты» (в окне редактора проекта) и пункт «Выйти». Меню закрывается клавишей Esc или кликом вне его области. Пункт «Выйти» открывает запрос подтверждения «Выйти из аккаунта?» с кнопками «Отмена» и «Выйти»; при выходе из окна редактора проекта в запросе дополнительно выводится предупреждение о возможной потере несохранённых данных. Подтверждение возвращает пользователя на стартовую страницу входа.
3. Где проекты
После входа и выбора роли (или после клика на «Мои проекты» в шапке) открывается список проектов пользователя — с самого начала пустой:
Над списком — фильтры по статусу (Все / Активный / Черновик / Архив) с счётчиками и строка поиска «по названию, адресу…».
3.1 Создание проекта
Кнопка «Новый проект» (или «Создать проект» в пустом состоянии) открывает выбор режима работы:
«Подбор решений» — упрощённый мастер из 3 шагов для быстрого подбора готового решения (Solution Finder); в этом документе описан «Профессиональный режим», так как он даёт полный контроль над параметрами расчёта. После выбора профессионального режима — второй экран, способ создания проекта:
«Из документа» помечено «(скоро)» и не кликабельно — функция ещё не реализована. «Найти в ЕГРЗ» открывает поиск по локальной базе реестра заключений экспертизы (интегрирован отдельно, не проверялся в рамках этого прохождения). Для пустого проекта — третий экран с реквизитами:
Обязательным является только поле «Название проекта»; кнопка «Создать проект» остаётся активной при незаполненных остальных полях.
3.2 Список, открытие, дублирование, удаление
Созданный проект сразу появляется в списке с колонками «Проект / Режим / Стадия / Заказчик / Статус / Полнота / Изменён». «Полнота» — процент заполненности данных для отчёта (у нового проекта с одним названием и адресом — 13%).
Правый клик по строке проекта открывает контекстное меню — «Открыть», «Переименовать», «Дублировать», «Удалить». Пункт «Переименовать» открывает диалог реквизитов проекта, в котором меняется его название:
3.3 Изоляция между пользователями
Проекты изолированы между учётными записями. Пользователь видит в списке и в поиске только собственные проекты; проекты других пользователей недоступны ни в перечне, ни по прямому запросу.
4. Работа с проектом
Открытый проект в профессиональном режиме — это семь вкладок в один экран, каждая со своей формой слева и живой визуализацией схемы справа (переключатель «Схема / Таблица» над вкладками). Порядок вкладок: Геология → Ограждение → Нагрузки → Анкеры, распорки → Результаты → Чертёж → Документы.
У пустого проекта уже подставлена демонстрационная геология (2 слоя: суглинок 3 м, песок средний 7 м), профиль шпунта ECO 622T, пригрузка q=20 кПа и УГВ на 2,0 м — это не пустые поля, а рабочие значения по умолчанию, на которых сразу можно запустить расчёт.
4.1 Геология
Слева — переключатель способа задания геологии (по мощности слоя / по относительным отметкам / по абсолютным отметкам), справа — таблица характеристик грунтов и живой разрез.
Для каждого инженерно-геологического элемента (ИГЭ) задаются: L (мощность слоя, м), γ (удельный вес, кН/м³), φ (угол внутреннего трения, °), c (удельное сцепление, кПа), E (модуль деформации, кПа), ν (коэффициент Пуассона), k_s (коэффициент постели, кН/м³ — 0 означает «вычислить из E»), ρ и ρ_sat (плотность природная и водонасыщенная, г/см³). Кнопка «+ Типовой грунт» подставляет готовый набор параметров из справочника СП по названию грунта (песок, суглинок, глина и т.д. — более 20 позиций), что заметно ускоряет ввод для типовых случаев.
Ниже — параметры расчёта: тип грунта (нормально уплотнённый / переуплотнённый), метод бокового давления (СП 22.13330.2016 / Сорочан / Соколовский / Eurocode 7 / вручную / по численному расчёту), сейсмика (баллы < 7…9, с пояснением «< 7 баллов — сейсмика в расчёте не учитывается»), модель воды (свободная/связанная) и способ определения жёсткости грунта (по коэффициенту постели или пропорциональности).
Если оставить геологию не заполненной (удалить оба слоя), расчёт не запускается — при попытке нажать «Расчёт» форма требует хотя бы один слой (проверялось косвенно: полностью пустая геология в проекте не создаётся, минимум один слой присутствует всегда по умолчанию).
4.2 Ограждение
Параметры котлована: глубина котлована (м), длина ограждения (м), глубина заделки (м) — начальное приближение, уточняется расчётом, и контакт с грунтом δ/φ (0 — идеальный контакт по Ренкину, обычное значение 0,33 по Кулону).
Параметры ограждения: тип (шпунт / буросекущие сваи / стена в грунте), тип сечения РРСК (сплошная стенка / двутавр-стойки / труба-стойки), профиль — выпадающий список из 29 профилей шпунта ECO и Л (с моментом сопротивления W в см³/м прямо в названии), марка стали (S240GP…S430GP, С245), и производные E/J/A сечения — кнопка «Заполнить E/J/A из профиля» подставляет их автоматически, чтобы не искать в сортаменте вручную. Отдельно — чекбокс «Расчёт ограждения на прочность» и блок коррозии по СП 28.13330 (срок службы в годах × агрессивность среды).
Ниже, в «Методе расчёта» — переключатели: метод давления грунта (Ренкин/Кулон), способ задания жёсткости грунта, порог минимального активного давления (20% от бытового), модель грунтовой воды, глубина действия пригрузки, обводнённость лица заделки, уклон засыпки, модель для расчёта коэффициента запаса (автоматически / линейно деформируемая / жёстко-пластическая) и класс сооружения по СП 116.13330 (влияет на нормируемый коэффициент запаса заделки [K] — от 1,10 до 1,25).
4.2.1 Пионерный котлован и «вырожденная призма среза»
Отдельный чекбокс «Пионерный котлован (откос выше бровки)» открывает дополнительный блок: режим откоса (берма + откос / откос / полный откос), глубина и угол откоса, способ учёта («по грунту» — давление по геометрии дневной поверхности, или «по силам» — грунт выше бровки заменяется распределённой нагрузкой), и настройку, которая прямо отвечает на пункт задания о содержательных предупреждениях продукта:
«Давление при вырожденной призме среза» — переключатель между «Калибровка по эталонной программе (0,2·σ₀)» и «Давление покоя (σa = σ0, допущение)», с пояснением прямо на экране: по умолчанию берётся калибровка, потому что давление покоя «проваливает сверку с эталоном» (ссылка на запись [0239] в журнале разработки). Вырожденная призма — ситуация, когда сцепление грунта вдоль линии скольжения перекрывает вес клина и активное состояние физически недостижимо; переключатель начинает на что-либо влиять только в такой геометрии, на обычных схемах он неактивен.
4.3 Нагрузки
Три независимых блока: «Расчётные нагрузки на грунт» (полосовая пригрузка — этап включения/выключения, отступ от бровки, ширина полосы, заглубление, интенсивность qA/qB кПа — у демонстрационного проекта уже есть одна такая нагрузка q=20 кПа шириной 100 м, видна на схеме сверху слева); «Расчётные нагрузки на ограждение» (точечные) и «Распределённые нагрузки на ограждение» — оба пустые по умолчанию, добавляются кнопкой «+ Добавить».
4.4 Анкеры, распорки
Три подраздела переключателем (Анкеры / Распорки / Грунтовые распорки), затем «Бермы» и центральный блок «Этапы разработки котлована» с таблицей: этап, глубина, уровень воды слева и справа по каждому этапу — на демонстрационном проекте задан один этап. Ниже — отдельная настройка УГВ (глубина по умолчанию, уровень водоупора, расстояние от дна до связи для расчёта нулевого этапа) и два независимых списка водоносных слоёв (слева/справа), с фильтром по этапу.
Если не задать ни одной связи (анкера или распорки), схема остаётся консольной («cantilever») — расчёт от этого не ломается, просто заделка держит стенку одна; это подтверждено расчётом демонстрационного проекта, где связи не добавлялись.
4.5 Результаты и последующие вкладки
Вкладка «Результаты» до расчёта показывает только одну строку — «Нажмите «Рассчитать» для получения результатов»; подробно она разобрана в разделе 6. Вкладки «Чертёж» и «Документы» — в разделе 7 (выгрузка).
5. Запуск расчёта
Кнопка расчёта — в правом верхнем углу экрана проекта, рядом с выпадающим списком выбора расчётного ядра («Блюм» — метод предельного равновесия, или «МКЭ» — конечноэлементный решатель Винклера). Надпись на кнопке меняется в зависимости от выбора: «Расчёт МКЭ» или «Расчёт»/«Расчёт Блюм».
5.1 Индикация хода расчёта
Во время расчёта кнопка превращается в индикатор прогресса с процентом и временем: «Расчёт… 39% · 1 с», «63% · 2 с» и т.д. Если расчёт занимает необычно долго, под верхней панелью появляется отдельное информационное сообщение:
5.2 Расчёт методом Блюма — типичное время
Переключение расчётного ядра на «Блюм» и повторный запуск на тех же входных данных завершились примерно за 1 секунду, с автоматическим переходом на вкладку «Результаты»:
Как понять, что расчёт готов: кнопка возвращает исходную надпись («Расчёт» / «Расчёт МКЭ»), полоса прогресса и предупреждение о долгом расчёте исчезают, а вкладка «Результаты» заполняется графиками и таблицами вместо заглушки «Нажмите «Рассчитать»…».
6. Чтение результатов
Вкладка «Результаты» после расчёта показывает четыре графика (эпюры) слева сверху и таблицы значений ниже; на схеме справа появляется переключатель эпюр (нет / σ / M / Q) поверх разреза.
6.1 Графики (эпюры)
- Давление грунта, кПа — активное (слева, синим) и пассивное (справа, красным) по глубине;
- Поровое давление u(z), кПа — гидростатическое давление воды;
- Момент M(z), кН·м/м — изгибающий момент по длине стенки;
- Поперечная сила Q(z), кН/м — перерезывающая сила по длине стенки.
6.2 Числовые результаты
Ниже графиков — три блока, дословно как на экране:
| Усилия | Значение |
|---|---|
| Mmax | 161,6 кН·м/м |
| Глубина Mmax | 4,3 м |
| Q внутр. max (металл) | 75,6 кН/м · z=1,0 м |
| Q у заделки (R_toe) | 0,1 кН/м |
| Усилие в опоре 1 | 81,5 кН/м |
«Q внутр. max» и «Q у заделки (R_toe)» — различные по смыслу величины: первая используется при проверке металла стенки, вторая является опорной реакцией заделки по методу Блюма.
| Прочность (I ГПС) | Значение |
|---|---|
| Профиль | ECO 622T |
| W | 2206 см³/м |
| Ry | 355 МПа |
| Capacity (W·Ry·γc) | 900,6 кН·м/м |
| Использование η | 0,229 |
| Запас Ks | 4,36 |
| Деформации (II ГПС) | Значение |
|---|---|
| Прогиб max | 2,9 мм |
| Допустимый (H/100) | 50 мм |
6.3 Устойчивость и предупреждения о несущей способности
| Устойчивость | Значение |
|---|---|
| kst (заделка) | 1,207 |
| d по Блюму | 2,92 м |
| d проектная (×1,2) | 3,51 м |
| Рекомендуемая длина | 8,51 м |
| Длина шпунта (ввод) | 8,00 м |
| Статус | НЕ ПРОХОДИТ |
Ниже расположены сворачиваемый блок «Ka / Kp / K0 коэффициенты» и панель формирования отчёта (раздел 7). При недостаточной несущей способности программа выводит статус «НЕ ПРОХОДИТ» и указывает причину с числовыми значениями — например: «Длина шпунта недостаточна. Введено 8.00 м, минимум по расчёту — 8.51 м», — сообщая как минимально необходимую длину ограждения, так и рекомендуемую с учётом технологического запаса.
7. Выгрузка
Три отдельных места для получения файлов: панель «Формирование отчёта» внизу вкладки «Результаты», вкладка «Документы» и вкладка «Чертёж».
7.1 Отчёт для экспертизы — вкладка «Результаты»
Внизу вкладки «Результаты» — переключатель формата (DOCX для экспертизы / XLSX таблицы / PDF краткий / XML ЕЦПЭ beta) и кнопка «Сформировать отчёт», с подписью «Полный отчёт для Главгосэкспертизы (A4, Times New Roman, ГОСТ)».
Отчёт в формате DOCX включает страницу реквизитов (свидетельство о государственной регистрации программы, перечень нормативной базы — своды правил и государственные стандарты), раздел с изложением методики расчёта (теория Кулона — Ренкина, эффективные напряжения, метод Блюма) и числовые результаты выполненного расчёта.
7.2 Пакет документов — вкладка «Документы»
Подвкладки внутри раздела — Спецификация / Ведомость / Расход материалов / Пояснительная записка / ТЭО — это предпросмотр разделов; согласно подписи на экране («состав файлов от выбранной вкладки не зависит»), кнопка «Скачать пакет документов» всегда формирует два файла независимо от того, какая подвкладка открыта.
По нажатию кнопки формируется и загружается пакет документов. Файл XLSX содержит три листа — «Спецификация», «Ведомость» и «Расход материалов»; при наличии объёмов для сметы добавляется четвёртый лист «ТЭО» (технико-экономическое обоснование) с расчётными объёмами и полями для расценок, в которых суммы заданы формулами.
Перед выгрузкой на экране — три содержательных предупреждения жёлтым (значок «!»): «Расчёт не выполнен — раздел 4 ПЗ будет без числовых результатов», «Организация-разработчик не указана», «ФИО разработчика не заполнено». Первое исчезает после запуска расчёта на вкладке «Результаты» (числа тогда попадают в пояснительную записку); два остальных требуют заполнения реквизитов проекта (баннер «Заполните данные проекта…» вверху экрана, кнопка «Заполнить», поля «описание, город, регион» и ещё 6 не показанных сразу).
Таблица спецификации формируется по геометрии сооружения и каталогу материалов и заполняется до запуска расчёта — позиции ограждения и распорной системы определяются периметром котлована и выбранным профилем, без обращения к результатам расчёта усилий.
7.3 Чертёж — вкладка «Чертёж»
Полноценный чертёжный редактор: выбор формата листа (A4/A3/A2/A1), ориентации (альбомная/книжная), видов (план/разрез), переключатели размеров/штриховки/осей, управление слоями («Слои 15/15»), масштаб (zoom + Fit) и кнопки экспорта SVG / DXF / PDF / RFA (последняя помечена «Скоро», недоступна). На самом чертеже — реальные размерные линии (5.0, 8.0, 3.0, 20.0, 1.0 м), основная надпись по ГОСТ (графы «Изм./Кол.уч/Лист/№ док/Подп/Дата/Разраб/Пров/Н.контр/Утв», сегодняшняя дата, обозначение «КЖ-001», стадия «Р», масштаб «М 1:200», название проекта).
Экспорт в формате SVG формирует файл чертежа с планом, разрезом, размерами и основной надписью.
7.4 Куда сохраняются файлы
Выгрузка выполняется стандартными средствами браузера: файл сохраняется в каталог загрузок, заданный настройками браузера. История выгрузок в интерфейсе программы не ведётся.
8. Типовые затруднения
8.1 Расчёт не сошёлся или идёт слишком долго
Если выбрано ядро «МКЭ» и индикатор длительное время остаётся на высоком проценте, программа выводит на экран пояснение о причине («Расчёт идёт дольше обычного… решателю нужно больше итераций… повторно нажимать не нужно»). Повторное нажатие кнопки расчёта не требуется. Для быстрой оценки и проверки исходных данных ядро переключается на «Блюм» в выпадающем списке рядом с кнопкой расчёта: классический метод предельного равновесия отрабатывает на тех же данных за время порядка секунды, но не воспроизводит многоэтапные схемы с той же полнотой, что МКЭ.
8.2 Поле не принимает значение
Числовые поля (глубина, длина, коэффициенты) имеют заданные границы допустимых значений: значение вне диапазона не сохраняется либо помечается ошибкой при запуске расчёта. Поле адреса электронной почты на форме регистрации проверяется при вводе — при некорректном значении под полем выводится сообщение «Некорректный email» и отправка формы блокируется.
8.3 Забыт пароль
Восстановление пароля выполняется самостоятельно с экрана входа. Ссылка «Забыли пароль?» расположена на форме входа; по ней запрашивается адрес электронной почты, на который отправляется письмо со ссылкой для задания нового пароля. Ссылка действует один час и является одноразовой: после успешной смены пароля она становится недействительной. Требования к новому паролю — те же, что при регистрации. Учётные записи, созданные через Яндекс ID, пароля не имеют — вход в них выполняется кнопкой провайдера, и восстановление пароля к ним неприменимо. В целях защиты от перебора сообщение об отправке письма выводится независимо от того, зарегистрирован ли указанный адрес на платформе.
8.4 Расчёт показывает «НЕ ПРОХОДИТ»
Как показано в разделе 6.3, статус «НЕ ПРОХОДИТ» с конкретным пояснением (например, недостаточная длина шпунта и минимально необходимое значение) — это не ошибка ввода, а результат расчёта: заданная конструкция не удовлетворяет проверке по СП. Практическое действие — увеличить длину ограждения (поле «Длина ограждения, м» на вкладке «Ограждение») до значения не меньше указанного продуктом («Рекомендуемая длина») и пересчитать.