Сокол — система автоматизированного анализа заданий на проектирование

Функциональные характеристики

Программа: «Сокол — система автоматизированного анализа заданий на проектирование».

Назначение

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

Входные данные

Пользователь загружает один файл задания на проектирование в формате PDF или DOCX размером до 50 МБ. PDF с изображениями страниц может обрабатываться как скан. Перед загрузкой PDF интерфейс требует подтвердить отсутствие в нём листов согласования и персональных данных третьих лиц, указанных в предупреждении при загрузке.

Программа проверяет тип загруженного документа и рассчитывает стоимость анализа до его запуска. Пользователь видит стоимость и отдельно подтверждает запуск.

Основные функции

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

Результат и границы применения

Паспорт объекта сводит основные сведения проекта. Отчёт-обоснование содержит результаты анализа и замечания. Проект письма помогает оформить запросы и замечания для заказчика. Файлы можно скачать из кабинета пользователя.

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

Руководство пользователя

Программа: «Сокол — система автоматизированного анализа заданий на проектирование».

1. Получение доступа и вход

Откройте сайт Сокола в браузере и выберите «Вход». Введите логин и пароль, предоставленные правообладателем. После входа откроется рабочий кабинет с областью загрузки и списком ваших анализов. Если доступ ещё не предоставлен, используйте форму запроса доступа на главной странице.

2. Подготовка файла

Подготовьте задание на проектирование в формате PDF или DOCX размером не более 50 МБ. Для старого формата Word .doc сохраните копию в DOCX или PDF перед загрузкой. Убедитесь, что текст читается, страницы расположены правильно, а файл относится именно к заданию на проектирование.

Если PDF состоит из изображений страниц, ознакомьтесь с предупреждением при загрузке: скан может обрабатываться как изображение до текстового обезличивания. Не загружайте PDF с листами согласования и персональными данными третьих лиц, указанными в предупреждении. Подтверждение в интерфейсе требуется для любого PDF.

3. Загрузка и оценка стоимости

В кабинете перетащите файл в область «Новый анализ» или нажмите на неё для выбора файла. Проверьте имя и размер файла. Нажмите «Оценить стоимость». Программа сначала определит тип документа и покажет стоимость отдельным шагом. Если документ не подходит или не читается, интерфейс сообщит причину.

4. Запуск и получение результата

На странице подтверждения проверьте стоимость. Нажмите «Запустить анализ», если хотите продолжить, либо «Отмена». Во время обработки отображаются стадия и состояние задачи; можно вернуться к списку анализов. После завершения откройте результат и скачайте три файла DOCX: «Паспорт объекта», «Отчёт-обоснование» и «Письмо заказчику».

История доступна в вашем кабинете. Для просмотра ранее готового результата войдите в учётную запись и выберите «Открыть документы» в соответствующей строке.

5. Работа с полученными документами

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

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

Установка и эксплуатация

Программа: «Сокол — система автоматизированного анализа заданий на проектирование».

Сокол предоставляется пользователям как веб-сервис. Рабочее место пользователя и серверная часть имеют разные требования. Пользователь не устанавливает серверные компоненты и не получает локальный установщик.

Рабочее место пользователя

Для работы нужны доступ к сайту по HTTPS, браузер с включённым JavaScript и возможностью загрузки файлов, а также программа для чтения результатов DOCX. Для входа требуются учётные данные, выданные правообладателем. Поддерживаемые входные файлы для штатного сценария — PDF и DOCX размером до 50 МБ.

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

Серверная часть

Развёртывание выполняет оператор сервиса в контролируемой им инфраструктуре из исходного кода и конфигурации поставки. Фактическая схема содержит четыре компонента: веб-интерфейс на React, API на Python/FastAPI, фоновый обработчик задач Celery и очередь Redis. Веб-интерфейс собирается в статические файлы и отдаётся Nginx; внешний обратный прокси предоставляет HTTPS-доступ.

Поставка исходного кода содержит backend/Dockerfile, frontend/Dockerfile и docker-compose.yml. В конфигурации используются образы Python 3.11, Node 20 для сборки, Nginx 1.27 и Redis 7. API и обработчик задач используют общий образ backend. Каталоги backend/data, backend/uploads и backend/output подключаются к API и обработчику как постоянные тома. Для анализа требуется подключение к используемому сервисом LLM API; его параметры доступа хранятся в приватной конфигурации и не публикуются.

Порядок развёртывания оператором

1. Подготовить сервер с Docker Engine, Docker Compose и обратным прокси для HTTPS. Конкретные минимальные аппаратные ресурсы для серверной части не зафиксированы; их определяют по нагрузке и объёму документов.
2. Разместить проверенную версию исходного кода и приватную конфигурацию сервиса, включая параметры подключения к LLM API. Создать или сохранить постоянные каталоги данных, загрузок и результатов. Не включать учётные данные и ключи внешних сервисов в публичные файлы.
3. Собрать образ backend командой docker build -t sokol-backend ./backend, затем образ frontend командой docker compose build frontend из корня поставки.
4. Запустить компоненты через Docker Compose. Настроить HTTPS-прокси на веб-интерфейс и убедиться, что API доступен через маршрут /api/.
5. Проверить состояние API, Redis и фонового обработчика, затем вход под специально выделенной проверочной учётной записью. Работоспособность API сама по себе не подтверждает обработку документов: состояние фонового обработчика проверяется отдельно.

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