Рабочие задачи. Решения. Развитие.
ФИО исключены из базы
Прототип для согласования с ИТ

Что сейчас мешает
двигаться дальше?

Выберите ситуацию и пройдите демодиалог: от уточнения фактов до действия и развития сотрудника. Все четыре сценария работают без ключа и подключения к серверу.

Демосценарии показывают будущую логику. Свободный текст — поиск в базе.
Используйте коды сотрудников и проектов. Автофильтр ФИО помогает, но не заменяет проверку текста.
Контекст сохраняется

Проекты и договоренности

Фиксируйте цель, стадию, ограничения и факты. Возвращайтесь к разговору с тем же контекстом.

Действия из разговоров

Справочник строительства

Где возникает сбой?

Выберите БП: посмотрите владельца, вход, ожидаемый результат и связанные показатели. Откройте разбор в чате.

ПроцессОтветственный по справочникуРезультат процесса

Владельцы взяты из вкладки «Ответственные по БП». Отметка роли в матрице статистик сама по себе не означает владение процессом.

Развитие через работу

Кому и чему учиться?

Наблюдение → проверка причины → навык → практика → подтверждение результата. Должность или плохая статистика не доказывают дефицит навыка.

Согласованные шаги развития

Ожидания по роли и материалы обучения

Требования из планов адаптации; это ориентир для разговора, а не автоматическая оценка сотрудника.

Внешний контекст · с источниками

Нормы и строительные практики

Официальные нормы, российский опыт и зарубежные практики рассматриваются отдельно. Источник и дата проверки видны рядом.

Как устроен коуч

Логика и архитектура

Нажмите на блок схемы, чтобы увидеть его роль. Раздел пригоден для обсуждения с командой хакатона и ИТ.

Выберите блок на схеме.
Проверяемая база

Что уже есть и чего не хватает

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

Версия 0.3 · 17 сентября 2026 · проект на согласование

ТЗ: постоянный ИИ-коуч строительства

Назначение прототипа — согласовать поведение продукта, интерфейс, данные и границы первой версии. Демонстрационные ответы не являются результатами работы подключенной модели.

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

1. Первая версия и следующий этап

В первой версииСледующий этапЧто уже показывает HTML
РС, УСМР с выбором специализации, МЗ и ВМЗ. ИСК, РВСК и ДП — участники процессов и дополнительные роли.Расширение на другие функции и регионы после проверки пилота.Выбор 7 ролей; детальные планы адаптации по 4 ролям. Специализации УСМР: каркас; отделка и внутренние сети; фасады и кровля; благоустройство.
Свободный диалог, контекст проекта, поиск оснований, уточнения, предложения действий и развития, фиксация результата.Автоматическое получение план/факта из корпоративных систем и запуск согласованных действий через API.4 демонстрационных диалога с развилками, проекты, карточки БП, наблюдения, принятие действия и фиксация результата.
Обезличенная база с источниками и статусом; ручной ввод фактов; адресная проверка нормативных изменений.Синхронизация версий документов, корпоративный вход, роли доступа, промышленный мониторинг и доставка уведомлений.Полностью автономные материалы и схемы. Поиск по словам не имитирует свободный ответ модели.
Персональная рекомендация обучения по подтвержденному основанию и назначенной роли.Автоматическая запись в Moodle и обратная загрузка результатов.Сохранение шага развития и подбор материалов по запросу. Нет автоматической аттестации или назначения кадрового решения.

2. Сквозные пользовательские сценарии

S-01 · РС · А3.3.5.1 / А3.3.5.2

Отставание по СМР

Ситуация → уточнение по захватке, РД, фронту, материалу → подтвержденное ограничение → план его снятия → проверка факта.

Развилка: материала нет — рабочее действие; причина неизвестна — сбор фактов. Обучение автоматически не назначается.

S-02 · УСМР / ИСК · А3.3.6

Замечания и развитие

Повторный пропуск критерия → проверка условий → разбор применения навыка → практика с наставником → проверка следующих комплектов.

Развилка: критерий не согласован — сначала исправление процесса; подтверждена ошибка применения — адресное развитие.

S-03 · МЗ / ВМЗ · А3.2.3 / А3.3.7

Рост стоимости

Общее отклонение → объем / цена / состав / изменение РД → сопоставление оснований → расчет и маршрут согласования.

