Клуб личных целей по подписке: бот, мини-приложение и админка

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

Задача

Автор идеи ведёт бизнес больше пятнадцати лет и на собственном примере менял привычки. Он хотел клуб, где люди ставят себе цель на месяц и каждый день делают маленький шаг, а кураторы и общий чат не дают бросить. Верхние ступени: эфиры, мастермайнды, поездки.

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

Что я сделал

• Презентации. Первая версия без цен, по расшифровке голосового. Автор прогнал её через свою языковую модель и вернул редакцию на 6 страниц, я принял её как техническое задание первого этапа и собрал ответную версию на 3 страницы. Потом сделал коммерческое предложение с этапами.
• Бот. Приветствие, кнопка меню «Клуб», которая открывает мини-приложение, и обработка кнопки «Сделал» в напоминаниях.
• Мини-приложение. Выбор цели, карточка цели (зачем, старт, результат к концу месяца, ежедневный шаг), экран «Сегодня» с отметкой, серия дней, маршрут месяца, лента группы, профиль с временем напоминания.
• Сервер и админка. Участники, рассылки, тексты клуба, эфиры, кураторы, тариф. Куратор входит своим логином и видит только свою группу.

Как устроено

Цели и направления

Направлений четыре, типов целей пять: шаги и километры, вес, книги, финансы, соцсети. У каждого типа свой шаг и своя мера. Для шагов есть маршрут месяца: 5 км в день дают 150 км, и на карте видно, сколько осталось до соседнего города. Для финансов мера в процентах прироста, для соцсетей в публикациях.

Вход без регистрации

Мини-приложение открывается внутри Telegram, и сервер проверяет подпись данных запуска. Участнику не нужен логин и пароль: Telegram сам подтверждает, кто это. Если открыть ту же страницу в обычном браузере, она работает в демо-режиме и хранит данные в самом браузере. В демо можно переключать роли: участник, куратор, автор.

Напоминания и сигналы куратору

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

• Напоминание о шаге в выбранное время с кнопками «Сделал» и «Открыть». Нажатие отмечает день прямо из чата.
• После трёх дней без отметок участнику уходит мягкое сообщение с предложением уменьшить шаг, а куратору сигнал написать лично.
• В конце бесплатной недели участник видит, сколько дней из семи прошёл с шагом, и предложение остаться.
• За два дня до продления подписки приходит напоминание.

Каждое сообщение отправляется один раз: сервер записывает, что и когда ушло. Новый участник получает куратора по очереди.

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

В админке семь разделов: обзор, участники с карточкой, рассылки по группам, тексты клуба, эфиры, кураторы, тариф. Тексты приветствия и темы месяца меняются в админке и сразу появляются в мини-приложении и в боте. Эфиров по плану десять, у каждого обложка, дата и площадки для рестрима, до пяти. Рассылки уходят по-настоящему тем, кто нажал «Старт» в боте.

Список «Нужно от вас»

В демо встроен список из 16 пунктов в пяти группах: фото автора, кейсы с датами, точка старта маршрута, темы эфиров, площадки, третий куратор, правила чата, реквизиты для приёма оплаты, условия паузы. Каждый пункт привязан к экрану, где он появится. Подсказки включаются переключателем, и автор видит, что именно от него ждут, прямо на макете.

Что было сложно

Сложнее всего было с внешним видом. Первую версию сочли слишком «ИИшной». Вторая получила оранжевый градиент со стеклом, и про неё сказали: «слишком ярко, как фрукты продаются». Третья стала деловой: графит, нейтральный светлый фон, белое матовое стекло и оранжевый только как акцент на прогрессе и отметках. С логотипом так же. Из трёх первых вариантов знака два не понравились, и со второй доски из шести выбрали слово с широкой разрядкой и первую букву названия в тонком круге.

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

Что получилось

Код занимает около двух тысяч строк на Python и JavaScript без учёта стилей. От первого голосового до работающего стенда прошло четыре дня.

Ограничения

Прогресс пока равен числу отметок, умноженному на шаг цели. Введённое значение стенд не учитывает: если человек прошёл 7 км вместо 5, он этого не увидит. Оплата не подключена, реквизитов ещё нет. Стенд живёт на моём демо-сервере, после запуска клуб переедет на сервер заказчика. Как клуб удержит людей, неизвестно: ни одного платного участника пока нет, и цифры удержания в презентации подписаны как пример.

Частые вопросы

Зачем мини-приложение, если есть бот с кнопками?

Карточку цели, маршрут на карте и ленту группы в чате не покажешь. Простые действия, отметка дня и напоминание, остались в чате, а всё, где нужен экран, ушло в мини-приложение.

Можно ли запустить такой клуб в MAX?

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

Что делает куратор?

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

Коротко о главном

Клуб по подписке держится на ежедневном маленьком шаге и на том, что кто-то замечает пропуск. Это и собрано в демо: отметка в один клик, серия, напоминание и сигнал куратору после трёх дней тишины. Оплата, MAX и перенос на сервер заказчика пойдут после согласования. Про модель подписки в общем виде есть статья закрытый клуб по подписке, а про сам формат мини-приложений Telegram Mini App: что это. Если у вас есть идея клуба или марафона и нужно быстро показать её команде, напишите мне в Telegram.