Каталог типовых вопросов и решений

Практические запросы владельца клуба к ИИ после подключения MCP-коннектора Fitness365: что спросить, какие методы будут вызваны, как ИИ обработает данные и что получится.

Как пользоваться

  • Скопируйте запрос в ИИ (кнопка «Копировать») и подставьте свои период, филиал или сотрудника.
  • Примеры результатов получены на тестовом клубе за неделю 24–30 августа 2026. Цифры показывают формат ответа, а не показатели вашего клуба.
  • ИИ должен каждый раз называть, что именно он посчитал (уникальные клиенты, записи, продажи, оплата) и какие допущения сделал. Если данных не хватает, он обязан сообщить об этом.
  • Методы описаны в справке для разработчиков: параметры, формат ответа, ошибки.
  • Максимальный период одного запроса — 3 месяца; для длинных периодов ИИ делает несколько запросов.
  • Данные о клиентах и зарплатах сотрудников — персональные: не пересылайте их без необходимости.

Расписание и записи

Расписание (занятия), записи клиентов и посещения — три разные сущности. Занятие бывает пустым, запись может не закончиться приходом, а клиент может прийти без записи.

Кто записан на тренировки сегодня?

Задача

Увидеть, какие занятия есть сегодня и кто на них записан.

Как спросить у ИИ

Кто записан на тренировки сегодня? Покажи по занятиям: время, название, тренер и список клиентов.

Какие методы MCP нужны

training_events_list training_event_participants reserves_list

Как ИИ получает и обрабатывает данные

  1. training_events_list за «сегодня» даёт занятия расписания (eventId, время, тренер, вместимость, сколько записано).
  2. Для каждого занятия, где записано больше нуля, ИИ вызывает training_event_participants и получает клиентов и статусы записей. Если занятий много, удобнее один вызов reserves_list за сегодня: он отдаёт все записи построчно.
  3. ИИ группирует записи по занятиям и выводит список.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. На сегодня (28 октября) занятий в расписании нет, ИИ отвечает «сегодня тренировок нет». Для примера взят вторник 25 августа: 19 занятий.

ВремяЗанятиеТренерМестЗаписано
08:00–08:30Гимнастика дети (индивидуальная)не указан201
09:00–10:00Пилатес (групповая)Люба С.1000
09:00–10:00Аренда (индивидуальная)не указан21

Записанные на «Гимнастика дети» (training_event_participants, eventId 23672): 1 запись, статус «Ожидает», клиент без имени в карточке.

Ограничения и уточнения

  • Статус «Ожидает» значит «запись есть, посещение ещё не отмечено». У прошедших занятий он остаётся таким же, если администратор не отметил приход.
  • reserves_list выдаёт ФИО клиентов полностью (это персональные данные), training_event_participants — имя и инициал фамилии. Не пересылайте списки дальше без необходимости.
  • Если клуб с несколькими филиалами, уточните филиал (get_branches), иначе будет весь клуб.

Сколько тренировок запланировано на сегодня?

Задача

Узнать число занятий в расписании на день или на период.

Как спросить у ИИ

Сколько тренировок запланировано на сегодня? Раздели на групповые и индивидуальные.

Какие методы MCP нужны

trainings_summary schedule_load training_events_list

Как ИИ получает и обрабатывает данные

  1. trainings_summary за «сегодня» возвращает блок events: сколько занятий запланировано, отменено, групповых и индивидуальных.
  2. Для вопроса «какие именно» ИИ добавляет training_events_list.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. Сегодня занятий 0. За неделю 24–30 августа 2026:

ПоказательЗначение
Занятий в расписании56
Групповых42
Индивидуальных14
Отменено0

Ограничения и уточнения

  • Это занятия расписания, а не посещения и не записи клиентов (в сводке это три разных блока). Клиентов на них пока не считаем.
  • В сводке «запланировано» и «проведено» рядом: факт проведения занятия по этим данным не проверяется, ИИ не должен утверждать больше.

Какие группы или тренировки заполнены не полностью?

Задача

Найти занятия со свободными местами и оценить загрузку расписания.

Как спросить у ИИ

Какие групповые занятия на этой неделе заполнены меньше чем на 50 %? Покажи загрузку по дням и по тренерам.

Какие методы MCP нужны

schedule_load training_events_list

Как ИИ получает и обрабатывает данные

  1. schedule_load за неделю: вместимость, записано, свободно и загрузка в % — общая, по дням и по тренерам.
  2. Для списка конкретных занятий ИИ берёт training_events_list (type=group) и по полям capacity, reserved, freePlaces отбирает те, где загрузка ниже порога.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ДеньЗанятийМестЗаписаноЗагрузка
Пн 24.0820342308,8 %
Вт 25.081938792,3 %
Ср 26.0836035 %
Чт 27.0836023,3 %
Пт 28.08916674,2 %
Всего за неделю561055535,0 %

Пример занятия: «Пилатес» 25.08, 09:00, вместимость 100, записано 0.

Ограничения и уточнения

  • «Заполнено не полностью» нужно определить: ИИ должен спросить порог (например, меньше 50 %) или показать всё как есть.
  • В загрузку попадают только занятия с заданной вместимостью; отменённые не считаются.
  • Записанные места берутся из счётчиков занятия, записи со статусом «Отменена» в них не входят.

Какие клиенты записались, но отменили запись?

Задача

Получить список отменённых записей: кто и на какие занятия.

Как спросить у ИИ

Какие клиенты записались на тренировки за последний месяц и отменили запись? Покажи клиента, занятие и время занятия.

Какие методы MCP нужны

reserves_list trainings_summary

Как ИИ получает и обрабатывает данные

  1. reserves_list с status=canceled за нужный период возвращает построчно записи: клиент, услуга, занятие, тренер, время.
  2. trainings_summary показывает общее число отмен за тот же период и сравнивает с числом записей.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: за последние 92 дня записей со статусом «Отменена» нет (всего 569 записей: 543 ожидают, 26 посетили, 0 пропустили, 0 отменено). Правильный ответ ИИ: «отмен записи не найдено».

Ограничения и уточнения

  • Показывается статус записи на момент запроса. Времени отмены в ответе нет.
  • Отменённое занятие (eventCancelled) и отмена записи клиентом — разные вещи; ИИ должен их не путать.
  • ФИО клиентов в reserves_list выдаются полностью.

Загрузка расписания по тренерам

Задача

Понять, у каких тренеров занятия пустуют.

Как спросить у ИИ

Покажи загрузку занятий по тренерам за прошлую неделю: сколько занятий и какой процент мест занят.

Какие методы MCP нужны

schedule_load staff_list

Как ИИ получает и обрабатывает данные

  1. schedule_load возвращает блок byTrainer со числом занятий, вместимостью и загрузкой на каждого тренера.
  2. При необходимости ИИ сверяет имена с staff_list.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ТренерЗанятийМестЗаписаноЗагрузка
не указан14234146,0 %
Андрей П.612000 %
Олеся С.54012,5 %

Ограничения и уточнения

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

Посещаемость

Перед ответом ИИ должен назвать, что именно он считает. «Посещения», «уникальные клиенты», «записи» и «проходы СКУД» — разные показатели, и их нельзя подменять друг другом.

Что считается в каждом показателе

ПоказательЧто это в данныхГде берётся
Посещения клиентовВизиты клиентов в клуб (Visit), посещения сотрудников не входят. Каждый приход — одно посещениеvisits_summary, visits_list
Уникальные клиентыСколько разных клиентов совершили хотя бы одно посещение за периодvisits_summary (uniqueVisitors)
Посещения тренировокПосещения, привязанные к занятию расписания или к списанной услуге у тренераtrainings_summary, visits_statistics_by_trainer
Записи на тренировкиЗапись клиента на занятие (Reserve) со статусом: ожидает, посетил, пропустил, отмененаreserves_list, trainings_summary
Проходы через СКУДСырые события турникета отдельно не выдаются. Посещение клуба фиксируется как визит; учитывайте, что один визит и один проход не всегда равнынет отдельного метода

Сколько уникальных клиентов посетили клуб сегодня?

Задача

Узнать, сколько разных клиентов были в клубе за день.

Что именно считаем. Здесь считаются визиты клиентов и уникальные клиенты. Записи на тренировки и проходы СКУД — другие показатели.

Как спросить у ИИ

Сколько уникальных клиентов посетили клуб сегодня и сколько всего было посещений?

Какие методы MCP нужны

visits_summary visits_current_in_club

Как ИИ получает и обрабатывает данные

  1. visits_summary за «сегодня»: число посещений и uniqueVisitors.
  2. Если нужно «кто в клубе прямо сейчас», ИИ добавляет visits_current_in_club.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. Сегодня (28 октября) посещений 0, уникальных 0. Для примера один из дней недели 24–30 августа 2026: 21 посещение, 6 уникальных клиентов (см. следующий сценарий).

Ограничения и уточнения

  • Уникальный клиент считается один раз за период, а посещений у него может быть несколько.
  • Если данных на сегодня нет, а клуб работает, стоит проверить, фиксируются ли визиты (интеграция со СКУД или ручная регистрация).

Сколько посещений было за неделю?

Задача

Посчитать посещения за неделю и сравнить с предыдущей.

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

Как спросить у ИИ

Сколько посещений было на прошлой неделе и сколько уникальных клиентов? Сравни с позапрошлой.

Какие методы MCP нужны

visits_summary visits_dynamics

Как ИИ получает и обрабатывает данные

  1. visits_summary с period=last_week и compare=true возвращает значения и изменение к предыдущему периоду.
  2. Для графика по дням ИИ добавляет visits_dynamics.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Показатель24–30.0817–23.08Изменение