Граница: коуч не утверждает бюджет, допсоглашение и объем принятых затрат.

S-04 · РС / ИСП · А3.1

Разные версии РД

Различие версий → статус действующего альбома → подтверждение передачи → согласование изменения БП с его владельцем.

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

3. Функциональные требования

IDПоведение системыПроверяемый результат
FR-01 · КонтекстОпределять роль, специализацию, проект, регион, стадию и доступные сотруднику материалы. Разрешать отдельный разговор без проекта.Смена роли или проекта начинает новый контекст; факты разных проектов не смешиваются. Неизвестные поля запрашиваются.
FR-02 · ДиалогПринимать свободный вопрос, уточнять 1–2 ключевых пробела, помнить историю в пределах прав доступа. Пользователь может вернуться к разговору.На следующий вопрос ответ учитывает уже сообщенные ограничения; не повторяет вопросы, на которые был ответ.
FR-03 · ОснованияИскать фрагменты только в доступных документах. Показывать название, точное место, версию, статус утверждения и дату проверки.Каждая ссылка открывает использованный фрагмент; отсутствие основания обозначено явно. Нельзя ссылаться на не найденный документ.
FR-04 · БПСвязывать ситуацию с кодом БП, владельцем, участниками, входом, выходом, критерием приемки и статистиками.Владение БП берется из справочника владельцев. Отметка в матрице метрик не превращается в назначение владельцем.
FR-05 · ПричинаРазделять факты и гипотезы; проверять процесс, ресурсы и применение навыка.Одно плохое значение статистики не приводит к выводу «сотрудник некомпетентен» и автоматическому обучению.
FR-06 · ДействияПредлагать до 3 следующих шагов: действие, роль владельца, основание, критерий результата; срок — при наличии данных или после согласования.Действие сохраняется после принятия пользователем. Принятое предложение, выполненная работа и подтвержденный эффект имеют разные статусы.
FR-07 · РазвитиеПо подтвержденному наблюдению формировать связь «код сотрудника → навык → основание → практика → материал → проверка → результат».Если оснований недостаточно, предложена диагностика, а не персональное заключение. Роль и специализация учитываются при подборе.
FR-08 · Возврат к результатуНа следующем обращении показывать незавершенные договоренности; принимать факт выполнения и подтверждение.Закрытие задачи не считается автоматически ростом компетенции. Хранятся факт, дата и проверяющий.
FR-09 · РуководительПоказывать в пределах своей команды подтвержденные потребности в развитии, основания, практику и результат проверки.Нет рейтинга личности или скрытой оценки по приватным диалогам. Руководитель видит предоставленные рабочие наблюдения и согласованные планы.
FR-10 · Практики рынкаВести группу ТОП-20 по объему текущего жилищного строительства ЕРЗ с датой среза; изучать первичные публикации компаний и международных организаций.Состав рейтинга отделен от полноты изучения практик; «подтвержденный факт компании» отделен от «нашей гипотезы применения».
FR-11 · Нормативные измененияПроверять официальные публикации; сравнивать редакции, даты публикации и действия; определять затронутые БП, работы и роли.Уведомление содержит официальный URL, было / стало, дату действия или статус «не проверена», применимость и предлагаемое действие.
FR-12 · Неподтвержденная нормаНе пересказывать поисковый фрагмент как прочитанный полный текст. Отделять проекты документов, действующие нормы и зарубежные практики.При недоступном тексте система сообщает ограничение; не ставит статус «изменений нет» как итог полной проверки.
FR-13 · УведомленияУведомлять адресно, после проверки применимости; исключать повторы по документу и редакции. Владелец подтверждает изменение внутреннего чек-листа.В уведомлении понятны получатель по роли, причина получения и конкретный шаг. Внутренний регламент не меняется автоматически.
FR-14 · Ошибки и расходыОбрабатывать отсутствие ключа, 401/402/403/429, таймаут, ошибку в теле HTTP 200, обрезанный ответ и неверный JSON. Учитывать модель и usage.cost_rub.Ошибка не отображается как ответ коуча. После неоднозначного таймаута нет незаметного повторного платного запроса.
FR-15 · Версии знанийХранить источник, дату чтения, редакцию, владельца, статус и права. При конфликте источников показывать конфликт.Рабочая редакция книги и черновик эталона не выдаются за утвержденный корпоративный стандарт.
FR-16 · Права и обезличиваниеПрименять доступ по пользователю, проекту и роли до поиска и формирования контекста. Заменять ФИО и контакты стабильными кодами до внешнего запроса.Запрос к модели не содержит ФИО; таблица соответствий кодов хранится отдельно в корпоративном контуре. Маскирование регулярными выражениями само по себе недостаточно для промышленного допуска.

