SPACE: моя платформа готовых решений для микробизнеса с входом через Telegram

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

Задача

Мастеру, небольшой студии или эксперту нужны бот в Telegram, рассылка по своей базе, розыгрыш, реферальная программа. Разработчик под каждое дорог, конструкторы собираются в зоопарк. Я хотел одну платформу: зашёл через Telegram, включил нужный модуль, дальше он работает.

У идеи была воронка. Человек читает статью на chimitdorzhi.tech и видит две кнопки: «Включить модуль» для самостоятельной настройки и «Сделайте за меня» для разработки под заказ. Объём первой версии я ограничил: ядро аккаунта, один модуль геймификации Telegram-бота, рассылки и статьи. Сообщество и знакомства отложил до 300 активных пользователей, потому что пустая лента убивает впечатление хуже, чем её отсутствие.

Что я сделал

Вход и ядро

Вход через Telegram. Штатный виджет рисует свою синюю кнопку, а она ломала вид интерфейса, поэтому я подключил официальный скрипт и вызываю его методом Telegram.Login.auth со своей кнопки. Подпись проверяет сервер: HMAC-SHA256, данные старше суток отбрасываются, сессия живёт в подписанной httponly-куке 30 дней. Бэкенд на FastAPI, база SQLite с плоской схемой, которая переезжает в PostgreSQL без смены логики.

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

Модули

Геймификация бота: баллы, награды, приглашения, подписка на канал, рассылка. Токен бота хранится зашифрованным, наружу отдаются последние четыре символа. Рассылка идёт в отдельном потоке примерно двадцать сообщений в секунду: на ошибку 403 участник помечается как заблокировавший бота, на 429 включается пауза. Подробнее про механики писал в статье про геймификацию SaaS-продукта.

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

Цифровой сотрудник

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

Каналы подключаются окном согласия, токеном руками или тремя шагами в настройках владельца. Есть Telegram Business, сообщества ВКонтакте, MAX, почта. Для площадок без API написал слой на браузере сервера, где клиент входит сам, а пароль у меня не хранится. Про безопасность такого ассистента отдельно писал в разборе ассистента для Telegram Business. Цифрового сотрудника под ваш бизнес можно заказать на странице услуги.

Лендинг студии на корне

После закрытия кабинета на корне домена понадобилась страница. Лендинг собирает генератор на 548 строк: весь текст в одном словаре, на выходе русская и английская версии, sitemap с hreflang, манифест. Руками два html я не правлю. На странице три адреса с разным весом: крупная карточка основного сайта студии и две компактные строки с продуктами.

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

Первое: поиск по русским словам молча не находил ничего. Встроенная в SQLite функция lower() понимает только латиницу, и фильтр по слову «Чита» отдавал ноль. Я зарегистрировал свою функцию и использую её во всех запросах.

Второе: тот же дефект дизайн-системы я ловил четыре раза. Классы с display:flex перебивают атрибут hidden, и скрытые элементы остаются на экране. Теперь в сборке стоит глобальное правило, и убирать его нельзя.

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

Четвёртое: контраст на живом фоне. Замер по одному кадру анимации был зелёным, а прогон по двенадцати фазам показал провалы до 2,58 при норме 4,5. Помогла тёмная заливка стекла вместо белой. Минимум после правки 5,23 на боевой странице. Замер прошлой сессии, сегодня не повторял.

Пятое: персональные данные. Хранить переписку значит стать оператором, поэтому я пишу только факты действий. Порядок подачи описан в материале про уведомление в РКН.

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

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

Что дальше

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

Перед возвратом нужно решить две вещи: нужен ли отдельный кабинет при заказной разработке и тянет ли сервер браузерные окна: одно окно входа занимало около 280 МБ, при 2 ГБ памяти их помещается четыре или пять. Прежде чем слать письма с платформы, надо дополнить SPF, иначе они уйдут в спам.

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

Можно ли сейчас зайти в SPACE?

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

Зачем агент отвечает черновиком?

Автономный ответ ошибается на живом клиенте. Черновик стоит одного нажатия «удалить». Автономность включается отдельно и по одному сценарию.

Во сколько обойдётся такая платформа?

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

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

SPACE выросла из каталога модулей в агента с черновиками и журналом действий, а затем была закрыта как отдельный кабинет. Прочное осталось внутри: проверка подписи Telegram, шифрование токенов, правила для ответов, 636 проверок. Лендинг на корне домена работает и отвечает 200.

Если вам нужна платформа или кабинет под свою нишу, я собираю их под ключ и сразу говорю, что из заявленного уже проверено. Напишите в Telegram, MAX или VK.