Посещения2113+8 (+61,5 %)
Уникальные клиенты68−2 (−25 %)

Посещений стало больше, а уникальных клиентов меньше: клиенты приходили чаще, но их стало меньше. ИИ должен показывать оба числа и не называть рост «ростом аудитории».

Ограничения и уточнения

  • Период не завершён — ИИ предупреждает, что данные на текущий момент.
  • Максимальный период в одном запросе — 3 месяца.

Какова посещаемость по тренерам за неделю?

Задача

Увидеть, у каких тренеров больше клиентов.

Что именно считаем. Посещения клиентов с указанным тренером визита. Не записи на занятия и не проведённые занятия.

Как спросить у ИИ

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

Какие методы MCP нужны

visits_statistics_by_trainer staff_list trainers_popularity

Как ИИ получает и обрабатывает данные

  1. visits_statistics_by_trainer за неделю: число визитов и уникальных клиентов по тренерам, плюс визиты без тренера.
  2. Для статистики по записям на занятия расписания ИИ использует trainers_popularity и отдельно подписывает, что это записи, а не посещения.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. Всего 21 посещение, у 8 указан тренер, у 13 — не указан.

ТренерПосещенийУникальных клиентовДоля
Козачук София219,5 %
Петров Андрей114,8 %
Савченко Олеся114,8 %
Ивченко Светлана114,8 %
Петров Алексей3114,3 %

Ограничения и уточнения

  • Считаются посещения, у которых указан тренер визита (Visit.Executor); 13 из 21 посещений без тренера. Это не то же самое, что тренировки с записью.
  • Если нужно количество проведённых занятий и сумму по ним, берите staff_trainings и staff_attendances (раздел «Зарплата»).

Сколько записавшихся клиентов не пришли на тренировку?

Задача

Оценить долю неявок: записались, но не пришли.

Что именно считаем. Записи на тренировки (Reserve) со статусом «Пропустил» против «Посетил». Общие посещения клуба и СКУД сюда не входят.

Как спросить у ИИ

Сколько клиентов записались на тренировки на прошлой неделе и не пришли? Какой процент неявок?

Какие методы MCP нужны

trainings_summary reserves_list

Как ИИ получает и обрабатывает данные

  1. trainings_summary возвращает записи по статусам (ожидает, посетил, пропустил, отменена) и noShowPercent.
  2. Для списка клиентов-«прогульщиков» ИИ вызывает reserves_list с status=missed.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Статус записиЗаписей
Ожидает50
Посетил3
Пропустил0
Отменена0
Всего53

Доля неявок: 0 %. Но 50 записей прошедших занятий остались в статусе «Ожидает», то есть приход не отмечен. Правильный ответ ИИ: «явных неявок нет, но по 50 записям статус не проставлен, оценить неявки нельзя».

Ограничения и уточнения

  • Неявкой система считает только статус «Пропустил». Если администраторы не отмечают приход, неявок в данных не будет, и ИИ должен предупредить об этом.
  • noShowPercent = пропустили / (посетили + пропустили); ожидающие записи не входят.
  • ФИО клиентов в reserves_list выдаются полностью.

В какие дни и часы клуб загружен больше всего?

Задача

Найти пиковые дни недели и часы, чтобы планировать персонал и расписание.

Что именно считаем. Посещения клиентов по времени начала визита.

Как спросить у ИИ

В какие дни недели и в какие часы в клубе больше всего посетителей за последние две недели?

Какие методы MCP нужны

visits_by_weekday_hour

Как ИИ получает и обрабатывает данные

  1. visits_by_weekday_hour за период: посещения по дням недели и часам начала, пиковый день и час пик.
  2. ИИ строит короткий вывод и таблицу.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: 17–30 августа, 34 посещения.

ДеньПосещенийВ среднем за день
Пятница189
Среда52,5
Понедельник42
Четверг31,5
Суббота21
Вторник10,5
Воскресенье10,5

Пик: пятница, час пик 22:00 (9 посещений).

Ограничения и уточнения

  • Час — это час начала посещения, а не время нахождения в клубе. Для длительности используйте visits_average_duration.

Динамика посещений по неделям

Задача

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

Что именно считаем. Посещения клиентов по неделям (с понедельника).

Как спросить у ИИ

Покажи динамику посещений по неделям за последние три месяца.

Какие методы MCP нужны

visits_dynamics

Как ИИ получает и обрабатывает данные

  1. visits_dynamics с granularity=week за последние 92 дня возвращает ряд «неделя — число посещений».

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: 92 дня, 53 посещения.

Неделя сПосещений
27.076
03.083
10.085
17.0813
24.0821
31.082
07.09 – 26.100–2 в неделю

Ограничения и уточнения

  • Максимум 3 месяца за запрос; для более длинного периода ИИ делает несколько запросов и склеивает.

Кто сейчас в клубе?

Задача

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

Что именно считаем. Клиенты с открытым визитом за последние 24 часа.

Как спросить у ИИ

Сколько клиентов сейчас в клубе?

Какие методы MCP нужны

visits_current_in_club

Как ИИ получает и обрабатывает данные

  1. visits_current_in_club считает клиентов с открытым визитом, начатым не более 24 часов назад.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: сейчас в клубе 0 клиентов; ещё 1 визит открыт больше суток назад (не закрыт при выходе).

Ограничения и уточнения

  • Если выход не отмечается, открытые визиты «висят». Старше 24 часов они выводятся отдельно и в число «сейчас» не входят.

Сколько человек сходили на пробную и сколько купили абонемент?

Задача

Оценить конверсию пробных посещений в покупки.

Что именно считаем. Клиенты с пробным посещением и покупкой абонемента или клубной карты после него.

Как спросить у ИИ

Сколько клиентов пришли на пробную тренировку за последние три месяца и сколько из них потом купили абонемент или клубную карту?

Какие методы MCP нужны

trials_conversion trials_list

Как ИИ получает и обрабатывает данные

  1. trials_conversion за период: клиенты на пробных, купившие после пробного, процент, разрез по пробным услугам.
  2. Кто именно не купил — trials_list с converted=false.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: за 92 дня 1 клиент на пробной услуге «Пробная», 0 купили, конверсия 0 %.

Ограничения и уточнения

  • Покупка может быть позже конца периода: смотрится состояние на сейчас.
  • Выборка маленькая (1 клиент): процент без числа клиентов не показывать.

Финансы

Продажи, начисления и фактические поступления — три разных числа. В каждом ответе ИИ должен назвать источник и определение выручки.

Определения

ПонятиеЧто это в данныхГде берётся
ПродажаПроведённая покупка клиента (Sale). В продаже может быть несколько позиций (SaleItem)sales_summary (value)
Выручка (оборот) по продажамСумма проведённых продаж после скидок. Не равна деньгам, полученным в кассеsales_summary (salesAmount)
Фактическая оплатаНаличные + карта + безнал − сдача по проведённым продажам. Покупки в кредит, оплаченные бонусами и с депозита сюда не входятsales_summary (paidAmount)
НачисленияПлатежи по подпискам: ожидаемые списания и проведённые продленияsubscriptions_summary, subscriptions_payments
ВозвратыВозвраты покупателям и продажи, отменённые со статусом «Возврат». Выручка нетто не вычисляется, возвраты показываются отдельноsales_returns

Какая выручка клуба сегодня?

Задача

Получить выручку за текущий день.

Что именно считаем. Выручка по продажам (сумма проведённых продаж после скидок). Если вопрос о деньгах в кассе — смотрите paidAmount и способы оплаты.

Как спросить у ИИ

Какая выручка клуба сегодня? Укажи сумму продаж, сколько реально оплачено и средний чек.

Какие методы MCP нужны

sales_summary

Как ИИ получает и обрабатывает данные

  1. sales_summary за «сегодня»: число продаж, сумма после скидок, фактическая оплата, оплата депозитом и бонусами, средний чек и возвраты.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. Сегодня (28 октября) продаж 0, сумма 0, оплачено 0, возвратов нет. ИИ отвечает «сегодня продаж не было».

Ограничения и уточнения

  • День не закончен: данные на текущий момент.
  • Выручка здесь — сумма проведённых продаж после скидок. Это не кассовый отчёт.

Какова выручка за неделю или месяц?

Задача

Узнать выручку за период и сравнить с предыдущим.

Что именно считаем. Выручка по продажам (после скидок) и фактическая оплата показаны рядом, но это разные суммы.

Как спросить у ИИ

Какая выручка была на прошлой неделе и в прошлом месяце? Сравни с предыдущим периодом.

Какие методы MCP нужны

sales_summary sales_dynamics

Как ИИ получает и обрабатывает данные

  1. sales_summary с compare=true за неделю или месяц.
  2. Для динамики по дням или неделям ИИ добавляет sales_dynamics.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Показатель24–30.0817–23.08Изменение
Продаж188+10 (+125 %)
Сумма продаж (выручка)438 920123 855+315 065 (+254 %)
Фактически оплачено438 920123 855+315 065
Средний чек24 384,4415 481,88+57,5 %
Возвраты0

Ограничения и уточнения

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

Динамика выручки по неделям

Задача

Увидеть, как менялись продажи.

Что именно считаем. Сумма проведённых продаж по неделям.

Как спросить у ИИ

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

Какие методы MCP нужны

sales_dynamics

Как ИИ получает и обрабатывает данные

  1. sales_dynamics с granularity=week за 92 дня.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: за 92 дня 40 продаж на 614 475.

Неделя сПродажСумма
27.07328 100
10.0822 200
17.088123 855
24.0818438 920
28.0914 000
12.1014 500
19.10612 900