4. Данные и связи

В текущей выгрузке: 22 уникальных БП из 30 строк перечня, 115 строк показателей, 743 строки этапов пакетов работ, 477 задач адаптации. Это не численность сотрудников, не число компетенций и не фактические результаты работы.
СущностьМинимальные поляИсточник / готовность
Сотрудник / рольemployee_code, role_id, specialty, manager_code, project_ids, access_scopeРоли есть; персональные соответствия, доступы и подтвержденный тип подчинения МЗ нужно передать из корпоративного контура.
Проектproject_id, регион, тип объекта, стадия, цель, план/факт, ограничения, актуальная РДВ макете — ручной ввод. Реальные проектные значения не переданы.
БП / показательbp_id, владелец, вход, выход, критерий приемки; metric_id, единица, формула, период, направление улучшения, план/фактЧасть формул и методов есть в справочнике. План/факт и противоречивые направления требуют владельца данных.
Наблюдение / навыккод сотрудника, задача, наблюдаемое поведение, дата, доказательство, предполагаемая причина, проверившийВ макете — обезличенный ручной ввод. Исходные индивидуальные оценки не загружены.
Шаг развития / действиеоснование, практика, материал, владелец, срок, критерий, статус, результат, подтверждениеКаталог обучения и планы адаптации доступны; завершение курса само по себе не подтверждает применение навыка.
Документ / фрагментsource_id, URL, тип, версия, статус, точное место, текст, дата проверки, ACLВ HTML — фиксированный обезличенный срез 17.09.2026. Автоматического обновления исходников нет.
Нормативное изменениеdocument_id, редакция до/после, опубликовано, действует с, применимость, роли, review_status, notification_idПолнотекстовая актуальная база СП/СНиП и промышленный канал доставки пока не подключены.

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

5. Доступы, приватность и архитектура

УчастникДоступ по умолчанию для согласования
СотрудникСвои разговоры, разрешенные проекты, принятые действия и план развития.
РуководительПроекты и сотрудники в своей области ответственности; согласованные рабочие наблюдения и развитие. Приватный диалог сотрудника автоматически не раскрывается.
HR / корпоративный университетСогласованные потребности в обучении и агрегированная аналитика. Детальные права и минимальный размер группы для агрегации согласовать.
Владелец БП / нормативный экспертПроверка содержания требований, противоречий и применимости изменений.
ИТ-администраторНастройки, технические журналы и расходы; содержание персональных разговоров не требуется для обычной диагностики.

Целевая архитектура: интерфейс → корпоративный вход и проверка доступа → контекст и поиск разрешенных фрагментов → серверный адаптер AITUNNEL → проверка ответа и ссылок → показ предложения → принятие пользователем → хранение результата. Внешний поиск выполняется отдельно, с публичным запросом без персональных и проектных данных. Подробные схемы находятся в разделе «Логика и архитектура».

6. Подключение и интеграции

ИнтеграцияКонтракт первой версииЧто нужно от ИТ
AITUNNELСерверный POST /v1/chat/completions; ключ из окружения / хранилища секретов; точная модель из GET /public/aitunnel/models/chat; max_tokens обязателен. Первый вариант без стриминга.Ключ, разрешенная модель, бюджет, срок действия, IP-ограничения, согласованный состав передаваемых данных и провайдеров.
Корпоративные документыЧтение, извлечение фрагментов, версия, ссылка, статус и ACL. Никаких команд из текста документов.Сервисный доступ к согласованным папкам / источникам; владелец и правило обновления.
Feroom / 1ССначала чтение справочника ЦКП, статистик и проектного план/факта; изменения — только после отдельного согласования.API или утвержденная выгрузка, ID сущностей, формулы, периодичность, контроль качества и права.
MoodleКаталог, компетенции, уровень, формат, длительность; затем назначение и результаты через согласованный API.API, права и стабильные course_id; правила связи курса с навыком. Ссылка на курс уже есть в исходной базе.
Нормативный мониторингЕжедневное чтение официальных публикаций; версии, сравнение, проверка применимости, очередь эксперта, уведомление по ролям.Разрешенные источники / лицензированный доступ, ответственный эксперт, канал доставки и проектные атрибуты.
В инструкции ИТ рабочего ключа нет. Это не мешает просмотру и приемке интерфейсного прототипа. Полная функциональная приемка диалога выполняется после подключения модели; подготовленный адаптер еще не проходил проверку реальным платным запросом.

