0. Все ссылки одним списком

Быстрый доступ ко всем частям решения. Ниже — боевой контур кампуса и демонстрационный стенд.

Для резидентов

Публичный календарь сейчас работает на демонстрационном стенде исполнителя: приложение внутри

портала закрыто авторизацией Битрикс24, и студенты его открыть не смогут. Чтобы календарь

резидентов работал на контуре кампуса, приложению нужно разрешить открытый доступ — это

отдельное решение по безопасности, принимает кампус.

Для сотрудников

Отдельный пароль не нужен: приложение открывается только у сотрудников, которым выдан доступ

на платформе. Кто вне списка — увидит экран входа Битрикс24.

Про список сделок. Прямой ссылки на список внутри одной воронки в Битрикс24 нет: этот режим

хранит выбор воронки в настройках пользователя, а не в адресе, поэтому любая ссылка вида

/crm/deal/list/... открывает все сделки портала. Рабочий путь один: открыть **канбан

«Шумный корпус» и переключиться на «Список»** в верхней панели — воронка сохранится и

в следующий раз список откроется уже отфильтрованным. Ссылка на канбан всегда ведёт строго

в брони «Шумного корпуса».

Служебное (для исполнителя и ИТ-специалиста кампуса)

Демонстрационный стенд исполнителя

Отдельный контур для показов и обкатки — данные туда не попадают в CRM кампуса.

Документы проекта

1. Что такое «Шумный корпус» и как это работает

Система бронирования пространств активного досуга 9 корпуса. Резиденты сами занимают этаж под свою

активность, сотрудники контролируют, кто и когда приходит.

Коротко

Резидент выбирает свободный слот (в Telegram-боте или на публичной странице), указывает активность

и количество человек, отправляет заявку. Сервис-координатор её подтверждает или отклоняет.

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

и отмечает явку.

Что бронируется

Слот — 2 часа. Будни 12:00–00:00, выходные с 10:00. Запись открыта на 5 дней вперёд.

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

Из чего состоит система

• Telegram-бот — то, чем пользуются резиденты.
• Публичная страница — открытый календарь свободного времени, вешается QR-кодом в корпусе.
• Кабинет управляющего — рабочее место сотрудников: заявки, шахматка, вход по коду, отчёты.
• CRM Битрикс24 — контакты резидентов и сделки-брони со стадиями, история и отчётность.

Занятость одна на всех: как только слот забронирован, он мгновенно исчезает и у бота,

и на публичной странице, и появляется в шахматке. Ничего сверять вручную не нужно.

Кто что делает

Жизненный цикл брони

Заявка → На подтверждении → Подтверждена (выдан код) → Идёт → Пришёл
Отказные варианты: Отклонена · Отменена · Не пришёл

Те же названия используются и в кабинете, и в стадиях сделки в CRM — это одна и та же бронь,

показанная в двух местах.

Что система делает сама

• Не показывает занятое и прошедшее время.
• Придерживает слот на 15 минут, пока резидент оформляет бронь.
• Не даёт занять второй слот в тот же день.
• Отклоняет заявку автоматически, если до начала остался час, а решения нет — слот возвращается другим.
• Напоминает резиденту за 3 часа и за 5 минут до начала.
• Закрывает прошедшие брони через 20 минут после окончания.

Дальше: Инструкция сервис-координатора

2. Сервис-координатор: подтверждение заявок

Заявка от резидента не действует, пока её не подтвердил координатор. Это главное правило —

без подтверждения группа в корпус не заходит.

Где смотреть

Кабинет управляющего → вкладка «Заявки». Рядом с названием вкладки показано число заявок,

ожидающих решения. Список обновляется сам каждые 20 секунд.

Что видно в карточке заявки

• ФИО резидента, корпус и комната, телефон;
• номер заявки;
• пространство, дата, время слота;
• активность и количество участников;
• комментарий резидента (какое оборудование нужно, особенности).

Подтвердить

Нажмите «Подтвердить».

Что произойдёт:

1. Резиденту в бот придёт сообщение с кодом на вход и памяткой (собраться у входа за 5 минут).
2. Сделка в CRM переедет на стадию «Подтверждена».
3. В журнале появится запись с вашим действием.

Отклонить

Нажмите «Отклонить» и напишите причину — она уходит резиденту дословно, поэтому формулируйте

понятно: «на это время этаж занят мероприятием кампуса», «активность не подходит для этого этажа».

Что произойдёт:

1. Резиденту придёт отказ с причиной и кнопкой выбрать другое время.
2. Слот сразу освободится для остальных.
3. Сделка перейдёт на стадию «Отклонена».

Если заявку не посмотреть

За час до начала слота необработанная заявка отклоняется автоматически, резиденту уходит

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

Порог настраивается.

Запуск группы в корпус

За 5 минут до начала группа собирается у входа. Порядок:

1. Спросите код брони (он есть у ответственного в боте).
2. Введите код в кабинете на вкладке «Вход по коду» — увидите ответственного, состав и активность.
3. Сверьте группу и нажмите «Пришли — запустить».

Подробнее: Вход по коду

Важные мелочи

• Отклонённую заявку нельзя вернуть — резидент оформляет новую.
• Резидент может отменить бронь сам, но только если до начала больше двух часов. Позже он обязан

сообщить координатору, а вы отменяете бронь через шахматку.

• Если резидент просит перенести время — не заводите новую бронь, используйте перенос в шахматке:

код сохранится, история не задвоится.

3. Администратор на входе: код и отметка явки

Порядок на входе

1. Группа подходит за 5 минут до начала слота.
2. Ответственный называет код брони — четыре цифры, они пришли ему в бот при подтверждении.
3. Откройте кабинет → вкладка «Вход по коду», введите код, нажмите «Проверить».
4. На экране появятся: ФИО ответственного, пространство, дата и время, активность,

количество участников, корпус и комната.

1. Сверьте, что перед вами та самая группа, и нажмите «Пришли — запустить».

Что происходит после нажатия

• Бронь получает статус «Пришли», код гасится — повторно он не сработает.
• Сделка в CRM переезжает на стадию «Пришёл».
• Резиденту в бот уходит короткое сообщение о том, что код принят.

Если группа не пришла

Нажмите «Не пришли». Бронь закроется как неявка, сделка перейдёт на стадию «Не пришёл».

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

Если никто ничего не нажал, бронь закроется автоматически через 20 минут после окончания слота.

Частые случаи

«Код не найден или уже погашен». Варианты: код уже использован на этом входе, бронь отменена

или отклонена, либо резидент диктует код от прошлой брони. Найдите его в шахматке по фамилии —

там видно актуальный статус.

Резидент не помнит код. В боте раздел «Мои брони» показывает код по подтверждённой брони.

Либо найдите бронь в шахматке — код указан в ячейке.

Пришли раньше времени. Код работает и до начала слота — можно запустить, если этаж свободен.

Пришло больше человек, чем в заявке. В текущей версии система хранит только количество; сверку

состава ведёт координатор по регламенту. Если людей больше заявленного — решение за координатором.

4. Шахматка: день, ручная бронь, перенос, отмена

Вкладка «Шахматка» — сетка «этаж × время» на выбранный день. Сверху лента дат: вчера, сегодня

и дни вперёд по горизонту записи.

Что показано в ячейке

• «свободно» — слот открыт;
• занятый слот: ФИО ответственного, активность, число участников, статус и код;
• «—» — в это время пространство не работает.

Статусы в ячейках: *ждёт подтверждения*, *подтверждена*, *идёт*, *пришли*, *не пришли*,

*отменена*, *отклонена*.

Ручная бронь (резидент подошёл лично)

Кликните по свободной ячейке и заполните: ФИО, телефон, корпус, комнату, активность, количество

участников.

Такая бронь создаётся сразу подтверждённой — сотрудник заводит её осознанно, ждать

подтверждения не нужно. В CRM появятся контакт и сделка, как при обычной брони.

Телефон лучше указывать: по нему система находит существующий контакт и не плодит дубли.

Действия с существующей бронью

Кликните по занятой ячейке и выберите действие:

Перенос брони

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

код сохраняется, сделка та же — история не задваивается, резиденту уходит уведомление

с новым временем.

Не создавайте вместо переноса новую бронь: в CRM появятся две карточки на одно событие.

Ограничения, о которых стоит помнить

• Прошедшее время выбрать нельзя нигде — ни в боте, ни в шахматке.
• Занять слот, где уже есть бронь, нельзя; сначала отмените или перенесите существующую.
• Правило «одна бронь в день на резидента» действует и для ручных броней.

5. Работа в CRM Битрикс24: воронка, стадии, поля, отчёты

Каждая бронь — это сделка в воронке «Шумный корпус», каждый резидент — контакт.

Кабинет и CRM показывают одну и ту же бронь: изменения в одном месте видны в другом.

Контакт резидента

Создаётся при первой брони. Если человек уже есть в базе (ищется по телефону) — используется