Ограничения и уточнения

  • Недели без продаж показываются нулями; в примере пропущены.

Сколько продаж и оплат зарегистрировано за период?

Задача

Различить число продаж, позиций и оплат.

Что именно считаем. Продажи (документы) и их способ оплаты. Позиции продаж и кассовые чеки считаются отдельно.

Как спросить у ИИ

Сколько продаж и сколько оплат было за неделю? Раздели оплаты по способам.

Какие методы MCP нужны

sales_summary sales_by_payment_type staff_sales

Как ИИ получает и обрабатывает данные

  1. sales_summary даёт число продаж и фактическую оплату.
  2. sales_by_payment_type раскладывает продажи по основному способу оплаты.
  3. Если нужны позиции, ИИ берёт sales_list или staff_sales (там одна строка на позицию).

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Способ оплатыПродажСуммаДоля
Наличные10320 00055,6 %
Карта8118 92044,4 %
В кредит00
Всего18438 920100 %

В тех же продажах 21 позиция (staff_sales): одна продажа может содержать несколько позиций.

Ограничения и уточнения

  • «Оплат» как отдельных платёжных документов (кассовых чеков) инструменты не выдают. Есть продажи и их способы оплаты.
  • Способ оплаты продажи основной; комбинированная оплата отмечена отдельным типом.

Как соотносятся продажи, начисления и фактические платежи?

Задача

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

Что именно считаем. Три разных вещи: продажи (оборот после скидок), начисления (ожидаемые платежи по подпискам) и фактическая оплата (paidAmount). Их нельзя складывать и называть выручкой одним числом.

Как спросить у ИИ

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

Какие методы MCP нужны

sales_summary sales_by_payment_type subscriptions_summary subscriptions_payments

Как ИИ получает и обрабатывает данные

  1. sales_summary: сумма продаж и paidAmount.
  2. sales_by_payment_type: продажи в кредит и непогашенный остаток.
  3. subscriptions_summary и subscriptions_payments: ожидаемые списания по подпискам и проведённые продления.
  4. ИИ выводит три блока отдельно и не складывает их.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ИсточникПоказательЗначение
ПродажиСумма проведённых продаж (после скидок)438 920
Фактическая оплатаНаличные + карта + безнал − сдача438 920
КредитПродаж в кредит; непогашенный остаток0; 0
Подписки (начисления)Ожидает списания (1 активная подписка)25 000
Подписки (проведено)Продлений за 92 дня0

За неделю продажи и фактическая оплата сходятся: кредитов нет, оплата наличными и картой. 25 000 по подписке — это только ожидаемый платёж, а не поступление.

Ограничения и уточнения

  • Данные о реально полученных деньгах по кассовым документам, банковским выпискам и эквайрингу в инструментах отсутствуют: paidAmount выводится из самих продаж.
  • Непогашенный остаток по кредитным продажам показывает sales_by_payment_type (credit.outstandingRest); это отдельная цифра, к фактической оплате она не добавляется.
  • Если ИИ не может провести сопоставление, он обязан сказать, чего не хватает, а не подбирать цифры.

Что чаще всего продаётся?

Задача

Найти самые денежные товары, услуги и абонементы.

Что именно считаем. Сумма проданных позиций после скидок.

Как спросить у ИИ

Какие продукты принесли больше всего денег на прошлой неделе?

Какие методы MCP нужны

sales_top_products sales_by_category

Как ИИ получает и обрабатывает данные

  1. sales_top_products за период; для разреза по категориям — sales_by_category.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ПродуктПроданоСумма
ПТ-103135 000
персональная3120 000
абонемент на мес + 10 ГТ575 000

Ограничения и уточнения

  • Суммы после скидок, без возвратов.

Как продают сотрудники?

Задача

Сравнить продавцов по сумме и среднему чеку.

Что именно считаем. Продажи по продавцу (кто оформил продажу).

Как спросить у ИИ

Кто из сотрудников продал больше всех на прошлой неделе? Покажи сумму и средний чек.

Какие методы MCP нужны

sales_by_employee staff_sales

Как ИИ получает и обрабатывает данные

  1. sales_by_employee: рейтинг продавцов по сумме проведённых продаж.
  2. Для построчной расшифровки одного сотрудника — staff_sales.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

СотрудникПродажСуммаСредний чек
Юлия В.18438 92024 384,44

Ограничения и уточнения

  • В рейтинге учитывается только продавец (Sale.Personal); исполнителей и рекомендателей можно получить через staff_sales.

Сколько было возвратов?

Задача

Оценить объём возвратов и отменённых продаж.

Что именно считаем. Возвраты покупателям и продажи со статусом «Возврат».

Как спросить у ИИ

Сколько возвратов было за последние три месяца и на какую сумму?

Какие методы MCP нужны

sales_returns returns_list

Как ИИ получает и обрабатывает данные

  1. sales_returns: количество и сумма возвратов покупателям и отменённых продаж. Детали — returns_list.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: за 92 дня возвратов 0, отменённых продаж 0.

Ограничения и уточнения

  • Возвраты показываются отдельно от выручки: выручка нетто не вычисляется, вычитать возвраты нужно явно.

Клиенты и абонементы

Вопросы про приток, отток и удержание клиентов.

Сколько новых клиентов пришло за неделю?

Задача

Посчитать новых клиентов и сравнить с прошлым периодом.

Что именно считаем. Новые карточки клиентов за период.

Как спросить у ИИ

Сколько новых клиентов появилось на прошлой неделе по сравнению с позапрошлой?

Какие методы MCP нужны

clients_new clients_registration_dynamics

Как ИИ получает и обрабатывает данные

  1. clients_new с compare=true; при необходимости со списком (includeList=true).

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ПериодНовых клиентов
24–30.089
17–23.083
Изменение+6 (+200 %)

Ограничения и уточнения

  • Считается дата создания карточки клиента; потенциальные клиенты (лиды) не входят.

Какие клиенты давно не ходят?

Задача

Найти клиентов с абонементом, которые перестали ходить.

Что именно считаем. Клиенты с действующим абонементом без посещений в клубе дольше порога.

Как спросить у ИИ

Какие клиенты с действующим абонементом не были в клубе больше 30 дней?

Какие методы MCP нужны

clients_inactive

Как ИИ получает и обрабатывает данные

  1. clients_inactive с inactiveDays=30: клиенты с абонементом и давностью последнего визита.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: найдено 13 клиентов, показаны первые три.

КлиентПоследний визитДней
Марина У.не было—
Первый П.не было—
Роман С.23.10.2025370

Ограничения и уточнения

  • Дата последнего посещения берётся из карточки клиента.
  • Для работы с такими клиентами можно создать задачи CRM — пишущий инструмент crm_task_create (см. раздел «Активная база, лиды и CRM»); существующие задачи показывает crm_tasks_list.

Какие абонементы скоро заканчиваются?

Задача

Увидеть, кому пора продлевать.

Что именно считаем. Окончание срока абонемента или клубной карты.

Как спросить у ИИ

Какие абонементы и клубные карты заканчиваются в ближайший месяц?

Какие методы MCP нужны

abonements_expiring abonements_low_remaining_visits

Как ИИ получает и обрабатывает данные

  1. abonements_expiring с days=30; для остатка занятий — abonements_low_remaining_visits.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

КлиентАбонементСрокОсталось
Первый П.абонемент на мес + 10 ГТ28.100 дней
Марина У.Клубная карта 12 мес01.114 дня

Ограничения и уточнения

  • Учитываются абонементы в статусе «Активна».

Какой отток: сколько абонементов не продлили?

Задача

Оценить непродление абонементов.

Что именно считаем. Непродление: у клиента нет абонемента с более поздней датой окончания.

Как спросить у ИИ

Сколько абонементов закончилось за три месяца и сколько клиентов их не продлили?

Какие методы MCP нужны

churn_nonrenewal churn_inactivity

Как ИИ получает и обрабатывает данные

  1. churn_nonrenewal за 92 дня: закончившиеся, продлённые и не продлённые абонементы по филиалам.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ПоказательЗначение
Закончились14
Продлены6
Не продлены8
Доля непродления57,1 %

Ограничения и уточнения

  • Считаются абонементы, а не клиенты: у клиента с несколькими абонементами число повторяется.

Что с подписками?

Задача

Понять, сколько подписок и каких платежей ожидается.

Что именно считаем. Подписки по текущему статусу и ожидаемым платежам.

Как спросить у ИИ

Сколько у нас активных подписок и какая сумма списаний ожидается?

Какие методы MCP нужны

subscriptions_summary subscriptions_upcoming_payments subscriptions_list

Как ИИ получает и обрабатывает данные

  1. subscriptions_summary: подписки по статусам и ожидаемые списания. Подробности — subscriptions_upcoming_payments.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ПоказательЗначение
Активных1
Аннулирована1
Ожидает списания1 подписка на 25 000

Ограничения и уточнения

  • Даты смены статусов в БД не хранятся: показывается текущее состояние.

Насколько подписка дешевле обычной цены?

Задача

Сравнить обычную цену абонемента и платёж по подписке, увидеть фактические продажи.

Как спросить у ИИ

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

Какие методы MCP нужны

subscriptions_price_comparison

Как ИИ получает и обрабатывает данные

  1. subscriptions_price_comparison возвращает по каждому абонементу, доступному по подписке: обычную цену, платёж по подписке, разницу в деньгах и процентах и среднюю фактическую сумму позиции (без подписки, первая покупка с подпиской, продление).
  2. ИИ выводит таблицу и отдельно отмечает абонементы «только по подписке» и абонементы без разницы в цене.

Пример результата на тестовых данных

Тестовый клуб, 1 июня – 30 августа 2026.