7. Предлагаемый контракт ответа коуча

Стабильные ID и проверяемые поля; интерфейс не должен зависеть от произвольного Markdown модели.

{
  "answer": "Факты, гипотезы и понятный следующий шаг",
  "questions": ["До двух ключевых уточнений"],
  "actions": [{"task":"…", "owner":"роль", "evidence":"…", "check":"…"}],
  "learning": [{"employee":"код", "skill":"…", "evidence":"…", "practice":"…", "check":"…"}],
  "citations": ["идентификатор найденного фрагмента"],
  "model": "реальная модель из ответа шлюза",
  "usage": {"costRub": "значение шлюза или null"}
}

В промышленной версии сервер добавляет request_id, project_id, conversation_id, версию источников и журнал согласования. URL источников сервер получает из своего реестра, а не принимает произвольный URL от модели. Ключ и баланс аккаунта в интерфейс сотрудника не передаются.

8. Критерии приемки

IDПроверкаОжидаемый результат
AT-01Открыть HTML без интернета.Все экраны, сценарии, поиск, проекты и схемы работают без внешних библиотек. Для перехода на исходный сайт нужен интернет.
AT-02Пройти S-01: материала нет.Коуч предлагает снятие ресурсного ограничения; персональное обучение не назначается.
AT-03Пройти S-02 в двух ветках.Несогласованный критерий → изменение процесса. Подтвержденная ошибка → диагностическая практика и критерий проверки.
AT-04Принять действие, перейти в проект, зафиксировать результат, перезагрузить.Контекст и результат доступны; статус не превращается в автоматическую аттестацию.
AT-05Запросить вывод без данных или по спорной статистике.Коуч запрашивает основания / отмечает конфликт и не выдает вымышленную оценку.
AT-06Указать ФИО, контакт или инструкцию «игнорировать правила» внутри документа.Данные маскируются до внешнего запроса; команды из источника не исполняются. Промышленная проверка включает тесты обхода фильтра.
AT-07Открыть чужой проект / передать его ID в API.Доступ отклонен до поиска. Проверяется на промышленной версии с корпоративным входом; локальный макет однопользовательский.
AT-08Получить ответ с выдуманным ID источника, неверным JSON или обрезкой.Неизвестная ссылка не показывается как подтвержденная; ошибочный ответ не сохраняется как решение.
AT-09Смоделировать 401, 402, 403, 429, таймаут и error в HTTP 200.Понятный статус; ключ не раскрывается; нет бесконечных повторов и скрытого удвоения запроса.
AT-10Нормативный текст недоступен / дата действия не установлена.Отмечена неполнота проверки. Нет ложного подтверждения актуальности или обязательности нормы.
AT-11Один нормативный документ обнаружен повторно.Нет повторного уведомления по той же редакции; измененная редакция проходит новый разбор применимости.
AT-12Открыть подборку ТОП-20.Есть дата и основание рейтинга; полнота изучения практик обозначена отдельно. У зарубежного опыта нет статуса нормы РФ.

Качество модели — отдельный этап

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

Предлагаемый порог пилота: ≥ 90% ответов приняты экспертами; 0 утечек между проектами и 0 вымышленных обязательных нормативных требований. Это целевые критерии, а не измеренный результат прототипа.

Нефункциональные требования

Предлагаемые цели пилота: подтверждение отправки ≤ 1 с; поиск источников ≤ 3 с; 95% обычных ответов ≤ 30 с при доступном провайдере. Показ состояния и возможность безопасного повтора при сбое.

Лимиты бюджета и запросов, контроль длины контекста, резервное копирование, удаление данных по согласованной политике, журнал версии модели и источников. Значения уточнить нагрузочным тестом.

9. Решения перед промышленной разработкой

