Главная тематическая статья раздела доступная по ссылке.
Сообщество проектировщиков последнее время посещает то одна боль, то другая. Не успели еще коллеги отмучаться, сдавая квалификационный экзамен для подтверждения уровня своей квалификации, как новая напасть. Теперь для подачи проектной документации (ПД) в экспертизу нужно разделы оформлять в машиночитаемом формате. Пока только пояснительную записку (ПЗ), которую оформляет главный инженер проекта (ГИП), но вы не волнуйтесь — рано или поздно страдать будут все.
Смысл понятен: реализация политики цифровизации, попытка совместить BIM с ТИМ, а также оптимизировать процессы экспертизы и подготовки заключений. Начали с ПЗ. Она в этом плане удобная — в основном текстовая информация, которая поддается некой формализации. С 1 августа 2023 года этот раздел для проектов, задание на проектирование которых утверждено после 1-го сентября 2022 года, нужно подавать на государственную экспертизу в XML. Я пообщался с директором знакомой негосударственной экспертизы — они тоже принимают ПЗ теперь только в таком формате. Так, что, как говорят в приветственной записи одной известной авиакомпании — «да, безнадежность».
Были опасения, что вместе с новыми правилами нам будет представлен какой-то «особый» платный программный продукт, абсолютно необходимый для работы, который единственный может формировать «правильные» документы. Но пока, тьфу-тьфу, этого не случилось.
XML-формат — изначально формат файла структурированных данных для Интернет-приложений. Если не вдаваться в подробности, то данные в этом файле разделяются на блоки и заключаются в теги. Тег можно воспринимать, как объединение имени и параметров данных. Выглядит это так.
<BLOCK 1 Attribute1 = значение1 Attribute2 = значение2 >
<PROPERTIES1>Свойство 1</ PROPERTIES1>
<PROPERTIES1>Свойство 1</ PROPERTIES1>
</BLOCK 1>
То есть при определенной структуре, такой, какая определена схемой (схема для пояснительной записки размещена официально на сайте Минстроя), да используя справочники и определенные правила заполнения, можно сразу получить набор значений для базы данных по объектам строительства и применения в куче официальных документов.
В настоящее время Сервис по Формированию Пояснительной Записки (СФПЗ) разработан Главгосэкспертизой и доступен в Личном кабинете заявителя Единой цифровой платформы экспертизы (ЕЦПЭ), а также на многочисленных сайтах около проектных компаний, экспертиз, файлообменниках.
Инструкция о работе с СФПЗ было рассказано в ходе семинара Главгосэкспертизы, запись которого доступна по ссылке.
Установка программного комплекса СФПЗ на компьютер
Решил я поставить данный комплекс сначала на домашнем компьютере, убил вечер — и не смог. Все уперлось в установку стороннего программного обеспечения, а именно платформы Docker. Почему СФПЗ был реализован с его помощью, а не более классическим способом, ответа у меня нет. Могу только сказать, что развернуть систему для человека, который такие задачи решает очень редко, оказалось нетривиальной задачей. В обучающем видео дистрибутив ставится легко, вскользь упоминаются некоторые возможные проблемы. А в руководстве администратора по всем вопросам установки отсылают сразу к разработчику стороннего программного обеспечения. Вражеского, надо отметить.
Скачал я дистрибутив, стал ставить. Процесс у меня сразу завис. Со второй попытки продукт вроде бы встал, но не запустился. Чего я только не делал, сколько разных советов не реализовал — результата не получил. Пробовал даже поставить старую версию Docker. Она встала и вроде бы запустилась, но теперь оказалось не установить СФПЗ: контейнеры не создавались, отчаянно ругаясь на устаревший компонент. Может быть, если досконально разобраться в том, как эта хрень работает, чего-то бы дальше и вышло. Но дальше мучить себя и семью я не стал. Причиной неудачи для себя определил особенности сборки своей Windows: я настолько ее отрубил от всех лишних сервисов, что это оказалось фатальным для некоторых технологий.
На работе с этим проще, поэтому в следующий раз, как выдалось свободное время, к увлекательному процессу развертывания СФПЗ я перешел там.
Процесс рассмотрен для ОС Windows(тестировал на версии Windows10). У вас должны быть права администратора.
1. Скачайте дистрибутив Docker с официального сайта (https://www.docker.com/get-started/) и установите программу «Docker Desktop Installer.exe» (здесь и далее используйте команду «Запуск от имени администратора», которая доступна в контекстном меню при выборе файла).
Галочки при установке программы, говорят, можно не снимать. Да и не сделаете с их помощью вы ничего страшного.
Я прямо даже обрадовался. Запустил. Принял (Accept) все официальные соглашения. И… ничего не заработало.
2. Благо решению этой проблемы посвящена целая статья от разработчика операционной системы. Совсем легко не будет: простой путь, который там описан, тоже не дал желаемого эффекта. Я использовал алгоритм, описанный тут.
Откройте командную строку PowerShellв режиме администратора (в меню пуск в соответствующей папке «Windows PowerShell»), щелкнув правой кнопкой мыши по ярлыку и выбрав команду «Запуск от имени администратора».
Включаем компонент «Платформа виртуальных машин», скопировав в командную строку: «dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart».
Перезагружаем компьютер.
Скачиваем и устанавливаем пакет обновления «Подсистема Windows для Linux».
Ставим WSL 2 по умолчанию, для этого запускаем PowerShell и выполняем команду: «wsl --set-default-version 2».
Пробуем снова запустить Docker — о чудо!
3. Скачаем дистрибутив СФПЗ (например, с Единой цифровой платформы экспертизы или в свободном доступе (ссылка может быть недоступна со временем) или по ссылке от вашей экспертизы).
4. Создаем папку «C:/Program Files/sfpz».
5. Распакуем в каталог «sfpz» архив «Дистрибутив_СФПЗ.zip».
6. Зайдите в папку «C:/Program Files/sfpz».
7. В каталоге «C:/Program Files/sfpz/nginx в файле default.conf» укажите адрес сайта или ip-адрес сервера по которому пользователи будут обращаться к приложению. По умолчанию server_name имеет значение 127.0.0.1. У меня сие чудное средство будет использоваться только локально, поэтому я ничего не меняю.
8. Для очистки совести запустите файл «start.bat», расположенный в папке «C:/Program Files/sfpz». Это, конечно, не даст результата, поэтому перемещаемся в полюбившийся PowerShell и директивно перейдем в нужную папку с помощью команды: «cd «C:/Program Files/sfpz»» (путь должен быть в кавычках, иначе никуда вы не перейдете). Затем используем та же команды: «docker load -i sfpz.zip», а затем «docker compose up -d». Upd 28.01.24: Коллеги подсказывают, что нужно быть осторожным с копированием команд, чтобы все получилось лучше самостоятельно ввести команды, как на картинке. Странно, конечно. Но может быть какой пробел лишний, раскладка, кодировка или еще чего не дает случиться успеху.
Работа с сервисом
А вот и счастье — результат танцев с бубном. Для доступа к сервису надо зайти в браузер и ввести адрес сервера (Dockerдолжен быть запущен). Если вы ничего не меняли, как я, то это стандартный: 127.0.0.1.
В-принципе, дальше все понятно. Администратор может работать с записями пользователей: АДМИНИСТРИРОВАНИЕ — СПИСОК ПОЛЬЗОВАТЕЛЕЙ. Мне это не актуально, так как пусть остальные тоже страдают.
Он может отслеживать активность всех пользователей, через просмотр всех событий, которые происходили в системе: АДМИНИСТРИРОВАНИЕ — ПРОТОКОЛ СОБЫТИЙ.
Наконец, загружать актуальную XML-схему: АДМИНИСТРИРОВАНИЕ — XML-СХЕМЫ: ДОБАВИТЬ XML-СХЕМУ. Тут надо указать номер версии, подгрузить файлы XSD и XSL. Актуальную схему можно скачать с сайта Минстроя. В загруженной мною версии СФПЗ схема актуальна, делать ничего не потребовалось.
Вернуться к главному окну из любого можно через команду СПИСОК ПРОЕКТОВ.
Формирование пояснительной записки в машиночитаемом формате
Сначала надо создать проект с помощью команды, вы не поверите: СОЗДАНИЕ ПРОЕКТА. Система тут же предложит вам заполнить форму, в которой также все понятно: наименование, шифр, тип объекта (производственный, непроизводственный, линейный). «ВЕРСИЯ» — это версия XML-схемы, актуальная «01.03».
И вот уже список проектов не так пустынен. Доступ к командам работы с проектом осуществляется путем клика на наименование конкретного проекта.
Стандартно вам доступны команды РЕДАКТИРОВАТЬ описание проекта, УДАЛИТЬ проект. Почитайте инструкцию пользователя, там эти вопросы все описаны подробно. В том числе про шаблон.
Нам нужно заполнить текстовую часть с помощью команды ПОЯСНИТЕЛЬНАЯ ЗАПИСКА, а также задать информацию по прилагаемым файлам (исходно-разрешительной документации, отчеты по результатам инженерных изысканий, разделам проектной документации, а также информационно-удостоверяющим листам). Все прилагаемые файлы должны быть подписаны с помощью электронной цифровой подписи. Цифровые подписи подгружаются к каждому документу.
Потом, при подаче заявления на экспертизу на портале у вас появится возможность его создать с загрузкой пояснительной записки в XML. Тогда часть данных заявления подгрузится автоматически. Когда вы перейдете к загрузке документации, то сможете загрузить только те файлы, которые указывали при заполнении ПЗ. Имейте это ввиду.
Заполним данные ПЗ.
Красным подсвечиваются обязательные поля для заполнения, внизу после начала ввода данных, подсказки по заполнению, если формат записи является строгим, например, регистрационный номер юридического лица должен состоять из 13 символом: ни меньше, ни больше.
После заполнения документ можно проверить на полноту и выполнение заданных правил с помощью команды ПРОВЕРИТЬ с выдачей отчета. Корректный документ можно СКАЧАТЬ. Также доступен ПРЕДПРОСМОТР.
После завершения проекта его можно ЗАВЕРШИТЬ (всегда можно вернуть его в работу) и ВЫГРУЗИТЬ результат для загрузки уже в экспертизу.
Ну а если у вас остались вопросы (точнее что-то не заработало), то ответы должны быть в 112-м страничном руководстве пользователя. Кто я такой, чтобы лишать такого увлекательного чтения. Тем более там присутствует строгое предупреждение: «Перед работой пользователя с Сервисом рекомендуется внимательно ознакомиться с настоящим руководством».
Вывод
Тут должен быть итоговый вывод, но его не будет.
Машиночитаемые файлы — это реальность, данная нам в ощущениях. Механизм их формирования на данный момент бесплатен. Он работает. А о реализации и возможности использовать его лично, судите сами.
Собственно, вот и все.
Если вдруг статья оказалась полезной, то Вы можете даже поблагодарить автора.
Источники, дополнительная информация
1. Утвержденные XML-схемы на сайте Минстроя России: https://minstroyrf.gov.ru/tim/xml-skhemy/
2. Дистрибутив СФПЗ (со временем ссылка может стать не рабочей): https://disk.yandex.ru/d/7Bdu4QcOg3nCFA
3. Программный комплекс проверки XML-документов: https://checkxml.platformaexpert.ru
4. Инструкция по работе с СФПЗ от Главгосэкспертизы: https://rutube.ru/video/ed0e6f75fb143fa124e8423541252b05/?r=emwd
5. Обсуждение нововведений на форуме DWG: https://forum.dwg.ru/showthread.php?t=166812
Ознакомиться с содержанием журнала.
Уважаемые коллеги, желаю хорошего дня. Подписывайтесь, чтобы иметь возможность обсудить со мной вашу задачу в комментариях. Буду рад лайку, альтернативному мнению или истории по теме статьи.
ПРЕДУПРЕЖДЕНИЕ №1: Оценки, суждения и предложения по рассматриваемым вопросам являются личным мнением автора.
ПРЕДУПРЕЖДЕНИЕ №2: Техническая информация, представленная на сайте, не является официальной и предоставлена только в целях ознакомления. Владелец сайта не несет никакой ответственности за риски, связанные с использованием информации, полученной из данного источника.
Все изображения, если не указано иное, либо выполнены автором, либо взяты из открытых источников.