АбонементОбычная ценаПлатёж по подпискеРазницаПродано без подписки
10 групповых занятий на 1 мес.10 0006 0004 000 (40 %)1
Занятия в группе1 000900100 (10 %)0
Абонемент 10 йога/стретчинг (только по подписке)25 00025 00002
3 мес КК101001

Ограничения и уточнения

  • Продаж с подпиской и продлений за период в тестовой базе нет, поэтому «по какой цене продлевают» ИИ ответить не сможет и должен так и сказать.
  • У абонемента с ценой по филиалам (в примере «Абонемент 10 йога/стретчинг») показана базовая цена, цены филиалов не учитываются.
  • Период для фактических продаж — до 3 месяцев.

Когда списываются деньги по подпискам?

Задача

Узнать настройки автоматической обработки подписок: когда идёт списание, когда подписка аннулируется, когда уходят уведомления.

Как спросить у ИИ

Когда у нас списываются деньги по подпискам и через сколько дней неоплаченная подписка аннулируется? Во сколько запускается обработка и когда она работала в последний раз?

Какие методы MCP нужны

subscriptions_job_settings

Как ИИ получает и обрабатывает данные

  1. subscriptions_job_settings возвращает настройки фоновой задачи клуба: сроки списания и аннулирования, параметры уведомлений, время запуска и последний запуск.
  2. ИИ переводит значения в понятные фразы и сообщает, если задача не создана (тогда подписки не оплачиваются и не аннулируются автоматически).

Пример результата на тестовых данных

Тестовый клуб, настройки на 29 октября 2026.

ПараметрЗначение
Списаниеза 10 дней до окончания оплаченного периода
Аннулирование неоплаченной подпискив день окончания периода (0 дней)
Абонементы по количеству посещенийсписание при остатке 1 посещение
Уведомление клиентуза 5 дней до списания; по количеству — при остатке 2 посещения
Время запускаежедневно в 14:00
Последний запуск31 августа 2026, статус «Завершена»

Ограничения и уточнения

  • Состояние планировщика (пауза, следующий запуск) в базе не хранится и не показывается.
  • Если последний запуск был давно, ИИ может только указать на это: причину (служба не работает или задача на паузе) по данным определить нельзя.
  • Задача общая для клуба, фильтра по филиалу нет.

Расчёт заработной платы

ИИ рассчитывает зарплату по правилу владельца клуба на данных из системы. Если данных недостаточно, он обязан сообщить об этом, а не придумывать значения.

Рассчитать зарплату каждого тренера за неделю по ставке 20 %

Задача

Посчитать начисление каждому тренеру как 20 % от стоимости проведённых им тренировок за неделю.

Что именно считаем. Тренировка здесь — посещение клиентом у тренера, цена берётся из продажи (с учётом скидки). Если нужно считать по проведённым занятиям или по прайсу, это нужно сказать явно.

Как спросить у ИИ

Рассчитай зарплату каждого тренера за прошлую неделю по ставке 20 % от стоимости проведённых тренировок. Покажи таблицу: сколько тренировок учтено, база расчёта, процент, начисление и итого. Скажи, какую цену ты взял за основу.

Какие методы MCP нужны

staff_list staff_attendances staff_trainings

Как ИИ получает и обрабатывает данные

  1. staff_attendances за неделю без staffId: в summary.byStaff по каждому тренеру число посещений и цены посещений (bySale — цена продажи, byService — до скидки).
  2. staff_trainings по каждому тренеру (staffId): сколько тренировок проведено (summary.trainings) и сколько из них учитывается (billable). Если не уточнено, ИИ берёт цену продажи и называет это в ответе.
  3. ИИ берёт только строки billable=true, считает 20 % от базы по каждому тренеру и складывает итог.
  4. Блоки unassigned (посещения без тренера) и completeness ИИ проверяет и упоминает, если они меняют сумму.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026. База — цена продажи посещений (price.bySale), учитываются проведённые посещения с ценой.

ТренерТренировокПосещенийБаза, ₽СтавкаНачислено, ₽
Козачук София7460 136,3620 %12 027,27
Петров Алексей432 280,0020 %456,00
Петров Андрей7140 000,0020 %8 000,00
Савченко Олеся6140 000,0020 %8 000,00
Ивченко Светлана21100,0020 %20,00
Итого2610142 516,3620 %28 503,27

Не вошли: 16 посещений без указанного тренера на 127 299,17 (в основном ГТ и членство по клубным картам). Платить ли за них, решает владелец клуба. Пустые занятия (без клиентов) в базу не попадают: у них нет цены посещения.

Ограничения и уточнения

  • Цену тренировки в системе не хранится: ИИ считает от цены посещений клиентов. Занятие без клиентов даёт 0 в базе.
  • Если владелец имеет в виду «стоимость тренировки по прайсу», нужно добавить price.byService или price.servicePriceList (текущий прайс, он отличается от цены продажи).
  • Три сущности нужно различать: проведено занятий (trainings), посещений клиентов (attendances) и цена посещений. ИИ должен писать, какую из них он взял за «тренировку».
  • Если summary.prices.missing > 0, у части посещений нет цены, и сумма неполная: ИИ обязан сказать об этом.
  • ФИО сотрудников и суммы зарплат — чувствительные данные, не пересылайте их дальше.

Сравнить расчёт ИИ с начислениями Fitness 365

Задача

Проверить, совпадает ли расчёт по правилу владельца с тем, что насчитала система.

Как спросить у ИИ

Сравни расчёт зарплаты Васиной за июль по правилу «5 % от продаж йоги» с тем, что насчитала система Fitness 365.

Какие методы MCP нужны

staff_sales staff_attendances payroll_sheets_list payroll_sheet_details payroll_schemes

Как ИИ получает и обрабатывает данные

  1. ИИ вызывает staff_attendances или staff_trainings с staffId: в ответе блок systemPayroll содержит листы системы за этот период и признак coversPeriod.
  2. Если листов нет, ИИ сообщает, что сравнить не с чем. При необходимости схему сотрудника и условия берёт из payroll_schemes и расшифровку листа из payroll_sheet_details.
  3. ИИ считает по правилу владельца и сопоставляет с systemPayroll, если период листа совпадает с запрошенным.

Пример результата на тестовых данных

Тестовый клуб: Васина Юлия (staffId 132). Листы системы по ней:

ЛистПериодОкладСдельная частьБазаНачисление системы
№ 5301.07–31.0718 000686,2513 725«от продаж йоги» 5 %
№ 5401.06–31.0818 0004 886,2597 725«от продаж йоги» 5 %

Листы пересекаются по датам и не совпадают с неделей 24–30 августа (coversPeriod = false), поэтому суммы напрямую сравнивать нельзя. Правильный ответ ИИ: показать оба листа, объяснить расхождение периодов и предложить пересчитать по периоду листа.

Сравнение с расчётом Fitness 365

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

Ограничения и уточнения

  • Система считает по схеме сотрудника (payroll_schemes), а не по правилу ИИ: расхождение ожидаемо.
  • Система не учитывает отмены и возвраты по посещениям, ИИ может их учитывать, если так сказал владелец.
  • Для сотрудника без листа за период (в примере большинство тренеров) блок systemPayroll пуст, сравнить не с чем.

Только от реальных денег: без кредита и бонусов

Задача

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

Что именно считаем. Реальные деньги = наличные + карта + безнал + депозит. Бонусы — не деньги; кредит — долг клиента, пока он не погашен.

Как спросить у ИИ

Посчитай зарплату Петрову Алексею за июль: 5 % от стоимости посещения, только от реальных денег. Скажи, какие типы оплаты ты учёл.

Какие методы MCP нужны

staff_attendances staff_trainings staff_sales

Как ИИ получает и обрабатывает данные

  1. staff_attendances возвращает у каждого посещения paymentShare и в summary.byPayment сумму по типам: наличные, карта, безнал, депозит, бонусы, кредит, погашенная часть кредита.
  2. ИИ выбирает типы по формулировке владельца. «Только реальные деньги» — это money; «с погашенным кредитом» — moneyWithRepaidCredit; «без бонусов, но с кредитами» — цена минус bonus.
  3. ИИ считает процент от выбранной базы и называет, какие типы оплаты учтены.

Пример результата на тестовых данных

Тестовый клуб: Петров Алексей, июль 2026, 9 посещений на «Стретчинг».

Вариант базыБаза, ₽5 %, ₽
Вся цена продажи (с кредитом)6 840,00342,00
Деньги и погашенная часть кредита6 390,00319,50
Только реальные деньги0,000,00

Все 9 посещений идут по абонементу, проданному в кредит: наличные, карта и депозит равны 0, кредит 6 840, погашено 6 390.

Ограничения и уточнения

  • Если у владельца разные правила для кредита и бонусов, он должен их назвать. ИИ не угадывает.
  • Бонусы и кредит считаются по способу оплаты проданной позиции-основания; для безналичной и комбинированной оплаты разложение приблизительное (approximate).
  • Дата поступления денег не учитывается: погашение кредита в другом месяце не переносится.
  • Посещения без продажи-основания разложить на типы оплаты нельзя.

Зарплата с учётом исключений

Задача

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

Что именно считаем. Посещение с пометкой billable и причиной исключения. Правила исключения задаёт владелец.

Как спросить у ИИ

Посчитай зарплату тренера за месяц: 20 % от цены посещений. Отменённые занятия не учитывай. Если продажу вернули, посещения до возврата оплати.

Какие методы MCP нужны

staff_attendances staff_trainings returns_list

