Техническое задание

1. О проекте

Telegram-бот записи на услуги для сети студий. Сейчас запись идёт через администратора в мессенджере: он вручную смотрит расписание, подтверждает время и напоминает клиенту накануне. В пик администратор не успевает отвечать, и часть записей теряется.

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

2. Целевая аудитория и сценарии использования

Пользователи: клиенты студий (в основном постоянные) и администраторы.

• Клиент открывает бота → выбирает услугу и мастера → видит свободные слоты на неделю → подтверждает запись и получает подтверждение в чат.
• Клиент за день до визита получает напоминание с кнопками «приду» и «перенести».
• Клиент переносит визит сам: бот показывает ближайшие свободные окна.
• Администратор получает уведомление о новой записи и видит день в веб-интерфейсе.

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

• Запись на услугу. Выбор филиала, услуги, мастера и слота; отображение длительности и цены.
• Расписание и занятость. Слоты формируются из графика мастеров и уже занятого времени, буфер между визитами.
• Напоминания. За сутки и за два часа до визита, с подтверждением или переносом одной кнопкой.
• Отмена и перенос. Правила: бесплатно не позже чем за N часов, иначе уведомление администратору.
• История визитов и повтор прошлой записи в одно нажатие.
• Уведомления администратору о новых записях, отменах и переносах.
• Веб-панель администратора. День и неделя, ручная запись, блокировка слотов, справочник услуг и мастеров.

4. Интеграции

• Telegram Bot API — сам бот и клавиатуры; при росте сценариев — Mini App с календарём.
• CRM студии — синхронизация записей в обе стороны, чтобы администратор работал в привычном интерфейсе.
• Платёжный сервис (опционально) — предоплата для услуг с высокой долей неявок.

5. Рекомендуемый стек

• Laravel + Telegram Bot API — сценарии диалога и правила расписания живут на сервере, бот остаётся тонким.
• PostgreSQL — расписание с проверкой пересечений слотов на уровне базы.
• Очереди и планировщик — напоминания отправляются задачами по расписанию, а не по крону «раз в час на всех».

6. Этапы работ

1. Аналитика (1 неделя). Результат: карта диалога, правила расписания, переносов и отмен.
2. Каркас бота и расписание (2 недели). Результат: запись на тестовых данных со всеми проверками занятости.
3. Напоминания и перенос (1–2 недели). Результат: полный цикл визита от записи до отметки о явке.
4. Панель администратора (1–2 недели). Результат: рабочее место администратора вместо таблицы.
5. Пилот в одном филиале (1–2 недели). Результат: две недели работы, правки по обратной связи, подключение остальных филиалов.

7. Что не входит в первую версию

• Онлайн-оплата — подключаем после того, как станет видна доля неявок.
• Программа лояльности и бонусные баллы.
• Mini App с визуальным календарём — на старте хватает кнопок в чате.

8. Открытые вопросы к клиенту

• Какая CRM используется в студиях и есть ли к ней доступ по API?
• Сколько филиалов и мастеров в первой версии?
• Как считается длительность услуги: фиксированно или зависит от мастера?
• Кто ведёт справочник услуг и цен после запуска?