Кейсы 6 мин чтения

Сервис соседской взаимопомощи: карта, боты Telegram и MAX

Сервис, где соседи помогают друг другу, а срочный мастер находится по карте. Mini App и боты в Telegram и MAX живут на одной базе, аккаунты связываются по телефону. Версия 2.1 работает с 19 ноября, оплата ждёт ключей платёжного сервиса.

кейсTelegramMAXмини-приложениегеопоисквзаимопомощь

Коротко (TL;DR)

  • Гиперлокальный сервис в двух режимах: срочный мастер и помощь по-соседски. Mini App и боты в Telegram и MAX работают на одной базе, заявки лежат на карте и ищутся по радиусу в метрах.
  • Строил по шагам: фундамент и база, логика и вход, карта, боты. Заказчик принимал каждый шаг отдельно, потом пошли версии 2.0 и 2.1 и несколько доработок по его голосовым.
  • Версия 2.1 работает на сервере с 19 ноября. Прогон автотестов даёт 115 проверок на живой базе с геоданными без ошибок. Оплата подготовлена и ждёт ключей платёжного сервиса от заказчика.
  • Цифр живого использования у меня нет, и выдумывать их я не буду.
Нужно мини-приложение для вашего бизнеса?

Сделаю под ключ: разберу задачу, назову срок и цену. Чтобы начать, напишите в Telegram одной фразой.

Обсудить бота

Объявление «помогите, течёт кран» в чате дома висит среди рекламы и мемов. Платные агрегаторы берут комиссию и тянут мастера из другого конца города. Заказчик хотел сервис между этими двумя крайностями: рядом, быстро и с понятной проверкой, что работа сделана.

Задача

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

Режимов два. В первом заявку берёт мастер, который готов приехать срочно. Во втором соседи помогают друг другу: донести сумки, одолжить дрель, посидеть с собакой. Telegram и MAX обслуживаются на равных, но база одна. Один человек может открыть сервис из обоих мессенджеров и остаться одним аккаунтом. Нужна карта с заявками, мастерами и местами рядом. Нужна сверка чека: мастер называет сумму, клиент подтверждает или спорит. И правило одного слота: пока мастер не закрыл заявку, вторую он не берёт.

Работать просили строго по шагам: сначала фундамент и база, дальше только после проверки. Так я и делал.

Что я сделал

Шаг 1, фундамент. FastAPI, aiogram, PostgreSQL с расширением PostGIS, Redis, миграции Alembic. Радиус считается по типу geography, поэтому расстояния получаются сразу в метрах. Правило одного слота записано не только в коде: в базе стоит частичный уникальный индекс, и второго активного слота у мастера не появится ни при какой гонке запросов.

Шаг 2, логика и вход. Подпись данных запуска проверяется одинаково для обоих мессенджеров, различаются только токены ботов. Телефон привязывается через подписанный ответ мессенджера: контакт должен принадлежать тому же человеку, иначе кто угодно мог бы забрать чужой аккаунт. Захват заявки идёт через блокировку в Redis на десять секунд и ту же проверку в базе. Если три мастера нажали одновременно, заявку получает один, остальные видят конфликт. Сверка чека считает суммы сошедшимися, если расхождение не больше 200 рублей или 10 процентов суммы, смотря что больше. Иначе заявка уходит в спор.

Шаг 3, Mini App. Единая карта, визитки мастеров, раздел «Мои дела», профиль. Точку мастера на карте огрубляю примерно до 150 метров, чтобы по приложению нельзя было вычислить его дом. Иконки нарисовал, эмодзи в интерфейсе нет.

Шаг 4, боты. Уведомления разведены по времени: профи получает заявку сразу, остальные через две минуты. Для администраторов есть команды в Telegram и веб-пульт со сводкой, пользователями, спорами и местами на карте.

Дальше версия 2.0: любой город, 28 категорий, загрузка фото со сжатием и без геометок, страница-визитка у каждого мастера, подписки, чат сделки, где сообщения можно только добавлять, отзывы после подтверждённой сделки, внутренние баллы и задания. Версия 2.1 добавила соседский чат района и отдельную вкладку «Соседи». Потом появились каталог мастеров по городам, доска объявлений и персональные лендинги услуг. Похожую логику «сосед соседу» я разбирал в статье про соцсеть для соседей района, а про интерфейс прямо в чате писал в отдельном кейсе. Как создать и подключить бота в MAX, описано в пошаговой инструкции, а идею бесплатной помощи между соседями я описывал в статье про раздачу лишней еды.

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

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