Как ИИ получает и обрабатывает данные

  1. В staff_attendances/staff_trainings исключаемые строки не скрываются: у них billable=false и excludeReason (event_cancelled, sale_cancelled, sale_returned).
  2. ИИ суммирует только нужные строки и по summary.excluded показывает, что и на какую сумму не учтено.
  3. Для посещений до возврата ИИ смотрит saleReturn.returnedAt и attendedBeforeReturn: тренер работал, поэтому посещения по умолчанию входят в расчёт.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: исключений за неделю нет (excluded: {}), отменённых занятий и возвратов нет. Вид ответа:

"summary": { "attendances": 10, "billable": 10, "excluded": {},
  "attendedBeforeReturn": { "count": 0 }, "prices": { "bySale": 142516.36 } }

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

Ограничения и уточнения

  • Система сама возвраты и отмены по посещениям не учитывает. Это решение владельца, и ИИ должен его спрашивать.
  • Частичные возвраты по позициям в суммы не вычитаются, они помечаются (item_returned).
  • Исключения, которые модель данных не поддерживает (например, «не платить за групповые с менее чем 3 клиентами»), ИИ считает сам по строкам, если нужные поля есть.

Зарплата менеджера: процент от продаж

Задача

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

Что именно считаем. Продажи сотрудника: позиция продажи считается за сотрудником как за продавцом, исполнителем или рекомендателем.

Как спросить у ИИ

Посчитай зарплату менеджера Васиной за прошлую неделю: 5 % от всех её продаж. Покажи разбивку по видам продуктов.

Какие методы MCP нужны

staff_list staff_sales

Как ИИ получает и обрабатывает данные

  1. staff_sales с staffId и role=seller за неделю: позиции продаж сотрудника и summary.
  2. ИИ берёт summary.amount (или сумму по нужному виду продукта) и считает процент.
  3. Если владелец просит «от реальных денег», берётся summary.byPayment.money.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: Васина Юлия, 21 позиция.

Вид продуктаПозицийСумма, ₽5 %, ₽
Услуги12224 92011 246,00
Абонементы9214 00010 700,00
Итого21438 92021 946,00

Оплачено наличными 320 000 и картой 118 920, кредитов и бонусов нет, поэтому «только деньги» даёт ту же сумму.

Ограничения и уточнения

  • Если не указать роль, ИИ применяет процент к ролям «продавец» и «исполнитель позиции» и называет это.
  • Процент за рекомендацию: в тестовых данных рекомендателей нет, поэтому показать пример нельзя. Инструмент поддерживает role=recommender.
  • Возвращённые и отменённые продажи помечены, а не скрыты.

Зарплата за тренировку или за час

Задача

Посчитать фиксированную ставку за проведённое занятие или за час работы.

Что именно считаем. Тренировка — занятие расписания, визит или списание услуги у тренера; пустые занятия показаны отдельно.

Как спросить у ИИ

Посчитай тренеру Козачук за прошлую неделю: 500 рублей за каждое проведённое занятие и 300 за каждый час.

Какие методы MCP нужны

staff_trainings

Как ИИ получает и обрабатывает данные

  1. staff_trainings с staffId: число тренировок, часы и источники (занятие расписания, визит без занятия, списание).
  2. ИИ считает ставку на каждую тренировку и на часы, учитывая только billable=true.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: Козачук София, 24–30 августа: 7 тренировок (5 занятий и 2 визита без занятия), 4 часа, из них 5 пустых занятий без клиентов.

ПравилоРасчётСумма, ₽
500 за тренировку7 × 5003 500
300 за час4 × 3001 200
Итого4 700

Ограничения и уточнения

  • Нужно сказать, считать ли занятия без клиентов («пустые»): в примере их 5 из 7.
  • Часы берутся из длительности занятия; для визитов без занятия длительность может отсутствовать (trainingsWithoutDuration).

Сколько мы платим зарплату и сколько осталось выплатить?

Задача

Увидеть фонд оплаты труда за месяц по расчётным листам: из чего он состоит, сколько выплачено и какой остаток.

Как спросить у ИИ

Сколько мы начислили зарплаты за июль, сколько уже выплачено и сколько осталось? Покажи фонд по должностям и самых оплачиваемых сотрудников.

Какие методы MCP нужны

payroll_summary payroll_sheets_list

Как ИИ получает и обрабатывает данные

  1. payroll_summary за месяц: число листов и сотрудников, итог, состав (оклад, сдельная часть, премии, штрафы), выплачено и остаток, разрез по филиалам и должностям, рейтинг сотрудников.
  2. Если в ответе есть предупреждение о пересекающихся листах, ИИ сообщает о нём и при необходимости смотрит листы построчно через payroll_sheets_list.

Пример результата на тестовых данных

Тестовый клуб, июль 2026.

ПоказательЗначение
Расчётных листов / сотрудников2 / 1
Оклад36 000
Сдельная часть5 572,50
Премии и штрафы0
Итого к выплате41 572,50
Выплачено0
Остаток41 572,50
Должность «Администратор»2 листа, 41 572,50

Предупреждение в ответе: периоды двух листов одного сотрудника пересекаются, итоги суммируют оба листа, оклад может быть учтён дважды.

Ограничения и уточнения

  • Суммы считает сама система при создании листа; за период без листов зарплата не посчитана.
  • Итог листа можно поправить вручную, поэтому он может отличаться от суммы компонентов.
  • Зарплата по сотруднику — чувствительные данные: не пересылайте ответ без необходимости.

Кого оштрафовали и кому выдали премию?

Задача

Получить список штрафов и премий сотрудников за период.

Как спросить у ИИ

Кого из сотрудников оштрафовали или премировали за июль и август? Покажи дату, сумму и причину и итог по премиям и штрафам.

Какие методы MCP нужны

awards_penalties_list staff_list

Как ИИ получает и обрабатывает данные

  1. awards_penalties_list за период, при необходимости с kind (премии или штрафы) и personalId сотрудника из staff_list.
  2. ИИ выводит строки и итоги: число и сумма премий, штрафов и их разница.

Пример результата на тестовых данных

Тестовый клуб, июль – август 2026: штрафов и премий нет. Правильный ответ ИИ: «за период штрафов и премий не найдено» (итоги равны нулю).

Ограничения и уточнения

  • Суммы автоматически входят в расчётный лист периода, куда попадает дата штрафа или премии.
  • Причина — произвольный текст, который ввели в клубе; филиал определяется по сотруднику.
  • Формат строк проверен только на пустом ответе: в тестовой базе нет ни одной записи.

Клиент и клиентская база

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

Найти клиента и показать его карточку

Задача

Найти клиента по имени, телефону или e-mail и получить карточку: контакты, менеджер, тренер, долги, активный абонемент.

Как спросить у ИИ

Найди клиента Васечкин Иван и покажи его карточку: менеджер, тренер, есть ли долги и какой у него сейчас абонемент.

Какие методы MCP нужны

client_find client_details

Как ИИ получает и обрабатывает данные

  1. client_find по паре «фамилия + имя» (или телефону, e-mail, ID) возвращает clientId. Одна фамилия или одно имя не принимаются. При нескольких совпадениях ИИ должен уточнить, кого именно.
  2. client_details по clientId даёт карточку: филиал, закреплённый тренер, менеджер, ближайший платёж, долги и активная карта со статусом.

Пример результата на тестовых данных

Тестовый клуб, клиент 1482 (имя в примере сокращено).

ПолеЗначение
КлиентИван В. (clientId 1482), филиал «fitness365 Москва»
МенеджерЮлия В.
Закреплённый тренерне указан
Задолженность по кредиту / платежу0 / 0
Активная карта«абонемент на мес + 10 ГТ», статус «Активна», до 27.10.2026

Ограничения и уточнения

  • Ответ содержит персональные данные: полное ФИО, телефон, e-mail, дату рождения; в client_details также паспорт, ИНН и адрес. Не пересылайте его дальше без необходимости.
  • Если поле в карточке не заполнено (дата рождения, e-mail, паспорт), ИИ должен так и написать, а не домысливать.
  • Сотрудники этими методами не ищутся.

Что купил клиент и как часто ходит

Задача

Собрать историю клиента: действующие услуги, последние посещения и сумма покупок.

Как спросить у ИИ

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

Какие методы MCP нужны

client_find client_services client_visits client_purchases_total

Как ИИ получает и обрабатывает данные

  1. После client_find ИИ вызывает client_services с onlyCurrent=true (действующие позиции), client_visits (последние визиты) и client_purchases_total (итог покупок).
  2. Построчный список продаж клиента даёт sales_list с clientId, посещений — visits_list.

Пример результата на тестовых данных

Тестовый клуб, клиент 1482, данные на 29 октября 2026.

ПоказательЗначение
Услуг в истории8; действующие: «ПТ-10» (10 занятий, до 27.06.2027), «абонемент на мес + 10 ГТ» (остаток 5, до 27.10.2026)
Посещений за 90 дней9; последнее — 29.08.2026 («fitness365 Москва»)
Покупок за всё время6 на 195 000, средний чек 32 500
Первая и последняя покупка28.08.2026
Возвраты0

Ограничения и уточнения

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

Из кого состоит клиентская база

Задача

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

Что именно считаем. Активный клиент — с действующим абонементом или клубной картой. Клиент с долгом — с признаком просрочки платежа в карточке.

Как спросить у ИИ

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

Какие методы MCP нужны

clients_overview clients_gender_distribution clients_age_distribution

Как ИИ получает и обрабатывает данные

  1. clients_overview: всего клиентов, активные, замороженные, заблокированные, клиенты с долгом и суммы долга, активные по филиалам.
  2. clients_gender_distribution и clients_age_distribution по умолчанию считают только клиентов с действующим абонементом; для всей базы ИИ передаёт onlyActive=false.

