Newer
Older
AI_Lab_SCRUME_Co / skills / ailab / om-documentation-review / references / ntd-source-kodeks-techexpert.md

Источник НТД: «Техэксперт»/«Кодекс» — доступ и сверка актуальности

Зачем: сверка ссылок в проектной документации требует не только текстов норм, но и статуса документа (действует / изменён / заменён / отменён) и действующей редакции. Тексты и статусы живут в ИСС «Техэксперт»/«Кодекс»; открытый фонд статусов и реестров требований не даёт.

Топология (чтобы не терять время на поиск)

  • docs.cntd.ru — открытый электронный фонд: чтение текстов документов, бесплатно.
  • cntd.ru — сайт вендора: продукты, контакты, заявки, техописания.
  • Интранет-контур заказчика (у нас ascrew.cntd.ru) — «ИС Техэксперт: Интранет», документы под /kodeks04/, вход по логину/паролю рабочего места. Веб-доступ закрыт: корень отдаёт только «Техэксперт-Клиент», модуль кАссист и Кодекс-сервер; внутренних API-путей нет (/api/*, /webservice/* → 404). Работа только через клиент + модуль кАссист.
  • Веб-версии новых продуктов (SMART Проектирование, Реестр требований) — отдельный контур (6 поколение), на интранет-сервере их обычно нет. Не искать их в интранете, запрашивать доступ отдельно.
  • Ошибки на странице входа «Не найден пользователь с такой комбинацией логина и пароля» и «Исчерпан лимит лицензий для пользователей группы» — это лицензирование и группы на стороне вендора, а не пароль. Обращение к сервисному специалисту, а не повторный вход.

Что реально автоматизирует сверку

Инструмент Что делает Как поставляется
кАссист (kAssist) Проверка проектной, рабочей, конструкторской, технологической и внутренней документации: выявляет отменённые/заменённые НД, расставляет и проверяет гиперссылки, пакетный режим по документам и каталогам, формирует отчёт Модуль, встраивается в MS Office, LibreOffice, Adobe Acrobat Pro; интеграции с AutoCAD, Kompas-3D, ЛОЦМАН PLM
Kodeks API Программный интерфейс для сторонних систем, «инструмент самостоятельной разработки» По договору, документация публично не публикуется
«Реестр требований: Строительство» (входит в SMART: Проектирование) База экспертно выделенных требований (связь с классификаторами КСИ, приказ Минстроя № 928, ПП № 1417), чек-листы, аудит проекта, сохранение перечня требований в файл Отдельная подписка
СУ НТД Внутренний фонд (СТО, ТУ, локальные акты), контроль актуальности ссылочных документов Отдельное решение/внедрение

Поддерживаемые приложения кАссист (методический материал 3.11.8, Приложения 1–2)

Вендор присылает эти приложения по запросу. Список сразу сверять с софтом заказчика: версия вне списка = интеграции нет; для ARCHICAD и для самой настройки нужны права администратора.

Платформа Приложение Версии
Windows Microsoft Office 2003–2024
Windows LibreOffice 5.0 и выше (32/64)
Windows МойОфис «Текст»/«Таблицы», десктоп «Стандартная» 2022.01 (в «Стандартная. Домашняя» интеграции нет)
Windows Adobe Acrobat Pro 9, 10, 11, DC (2015–2021), 2017, 2020
Windows AutoCAD, Mechanical, Architecture, Electrical, Utility Design, MEP, Plant 3D, Civil 3D 2007–2024 (32/64)
Windows Inventor 2018–2021
Windows Revit 2018–2024
Windows nanoCAD, PLUS, СПДС, Конструкции, ВК, ОПС, СКС, Отопление, Электро, Геоника, Механика, СПДС Железобетон, СПДС Стройплощадка по продуктам, от 4.0 до 24.1
Windows Компас-3D 13–23
Windows Siemens NX 8.0, 8.5, 9–12, 1847–1980
Windows T-FLEX CAD 14–17
Windows SOLIDWORKS 3D CAD 2013–2018, 2020
Windows ARCHICAD 25
Windows PDM STEP Suite 5.641 и выше
Linux (Astra, ALT, RED OS, Ubuntu) LibreOffice Writer/Calc 5.1 и выше (64)
Linux (Astra, ALT, RED OS, Ubuntu) Р7-Офис 2024.1.2.401 и выше (только редактор текста, таблиц нет)

кАссист: подтверждённые факты о режимах и форматах

Источник — руководства пользователя кАссист 3.10 и 4.0.2, выложенные в открытом доступе дилерами вендора (дилерские сайты ищутся по запросу «руководство пользователя кАссист pdf»). Проверять факты под свою установленную версию, но рассчитывать на них можно.

Что Факт
Форматы в безинтерфейсном пакетном режиме doc, docx, rtf, xls, xlsx, pdf — офисное приложение при этом не запускается
DWG только интерактивно, через панель в AutoCAD (текстовое поле, ячейка таблицы); в безинтерфейсный пакетный список DWG не входит
Сканы PDF «В отсканированных, а также отсканированных и распознанных документах работа кАссист невозможна» — только PDF, подготовленные редактором PDF
Отчёт RTF, сохраняется вручную или по заданному пути; машиночитаемого формата (XML/JSON/CSV) нет
Расписание есть внутри кАссист: вкладка «Пакетная обработка» → дата, время, периодичность (ежедневно / через интервал), опции сохранения файлов и отчётов
Вызов извне командной строки, службы и API по каталогу в руководстве нет — внешний запуск не подтверждён
Логика пакетного прохода одна подходящая ссылка — ставится автоматически; ничего не найдено или найдено несколько — файл уходит в список «требует внимания» и дорабатывается человеком
«Бессылочные» фрагменты Inventor, Компас-3D (спецификация), Revit, SOLIDWORKS — часть объектов; в nanoCAD таблицы и таблица DWG

Куда девается работа агента. Извлечение текста, OCR сканов, разбор DWG — делает агент своими средствами; кАссист этого не умеет (сканы для него закрыты прямо). Что агент не может сам — статус и действующую редакцию НД. Это и есть настоящий незакрытый вопрос сверки.

Чек-лист запроса вендору

  1. Документация Kodeks API: руководство программиста, спецификация методов, форматы обмена, точка входа, авторизация (логин/пароль, ключ, сертификат, привязка к IP).
  2. Перечень методов: поиск документа, карточка и атрибуты, редакции и статус, ссылочные документы, изменения.
  3. Позиции прайса: API, кАссист, Реестр требований, СУ НТД — что входит в действующий договор, что оформляется допсоглашением.
  4. кАссист: запускается ли пакетная проверка без ручного открытия файлов (CLI, сервис, планировщик, API по каталогу) — по руководству ответ «нет, только окно модуля и его внутреннее расписание», нужно подтверждение для последней версии. Отдельно: подтвердить список форматов и формат отчёта (по руководству — doc/docx/rtf/xls/xlsx/pdf и RTF).
  5. Экспорт перечней требований из «Реестра требований» и машинный API к нему (XML/JSON/XLSX/CSV).
  6. Тестовый стенд или тестовая лицензия API на период отладки.
  7. Сервисная (робот) учётная запись и правила её лицензирования — не только рабочее место пользователя.
  8. Регламент сопровождения API и совместимость версий при обновлении системы.
  9. Контакт технического специалиста по интеграциям.

Контакты: служба поддержки 8-800-505-78-25 (8:00–18:00 МСК), spp@kodeks.ru / spp@cntd.ru. Демо-доступ 7 дней оформляется по ИНН компании.

Питфоллы

  • Вендор отвечает «раскройте запрос» и «дать всё не можем». В этом случае не пухнуть запрос, а срезать его до 5 пунктов, где каждый ответ — «да/нет»: программный доступ (адрес, авторизация, методы карточки документа, служебная учётка), внешний запуск кАссист и формат отчёта, лицензии и цена под эти два пункта, форматы документов и поведение на сканах, тестовый стенд + контакт техспециалиста. В письме писать прямо: «если пункт не закрывается — сообщите, скорректируем задачу». Остальное срезать самим.
  • Не ждать вендора там, где ответ лежит в открытом доступе. Режимы, форматы и отчёты кАссист описаны в руководстве пользователя у дилеров; топология, факты и ограничения берутся из живых проверок. Прежде чем просить у вендора справку по возможностям — поискать её самому, а у вендора просить только то, что закрыто договором (API, лицензии, служебная учётка, тестовый стенд).
  • Вендорский .docx разбирать как OOXML, а не глазами. read_file по .docx склеивает ячейки таблиц и теряет строки — для таблиц версий и режимов распаковывать пакет (unzip + разбор word/document.xml по <w:tr>/<w:tc> с учётом gridSpan/vMerge), иначе перечень приложений и версий читается неверно.
  • Не обещать автоматическую сверку, пока нет подтверждённого программного доступа. Сначала проверить фактические точки входа (страницы, эндпоинты) и только потом говорить, что возможно.
  • Браузерная сессия агента изолирована от браузера пользователя — авторизация пользователя туда не переносится. Пароли и коды не вводить и не запрашивать; доступ оформляется как отдельная учётная запись (лучше сервисная), проверяется живым вызовом, а не «должно работать».
  • Актуальность норм и текст проекта — разные проверки. Корректно спроектированный узел со ссылкой на отменённый НД всё равно уходит в замечания.
  • Ссылок на пункты вендорских продуктов не выдумывать: вендор публикует состав функций, но не публичные номера методов API — без полученной документации ссылаться не на что.
  • Перечень приложений ≠ перечень форматов. Присланный вендором список «форматов» оказался приложениями и версиями, куда встраивается панель кАссист. Он не отвечает ни на вопрос о форматах файлов документации, которые модуль разбирает (включая сканы PDF), ни о формате отчёта, ни о запуске без GUI. Не выдавать его за подтверждение автоматизации — говорить прямо, что прислали не то, и добивать теми же вопросами.
  • Список поддерживаемых приложений описывает интерактивный режим. Пока вендор не подтвердил CLI/сервис/API по каталогу, пакетная ночная проверка не подтверждена, сколько бы приложений ни было в списке.
  • Запрашивать полный методический материал, а не только приложения. В нём режимы работы, форматы, отчёты и способ вызова; по Приложениям 1–2 судить о возможностях нельзя.
  • Сверять версии софта заказчика с таблицей. AutoCAD/Revit/nanoCAD новее списка, ARCHICAD не 25, Inventor после 2021 — интеграции нет; это конкретное замечание до покупки, а не «уточнить у вендора».