существующий контакт, дубль не создаётся. В карточку записываются корпус и комната.

Сделка-бронь

Стадии и что они значат

Управление прямо из CRM

Стадию сделки можно двигать мышкой в воронке — система подхватит изменение в течение минуты:

статус брони в кабинете изменится, а резиденту уйдёт уведомление, если стадия стала «Подтверждена»

или «Отклонена».

Важно: из CRM тянется только статус. Дата, время и состав меняются в кабинете —

так календарь защищён от случайной правки в карточке.

Отчёты

Всё, что нужно руководителю, строится штатными средствами Битрикс24 по сделкам воронки:

• загрузка этажей по дням недели и времени суток;
• популярные активности;
• доля подтверждённых и отклонённых заявок;
• неявки — по резидентам и по этажам;
• средний размер группы, динамика по месяцам.

Быстрые цифры без CRM — вкладка «Отчёты» в кабинете: брони за 30 дней, ожидающие

подтверждения, состоявшиеся, неявки, загрузка пространств, топ активностей.

Права доступа

Права на воронку выдаются администратором портала в интерфейсе Битрикс24

(CRM → Настройки → Права доступа). Через API права не выдаются — только руками.

6. Настройки: что можно менять самим

Кабинет → вкладка «Настройки». Изменения вступают в силу сразу — бот и публичный календарь

начинают работать по новым правилам без перезапуска и без программиста.

Пространства и активности

Для каждого этажа задаются:

• Название — то, что видит резидент («2 этаж»);
• Назначение — подпись под названием («Спортивные активности»);
• Активности — список через вертикальную черту:

Растяжка|Йога|Танцевальная тренировка|Функциональная тренировка|Другое.

Вариант «Другое» даёт резиденту написать свою формулировку — оставляйте его в списке.

Расписание и правила

Типовые задачи

Закрыть этаж на ремонт или мероприятие. Занять нужные слоты ручными бронями либо временно

выключить пространство. Для разового мероприятия проще ручная бронь на нужное время.

Изменить время работы на праздники. Поменяйте окно «с / до» — сетка пересчитается сразу.

Открыть запись дальше на неделю. Увеличьте «Горизонт записи».

Разрешить две брони в день. Поставьте «Броней на резидента в день» = 2. Помните, что вечерние

слоты дефицитные — правило защищает от захвата времени одними и теми же группами.

Отключить подтверждение (например, на время эксперимента). Поставьте «Подтверждение

координатором» = 0 — брони будут действовать сразу с выдачей кода.

Чего в настройках нет

Тексты сообщений бота, состав шагов диалога и правила проверки участников меняются в коде —

это делает исполнитель. Скажите, что нужно изменить, — правка занимает минуты.

7. Открытая линия «Шумный корпус»: как это работает

Резидент пишет в мессенджер кампуса → сообщение попадает в Открытую линию «Шумный корпус» →

диалог ведёт бот → бронь оформляется, и вся переписка остаётся в карточке сделки.

Что настроено на портале

Почему переписка оказывается в сделке

Когда резидент пишет впервые, Открытая линия сама заводит контакт и сделку и привязывает к ним

чат. Бот не создаёт вторую сделку — он заполняет ту, которую завела линия: подставляет

пространство, слот, активность, количество участников и код.

Результат: в карточке сделки одновременно видно и параметры брони, и всю переписку — кто что

писал, когда бот выдал код, о чём просил резидент. Отдельно искать диалог не нужно.

Что видит оператор

Диалог приходит в Чат Битрикс24 → раздел «Открытые линии». Пока диалог ведёт бот, он

операторов не занимает. Оператор подключается в двух случаях:

1. Резидент попросил человека — бот выходит из чата, диалог встаёт в очередь.
2. Прошло 24 часа без завершения — линия переводит диалог на оператора автоматически.

Когда диалог у оператора, бот в него не вмешивается.

Подключение мессенджера кампуса

Канал подключается в интерфейсе Битрикс24: **Контакт-центр → нужный мессенджер → выбрать линию

«Шумный корпус»**. Для Telegram — штатный коннектор Битрикс24: указывается токен бота кампуса,

созданный в BotFather.

После подключения проверьте: напишите в канал с личного аккаунта, диалог должен появиться в линии

«Шумный корпус», а бот — ответить приветствием.

Пока канал кампуса не подключён, бот доступен напрямую в Telegram — тестовый @UKMiraTest_bot.

Логика диалога у обоих каналов одна и та же.

Важные правила эксплуатации

