Правообладатель: ООО «ФЬЮТЕХ» (RU). Версия: 1.1.0-alpha. Документ актуализирован: 25.08.2026.
Программа для ЭВМ «ГидроВэб» распространяется как облачный сервис (модель SaaS). Установка программного обеспечения на технические средства пользователя, включая персональный компьютер эксперта, не требуется: работа ведётся через веб-браузер по сети «Интернет». Экземпляр программы уже развёрнут правообладателем на сервере, расположенном на территории Российской Федерации, и доступен для проверки.
Документ содержит две части:
— раздел 1 — порядок получения доступа к развёрнутому экземпляру (то, что необходимо выполнить проверяющему); — разделы 2–9 — порядок разворачивания экземпляра программы на сервере. Эта часть приводится в соответствии с требованием подраздела «Документация на программное обеспечение» методических рекомендаций и адресована администратору, разворачивающему собственный экземпляр; для экспертной проверки её выполнение не требуется.
| Параметр | Значение |
|---|---|
| Адрес экземпляра программы | https://hydroweb.online |
| Способ доступа | Веб-браузер, подключение к сети «Интернет» |
| Программное обеспечение на рабочем месте | Не устанавливается; достаточно браузера |
| Учётная запись для проверки | Выдана правообладателем; логин и пароль приведены в документе «Информация, необходимая для эксплуатации экземпляра программного обеспечения» |
| Права доступа учётной записи | Профессиональный уровень — открыт весь заявленный функционал |
| Параметр | Значение |
|---|---|
| Браузер | Yandex Browser, Google Chrome, Mozilla Firefox, Microsoft Edge, Safari — актуальные версии |
| Поддержка технологий | JavaScript, HTML5 (включены по умолчанию) |
| Разрешение экрана | Не менее 1366 × 768 |
| Канал связи | Доступ к сети «Интернет», не менее 1 Мбит/с |
| Операционная система | Любая, в которой работает перечисленный браузер (Windows, Linux, macOS) |
браузера: файлы сохраняются средствами браузера в каталог загрузок.
браузера; несохранённые изменения проекта при этом не теряются, так как проекты хранятся на сервере.
Никакие компоненты на рабочее место не устанавливаются и не требуют настройки; программная и аппаратная защита (ключи, лицензионные файлы) не применяется.
| Параметр | Минимально | Рекомендуется |
|---|---|---|
| Вычислительные ядра | 2 | 4 |
| Оперативная память | 4 ГБ | 8 ГБ |
| Дисковое пространство | 20 ГБ | 30 ГБ (при использовании реестра заключений экспертизы — дополнительно около 3 ГБ) |
| Операционная система | Ubuntu 22.04 LTS / Debian 12 или иной дистрибутив Linux с поддержкой контейнеров | Ubuntu 24.04 LTS |
| Системное ПО | Docker Engine 24+ с Docker Compose, nginx (при использовании защищённого соединения) | то же |
Все компоненты системного ПО распространяются на условиях свободных лицензий и доступны из репозиториев дистрибутива. Проприетарное иностранное программное обеспечение для работы программы не требуется.
Веб-браузер с поддержкой JavaScript: Yandex Browser, Google Chrome, Mozilla Firefox, Microsoft Edge, Safari — актуальные версии. Установка программного обеспечения на рабочее место не требуется.
Дистрибутив передаётся в виде исходных текстов и сборочных файлов и содержит:
| Каталог / файл | Содержимое |
|---|---|
hydroweb/ | Серверная часть: расчётное ядро, программный интерфейс, подсистема хранения |
frontend/ | Веб-интерфейс (исходные тексты и сборочная конфигурация) |
Dockerfile | Описание сборки контейнера приложения |
docker-compose.yml | Описание запуска и параметров среды |
deploy/entrypoint.sh | Сценарий запуска процессов внутри контейнера |
deploy/nginx-site.conf | Конфигурация веб-сервера внутри контейнера |
deploy/setup-server.sh | Сценарий первичной подготовки сервера |
deploy/deploy.sh | Сценарий обновления экземпляра |
pyproject.toml | Перечень зависимостей серверной части |
frontend/package.json | Перечень зависимостей веб-интерфейса |
Выполняется однократно с правами суперпользователя. Сценарий deploy/setup-server.sh устанавливает Docker, создаёт непривилегированную учётную запись для развёртывания, подготавливает каталог приложения и настраивает межсетевой экран:
scp deploy/setup-server.sh root@<адрес-сервера>:
ssh root@<адрес-сервера> bash setup-server.shДействия сценария:
deploy с правом управления контейнерами;/opt/hydroweb;Те же действия могут быть выполнены вручную — сценарий не содержит специфичных для поставщика зависимостей.
В каталоге приложения создаётся файл .env со значениями параметров. Файл не входит в дистрибутив и не подлежит передаче третьим лицам.
| Параметр | Обязательность | Назначение |
|---|---|---|
HYDROWEB_JWT_SECRET | обязательный | Секрет подписи токенов доступа. Задаётся случайной строкой не короче 32 символов |
HYDROWEB_CORS_ORIGINS | обязательный | Перечень доменов, которым разрешены запросы к программному интерфейсу |
HYDROWEB_FRONTEND_URL | обязательный | Адрес сервиса; используется в ссылках писем подтверждения |
UVICORN_WORKERS | необязательный | Число рабочих процессов сервера приложений (по умолчанию 2) |
EGRZ_DB_PATH | необязательный | Путь к базе реестра заключений экспертизы |
HYDROWEB_SMTP_HOST, _PORT, _USER, _PASSWORD, _FROM, _TLS | необязательные | Параметры почтового сервера для писем подтверждения адреса |
YANDEX_CLIENT_ID, YANDEX_CLIENT_SECRET, YANDEX_REDIRECT_URI | необязательные | Параметры входа через Яндекс ID |
HYDROWEB_AI_PROVIDER, HYDROWEB_YANDEX_API_KEY, HYDROWEB_YANDEX_FOLDER_ID | необязательные | Параметры подсистемы помощи |
При отсутствии необязательных параметров соответствующие функции отключаются, остальная функциональность сохраняется в полном объёме.
Выполняется на машине сборки; результат помещается в контейнер:
cd frontend
npm ci
npm run builddocker compose up -d --buildКоманда собирает образ (устанавливая зависимости серверной части), создаёт том для данных и запускает контейнер. Внутри контейнера запускаются сервер приложений на порту 8000 и веб-сервер, публикующий интерфейс и проксирующий обращения к программному интерфейсу. Контейнер публикуется на локальном интерфейсе узла (127.0.0.1:8080), внешний доступ организуется через nginx узла с защищённым соединением.
curl -f http://localhost:8080/api/profiles
docker compose ps # состояние должно быть healthy
docker compose logs -f # журнал запускаВ образ встроена периодическая проверка работоспособности: при отказе приложения контейнер перезапускается автоматически (политика restart: unless-stopped).
назначаемые администраторами при первом входе, задаются в конфигурации приложения.
docker compose exec hydroweb python scripts/import_egrz.py <путь-к-файлу>переносится в том данных при первом запуске автоматически.
Обновление выполняется сценарием deploy/deploy.sh, который собирает веб-интерфейс, переносит изменившиеся файлы на сервер и пересобирает контейнер:
bash deploy/deploy.sh <адрес-сервера>Данные пользователей размещены в отдельном томе и при обновлении сохраняются. Схема базы данных при запуске приводится к актуальной автоматически.
docker compose down # остановка и удаление контейнера
docker volume rm hydroweb_hydroweb-data # удаление данных (необратимо)
rm -rf /opt/hydroweb # удаление файлов приложения