Первое: подпись Telegram. Часть новых пользователей получала «Подпись не совпала». Оказалось, что в проверку нужно включать поле signature, которое у новых клиентов приходит вместе с остальными. Исправил в тот же вечер.

Второе: вход на телефоне. У заказчика через мобильный интернет страница входа через Telegram висела на чёрном экране, потому что адрес t.me не открывался. Теперь на телефоне кнопка открывает приложение прямой ссылкой, запасной остаётся ссылка t.me. Скрипты мессенджеров и карты я положил на свой сервер, потому что внешние адреса блокировали страницу целиком. Тайлы карты идут через собственный прокси.

Третье: запуск MAX. Мини-приложение в нём открывается по имени бота, адрес сайта вместо имени даёт ошибку «Техническая заминка». Адрес мини-приложения заказчик прописывает сам в кабинете бота. Ещё выяснилось, что бот в MAX не может написать человеку первым: уведомления заказчику сначала возвращали 404, пока он не нажал «Старт».

Четвёртое: аудит. 19 ноября я прошёл сервис без правок, только искал. Нашлось двойное списание внутренних баллов: библиотека не перечитывала строку после блокировки, и десять параллельных запросов проходили по устаревшему балансу. Нашлось, что при объединении аккаунтов стирались данные второй версии, а вход на сайт по ссылке бота шёл без подтверждения. К вечеру всё исправил: вход теперь требует нажатия «Да, это я», объединение переносит все таблицы автоматически, а связка Telegram и MAX идёт кодом через бота. Тесты выросли с 77 до 98, к 20 ноября до 115.

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

ЧтоСостояние
Шаги 1 до 4приняты заказчиком, архивы переданы
Версия 2.1 на сервереработает с 19 ноября, выкладка скриптом с проверкой тестов
Автотесты115, на живой базе с геоданными
БотыTelegram и MAX подключены, переписка работает из обоих
Резервные копии и сторожкопия базы каждую ночь, проверка сервиса каждые пять минут
Платежиподготовлены, ждут ключей платёжного сервиса от заказчика
Живое использованиецифр нет

Не проверено: Mini App в MAX на телефоне после смены адреса, ИИ-модерация (ключ ещё не дали, работает словарь стоп-слов), нагрузка при реальном потоке заявок.

Что дальше

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

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

Можно ли так же сделать сервис под свой город или сообщество?

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

Нужно ли ставить приложение?

Нет. Mini App открывается из бота в Telegram или MAX, а в обычном браузере можно войти через бота.

Как избежать споров о деньгах между сторонами?

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

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

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

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

Всё о мессенджере MAX в одном месте

Эта статья — часть кластера материалов о MAX: разработка ботов и мини-аппов, продвижение канала, воронки, отраслевые сценарии и кейсы с реальными результатами.

Обсудим вашу задачу

Что я делаю для бизнеса

Напишите одной фразой, что нужно. Отвечу, что подойдёт, сколько займёт и сколько стоит. Сообщение уже подготовлено.

  • Боты в Telegram, MAX, VK
  • Автоматизация процессов и CRM
  • Аналитика и дашборды
  • Сайты и лендинги под ключ
Пишу о разработке, ИИ и законах для бизнеса

Разборы, кейсы и практика — без воды. Выходит регулярно, читать 3–5 минут.

Готовые решения под ключTurnkey solutionsSoluciones llave en mano交钥匙解决方案Түлхүүр гардуулах шийдэл 451 готовых IT-решений для бизнеса451 ready-made IT solutions for business451 soluciones IT listas para empresas451 个面向企业的现成 IT 解决方案Бизнест зориулсан 451 бэлэн IT шийдэл Автоматизация, боты, AI, 152-ФЗ и платформы · бесплатная консультацияAutomation, bots, AI, data privacy and platforms · free consultationAutomatización, bots, IA, privacidad de datos y plataformas · consulta gratis自动化、机器人、AI、数据合规与平台 · 免费咨询Автоматжуулалт, бот, AI, өгөгдлийн хамгаалалт ба платформ · үнэгүй зөвлөгөө Смотреть каталогView catalogVer catálogo查看目录Каталог үзэх