• Линию «Неймарк» не трогаем — там боевой трафик кампуса и своя очередь операторов.
• Настройки бота на линии Битрикс24 сохраняет только пакетом (все поля разом). Если менять

их по одному в API, интерфейс покажет «сохранено», а значение не изменится. Меняйте настройки

в интерфейсе или просите исполнителя.

• В выпадающем списке «чат-бот» интерфейс иногда показывает не тот бот, что реально привязан.

Правда — в настройках линии, которые возвращает API; при сомнении спросите исполнителя.

• Если резидент пишет из мессенджера без номера телефона (MAX, Telegram), система опознаёт его

по контакту, который линия привязала к чату, и дозаполняет карточку из ответов бота.

Если что-то идёт не так

Бот не отвечает в линии. Проверьте, что линия активна и в её настройках включён бот

«Шумный корпус». Затем — что приложение работает (у исполнителя есть страница состояния).

Диалог сразу уходит к оператору. Значит бот отключён на линии или упал — обращения при этом

не теряются, их видит оператор.

В сделке нет переписки. Такое бывает, если бронь оформлена не через линию, а напрямую

в Telegram-боте или руками в кабинете — там переписки в Битрикс24 просто нет.

8. Частые ситуации и что делать

Резидент

«Бот не даёт забронировать — пишет, что бронь уже есть».

Действует правило «одна бронь в календарный день». Пусть выберет другой день или отменит текущую

бронь в разделе «Мои брони».

«Не приходит код».

Код приходит только после подтверждения координатором. Проверьте вкладку «Заявки» — возможно,

заявка ещё ждёт решения.

«Хочу отменить, но кнопка не работает».

До начала осталось меньше двух часов — самостоятельная отмена закрыта. Отмените бронь за резидента

в шахматке и напомните, что предупреждать нужно заранее.

«Ошибся в комнате / корпусе».

В боте есть «Профиль» → «Изменить данные». Карточка контакта в CRM обновится при следующей брони;

если нужно сразу — поправьте контакт в Битрикс24 руками.

«Слот был свободен, а теперь занят».

Скорее всего, его придержал другой резидент на время оформления (15 минут). Если он не завершит

оформление, слот вернётся в календарь автоматически.

Сотрудник

Нужно закрыть этаж на мероприятие.

Заведите ручные брони на нужные слоты в шахматке — с пометкой в поле активности («мероприятие

кампуса»). Резиденты этих слотов не увидят.

Группа пришла без ответственного.

По правилам ответственный должен присутствовать всю бронь. Решение за координатором; систему это

не касается — она хранит, кто ответственный.

Пришли не в свой слот / раньше.

Код работает и до начала. Если этаж свободен — можно запустить, но помните: следующий слот может

быть занят другой группой.

Нужно перенести бронь на другое время.

Используйте перенос в шахматке, а не новую бронь: код сохранится, история не задвоится,

резидент получит уведомление.

Резидент нарушил правила.

Отметьте это в комментарии к сделке. Ограничение бронирования пока применяется вручную:

скажите исполнителю, если нужно закрыть резиденту доступ на срок.

Заявок много, все похожие.

Смотрите на этаж и активность: спорт — только 2 этаж, шумные форматы — 3, спокойные — 4.

Несоответствие — повод отклонить с понятной причиной.

Технические мелочи

Кабинет не открывается. Нужна ссылка с ключом доступа — она у координатора и у исполнителя.

Ключ можно поменять, если он попал не тем людям.

Данные в кабинете «застыли». Страница обновляется сама каждые 20 секунд; если нет —

перезагрузите вкладку.

Стадию сделки подвинули в CRM. Это разрешено: система подхватит изменение в течение минуты

и, если стадия «Подтверждена» или «Отклонена», пошлёт резиденту уведомление.

Сделку удалили в CRM. Бронь останется в кабинете; при следующем действии система заведёт

карточку заново. Лучше так не делать — историю не восстановить.

9. Как тестировать систему

Раздел для приёмки: что проверить перед тем, как открывать бронирование резидентам.

Тесты независимы, порядок любой. Удобнее проверять с телефона.

Что понадобится

• Бот: канал Открытой линии «Шумный корпус» или тестовый бот в Telegram.
• Кабинет управляющего: ссылка с ключом доступа (у координатора).
• CRM: воронка «Шумный корпус» в Битрикс24.
• Отдельный телефон или аккаунт, чтобы играть роль резидента.

Чек-лист

На что смотреть особенно внимательно

