This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Агент для ПТО в строительстве: сверяет КС-2 с журналом и сметой, распознаёт выпуск исполнительной документации со сканов и фотографий, переводит каждый спор с актом в рубли и подключается к Claude Desktop / Cursor / VS Code по Model Context Protocol.
Главный принцип: ни одна цифра не выдумывается. У каждой суммы есть формула и источник, где данных нет — «не оценено» с причиной, а не ноль; чертёж не меняется без подтверждения человека; каждый вызов инструмента пишется в журнал с хэш-цепочкой.
Что умеет | Результат на демо-объекте |
Сверка КС-2, объёмов, комплектности ИД | 7 расхождений из 7 заложенных, 0 лишних |
Выпуск ИД целиком (30–50 листов) | 40 листов, 205 пометок, 43 конфликта с актом |
Фото с телефона → чертёж | гомография по 4 точкам, rms 0,0 мм, 5/5 пометок |
Деньги по выпуску | 1 850 000 ₽ под риском = 5,42 % акта, каждый рубль с формулой |
Портфель актов объекта | 3 акта, покрытие 100 %, 2 091 000 ₽ под риском (5,43 %) |
Исполнительная документация | схема из DXF + черновик АОСР по форме № 344/пр + реестр на 5 документов; 9 проверок черновика, матрица 17 видов работ |
Смета 1166/Н (АРОС, 47 позиций) | читается напрямую: 33 работы + 14 материалов, 5 отдельных актов по скрытым работам, 0 лишних протоколов в акте на борозды, ПУЭ 1.8.37/1.8.39 — |
Закупка материалов | заявка из сметы 1166/Н → 11 позиций; 3 КП в сравнении, 1 отклонено (нет срока действия цены), 34 900,32 ₽ и 13 079,76 ₽ экономии; выбор человека в журнале аудита |
Цены ФГИС ЦС | 2 версии выгрузки, цена на дату: 410 ₽ на 01.10 против 459 ₽ на 01.12 — без подстановки свежего прайса |
Аудит-лог | снимок «до/после», дельта, автор, причина, основание; хэш-цепочка, подмена видна |
Материалы | заявка → приход → КС-2: заморожено 1 645,92 ₽, риск 15 134,40 ₽, возврат переплаты 840 ₽ — по позициям, с формулами |
Стык takeoff КР | выгрузка объёмов (формат autoconst, MIT) → ведомость: 2 503 660 ₽ по строкам с ценой, из них 1 763 900 ₽ высокой уверенности; LOW и RATE_NOT_FOUND — в «не включено» |
Том КР из PDF | школа на 825 мест (Сертолово, 49 стр.): 14 параметров с цитатами, ведомостей в томе нет, плита 5 259,2 м3 расчётом по габаритам, арматура — «нет ведомости расхода стали», а не «примерно» |
MCP | 36 инструментов, stdio + http; http — только с Bearer-токеном ( |
git clone https://github.com/akoffice933-maker/pto-agent.git && cd pto-agent
pip install -r requirements-pto.txt
# 1. демо-данные и чертежи
python3 scripts/make_demo_data.py && python3 scripts/make_demo_dxf.py
python3 scripts/make_demo_redline.py && python3 scripts/make_demo_batch.py
# 2. сверка КС-2 и объёмов
python3 -m pto_agent run --data data/demo --out out
# 3. выпуск исполнительной документации со сканов
python3 -m pto_agent cad scan-batch --manifest data/demo/batch/manifest.json \
--engine vlm --summary out/summary.json --out out/cad/batch
# 4. деньги: сколько стоит спор с актом
python3 -m pto_agent cad impact --batch out/cad/batch/batch_summary.json \
--summary out/summary.json --out out/cad/impact --with-background
# 5. страница руководителя
python3 docs/build_dashboard.py && open Дашборд_руководителя_ПТО.html
# 6. тесты
python3 -m pytest tests -qRelated MCP server: AutoCAD MCP Server - Codex Edition
python3 scripts/install_mcp.py --client claude --write # Claude Desktop
python3 scripts/install_mcp.py --client cursor --write # Cursor
python3 scripts/install_mcp.py --client vscode --write # VS Code
python3 -m pto_agent.mcp_server --transport http --port 8765 # http + инспектор
docker build -t pto-agent-mcp:0.6 . && docker run -p 8765:8765 pto-agent-mcp:0.636 инструментов: чтение DXF и takeoff, распознавание сканов и план правок, применение
операций только с confirm{by, role, comment}, пакетная обработка выпуска, деньги по акту
и по портфелю актов, итог проверки одним ответом (review_summary) и выпуск исполнительной
документации (asbuilt_docs: схема, АОСР, реестр ИД, комплектность), цены с версиями и датой
(prices), закупка материалов с обоснованием выбора (procurement) и журнал аудита
(audit_trail), сверка материалов с приходом и актом (materials_reconcile), стык объёмов из чертежей с ценами (takeoff), черновик ТК/ППР со сверкой норм
(tk_draft) и реестр карт объекта «объект → ТК → статус → кто проверил» (tk_registry), накопительная
ведомость по актам (cumulative_ledger), акт на дополнительные работы с основанием
(atn_draft) и расход материалов — потребность по нормам, списание, лимит, давальческие
(consumption_report), чек-листы выполненных работ с источником пункта и подписью
(checklist), два журнала комплекта ИД — общий журнал работ и журнал верификации закупленной
продукции (journals), реестр документов качества на материалы с привязкой к партиям
(quality_docs), движение документации — выдача РД «В производство работ» и согласование ИД
(docflow) и переписка с внешними участниками — письма, лаборатории, геодезисты, авторские дни
(correspondence), и комплект объекта целиком — одна команда pack build --config, одна папка out/pack, один вердикт «можно ли предъявлять» (object_pack) и портфель комплектов с деньгами — где можно предъявлять, где нет и сколько денег держит непредъявление, с разбивкой «подписи / ошибки / данные» (pack_portfolio) и график финансирования — что попадёт в платёж, что переносится и сколько стоит перенос по ставке из договора (funding_plan) и месячный план — обратный ход от платежа к работам: какие работы дают платёж, какой документ нужен по матрице и чего не хватает (monthly_plan). Подробно — docs/10_MCP_обвязка.md.
https://github.com/akoffice933-maker/pto-agent — публичный, MIT.
git clone https://github.com/akoffice933-maker/pto-agent.gitЧто настроено: .gitignore (артефакты прогонов и тяжёлые демо-сканы в git не едут —
генерируются скриптами), LICENSE (MIT), CI на GitHub Actions: unit на Python 3.11/3.12 →
e2e со сквозным прогоном (выпуск → деньги → дашборд) → сборка Docker-образа.
Чтобы запушить в свой форк: ./scripts/publish_github.sh git@github.com:ВАШ_АККАУНТ/pto-agent.git.
Дата: 02.11.2026 · Версия пакета: 1.2
Решение: проект делаем сами, готовые open-source проекты используем как подспорье (с фиксацией лицензий). Прототип собран и прогнан на демо-наборе: 7 расхождений из 7 заложенных найдено, 17 тестов зелёные.
pip install -r requirements-pto.txt
python3 scripts/make_demo_data.py # демо-смета, журнал, ранее закрытые акты, нормативы
python3 -m pto_agent run --data data/demo --out out
python3 -m pto_agent approve --out out --by "Иванов И.И." --decision returned_for_revision --comment "…"
python3 -m pto_agent takeoff --out out/kr1 schedules --schedules data/input/kr1_schedules.json
python3 -m pto_agent tk --out out/tk draft --work-type concrete --object-name "Школа"
python3 -m pto_agent tk --out out/tk registry # реестр: объект → ТК → статус → кто проверил
python3 -m pto_agent cumulative --acts data/demo/acts/acts.json --out out/cumulative
python3 -m pto_agent consumption --works data/demo/consumption/works.json --norms data/demo/consumption/norms.json --out out/consumption
python3 -m pto_agent checklist --out out/checklists build --work-type earthworks --object-name "Школа"
python3 -m pto_agent journal --out out/journals work --entries data/demo/journals/work_entries.json --number ОЖР-1
python3 -m pto_agent journal --out out/journals verification --records data/demo/journals/verification.json --writeoffs data/demo/consumption/writeoffs.csv
python3 -m pto_agent quality --out out/quality build --documents data/demo/quality_docs/documents.json --requirements data/demo/quality_docs/requirements.json --usage data/demo/quality_docs/usage.json --number ДК-1
python3 -m pto_agent docflow --out out/docflow rd --transmittals data/demo/docflow/transmittals.json --revisions data/demo/docflow/revisions.json --works data/demo/docflow/works_rd.json --number РД-1
python3 -m pto_agent correspondence --out out/corr letters --source data/demo/correspondence/letters.json --number ПИС-1
python3 -m pto_agent audit-verify --path out/audit.jsonl
python3 scripts/check_expected.py # 7 из 7 заложенных расхождений, без лишних
python3 -m pytest tests -qФайл | Что внутри |
| Круг 16 — обратный ход от платежа к работам: |
| Круг 15 — деньги месяца, а не только риск: |
| Круг 14 — сводка по портфелю вместо чтения восьми отчётов: |
| Круг 13 — не новые обязанности, а сквозной прогон комплекта по одному объекту: одна команда |
| Последний круг очереди — 5 обязанностей: выдача РД (работать можно только по редакции со штампом «В производство работ», передача без подписи получившего не подтверждена, выдача заменённой редакции и ссылка на невыданную РД — ошибки), согласование ИД (подпись при открытых замечаниях недействительна, повторная передача без устранения — та же передача, просроченное замечание — ошибка), письма и запросы (без основания не предъявляется, без ФИО и роли не отправлено, просроченный ответ — ошибка), лаборатории и геодезисты (аттестат на дату работы, привязка результата), авторские дни и дни качества (участники, протокол, замечание со сроком и ответственным). CLI |
| Документы качества: документ проверяется по трём вопросам — тот ли материал (марка и фракция входят в наименование), та ли партия, действовал ли он на дату применения. Товарный чек документом качества не является, копия без отметки «копия верна» в комплект не идёт, состав требуемых документов берётся из файла требований (проект, договор, ТУ) и не выдумывается, материал, применённый без документа на свою партию, — ошибка, стык с журналом входного контроля в обе стороны, комплект передаётся только подписанным человеком с ФИО и ролью. CLI |
| Два журнала ИД: общий журнал работ — запись без даты, смены, описания или исполнителя в журнал не попадает (и это видно отдельным разделом), вид работ определяется матрицей, даты только по возрастанию, температура обязательна для земляных/бетонных/кровельных работ, объёмы сверяются с актом КС-2 построчно там, где в позициях есть наименования (деньги журнал не подтверждает); журнал верификации — «допущен» без документа качества невозможен, документ с истёкшим на дату проверки сроком не даёт допуска, без ФИО и роли проверяющего контроль не состоялся, материал, списанный без входного контроля, виден отдельно. Подпись только с ФИО и ролью и только при отсутствии ошибок, правка после подписи аннулирует подпись. CLI |
| Чек-листы выполненных работ: пункт без источника (документ + пункт + редакция) не создаётся, три результата без «ок»/«да», подпись только при ФИО и роли и только когда все пункты проверены, несоответствие без описания не подписывается, правка после подписи аннулирует подпись, |
| Материалы в цифрах: потребность = объём × норма, норма без документа/пункта/редакции не применяется, норма без подтверждения базой идёт «справочно» (пока её не примет человек с ФИО), перерасход сверх нормы без причины — ошибка, списание без нормы не сравнивается с нулём, лимит закупки = потребность, давальческий материал в собственных закупках — двойной счёт. Демо-набор |
| Деньги по допработам: накопительная ведомость по позициям (периоды, итог нарастающим, остаток к смете) с 9 проверками — сумма акта против суммы позиций, дубль акта, одна позиция в двух актах периода, м² и м³ под одним кодом, сторно, |
| Сверка 18 обязанностей ПТО с кодом: все 18 закрыты кодом, страж-тестами и сквозной проверкой в CI (круги 7–12 закрыли журналы и верификацию, документы качества, чек-листы, нормы и списание, АТН и ведомости, выдачу РД, согласование ИД, письма, лаборатории и геодезистов, дни качества). Что остаётся за человеком — подписи, согласования и решения |
| Реестр ТК объекта: |
| Прогон ТК по всем 17 видам работ матрицы: 196 заполненных пунктов, 89 запросов данных, нормы сверено 2 из 34, нарушений 0. Таблица по видам работ (комплект ИД от 4 до 15 документов) и список 21 документа, которые надо загрузить в нормативную базу, чтобы пометки «не проверено» исчезли. Скрипт |
| Черновик ТК и ППР своими силами: 8 разделов ТК и 10 разделов ППР; заполняется только то, что есть в матрице требований, нормативной базе и смете; состав операций, машины, ОТиПБ и трудозатраты — |
| Проверка обзора OSS по ТК/ППР/ИД: |
| Целостность цифр (пункт 4 аудита): |
| Сеть и недоверенные файлы (то, чего не покрывало ревью): SSRF в LLM ( |
| Ответ на внешнее ревью: 17 пунктов — 8 исправлено полностью, 2 частично, 5 в бэклоге с причиной; NameError в commit через MCP, синтаксис 3.12 в 3.11-поставке, открытый HTTP-MCP (теперь 127.0.0.1 + Bearer-токен + CORS без |
| Круг 9 — объёмы из ведомостей, а не из габаритов: 4 листа тома 7820/03-02-КР (спецификация на фундамент, котлован, ведомости расхода стали) — плита 2 871 м³ вместо оценки 5 259,2 м³ (+83 % завышения), арматура 376,4 т; арифметика ведомостей проверяется («Итого» плиты не сходится с суммой по диаметрам → |
| Прогон на реальном томе КР: 7820/03-02-КР1, школа на 825 мест — 49 стр., 42 с текстовым слоем, 7 только с графикой; ведомостей объёмов/расхода стали в томе нет (и это сказано прямо); 14 параметров с цитатой и страницей, плита 5 259,2 м3 — расчёт по габаритам (MEDIUM, «оценка сверху»), арматура — вопрос «нужна ведомость расхода стали» |
| Стык «PDF КР → объёмы → ведомость с ценами»: 6 takeoff-проектов проверены по GitHub API (код можно брать у одного — MIT), формат BOQ |
| Материалы: заявка → приход → КС-2: 10 классов расхождений с ценой вопроса и адресатом, отсутствие двойного счёта (недопоставка и «акт без накладной» делят объём), единицы вместо количеств при несовпадении, |
| Аудит-лог, закупка и версии цен: журнал со снимком «до/после», дельтой, автором и причиной (хэш-цепочка, подмена видна); заявка из сметы → сравнение КП с приведением к цене с НДС → решение человека; непригодное КП (нет срока действия цены) — в |
| Поиск готовых OSS-проектов под слои 2–9: 43 проекта в 9 слоях, лицензии сверены через GitHub API (звёзды, дата, |
| Прогон на реальной смете АРОС: чтение выгрузки АРОС напрямую (47 позиций), работы отделены от материалов ФГИС ЦС (33/14), 5 отдельных актов по скрытым работам, протоколы и комплект документов — по группе акта (акт на борозды без протоколов испытаний), ПУЭ-7 пп. 1.8.37/1.8.39 в базе фрагментом → |
| Ответ на прогон на смете 1166/Н: классификатор v2 (сильные/слабые ключи, квалификаторы, доля вида работ в документе) — 46 из 47 позиций вместо 23; отдельный АОСР на каждую группу скрытых работ (7 актов, демонтаж и вывоз мусора вне актов); проверка норм по нормативной базе (verified / clause_missing / doc_missing) и |
| Исполнительная документация — выпуск, а не только проверка: исполнительная схема из DXF (DOCX + PNG, ведомость объёмов, привязка к акту), АОСР по РД-11-02-2006, реестр ИД (XLSX) и проверка комплектности; 14 проверенных GitHub-проектов с лицензиями (ezdxf, pyHanko, IfcOpenShell, LibreDWG, OpenConstructionERP) — что берём, что только идеи |
| Итог проверки одним ответом: что проверено ( |
| 1С/БИТ.Строительство vs pto-agent: матрица из 26 задач инженера ПТО (кто закрывает), где мы честно слабее, три уровня стыковки (файловый обмен → HTTP-сервис 1С → программный робот), реализованный контракт обмена CSV |
| Смежные проекты: 10 открытых сметных/обмерных проектов с проверенными звёздами и лицензиями, матрица «код можно / нельзя» (AGPL и «без лицензии» — только идеи), три сценария стыковки (внешний MCP-обмер, база ГЭСН/ФЕР, паттерны multi-agent), чего сознательно не делаем, дорожная карта |
| MCP одной командой: установщик конфигов для Claude Desktop / Cursor / VS Code, HTTP-транспорт и Docker, настройки из окружения, 15 тестов протокола, правила безопасности |
| Деньги под риском по объекту: реестр актов, покрытие проверкой 100 % после ретро-выпуска, разбивка по месяцам; непроверенный акт — «не оценено», а не «0 ₽» |
| Сколько стоит спор: конфликты пометок и расхождения ПТО → рубли по ценам сметы/КС-2; 1 850 000 ₽ под риском (5,42 % акта) на демо-выпуске, каждый рубль с формулой, «не оценено» вместо нуля |
| Фото с телефона и выпуск целиком: калибровка по 4 точкам (гомография), выпрямление и выравнивание света, контроль качества съёмки; пакетная обработка 40 листов за сеанс со сводкой в XLSX/Markdown (конфликты, вопросы человеку, позиции) |
| Распознавание сканов готово: скан листа с рукописными пометками → локальная VL-модель по API (или офлайн-CV без модели) → типизированные операции; анти-галлюцинационная проверка каждого bbox по чернилам, конфликты «согласовано»/объём против КС-2 уходят человеку, деньги по позициям, 14 MCP-инструментов (на тот круг) |
| CAD-модуль готов: headless DXF на ezdxf, корпоративный шаблон (слои/блоки/шрифты/рамка/штамп), белый список из 7 операций, dry_run/commit с подтверждением человека, сверка объёмов схемы с КС-2 (±5 %), MCP-сервер на 14 инструментов (stdio + http) |
| Отчёт о сборке MVP: архитектура, результаты прогона, что переиспользовано из OSS и с какой лицензией, соответствие требованиям ТЗ, ограничения, дорожная карта этапа 2 |
| Точка входа MCP-сервера ( |
| Готовые конфиги клиентов (Claude Desktop, Cursor, VS Code, http) и установщик: подставляет пути, не затирает чужие серверы, делает бэкап |
| HTTP-транспорт MCP в контейнере: |
| Пакет и точки входа: |
| 15 тестов протокола: рукопожатие, список инструментов, ошибки JSON-RPC, чистота stdout, схемы, http, установщик |
| Обмен с 1С по HTTP (уровень 2): акты и смета из HTTP-сервиса 1С, отправка проверенной КС-2 с |
| Конфиг HTTP-обмена: адрес сервиса, учётные данные из |
| 21 тест: фейковый HTTP-сервис 1С, аутентификация, 401/400/500, повторы, не-JSON, обе формы актов, идемпотентность, CLI |
| Исполнительная документация: |
| Журнал аудита: JSONL с хэш-цепочкой, |
| Закупка: |
| Том КР из PDF: |
| Черновик ТК (8 разделов) и ППР (10 разделов): нормативные ссылки со сверкой по базе (цитата либо явное «не проверено»), комплект ИД из матрицы, всё остальное — запрос человеку с адресатом; DOCX с местом для подписи, подтверждение с ФИО и ролью |
| Реестр ТК объекта: читает готовые черновики, группирует по объектам, ставит статус ( |
| Накопительная ведомость: строки по коду и единице, количество и сумма по периодам, итог нарастающим, остаток к смете; 9 проверок ( |
| АТН на дополнительные работы: позиция проходит только с основанием (вид + ссылка) и ценой; |
| Движение документации: реестр выдачи РД (редакции, штамп «В производство работ», подпись получившего, состояние документа, ссылки работ на РД) и реестр согласования ИД (комплект → замечания со сроками → устранение → повторная передача → подпись; подпись при открытых замечаниях и без ФИО/роли недействительна), подпись реестра человеком, JSON/Markdown/XLSX |
| Переписка и участники: письма и запросы (основание, адресат, подписавший, срок ответа, ожидание ответа), лаборатории и геодезисты (аттестат, область, срок действия на дату работы, привязка результата), авторские дни и дни качества (участники, протокол, замечания со сроком и ответственным), подпись реестра человеком |
| Документы качества: реестр документов с привязкой к применённым партиям (материал, марка, фракция), проверка срока действия на дату применения (а не на сегодня), рабочий перечень типов документов, основание соответствия, файл и отметка «копия верна», состав требуемых документов из файла требований, стык с журналом входного контроля, |
| Журналы: общий журнал работ (полнота записи, классификация вида работ по матрице, хронология, погода для чувствительных работ, дубли, |
| Чек-лист выполненных работ: пункты из файла организации или из матрицы/норм (только со ссылкой на документ и пункт), результаты «соответствует / не соответствует / не проверено», подпись с ФИО и ролью только на полностью проверенный чек-лист, |
| Расход материалов: нормы расхода с источником и сверкой по базе, потребность = объём × норма, списание против нормы (перерасход без причины — ошибка), лимит закупки против факта, давальческие (получено/израсходовано/возвращено/остаток, двойной счёт); |
| Отпечаток содержания документа и |
| Разбор чисел из внешних документов: |
| Сетевые предохранители: схема только http/https, запрет метаданных облака, https для внешних хостов, редирект только внутри хоста, предел размера ответа, очистка текста ошибок от адресов и учётных данных, |
| Ведомости расхода стали и спецификации: |
| Стык объёмов и цен: |
| Сверка материалов: |
| Цены версиями: импорт выгрузки (xlsx/csv) со снимком и digest, |
| Реестр 14 GitHub-проектов для ИД и схем: лицензия, звёзды, что берём и чего не берём; проверяется |
| Матрица комплектности и классификатор (профиль |
| Чтение сметы АРОС (html/markdown-выгрузка): разделы, позиции с ГЭСН/ФЕР/ФССЦпг, объёмы с формулой, отдельно работы и материалы ФГИС ЦС |
| Ведомости листов 2, 4–6 тома 7820/03-02-КР (перенесены с фото автора, |
| Версия цен от 15.09.2025 (10 ресурсов: В25 W6 F150 отдельно от базового В25) и 10 правил «позиция ведомости → код ресурса» |
| Результат прогона по ведомостям: |
| Результат прогона реального тома КР: |
| Реестр takeoff-проектов: 6 репозиториев, звёзды и лицензии с GitHub API, код можно брать у одного |
| Реестр ТК/ППР/ИД: 6 проектов с проверкой по дереву файлов и лицензии; выписка |
| Реестр OSS под расширение в платформу: 43 проекта, 9 слоёв (сметы, закупки, подрядчики, финансы, график, CRM, поле, 1С, сквозные), лицензия, что берём и чего не берём, |
| Проверка реестра: структура, покрытие слоёв, лицензионная политика (exit 2 при попытке взять код из GPL/AGPL), сверка с GitHub |
| Рабочая нормативная база (ПУЭ-7 гл. 1.8 пп. 1.8.37/1.8.39 — фрагментом) + инструкция, как добавить документ |
| Отдельный акт на скрытые работы: смета режется по группам (борозды, проходки, трассы, щиты, освещение, заземление, испытания); демонтаж и вывоз мусора в акты не попадают и перечислены в |
| Сверка норм с базой |
| Демо-смета на 47 позиций по описанию прогона 1166/Н: автоматы, УЗО, провод в гофре, кабель, штробление, проходки, кронштейны под вентиляцию, демонтаж, вывоз мусора |
| Демо-спецификации: реестр ИД (5 документов, 56 листов) и АОСР № 114 на фундаментную плиту |
| 20 тестов: лист и ведомость в схеме, |
| 31 тест правил: форма № 344/пр против legacy, wording черновика, матрица по видам работ и электромонтаж, хронология дат, нормы без пунктов, НРС, спецификация из сметы, CLI и MCP |
| 26 тестов аудита, закупки и цен: цена на дату не берёт свежую выгрузку, КП без реквизитов в сравнение не идёт, приведение к НДС меняет победителя, решение человека ложится в журнал с причиной, подмена записи ломает хэш-цепочку, CLI и MCP |
| 25 тестов: чтение накладных и акта, все классы расхождений, отсутствие двойного счёта, |
| 26 тестов стыка: чтение BOQ, кг → т, сопоставление по правилам, гейт уверенности, «нет цены» вместо нуля, цена на дату, подтверждение с аудитом, CLI, MCP, реестр OSS |
| 18 тестов тома КР: отсутствие ведомостей как факт, факты с цитатами, опечатка «подала» не мешает прочитать 250 мм, габариты → объём плиты, число перекрытий из листов, высота подвала не угадывается, арматура — вопрос, а не ноль, CLI на реальном файле |
| 8 тестов: прогон ТК по всем видам работ без нарушений, у каждого вида есть запросы данных и раздел ИД, у демонтажа явно написано «матрица не требует документов» + подтверждение, все несверенные нормы с причиной, в документе есть список того, что грузить в базу |
| 20 тестов: норма с цитатой / без документа / без пункта, никаких выдуманных разделов (пустой раздел обязан быть запросом), статус «черновик» и запрет слов «готова к применению», подтверждение без ФИО не принимается, запись в аудит, ППР по смете, DOCX с таблицей сверки норм, CLI end-to-end |
| 21 тест: штамп «В производство работ» обязателен, подпись получившего, заменённая и неизвестная редакция, ссылки работ на РД, дубли, подпись при открытых замечаниях, анонимная подпись, просрочка и повторная передача, CLI и MCP |
| 20 тестов: письмо без адресата/основания/подписи, сроки ответа, ответ без номера, аттестат и область аккредитации с проверкой на дату работы, привязка результата, заявка без результата, мероприятие без участников и протокола, замечания без ответственного и срока, CLI и MCP |
| 25 тестов документов качества: документ без реквизитов не принимается, товарный чек — не документ качества, документ на другую партию не закрывает применённую, фракция — часть наименования, срок сверяется с датой применения, копия без заверения, требования берутся из файла, стык с входным контролем, подпись без ФИО и при ошибках, правка после подписи, CLI и MCP через stdio |
| 28 тестов журналов: неполная запись не проходит, вид работ определяется, дата назад — ошибка, погода только там, где объясняет материал, дубль и |
| 23 теста чек-листов: пункт без источника не создаётся, источник из матрицы — это ссылка на пункт, «ок» вместо «соответствует» не принимается, подпись без ФИО, подпись при непроверенных пунктах, несоответствие без описания, приёмка работ при несоответствиях, правка после подписи, DOCX и CLI, MCP через stdio |
| 29 тестов расхода материалов: норма без источника не применяется, «справочно» против подтверждённого, коэффициент потерь только из нормы, перерасход с причиной и без, списание без нормы, лимит против факта, отсутствие цены не как 0 ₽, давальческие остаток/отрицательный остаток/двойной счёт, чтение колонок «причина»/«получено», CLI и MCP |
| 28 тестов ведомости и АТН: сумма акта ≠ сумма позиций, акт без позиций, дубль акта, двойное предъявление позиции, м² против м³, |
| 18 тестов реестра: две карты в одном каталоге не затирают друг друга, свежий черновик — «не проверен», проверка без ФИО не считается, правка после проверки аннулирует подпись, группировка по объектам, в отчёте нет «готова к применению», копия файла не удваивает карты, удалённый файл виден |
| 12 тестов: лицензионная политика реестра ТК/ППР (три проекта без лицензии — только идеи), обязательность |
| 35 тестов: |
| 34 теста: SSRF и метаданные облака, |
| 43 теста по пунктам ревью: commit через MCP без NameError, парсинг всей поставки как Python 3.11, HTTP без токена → 401, отказ слушать сеть без токена, песочница путей, машинная идентичность в подтверждении, 120 записей аудита из 8 потоков, усечение хвоста через якорь, открытые работы вне актов, 16 примеров классификатора |
| 25 тестов ведомостей: расхождение суммы с «Итого» как находка с обоими числами, марка В10 не конфликтует с В25, правдоподобие подано как эвристика, а не норматив, бетон из спецификации и ведомости не удваивается, этажи 2–3 и перекрытия — |
| 11 тестов: покрытие слоёв 2–9, лицензионная политика (AGPL/GPL/Sustainable Use — только идеи), проект без лицензии, CLI |
| 21 тест: разбор выгрузки АРОС (шапка таблицы, colspan, формулы объёма), материалы против работ, материалы по актам, протоколы по группе, |
| 25 тестов: сильные ключи и квалификаторы, «ФЕРм» ≠ «ферма», «кладк» ≠ «прокладка», 46 из 47 позиций на смете 1166/Н, 7 актов по скрытым работам, демонтаж вне актов, три исхода проверки норм, cite_verify |
| Сводка проверки: собирает пять артефактов в один ответ — что проверено, что осталось, где нужен человек, деньги, вердикт; пропуск ≠ «ок», «не оценено» ≠ 0 ₽ |
| 18 тестов: вердикты |
| Обмен с 1С/БИТ.Строительство: выгрузка проверенной КС-2 и реестра актов в CSV ( |
| 12 тестов обмена: формат для 1С, режимы объёма (claim/journal/estimate), импорт сметы и актов, кодировки и разделители, круг «экспорт → импорт» без потери сумм |
| Внешний обмер по MCP: клиент (stdio/http, SSE), нормализация чужой схемы к нашей, сверка «чужой обмер ↔ наш DXF/смета», правило «не оценено ≠ 0», лицензионный режим «отдельный сервис» для AGPL |
| Конфиг внешнего обмера: транспорт, команда/url, инструмент, лицензия; готовый self-check на нашем же MCP-сервере |
| 22 теста: фейковые stdio- и http-серверы, SSE, ошибки JSON-RPC и |
| CAD-модуль: |
| Корпоративный шаблон |
| Демо-чертёж A1 с заложенными дефектами оформления и машиночитаемыми объёмами; генератор + PNG-предпросмотр |
| План операций, журналы версий и аудита, выпущенная схема (DXF+PNG+манифест), предпросмотр «лист + фрагмент» |
| Распознавание сканов: |
| Демо-скан A1 с 5 рукописными пометками, эталон разметки и тексты, введённые инженером |
| Генератор демо-скана: шум, поворот, поля бумаги — и эталонных пометок |
| Фото с телефона: гомография по 4 точкам, выпрямление листа, выравнивание света, контроль качества снимка |
| Портфель актов: покрытие проверкой, свод по актам и месяцам, сверка акта со сметой, отчёты |
| Ретро-выпуск по прошлым актам: сканы + эталон пометок + сводка ПТО периода акта (сверка с количествами того акта, а не с текущим журналом) |
| Сканы, эталон и манифесты ретро-выпуска: 15 листов по актам КС-2 №35 и №37 |
| Реестр актов объекта (КС-2 №35, №37, №38): суммы, статус проверки, ссылка на прогон выпуска; собирается |
| Стоимость споров: правила перевода расхождений в рубли, дедупликация по позиции, отчёты XLSX/Markdown и диаграмма «где деньги» |
| Пакетная обработка выпуска: манифест, кеш по хэшу скана, изоляция ошибок листа, сводка XLSX/Markdown/JSON |
| Демо-фото «с телефона» 2600×1950, 4 опорные точки и эталон пометок |
| Демо-выпуск: 4 чертежа комплекта, 40 сканов, эталоны, тексты и |
| Генераторы демо-фото и демо-выпуска (общий рендер и рисование пометок) |
| 24 теста: гомография, отказы на плохих точках, равенство «фото = скан», качество съёмки, пакет, кеш, сводка, отчёты |
| 24 теста распознавания: схема ответа, калибровка, mock-сервер, анти-галлюцинация, тексты инженера, конфликты с ПТО, MCP |
| 24 теста CAD: DWG-отказ, проверка шаблона, белый список, HITL, diff, takeoff, MCP (включая stdio-процесс) |
| Пакет: |
| Генератор и сам демо-набор + |
| Сверка прогона с эталоном |
| 17 тестов: полнота выявления, дубли, единицы, арифметика, цитаты, применимость редакций, хэш-цепочка, маршрутизация моделей, экспорт КС-2 |
| Результаты прогона: |
| SBOM: компонент, версия, лицензия, тип использования, в поставке да/нет |
| Смежные проекты: репозиторий, лицензия, звёзды, «что берём / что не берём», тип интеграции; звёзды и лицензии сверяются с GitHub API |
| Проверка списка и лицензионной политики: |
| 10 тестов политики: AGPL и проекты без лицензии никогда не «можно копировать», у MIT-проектов описано, что берём, подмена флага ломает сборку |
| Зависимости с лицензиями; запрещённые (AGPL/GPL, без лицензии) отмечены явно |
Файл | Что внутри | Кому |
| Полное ТЗ: 17 разделов + приложения A–F. Готово к согласованию | ИТ, ПТО, закупки |
| То же в markdown — для правок в git/Confluence | команда |
| ТЗ на эталонную выборку: состав 360 единиц, схемы разметки, метрики с порогами, регламент регрессии, критерии приёмки | ПТО + методолог |
| Видео-презентация продукта, 3:36, 1080p, с озвучкой. 10 слайдов: проблема → 4 сценария MVP → как работает → прозрачность и остатки → исполнительные схемы → безопасность → ИИ по API → план и бюджет → что нужно для старта | руководство, инвесторы |
| 14 слайдов для защиты бюджета: проблема → scope → архитектура → CAD → безопасность → рынок/OSS → план → бюджет → метрики → риски → ask | руководство |
| Экран руководителя. Стадии проекта (план/факт), остаточные объёмы по работам, деньги по договору и деньги под риском (сколько стоит каждый спор с актом — из сводки выпуска), стоимость и качество ИИ, журнал действий, список решений. Каждая цифра — с адресом источника. Открывается в браузере, без внешних зависимостей | руководство, ПТО |
| Шорт-лист исполнителей: 15 команд по GitHub-следу (проверка 02.11.2026), скоринг по 8 критериям, 4 модели контракта, рекомендуемая гибридная конфигурация, красные флаги | закупки, ИТ |
| Скоринг-матрица с формулами (веса редактируются), 25 вопросов RFP с «хорошими» и «плохими» ответами, чек-лист проверки GitHub-профиля с API-командами | закупки, ИТ |
| MVP собран своими силами: архитектура прототипа, 7 найденных расхождений, SBOM и лицензии, соответствие AC-TR/AC-LLM, ограничения, план этапа 2 | ИТ, ПТО |
| ТЗ, разделы 18–19: прозрачность, стадии, остатки, отчёт руководителю; подключение ИИ-моделей по API (маршрутизация, бюджеты, fallback, приёмка модели) | ИТ, ИБ, ПТО |
| 5 провайдеров (2 локальных + 2 РФ-облака + внешний запрещённый), 5 правил маршрутизации по классу данных, бюджеты, fallback, привязка промптов, пороги приёмки новой модели | ИТ, ИБ |
| Миграция: стадии и контрольные точки, снимки остатков и прогресса, платежи, провайдеры и журнал вызовов моделей, бюджеты, отчёты; представления | разработка |
Файл | Назначение |
| «Сметчик»: КС-2, 7 классов расхождений, JSON-схема ответа |
| «Документатор»: АОСР, комплектность ИД, чек-лист замечаний |
| «Нормативщик»: ответ только с цитатой, правила конфликтов норм, регрессионные тесты |
| «Чертёжник»: redline → типизированные CAD-операции, белый список, блокирующие валидации |
| 36 инструментов с JSON-схемами, guardrails, политикой логирования и лимитами |
Файл | Назначение |
| Сценарий: текст каждой реплики + содержание слайда (единый источник правды) |
| Рендер 10 слайдов 1920×1080 (Pillow, DejaVu, без внешних ресурсов) |
| Сборка mp4: слайд + озвучка → сегмент → склейка (ffmpeg из imageio-ffmpeg) |
| Готовые кадры — можно использовать в PowerPoint или на печать |
Пересобрать видео целиком:
python3 video/build_slides.py
python3 video/make_video.pyФайл | Назначение |
| PostgreSQL 16: 40+ таблиц — объекты, договоры, сметы, журналы, КС-2/КС-3, ИД и связи, комплектность, нормативы с редакциями, CAD-операции, задачи агентов, append-only журнал аудита с хэш-цепочкой, RLS, 3 представления. Проверено парсером PostgreSQL |
| OpenAPI 3.1, 33 пути: КС-2/КС-3, сверка, комплектность, нормы, CAD (dry_run/commit), выпуск схем, задачи, аудит. Проверено |
| Шаблоны разметки GS-01…GS-05 |
| Паспорт выборки (инвентаризация) |
| Автопроверки разметки: JSON, обязательные поля, арифметика КС-2, допустимые типы ошибок, спаны, bbox |
# пересобрать ТЗ или ТЗ на golden set после правок markdown
python3 docs/build_docx.py "ТЗ_ИИ-агент_ПТО_v1.2.md" "ТЗ_ИИ-агент_ПТО_v1.2.docx"
python3 docs/build_docx.py "docs/01_Golden_set_и_методика_разметки.md" "01_Golden_set_и_методика_разметки.docx"
# пересобрать презентацию
python3 docs/build_pptx.py
# пересобрать дашборд руководителя (числа считаются из одного массива данных)
python3 docs/build_dashboard.py
# проверить файлы разметки перед сдачей
python3 golden_set/tools/validate_gs.py golden_set/templates/
# CAD-модуль: чертёж → проверка шаблона → пометки → версия
python3 scripts/make_demo_dxf.py
python3 -m pto_agent cad validate --file drawings/korpus2_plan_v1.dxf
python3 -m pto_agent cad plan --file drawings/korpus2_plan_v1.dxf --summary out/summary.json
python3 -m pto_agent cad apply --file drawings/korpus2_plan_v1.dxf --plan out/cad/plan.json --mode dry_run
python3 -m pto_agent cad apply --file drawings/korpus2_plan_v1.dxf --plan out/cad/plan.json \
--mode commit --confirm-by "Иванов И.И."
python3 -m pto_agent mcp --transport http --port 8765 # MCP-инспектор и JSON-RPC на /mcp
# распознавание скана с пометками: скан → операции → проверка → commit с подписью
python3 scripts/make_demo_redline.py
python3 -m pto_agent cad scan --scan drawings/redline_scan.png \
--file drawings/korpus2_plan_v1.dxf --engine vlm --json out/cad/scan.json
python3 -m pto_agent cad redline-from-scan --scan drawings/redline_scan.png \
--file drawings/korpus2_plan_v1.dxf --engine offline \
--texts data/demo/redline_texts.json --mode plan_only
# фото с телефона: 4 угла листа → выпрямление → пометки
python3 scripts/make_demo_photo.py
python3 -m pto_agent cad scan --scan drawings/redline_photo.jpg \
--file drawings/korpus2_plan_v1.dxf --engine offline \
--anchors data/demo/photo_anchors.json --rectified out/cad/photo_rectified.png
# выпуск целиком: 40 листов за сеанс, сводка в out/cad/batch/
python3 scripts/make_demo_batch.py
python3 -m pto_agent cad scan-batch --manifest data/demo/batch/manifest.json \
--engine vlm --out out/cad/batch
python3 -m pto_agent cad impact --batch out/cad/batch/batch_summary.json \
--summary out/summary.json --out out/cad/impact --with-background
python3 -m pto_agent cad impact --acts data/demo/acts/acts.json \
--summary out/summary.json --out out/cad/portfolio
# итог проверки: что проверено, что осталось, где нужен человек (и можно ли подписывать)
python3 -m pto_agent review --summary out/summary.json --batch out/cad/batch/batch_summary.json \
--impact out/cad/impact/impact.json --acts data/demo/acts/acts.json --out out/review
# исполнительная документация: схема из DXF, черновик АОСР, реестр ИД, комплектность
python3 -m pto_agent asbuilt scheme --file drawings/korpus2_plan_v1.dxf \
--object-name "ЖК «Северный», корпус 2" --work "Фундаментная плита" \
--code ИС-01-26 --act-ref "КС-2 №38" --executor "Иванов И.И." \
--reviewer "Петров П.П." --out out/asbuilt
python3 -m pto_agent asbuilt aosr --spec data/demo/asbuilt/aosr_ks38.json --out out/asbuilt
python3 -m pto_agent asbuilt registry --spec data/demo/asbuilt/registry.json --out out/asbuilt
# электромонтаж: матрица требует протоколы изоляции, «фаза-нуль», УЗО, заземления
python3 -m pto_agent asbuilt registry --spec реестр_эл.json --work-type electrical
# спецификация акта из сметы (работы, виды работ, нормы с пунктами) и матрица требований
python3 -m pto_agent asbuilt spec --smeta data/demo/smeta_v1.xlsx --object-name "Объект"
python3 -m pto_agent asbuilt requirements --work-type electrical
# смета АРОС читается напрямую — что агент в ней увидел (разделы, работы, материалы)
python3 -m pto_agent asbuilt smeta --smeta <выгрузка_АРОС>.md
# отдельный акт на каждую группу скрытых работ (демонтаж и вывоз мусора — вне актов)
python3 -m pto_agent asbuilt acts --smeta <выгрузка_АРОС>.md \
--act-prefix "АОСР-1166/Н" --write-specs --out out/asbuilt/acts
# проверка норм по нормативной базе (непроверенная ссылка так и называется)
python3 -m pto_agent asbuilt verify-norms --spec out/asbuilt/acts/specs/aosr_1.json
python3 -m pto_agent asbuilt forms # какая форма АОСР действует на дату
# обмен с 1С/БИТ.Строительство: смета и акты из 1С → наши структуры
python3 -m pto_agent import-1c --smeta выгрузка_сметы.csv --acts реестр_кс2.csv --out out/1c
python3 -m pto_agent export-1c --summary out/summary.json --out out/1c/ks2_for_1c.csv
# то же по HTTP, без файлов: акты из 1С → портфель, проверенная КС-2 → обратно
python3 -m pto_agent sync-1c --config config/one_c.example.yaml --period 2026-09 \
--summary out/summary.json --push --out out/1c
# внешний обмер по MCP (чужой сервер меряет, мы сверяем) — self-check на своём сервере
python3 -m pto_agent cad takeoff-external --config config/external_takeoff.example.yaml \
--pdf drawings/korpus2_plan_v1.dxf --file drawings/korpus2_plan_v1.dxf --out out/cad/external
python3 scripts/make_demo_retro.py && python3 scripts/make_demo_acts.py # ретро-выпуск
# полный цикл MVP агента (сверка → черновик КС-2 → отчёт → аудит)
python3 -m pto_agent run --data data/demo --out out
python3 -m pytest tests -qТесты, которым нужны тяжёлые демо-артефакты (сканы выпуска, ретро-выпуски, out/cad/batch*),
помечены skipif и просто пропускаются, если артефактов нет: свежий клон даёт 0 падений
(132 passed / 24 skipped после make_demo_redline.py), а джоб e2e в CI собирает весь набор
и прогоняет все тесты на реальных отчётах.
# поднять БД (после установки расширений pgcrypto, vector, pg_trgm)
psql -d pto_agent -f db/schema.sql
psql -d pto_agent -f db/002_transparency_llm.sqlДве цифры вместо одной: «выполнено» (физический факт по журналам) и «закрыто» (подписанный акт). Работы без документов не списываются в остаток — они висят как «готово к предъявлению».
Остаток = смета − закрыто подписанными КС-2 − выполнено, но не закрыто актом. Одна формула на всю систему, сумма по видам работ обязана сходиться с итогом до рубля.
Каждая цифра отчёта имеет trace_ref — раскрывается до документа, листа и строки. Журнал append-only с хэш-цепочкой, изменение записей невозможно технически.
Модель — сменный компонент. Подключение через единый OpenAI-совместимый шлюз; данные классов «коммерческая тайна» и «ПДн» обрабатываются только в контуре заказчика — блокировка на уровне шлюза и триггера БД.
Бюджет ИИ с жёстким стопом: при 80 % лимита — предупреждение, при 100 % — внешние вызовы прекращаются, система продолжает работать на локальных моделях.
MVP = 4 сценария, а не 18. КС-2/КС-3, сверка объёмов, комплектность ИД, АОСР. Исполнительные схемы — этап «CAD + 2.0» (июнь–декабрь 2027).
Арифметику делает код, а не модель (calc_totals + принцип детерминизма расчётов).
Ответ без цитаты запрещён. cite_verify блокирует выдачу, если цитата не найдена в указанном пункте указанной редакции. Цель — ≤ 0,5 % выдуманных ссылок.
CAD-модуль: headless-first (ezdxf + ODA), live-мост — опция. Плата — потеря объектов при конвертации, отсюда обязательное сравнение количества объектов до/после и запрет выпуска при расхождении.
Собственная сборка, а не форк «готового каркаса». Аудит GitHub 02.11.2026: у construction-ai-core нет лицензии (только идеи), AutoGAD под AGPL-3.0 (не для закрытого продукта). Рабочая база: ai-pmo-skills (MIT), DDC_Skills (MIT), Autocad-MCP (MIT), cad-ai-agent (Apache-2.0), ezdxf (MIT).
Согласовать ТЗ v1.2 и ТЗ на golden set, назначить владельца выборки.
Собрать 50–100 пакетов документов + NDA/обезличивание (Приложение E ТЗ, п.2.2 ТЗ на golden set).
Разметить: 30 актов КС-2, 20 пакетов ИД, 200 нормативных вопросов, 20 redline-кейсов, 60 документов на извлечение полей.
Провести базовый хронометраж «как есть» — точка отсчёта для метрик и для критериев остановки.
Параллельно — 2 демо вендорских решений на своих данных (страховка на случай «купить вместо делать»).
Схема БД «как есть» → миграции Alembic/Flyway и seed-данные для демо-стенда.
Реализовать calc_totals + reconcile_volumes как отдельный сервис с тестами на golden set.
ТЗ на пилот: регламент работы инженера с агентом, инструкция пользователя, форма журнала замечаний.
Расчёт ROI под фактические цифры компании (ФОТ ПТО, объём ИД, штрафы за просрочку).
Прототип CAD-пайплайна на ezdxf: чтение DWG/DXF, список слоёв, применение 3 операций, diff-растр.
Проверенный список открытых проектов по сметам и обмерам — в
docs/11_Смежные_проекты_и_лицензии.md,
машиночитаемо — data/reference/analogue_projects.json (звёзды и лицензии сверены с GitHub API 2026-11-03).
Проект | Лицензия | Что берём |
AGPL-3.0 | декомпозицию intake → takeoff → pricing → review → quote; только как идею | |
AGPL-3.0 | обмер как внешний MCP-сервер, который поднимает сам пользователь — наш код остаётся MIT | |
MIT | RAG по расценкам с обязательной ссылкой на источник, схему «код → единица → объём → цена» | |
MIT | схему инструментов | |
MIT | роли QTO / Pricing / Validation и формат skill «когда вызывать, входы, выходы, критерий успеха» | |
NOASSERTION | базу ГЭСН/ФЕР/ТЕР для позиций, которых нет в смете — после ручной проверки условий |
Правило простое: лицензия сильнее звёзд. В MIT-поставку не попадает ни строчки AGPL-кода и кода без лицензии; такие проекты либо остаются внешним процессом, либо дают только идею. Проверяется автоматически:
Шаг 1 дорожной карты сделан: адаптер pto_agent/cad/external_takeoff.py, CLI
python3 -m pto_agent cad takeoff-external и 15-й MCP-инструмент external_takeoff — агент сам
зовёт чужой обмер и сверяет его с нашим чертежом; чужой код остаётся за границей протокола.
python3 scripts/check_analogues.py --offline # структура и политика, без сети (то же делает CI)
python3 scripts/check_analogues.py # сверить звёзды и лицензии с GitHub API
python3 -m pytest tests/test_analogues.py -q # 10 тестов политикиПодробно — docs/12_Сравнение_с_БИТ_Строительство.md
(матрица из 26 задач инженера ПТО и три уровня стыковки).
БИТ.Строительство (1С) | pto-agent | |
Что это | отраслевая ERP: 16 модулей, Реестр российского ПО | AI-агент контроля и анализа, MIT |
Сильная сторона | учёт объектов, смет, материалов, КС-2/КС-3/КС-6а/М-29, БДР/БДДС, Гантт, архив ИД, ЭП | сверка КС-2 (7 классов расхождений), «деньги под риском», распознавание сканов и фото, CAD-redline, MCP |
Чего нет | распознавания рукописных пометок, «стоимости спора», правки DXF по пометкам | учёта, финансов, планирования, печатных форм, архива с ЭП |
Стыковка | файловый CSV-обмен → HTTP-сервис 1С (оба реализованы) → программный робот по расписанию |
|
Кому что | «что у нас есть и сколько потратили» | «правда ли то, что предъявляют, и сколько стоит спор» |
Мы не заменяем ERP: контроль нечего проверять там, где нет учёта. Пилот поверх работающей 1С делается файловым обменом за неделю и не требует доступа к конфигурации.
This server cannot be deployed
A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
An MCP server that audits the fairness of construction and renovation estimates in Japan. Provides fair-price ranges, overcharge detection, and verifiable unit-cost data based on JCCDB (65,520 items across 402 categories, CC BY 4.0, DOI-backed).