Пример результата на тестовых данных

Тестовый клуб, данные на 29 октября 2026, вся база.

ПоказательЗначение
Клиентов всего574
Активных (действующий абонемент)14
Заблокированных5
С долгом39 (просрочка по платежам 12 597, по кредитам 204 530,50)
Пол: женщин / мужчин / не указан34 / 21 / 519
Возраст: до 18 / 18–24 / 25–34 / 35–44 / 45–54 / 55+22 / 3 / 10 / 13 / 4 / 1
Возраст не указан521 (90,8 %)

Ограничения и уточнения

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

Откуда приходят новые клиенты

Задача

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

Как спросить у ИИ

Из каких источников к нам пришли новые клиенты за последние три месяца? Покажи число и долю каждого источника.

Какие методы MCP нужны

clients_by_source clients_new

Как ИИ получает и обрабатывает данные

  1. clients_by_source за период (до 3 месяцев): число новых клиентов по каждому источнику и доля.
  2. Для общего числа новых клиентов и динамики регистраций есть clients_new и clients_registration_dynamics.

Пример результата на тестовых данных

Тестовый клуб, 1 июня – 30 августа 2026: 21 новый клиент.

ИсточникКлиентовДоля
Не указан419,0 %
Fitness365ScheduleWidget419,0 %
Виджет на сайте314,3 %
Instagram29,5 %
Telegram29,5 %
WhatsApp29,5 %
www.fitness365.ru, Мобильное приложение, От клиентов клуба, Яндекс картыпо 1по 4,8 %

Ограничения и уточнения

  • Каждый клиент учитывается по одному источнику; пустой источник показан как «Не указан».
  • Источники, которые вводят вручную, могут дублировать друг друга по смыслу (виджет на сайте и сайт): объединять их ИИ может только по вашей подсказке.

Дни рождения и самые активные покупатели

Задача

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

Как спросить у ИИ

У кого из клиентов день рождения в ближайшие 7 дней? И кто больше всех купил за прошлую неделю?

Какие методы MCP нужны

clients_birthdays clients_top_by_purchases

Как ИИ получает и обрабатывает данные

  1. clients_birthdays с dateFrom = сегодня и dateTo = +6 дней (диапазон до 31 дня).
  2. clients_top_by_purchases за неделю: рейтинг клиентов по сумме проведённых продаж.

Пример результата на тестовых данных

Тестовый клуб, дни рождения 29.10–04.11.2026; покупки 24–30 августа 2026.

Дни рождения: 1 клиент — Сергей С., 31.10 (филиал «fitness365 Санкт-Петербург»).

КлиентПокупокСумма
Иван В.6195 000
O O.155 000
Петр П.155 000
Первый П.155 000
Третий Т.155 000

Ограничения и уточнения

  • Выдаются имя и инициал фамилии, для связи с клиентом нужен clientId и client_find.
  • Рейтинг — по сумме продаж после скидок, возвраты не входят.

Кого вернуть: клиенты без действующего абонемента

Задача

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

Как спросить у ИИ

Сколько у нас клиентов, у которых раньше был абонемент, а сейчас нет действующего? Покажи первые пять и скажи, сколько карточек удалено.

Какие методы MCP нужны

clients_without_active_abonement clients_deleted

Как ИИ получает и обрабатывает данные

  1. clients_without_active_abonement: количество и постраничный список кандидатов на возврат (абонемент был, но сейчас нет действующего, замороженного или неактивированного).
  2. clients_deleted: удалённые карточки (мягкое удаление), без потенциальных клиентов; период, если задан, отбирает по дате создания карточки.

Пример результата на тестовых данных

Тестовый клуб, данные на 29 октября 2026.

ПоказательЗначение
Без действующего абонемента149 клиентов (первые: Ольга В., Александр Т., Марина З., Татьяна А., Вадим В.)
Дата последнего визита в строкахне заполнена (null) у всех пяти
Удалённых карточек335 (последняя создана 28.06.2026, «fitness365 Москва»)

Ограничения и уточнения

  • Даты удаления в системе нет — только дата создания карточки.
  • Для обзвона ИИ берёт clientId из списка и открывает client_details; задачи обзвона и их результаты — crm_tasks_list.

Должники: кому позвонить и поставить задачу

Задача

Получить список клиентов с долгом (по кредитам и по просроченной рассрочке) и поставить сотруднику задачу обзвонить их, начав с должников по кредитам.

Как спросить у ИИ

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

Какие методы MCP нужны

clients_debtors staff_list crm_task_create

Как ИИ получает и обрабатывает данные

  1. staff_list: находит сотрудника «Иванов» и его staffId.
  2. clients_debtors: список должников; кредитные идут первыми, внутри — по убыванию суммы. Для вопроса «только по кредитам» ИИ передаёт debtType=credit.
  3. crm_task_create по каждому clientId: тип «Исходящий звонок», срок — завтра, ответственный — найденный сотрудник. Задачи создаются в порядке списка, поэтому должники по кредитам получают задачи первыми.
  4. ИИ сообщает, сколько задач создано и для каких клиентов.

Пример результата на тестовых данных

Тестовая база Fit365Local, на сегодня. Имена — как в базе, показаны сокращённо.

КлиентВид долгаСумма
Арсен А.кредит (14 продаж)1000
Михаил А.кредит (13 продаж)950
Петр А.кредит (11 продаж)550
…ещё 8 клиентов с долгом по кредитуот 3 до 100
Андрей И.просрочка по рассрочке (25 платежей, самый старый 781 день)7220
Всего должников: 13кредит: 12, рассрочка: 110223

Ограничения и уточнения

  • Кредит — остаток по проведённым продажам в кредит; рассрочка — только платежи графика со сроком в прошлом, будущие не входят.
  • Если исполнитель в запросе не назван, ответственным станет менеджер клиента (так работает crm_task_create); отдельного режима «без исполнителя» пока нет.
  • Задачи создаются по одной на клиента; для большого списка ИИ делает много вызовов, поэтому стоит ограничить отбор (limit, minAmount, branchId).
  • Запись доступна только при включённой опции Mcp:EnableWrites.

Абонементы

Истёкшие, замороженные, популярные абонементы и продления. Абонемент и клиент — разные единицы: у клиента может быть несколько абонементов.

Сколько абонементов истекло и сколько заморожено

Задача

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

Как спросить у ИИ

Сколько абонементов закончилось на прошлой неделе и сколько сейчас заморожено? Покажи по филиалам.

Какие методы MCP нужны

abonements_expired abonements_frozen abonements_expiring

Как ИИ получает и обрабатывает данные

  1. abonements_expired за период: число абонементов и клубных карт, срок которых наступил, по филиалам.
  2. abonements_frozen: текущее число замороженных и уникальных клиентов.
  3. Скоро заканчивающиеся — abonements_expiring (карточка выше).

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ПоказательЗначение
Истекло за неделю2 (все — «fitness365 Москва»)
Заморожено сейчас0

Ограничения и уточнения

  • Неактивированные абонементы в «истекших» не считаются.
  • Заморозка показывается на текущий момент, истории замораживаний нет.

Какие абонементы покупают чаще и на какой срок

Задача

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

Как спросить у ИИ

Какие абонементы мы продали на прошлой неделе чаще всего? Сколько из них действует сейчас и на какой срок в среднем они выдавались?

Какие методы MCP нужны

abonements_popularity abonements_average_duration

Как ИИ получает и обрабатывает данные

  1. abonements_popularity: проданные позиции (проведённые продажи без возвратов), сумма, доля и число сейчас действующих. С byBranch=true — по филиалам.
  2. abonements_average_duration: средний срок в днях (окончание минус активация) общий и по продуктам.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Продажи за неделю

АбонементПроданоСуммаДоляДействует сейчас
абонемент на мес + 10 ГТ575 00062,5 %0
ПТ-103135 00037,5 %2
Всего8210 000100 %2

Средний срок

ПродуктАбонементовСредний срок, дней
абонемент на мес + 10 ГТ460
ПТ-103212
12 + гость140
Среднее8114,5

Ограничения и уточнения

  • Число проданных по двум инструментам может не совпадать (в примере 5 и 4 позиции «абонемент на мес + 10 ГТ»): срок считается только у абонементов с заполненными датами начала и окончания.
  • Действующие считаются на текущий момент, а не на конец периода.

Доля продлений абонементов

Задача

Понять, какая доля закончившихся абонементов была продлена, и как это менялось по месяцам.

Как спросить у ИИ

Какая доля абонементов продлевается? Сравни август с июлем и покажи динамику по месяцам за лето.

Какие методы MCP нужны

abonements_renewal abonements_renewal_dynamics churn_nonrenewal

Как ИИ получает и обрабатывает данные

  1. abonements_renewal с compare=true: закончилось, продлено, не продлено, доли и сравнение с предыдущим периодом такой же длины.
  2. abonements_renewal_dynamics: то же по календарным месяцам внутри периода (до 3 месяцев).

Пример результата на тестовых данных

Тестовый клуб, июнь – август 2026.

МесяцЗакончилосьПродленоНе продленоДоля продлений
Июнь85362,5 %
Июль3030 %
Август73442,9 %

Август к июлю: закончилось +4 (+133 %), не продлено +1 (+33 %), доля непродлений 57,1 % против 100 %.

Ограничения и уточнения

  • Считаются абонементы, а не клиенты. Абонемент продлён, если у клиента есть другой абонемент с более поздней датой окончания.
  • Месяцы с малым числом абонементов дают скачущие доли (в примере 3 абонемента в июле): ИИ должен говорить и о числах, и о процентах.

Активная база, лиды и CRM