• Тексты бота — это лицо системы для студентов. Всё, что режет глаз, исправляется за минуты:

формулировки, порядок вопросов, эмодзи.

• Расписание и правила — сетка слотов, горизонт записи, лимиты. Проверьте на реальном

сценарии выходного дня: сетка там начинается раньше.

• Названия активностей по этажам — должны совпадать с тем, что кампус реально разрешает.
• Реакция на ошибку — попробуйте ввести бессмыслицу вместо номера комнаты или телефона,

бот должен вежливо переспросить, а не молчать.

Как сообщать о проблемах

Пишите одним сообщением исполнителю:

1. Что делали (шаг за шагом).
2. Что ожидали увидеть.
3. Что увидели на самом деле.
4. Скриншот и время с точностью до минуты — по времени найдём событие в журнале.

Если проблема в боте — приложите номер заявки или код брони. Если в кабинете — скажите,

на какой вкладке.

Когда считать, что можно запускать

• Тесты 1–7 проходят без замечаний.
• Координатор понимает, где смотреть заявки и как подтверждать.
• Администратор на входе умеет гасить код.
• Тексты бота согласованы.
• Канал мессенджера подключён к линии «Шумный корпус» и проверен живым сообщением.

10. Что видит резидент в боте — шпаргалка

Чтобы отвечать на вопросы студентов, не открывая бота.

Главное меню

Порядок диалога при первом обращении

1. Приветствие и объяснение, зачем данные.
2. «Как вас зовут? Напишите фамилию и имя».
3. «В каком корпусе вы живёте?»
4. «Номер вашей комнаты?»
5. Телефон — кнопкой «Отправить мой номер» (в Telegram) или текстом.
6. Подтверждение: данные сохранены, дальше главное меню.

Повторно эти вопросы не задаются.

Что бот пишет на каждом шаге брони

• Даты — кнопками: «сегодня», «завтра», дальше днями недели. День, где у резидента уже есть

бронь, не показывается.

• Этажи — с подписью назначения: «2 этаж — Спортивные активности».
• Время — только свободные слоты, парами «18:00 – 20:00».
• После выбора времени: «Слот придержан за вами на 15 мин».
• Активность — список своего этажа плюс «Другое» (тогда бот просит описать одним предложением).
• Участники — кнопки 1–15 или ввод числа.
• Комментарий — необязательный, с кнопкой «Пропустить».
• Проверка заявки — сводка и текст об ответственности, кнопки «Отправить заявку» / «Отменить».

Сообщения после отправки

Типовые ответы бота на отказ

• «На эту дату у вас уже есть бронь» — правило одной брони в день.
• «Этот слот только что заняли» — кто-то успел раньше.
• «Это время уже прошло».
• «Максимальная вместимость — 15 человек включая ответственного».
• «До начала меньше 2 ч — самостоятельная отмена уже недоступна».
• «Бронирование временно ограничено до …» — действует ограничение доступа.

Все формулировки меняются по просьбе кампуса — это правки текста, а не переделка системы.

11. Полная техническая инструкция: устройство, исходники, доступы

Документ для тех, кто сопровождает решение: как всё устроено, где лежит код, как внести правку,

кому что доступно и как выдать доступы.

11.1. Из чего состоит решение

Источник истины по занятости — база приложения, а не календарь Битрикс24. Стадия сделки —

отражение статуса брони. Обратная связь тоже есть: если стадию подвинуть руками в CRM,

приложение подтянет статус к себе в течение минуты (только статус, не время и не состав).

11.2. Что где развёрнуто

Контур кампуса (боевой)

«Горячая вода» живёт отдельно (сервер db523e01…, воронка 7, линия 3, бот 339) и этим проектом

не затрагивается.

Демо-контур (наш, для показов и обкатки)

Два контура независимы: тесты на демо-стенде не попадают в CRM кампуса.

11.3. Исходники

Где лежат: рабочая копия у исполнителя — ~/ai-lab/gotovye-resheniya/apps/resource-booking/.

app/
  tg.py        транспорт Telegram (long-polling, кнопки)
  ol.py        транспорт Открытой линии (события бота → тот же сценарий)
  tgbot.py     сценарий диалога: знакомство, бронь, «мои брони», уведомления
  booking.py   правила, удержание слота, модерация, статусы, фоновые проверки
  slots.py     сетка слотов (в т.ч. через полночь), свободное время, шахматка
  store.py     SQLite: настройки, пространства, брони, резиденты, журнал
  b24.py       клиент API Битрикс24: контакты, сделки, стадии, бот
  main.py      HTTP: публичная страница, кабинет, API, фоновые задачи, синхронизация
  static/      public.html (календарь), admin.html (кабинет)