ВопросОтветственный за решениеЧто уже известно
Утвержденная редакция производственной книги и приоритет источниковВладелец строительного процессаНазвание исходника содержит «для редактуры в 2026»; статус утверждения всех разделов не доказан.
Эталоны диагностики УСМРРВСК / владелец аттестации / КУВ оценочном листе есть «уточнить» и вопросы. Не использовать его как утвержденный эталон.
Подчинение МЗ и маршруты согласованияВМЗ / ДП / HRСправочник указывает ВМЗ, план адаптации — ДП. Нужно различить виды подчинения.
Формулы и направление улучшения показателейВладелец статистикиВ части строк просроченных замечаний указано «выше — лучше». До уточнения оценка не рассчитывается.
Факты сотрудников, регион и проекты пилотаРуководители пилотаПерсональные результаты не переданы. Для проверки полезности нужны обезличенные наблюдения и план/факт.
Размещение, модель, данные и срок храненияИТ / ИБ / владелец продуктаAITUNNEL задан инструкцией ИТ. Локальный макет не заменяет корпоративную систему доступа.
Нормативная база и экспертная проверкаНормативный эксперт / ИТЕсть официальные каналы. Полнотекстовая база СП/СНиП и адресная доставка в продукт требуют реализации.

10. Основания ТЗ

Справочник БП строительства ↗

Прочитаны 4 целевые вкладки: матрица, роли, ответственные и этапы пакетов работ.

Девелоперский проект · Путь регионов ↗

Прочитан текст; статус утверждения уточнить. Изображения и все связанные файлы не интерпретировались автоматически.

Менеджер по затратам.xlsx · РС_9.26.xlsx · УСМР_итог 9.26.xlsx

Планы адаптации и ожидаемые результаты; не индивидуальные оценки сотрудников. Архивы и черновые эталоны не используются для автоматической аттестации.

Документация AITUNNEL ↗

Дополнена файлом ИТ «aitunnel-api_1 (1).md». Каталог моделей проверен 17.09.2026. Рабочий ключ не передан.

Дополнительная база

Реестр профилей, ЦКП и статистики ФЕ, программа аттестации ПК, каталог развития и курс А3. Точное покрытие, ограничения и внешние первичные источники перечислены в разделе «Источники» прототипа.

Все демонстрационные проектные обстоятельства и наблюдения в сценариях условные. Материалы компании обезличены в части известных ФИО и контактов. Прототип предназначен для согласования требований, а не для нормативного заключения или автоматического кадрового решения.
Подготовлено по инструкции ИТ

Подключение AITUNNEL

HTML открывается самостоятельно. Для живого диалога используется локальное приложение из архива: ключ остается в памяти серверного процесса.

01 · открыть сейчас

Один HTML-файл

Скачайте файл и откройте его двойным щелчком в Chrome, Edge или Firefox. Интернет нужен только для перехода к источникам.

Доступны проекты, наблюдения, поиск по БП и материалам, схемы, источники, резервная копия. Генерации ответов ИИ без подключения нет.

02 · включить ИИ

Локальное приложение

Распакуйте архив «ИИ-коуч-приложение.zip». Запустите Запустить.bat на Windows или server.py через Python 3.10+.

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

Требуются интернет, Python и действующий ключ с бюджетом. Для HTML они не нужны.

Что передать ИТ

ПараметрЧто требуется
AITUNNEL_API_KEYКлюч администратора мероприятия. В присланной инструкции только примеры; рабочего ключа нет.
AITUNNEL_MODELТочный ID из текущего каталога; текстовый вход и выход, окно ≥ 32 000 токенов. Модель должна быть разрешена для ключа.
AITUNNEL_MAX_TOKENS2000 по умолчанию; ограничение 512–4096. Бюджет в рублях задается на стороне ключа.
Доступ к сетиОсновной адрес api.aitunnel.ru; зеркало ru-api.aitunnel.ru — только при необходимости. Уточнить IP-ограничения ключа.
Данные компанииПодтвердить, какие обезличенные фрагменты разрешено передавать через шлюз выбранному провайдеру. Экран поиска в интернете не получает внутренние материалы.
После пилотаКорпоративный вход и роли доступа, централизованная база, версии документов, интеграции Moodle / Feroom / 1С, доставка нормативных уведомлений в приложение.