Как менялась база клиентов с действующим абонементом, сколько лидов стало клиентами, какие задачи стоят у менеджеров и как ИИ сам создаёт задачи в CRM (пишущий инструмент crm_task_create).

Как менялась активная база клиентов

Задача

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

Как спросить у ИИ

Как изменилось число клиентов с действующим абонементом за август? Покажи по неделям и по филиалам.

Какие методы MCP нужны

churn_active_base_change active_base_dynamics

Как ИИ получает и обрабатывает данные

  1. churn_active_base_change: активные клиенты на начало и конец периода, разница и процент.
  2. active_base_dynamics: активная база на начало каждой недели (или месяца) и на конец периода, по филиалам.

Пример результата на тестовых данных

Тестовый клуб, август 2026.

ДатаАктивных клиентовМоскваБез филиала
01.081274 (+1 без данных)
03.081173 (+1)
10.081173 (+1)
17.08963
24.081494 (+1)
31.0818125 (+1)
01.0917125

За август: 12 → 17, +5 клиентов (+41,7 %).

Ограничения и уточнения

  • Активная база определяется по датам начала и окончания абонементов; заморозки, возвраты и досрочные закрытия не учитываются (истории статусов нет).
  • Филиал — это филиал продажи абонемента.
  • Это изменение базы, а не прямое число ушедших клиентов: для оттока по непродлениям см. карточку «Какой отток» и «Доля продлений абонементов».

Конверсия лидов и задачи менеджеров

Задача

Оценить, сколько лидов стало клиентами, и увидеть задачи CRM: кому позвонить и когда.

Как спросить у ИИ

Сколько лидов появилось за лето и сколько из них стали клиентами? Покажи ближайшие открытые CRM-задачи менеджеров.

Какие методы MCP нужны

leads_conversion crm_tasks_list

Как ИИ получает и обрабатывает данные

  1. leads_conversion: число лидов периода и доля тех, у кого уже создан клиент.
  2. crm_tasks_list со status=open и при необходимости managerId или clientId: задача, клиент, ответственный, срок, результат.

Пример результата на тестовых данных

Тестовый клуб, 1 июня – 30 августа 2026.

Лидов 24, конвертировано 24 (100 %). CRM-задач за период: 9. Примеры:

ТипКлиентОтветственныйСрокСтатус
Исходящий звонок: «Сервисный звонок через 7 дней после завершения карты»Иван В.Юлия В.03–05.11.2026Открыта
Напоминание: поздравить с днём рожденияАрина К.Юлия В.13–15.02.2027Открыта

Ограничения и уточнения

  • Конверсия — доля лидов периода, у которых к моменту запроса создан клиент; 100 % в тестовых данных не показатель клуба. Лиды, которые сконвертируются позже, пока не входят.
  • В реестре задач имена выдаются полностью («Фамилия Имя»); «обещанной даты покупки» в базе нет, дата следующего контакта вычисляется по следующей незавершённой задаче клиента.

Создать задачу по клиенту или лиду

Задача

Записать в CRM задачу от имени менеджера: «позвонить X числа и …» — с типом, сроком, комментарием и ответственным. Один из трёх сценариев (вместе с «Завести лида» и «Завести клиента»), где ИИ меняет данные клуба.

Как спросить у ИИ

Создай задачу по клиенту Иванову Сергею: позвонить 31 декабря, поздравить с Новым годом.

Какие методы MCP нужны

client_find crm_task_create

Как ИИ получает и обрабатывает данные

  1. client_find по фамилии и имени (или телефону): clientId. При нескольких однофамильцах — список и уточнение по дате рождения/телефону; лид ищется тем же инструментом.
  2. crm_task_create: title — суть («Позвонить 31 декабря — поздравить с Новым годом»), taskType — для звонка «Исходящий звонок», для напоминания «Напоминание», для сообщения «SMS» (по умолчанию «Задача»), startDate/endDate — дата из запроса, description — что сделать. managerId не передаётся: ответственный берётся у клиента/лида.

Пример результата на тестовых данных

Тестовый клуб, 29 октября 2026.

ПолеЗначение
Задача№ 5637, «Позвонить 31 декабря — поздравить с Новым годом»
ТипИсходящий звонок
Срок31.12.2026
СтатусОткрыта
Ответственныйзаполнен автоматически — менеджер клиента

Ограничения и уточнения

  • Нужна опция Mcp:EnableWrites (по умолчанию выключена); без неё ИИ откажется с объяснением. Включайте только на клубе, где поручают ИИ вести задачи.
  • Задача сразу видна менеджеру в CRM и в crm_tasks_list. Результаты работы (статус «Выполнена», комментарий к результату) ИИ не проставляет — их ставит менеджер в интерфейсе клуба.
  • Описание ограничено 500 символами (суть) и 2000 (комментарий); поле «Обещанная дата покупки» не заполняется (в базе его нет).

Завести лида

Задача

Быстро записать в CRM нового потенциального клиента со слов менеджера: ФИО, телефон, источник, филиал.

Как спросить у ИИ

Заведи лида: Иванов Сергей, телефон +7 911 222-33-44, пришёл из Instagram, филиал Москва.

Какие методы MCP нужны

get_branches client_find lead_create crm_task_create

Как ИИ получает и обрабатывает данные

  1. Если филиалов несколько — get_branches, чтобы взять branchId по названию.
  2. lead_create: фамилия, имя, телефон, source (название источника из справочника клуба), branchId, при необходимости managerId и note. Перед записью сервер сам проверяет дубликаты по правилу клуба (по умолчанию — по телефону).
  3. Если такой человек уже есть, лид не создаётся: ИИ покажет найденную запись, а при необходимости откроет её через client_find.
  4. Если нужно действие по новому лиду, ИИ вызывает crm_task_create с leadId из ответа.

Пример результата на тестовых данных

Тестовый клуб, 30 октября 2026. Тестовая запись после проверки удалена.

ПолеЗначение
Лид№ 2492, «Тестовый Лид Проверкович»
Парный клиент№ 2491 (признак «потенциальный», создаётся автоматически)
Филиалfitness365 Москва
Статусначальный (как при создании в интерфейсе)
Повторный вызов с тем же телефономотказ: найден дубликат, ID 2491

Ограничения и уточнения

  • Нужна опция Mcp:EnableWrites (по умолчанию выключена); без неё ИИ откажется с объяснением.
  • Дубликаты ищутся по полям правила клуба (настройка «Проверка дубликатов клиентов по полям»); если правило пустое, проверки нет. Поиск идёт по всем клиентам клуба, включая парных клиентов лидов, без учёта прав конкретного сотрудника.
  • Нужна хотя бы фамилия или имя. Источник выбирается только из справочника клуба; если филиалов несколько, филиал обязателен.
  • Не записываются: журнал аудита, интеграции (AmoCRM, Битрикс), события. Паспортные данные, адрес и фото ИИ не вводит.
  • Менеджер не назначается автоматически (у MCP нет «текущего пользователя»): без managerId лид создаётся без ответственного, и ИИ предупредит об этом.

Завести клиента

Задача

Записать в клубе нового клиента со слов администратора: ФИО, телефон, источник, филиал. Для человека, который ещё ничего не купил, лучше завести лида.

Как спросить у ИИ

Заведи клиента: Петрова Анна, телефон 8 911 333-44-55, источник «От клиентов клуба», филиал Москва.

Какие методы MCP нужны

get_branches client_find client_create crm_task_create

Как ИИ получает и обрабатывает данные

  1. Если филиалов несколько — get_branches, чтобы взять branchId по названию.
  2. client_create: фамилия, имя, телефон, source (название источника из справочника клуба), branchId, при необходимости managerId и note. Перед записью сервер сам проверяет дубликаты по правилу клуба (по умолчанию — по телефону) среди клиентов и лидов.
  3. Если такой человек уже есть, клиент не создаётся: ИИ покажет найденную запись, а при необходимости откроет её через client_find.
  4. Если нужно действие по клиенту, ИИ вызывает crm_task_create с clientId из ответа.

Пример результата на тестовых данных

Тестовый клуб, 30 октября 2026. Тестовая запись после проверки удалена.

ПолеЗначение
Клиент№ 2493, «Тестовый Клиент Проверкович»
Филиалfitness365 Москва, доступен всем филиалам (по настройке клуба)
Счётскидочный, создан автоматически
Повторный вызов с тем же телефономотказ: найден дубликат, ID 2493

Ограничения и уточнения

  • Нужна опция Mcp:EnableWrites (по умолчанию выключена); без неё ИИ откажется с объяснением.
  • Дубликаты ищутся по полям правила клуба; если правило пустое, проверки нет. Поиск идёт по всем клиентам клуба, включая парных клиентов лидов, без учёта прав конкретного сотрудника.
  • Нужна хотя бы фамилия или имя; источник — только из справочника клуба; если филиалов несколько, филиал обязателен.
  • Не создаются: карта клиента, бонусный счёт, абонементы. Не записываются: журнал аудита, интеграции (AmoCRM, Битрикс), события. Паспортные данные, адрес и фото ИИ не вводит.
  • Менеджер не назначается автоматически: без managerId клиент создаётся без ответственного, и ИИ предупредит об этом.

Скидки

Правила скидок и сумма реально предоставленных скидок. Правило в списке не значит, что скидка сработала: это видно только по выданным скидкам.

Какие скидки есть и сколько их выдано

Задача

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

Как спросить у ИИ

Какие скидки у нас настроены? Сколько скидок мы предоставили на прошлой неделе и по каким правилам? Какие акции закончатся в ближайшие две недели?

Какие методы MCP нужны

discounts_overview discounts_given discounts_date_conditions