scripts/
  setup_b24.py настройка портала: воронка, стадии, поля (можно запускать повторно)
  deploy.py    сборка и деплой на VibeCode
docs/kb/       эта база знаний
PLAN.md        разбор ТЗ и принятые решения
README.md      краткая карта решения и команды

Поставка лежит у кампуса. Полный комплект — исходный код, скрипты настройки портала и

деплоя, вся база знаний, README и разбор ТЗ — находится:

• на сервере приложения, в каталоге /opt/app (папки app/, scripts/, docs/);
• в хранилище исходников платформы — версия с тегами release, v1, full-delivery.

Ничего отдельно запрашивать у исполнителя не нужно: всё, что нужно для поддержки и доработки

решения, уже на стороне кампуса.

Как скачать код с боевого сервера. Платформа хранит снимки исходников при каждом деплое:

SRV=7b2a7daa-cf2c-4594-9244-2a7698cebf9f
BASE=https://vibecode.bitrix24.tech/v1/infra/servers/$SRV

# список версий: помеченная релизная имеет теги release, v1, full-delivery
curl -H "X-Api-Key: $VIBE_API_KEY" "$BASE/sources"

# скачивание идёт в два шага — сначала ссылка, потом файл
URL=$(curl -s -H "X-Api-Key: $VIBE_API_KEY" "$BASE/sources/<версия>/download" \
      | python3 -c "import sys,json;print(json.load(sys.stdin)['data']['url'])")
curl -L "$URL" -o shumny-korpus.tar.gz
tar -xzf shumny-korpus.tar.gz

В архиве: app/ — код, scripts/ — настройка портала и деплой, docs/kb/ — база знаний

статьями, docs/*.html — она же одним документом, README.md, PLAN.md, .env.example.

Секреты (ключи портала, токен бота) в поставку не входят — они лежат только в .env

на самом сервере.

11.4. Как внести правку

1. Поправить файл в рабочей копии.
2. Проверить локально: python3 -m uvicorn app.main:app --port 3111 (нужен .env с ключом портала).
3. Задеплоить на кампус:

set -a; . ./.env; set +a
export B24_CATEGORY_ID=9 B24_STAGE_NEW=C9:NEW B24_STAGE_PREPARATION=C9:PREPARATION \
       B24_STAGE_EXECUTING=C9:EXECUTING B24_STAGE_WON=C9:WON B24_STAGE_LOSE=C9:LOSE \
       B24_STAGE_UC_REJECT=C9:UC_REJECT B24_STAGE_APOLOGY=C9:APOLOGY \
       OL_ENABLED=1 OL_BOT_ID=351 OL_LINE_ID=9 ADMIN_PASSWORD=<ключ кабинета> \
       PLACEMENT=dedicated PLAN=bc-agent REGION=ru-central1-a RUNTIME=static
python3 scripts/deploy.py

Деплой заменяет код в /opt/app, база в /var/lib/booking/ остаётся — брони не теряются.

Грабли, на которые уже наступили:

• Стандартный рантайм python311 платформы тянет внешний PPA, который недоступен с этих машин —

деплой падает. Поэтому RUNTIME=static и системный Python: так работает стабильно.

• Настройки бота на линии Битрикс24 принимает только пакетом (все поля разом). По одному —

отвечает «сохранено» и молча игнорирует.

• Привязка пунктов меню возможна только от имени пользователя портала: нужен OAuth-токен,

он живёт 24 часа и не продлевается. Персональным ключом плейсменты не привязать.

• Пункт меню всегда открывает адрес самого OAuth-приложения. Свой handler в запросе

привязки Битрикс не использует — он проксирует через bitrix-handler на appUrl приложения.

Поэтому на каждое решение нужно своё OAuth-приложение: одно на «Горячую воду», другое на

«Шумный корпус». Если привязать оба пункта к одному приложению, второй пункт будет открывать

первое решение (наступили на это 04.08.2026).

• Из облака Битрикса нет доступа к api.telegram.org — прямой запрос отваливается по

таймауту, поэтому Telegram-бот на сервере приложения сам по себе не поднимается. Решается

двумя способами: либо канал Telegram подключается штатным коннектором к Открытой линии

(трафик идёт через инфраструктуру Битрикса), либо запросы бота проксируются через сервер

исполнителя — переменная TELEGRAM_API указывает на прокси вместо api.telegram.org.

Сейчас включён второй вариант.

• Один токен бота — один экземпляр. Если приложение поднято и на боевом контуре, и на

демо-стенде с тем же токеном, Telegram отдаёт Conflict: terminated by other getUpdates.

Держите TG_ENABLED=1 только там, где бот должен работать.

• Многое из настроек менять кодом не нужно — см. вкладку «Настройки» в кабинете.

11.5. Кто имеет доступ

К приложению (кабинет управляющего, левое меню)

Политика — «только названные пользователи». Сейчас в списке:

Тот же состав, что и у «Горячей воды».

К данным броней

• В приложении — только перечисленные выше.
• В CRM — все, у кого есть права на воронку «Шумный корпус» (см. ниже).
• Публичный календарь персональных данных не содержит: только «свободно / занято».

11.6. Как выдать доступ к приложению

Через интерфейс VibeCode: кабинет платформы → приложение «Шумный корпус» → «Доступ» →

добавить сотрудника.

Через API (быстрее, если сотрудников несколько):

SRV=7b2a7daa-cf2c-4594-9244-2a7698cebf9f
# найти пользователя портала
curl -H "X-Api-Key: $VIBE_API_KEY" ".../v1/infra/servers/$SRV/b24-users?search=Иванов"
# выдать доступ
curl -X POST -H "X-Api-Key: $VIBE_API_KEY" -H "Content-Type: application/json" \
  -d '{"type":"user","userId":"243","userName":"Иванов Иван"}' \
  "https://vibecode.bitrix24.tech/v1/infra/servers/$SRV/access"
# посмотреть список
curl -H "X-Api-Key: $VIBE_API_KEY" ".../v1/infra/servers/$SRV/access"

Убрать доступ — DELETE .../access/<id записи>.

11.7. Как выдать права на воронку «Шумный корпус»

Права CRM выдаются только руками в интерфейсе — API для этого у платформы нет.

1. CRM → «Настройки» (шестерёнка) → «Права доступа» → «Сделки».
2. Выбрать роль сотрудника (или создать новую, например «Сервис-координатор»).
3. В строке роли открыть воронку «Шумный корпус» и задать права:
• сервис-координатору: чтение, изменение, добавление — по всем сделкам воронки;
• администратору на входе: достаточно чтения и изменения;
• остальным сотрудникам воронку можно не открывать.
1. Сохранить и проверить: зайти под сотрудником, открыть CRM → воронка должна быть видна.

Если у сотрудника нет прав на воронку, брони в CRM он не увидит, но кабинет приложения

работать будет — это разные системы прав.

11.8. Как подключить мессенджер кампуса

1. Создать бота в Telegram (BotFather) и получить токен.
2. Битрикс24 → Контакт-центр → Telegram → указать токен → выбрать линию «Шумный корпус».
3. Проверить: написать боту с личного аккаунта — диалог появится в линии, бот ответит.

Наш тестовый бот @UKMiraTest_bot на время обкатки работает параллельно, в демо-контуре.

11.8а. Почему приложение иногда «просыпается» и что с этим сделано

Приложение живёт на тарифе bc-agent — он вытесняемый: облако принудительно перезапускает

такую машину примерно раз в сутки, с коротким окном недоступности. В этот момент Битрикс24 может

показать «Ошибка при показе приложения» — достаточно обновить страницу через минуту.

Что настроено, чтобы это почти не мешало:

• Авто-сон по бездействию отключён — сама платформа приложение не усыпляет.
• Три окна пробуждения по расписанию: 07:00, 12:00 и 18:00 по Москве — к рабочим часам

машина поднята.

• Сторож на нашем сервере: каждые 5 минут проверяет состояние и, если приложение уснуло,

сразу будит его, не дожидаясь, пока сотрудник наткнётся на ошибку. Лог —

/var/log/shumny-keepawake.log на сервере исполнителя.

Если нужна работа без единого перерыва — переходим на невытесняемый тариф bc-small

(2 ядра / 2 ГБ, 1200 ₽/мес вместо 300 ₽/мес). Там принудительных перезапусков нет вообще.

Решение за кампусом: разница 900 ₽/мес.

11.9. Что делать, если что-то сломалось

Симптом	Что проверить
«Ошибка при показе приложения»	Машина перезапускается облаком (см. 11.8а). Обновите страницу через минуту — сторож будит её автоматически
Бот молчит	Приложение запущено? (страница /health) Линия активна, бот включён на линии?
Кабинет не открывается	Ссылка с ключом доступа; сотрудник в списке доступа приложения
Брони не попадают в CRM	Ключ портала не истёк; воронка 9 на месте; поля сделки не удалены
Календарь пустой	Проверить пространства и расписание во вкладке «Настройки»
Слот занят «навсегда»	Скорее всего висит удержание — оно снимается автоматически, максимум 15 минут

Логи приложения — на сервере (/var/log службы shumny) и в кабинете платформы VibeCode.

Журнал действий сотрудников — вкладка «Журнал» в кабинете.

11.10. Резервные копии и восстановление

• Код — снимки на платформе при каждом деплое плюс рабочая копия у исполнителя.
• Данные броней — файл /var/lib/booking/booking.db на сервере приложения; переживает

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

• CRM — данные в Битрикс24, восстановление через корзину CRM (в API корзины нет).

Практика: перед крупной правкой снимаем копию базы и делаем деплой; при проблеме

возвращаем предыдущий снимок кода.

---

12. Уведомления координаторам и распределение заявок

Кто первым взял заявку — тот её и ведёт. Никаких графиков смен, замен и больничных

система не учитывает: она просто показывает заявку всем и запоминает, кто откликнулся.

12.1. Как это работает

1. Резидент отправил заявку → в общий чат координаторов приходит карточка: пространство,

дата и время, ФИО резидента с корпусом и комнатой, активность, число участников, комментарий.

1. Кто первым нажал «Подтвердить» в кабинете — за тем закрепляется сделка в CRM. В чат

уходит сообщение: «Бронь №N взял в работу такой-то». Дальше он ведёт резидента.

1. Через час без решения — в чат приходит напоминание, что заявка ждёт.
2. Ещё через 30 минут — сделка автоматически назначается на администратора СПиР,

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

1. Администратор СПиР подтверждает её и при необходимости передаёт сделку координатору —

обычной сменой ответственного в карточке сделки.

Пороги (час и 30 минут) меняются в кабинете, вкладка «Настройки».

12.2. Ответственный за сделку

Когда	Кто ответственный
Заявка только создана	Робот Шумный корпус — служебный пользователь портала
Координатор подтвердил	Тот, кто нажал «Подтвердить»
Сработала эскалация	Администратор СПиР из настроек

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

чужие карточки в свою воронку.

12.3. Чат координаторов

Сейчас подключён чат в Telegram — тот, куда добавлен бот бронирования.

Как подключить или сменить чат: добавьте бота в нужный чат и напишите там команду

/start@имя_бота. Бот ответит, что чат подключён, и запомнит его. Команда /chatid покажет

идентификатор текущего чата.

Кроме Telegram поддерживаются ещё два канала — включаются в «Настройках» независимо,

можно использовать сразу несколько:

Канал	Что нужно указать
Telegram	id чата (заполняется автоматически по команде выше)
Чат Битрикс24	id чата портала — бот пишет туда как обычный участник
MAX	токен бота MAX и id чата

12.4. Настройки, которые к этому относятся

Настройка	Значение
Чат координаторов: Telegram / Битрикс24 / MAX	куда слать уведомления
Токен бота MAX	нужен только для канала MAX
Напомнить в чат через, мин	по умолчанию 60
Назначить админа СПиР ещё через, мин	по умолчанию 30
Администратор СПиР (id)	на кого назначать просроченные заявки
Ответственный в CRM (id)	кто владеет заявкой до подтверждения — по умолчанию робот

12.5. Срочные заявки

Если резидент записался незадолго до начала слота, заявка помечается в чате как срочная

и не отклоняется автоматически: у координатора просто не было времени её посмотреть, и отказ

за это был бы несправедлив.

Автоматически снимаются только те заявки, которые пролежали без решения дольше порога, —

чтобы слот вернулся другим резидентам, а не сгорел. Резидент получает уведомление с причиной.

12.6. Что видит резидент

• заявка отправлена — «ждите подтверждения, приходить рано»;
• подтверждена — код на вход и памятка;
• отклонена — причина от координатора и предложение выбрать другое время;
• снята автоматически — извинение и предложение выбрать другое время.

12.7. Если уведомления не приходят

1. Проверьте, что бот всё ещё состоит в чате и не был из него удалён.
2. Напишите в чате /chatid и сверьте идентификатор с полем в «Настройках».
3. Проверьте, что заявка действительно создана — она видна во вкладке «Заявки».
4. Если чат сменили — просто напишите /start@имя_бота в новом, старый отключится сам.

---

Вопросы и правки — исполнителю: Тюнинг бизнеса, biztune.ru