Как ИИ получает и обрабатывает данные

  1. discounts_overview: схемы и правила скидок (тип, размер, приоритет, ручная или автоматическая, филиал).
  2. discounts_given за период: сумма скидок, доля от суммы до скидок, топ применённых правил.
  3. discounts_date_conditions: условия «интервал дат», которые начинаются или заканчиваются в ближайшие N дней (по умолчанию 14).

Пример результата на тестовых данных

Тестовый клуб, правила — на 29 октября 2026; выданные скидки — 24–30 августа 2026.

Правил скидок: 24 (схема «Дисконтная схема по умолчанию», активна). Первые три: «Сто проц 111» (процент, 90), «10% на бонусный счёт», «Silver статус скидка 10%» (сумма, 10).

Показатель за неделюЗначение
Сумма до скидок380 100
Предоставлено скидок180 (0,05 %)
Позиций со скидкой1
Правило«скидка 15%», 1 позиция, 180

Скидок с датами начала или окончания в ближайшие 14 дней нет.

Ограничения и уточнения

  • Связь «правило ↔ схема» и условия правил (дни недели, группы клиентов, продукты) не проверяются: наличие правила в списке не означает, что оно действует для конкретной продажи.
  • Инвертированные условия («кроме периода») в списке дат не показываются.

Продажи: филиалы, виды, реестр

Дополнение к финансам: разрезы по филиалам и видам продаж и построчный реестр.

Выручка по филиалам и по видам продаж

Задача

Сравнить филиалы по выручке и увидеть, какую часть дают первичные продажи, продления, услуги и пробные.

Как спросить у ИИ

Покажи выручку по каждому филиалу за прошлую неделю и разбей продажи по видам: первичная, продление, услуга, пробная.

Какие методы MCP нужны

sales_by_branch sales_by_type sales_summary

Как ИИ получает и обрабатывает данные

  1. sales_by_branch: по каждому филиалу число продаж, сумма, фактическая оплата и средний чек.
  2. sales_by_type: позиции проведённых продаж по типу продажи. Параметр subscription отдельно выделяет подписочные продажи.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

По филиалам

ФилиалПродажСуммаОплаченоСредний чек
fitness365 Санкт-Петербург18438 920438 92024 384,44

По видам продаж

Тип продажиПозицийСумма
Первичная12224 920
Услуга385 000
Продление370 000
Пробная10
Всего19379 920

Ограничения и уточнения

  • В тестовой базе суммы по филиалам (438 920) и по видам продаж (379 920) не совпали; причина не выяснена. При расхождении ИИ должен назвать оба числа и их источник, а не выбирать одно.
  • В неделю продажи есть только в одном филиале, а посещения — в другом (см. «Посещаемость по филиалам»).
  • Выручка здесь — сумма проведённых продаж после скидок; фактически полученные деньги — отдельное поле.

Список продаж за период или клиента

Задача

Получить построчные продажи: что, кому, на какую сумму и чем оплачено.

Как спросить у ИИ

Покажи последние продажи за прошлую неделю: дата, клиент, что куплено, сумма, способ оплаты и кто оформил.

Какие методы MCP нужны

sales_list

Как ИИ получает и обрабатывает данные

  1. sales_list с периодом (до 3 месяцев), страницами и фильтрами status, employeeId, branchId. Для истории клиента — clientId, phone или пара фамилия + имя (период тогда не ограничен).

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026: всего 18 продаж на 438 920, показаны 2.

ДатаКлиентПродуктСуммаОплатаОформил
29.08 16:30Третий Т.ПТ-1055 000КартаЮлия В.
29.08 11:52Второй В.абонемент на мес + 10 ГТ15 000НаличныеЮлия В.

Ограничения и уточнения

  • В реестре имена клиентов выдаются полностью (в примере сокращены), это персональные данные.
  • По умолчанию показаны проведённые продажи; сохранённые, ожидающие оплаты и отменённые — через status.

Посещаемость: филиалы, услуги, гости, организация

Дополнение к посещаемости: сравнение филиалов, услуги и направления, гостевые визиты и реквизиты клуба.

Посещаемость по филиалам и длительность визитов

Задача

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

Как спросить у ИИ

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

Какие методы MCP нужны

visits_by_branch visits_average_duration

Как ИИ получает и обрабатывает данные

  1. visits_by_branch: посещения и уникальные посетители по филиалам.
  2. visits_average_duration: средняя длительность закрытых визитов в минутах, общая и по филиалам.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

ФилиалПосещенийУникальных клиентовСредняя длительность
fitness365 Москва21692,5 мин (по 19 визитам)

Ограничения и уточнения

  • Длительность определена не у всех визитов: из 21 закрытого у 19 есть корректное время выхода, остальные исключены; ИИ должен сказать, по скольким визитам посчитано.
  • Посещения сотрудников не входят.

Куда ходят клиенты: услуги и направления

Задача

Увидеть, по каким услугам больше всего посещений и какие направления занятий популярнее по записям.

Как спросить у ИИ

Какие услуги были самыми посещаемыми на прошлой неделе? И какие направления занятий чаще всего записывали?

Какие методы MCP нужны

visits_statistics_by_service trainings_popular_classes

Как ИИ получает и обрабатывает данные

  1. visits_statistics_by_service: визиты и уникальные клиенты по услуге визита.
  2. trainings_popular_classes: направления занятий по числу записей (без отменённых и листа ожидания).
  3. ИИ обязан сказать, что первая статистика основана на посещениях, а вторая — на записях: это разные показатели.

Пример результата на тестовых данных

Тестовый клуб, 24–30 августа 2026.

Услуга (по посещениям)ВизитовКлиентовДоля
ГТ10247,6 %
Йога3314,3 %
Членство в клубе3114,3 %
Стретчинг3114,3 %
Солярий114,8 %
Всего21
Направление (по записям)Записей
Без направления41
ABT8
Детский2
MIX FIGHT1
SWIMMING1

Ограничения и уточнения

  • Записи и посещения нельзя складывать и сравнивать числами: запись не гарантирует приход.
  • Большинство записей в тестовой базе — «Без направления» (у занятия не выбран класс).

Сколько гостей приходит в клуб

Задача

Оценить долю гостевых посещений, какие услуги они используют и кто приглашает больше всего гостей.

Как спросить у ИИ

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

Какие методы MCP нужны

guest_visits visits_statistics_by_service visits_list

Как ИИ получает и обрабатывает данные

  1. guest_visits: гостевые посещения (по гостевой услуге или с указанным пригласившим), доля, уникальные гости, услуги и топ приглашающих.
  2. Построчный список — visits_list с serviceKind=guest.

Пример результата на тестовых данных

Тестовый клуб, 1 июня – 30 августа 2026.

ПоказательЗначение
Посещений всего99
Гостевых48 (48,5 %)
Уникальных гостей7
По гостевой услуге / по приглашению48 / 0
УслугиСтретчинг — 44 визита (3 гостя); Плавание (бассейн разовое) — 4 (4 гостя)
Топ приглашающихнет данных

Ограничения и уточнения

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

Реквизиты и филиалы клуба

Задача

Узнать список филиалов и реквизиты организации: название, ИНН, телефон, адрес.

Как спросить у ИИ

Какие у нас есть филиалы? Дай реквизиты филиала «fitness365 Москва»: ИНН, телефон, адрес.

Какие методы MCP нужны

get_branches organization_details get_metric_definitions

Как ИИ получает и обрабатывает данные

  1. get_branches возвращает branchId и название каждого филиала; этот же идентификатор нужен фильтрам других методов.
  2. organization_details по organizationId (то же число, что branchId) выдаёт название, ИНН, e-mail, описание, телефон и адрес.

Пример результата на тестовых данных

Тестовый клуб, 4 филиала.

branchIdНазвание
1327казань
1084fitness365 Москва
1048fitness365 Санкт-Петербург
1275fitness365 Сочи

«fitness365 Москва»: страна Россия, описание «Лучший фитнес клуб на свете!»; ИНН, телефон, e-mail, город и улица не заполнены, ИИ должен сказать, что реквизитов в карточке нет.

Ограничения и уточнения

  • Определения метрик и правила периодов можно получить методом get_metric_definitions: ИИ вызывает его, когда нужно объяснить, что именно посчитано.
  • Адрес и ИНН берутся из карточки организации: если там пусто, MCP их не восстановит.

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

Задача

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

Как спросить у ИИ

По чему было больше посещений в прошлом месяце: по абонементам или по разовым услугам? Покажи долю каждого основания.

Какие методы MCP нужны

visits_statistics_by_basis visits_list

Как ИИ получает и обрабатывает данные

  1. visits_statistics_by_basis: визиты, уникальные клиенты и доля по основанию (abonement, club_card, one_time, training, none).
  2. Для списка конкретных визитов ИИ вызывает visits_list с фильтром basis; в строках есть basis, basisName и название купленной позиции basisItem.
  3. ИИ обязан сказать, что статистика основана на посещениях, а не на продажах.

Пример результата на тестовых данных

Тестовая база Fit365Local, сентябрь–ноябрь 2020. Посещений по абонементам и разовым услугам в этом периоде нет, ветки проверены сверкой с SQL на других периодах.

ОснованиеВизитовКлиентовДоля
Занятие по расписанию5513100 %
Всего55

Ограничения и уточнения

  • Основание берётся из купленной позиции посещения (Visit.SaledService); если позиции нет, но посещение привязано к занятию — «занятие»; иначе «без основания» (например, свободный вход).
  • «Разовая услуга» — любая купленная позиция, которая не абонемент и не клубная карта.
  • Пробные и гостевые посещения выделяются отдельно через serviceKind и могут совпадать с любым основанием.