Бот для розыгрышей Вкусно и Точка в MAX

Клиент обратился с задачей создать платформу для управления маркетинговым ботом в мессенджере MAX, российском аналоге Telegram. Нужен был полный инструментарий: онбординг пользователей с маркетинговым согласием, массовые рассылки по собранной базе, механики вовлечения через розыгрыши и административная веб-панель для управления всем этим.

Монорепо с тремя приложениями: API-сервер на Elysia (Bun) для обработки входящих обновлений MAX, асинхронный worker для доставки рассылок через BullMQ + Redis, и веб-панель на React + Vite для администраторов. Хранение данных: PostgreSQL через Prisma ORM.

• Монорепо с приложениями bot-api, bot-worker, admin-web и общим пакетом packages/shared
• API-сервер на Elysia (Bun) с обработкой обновлений MAX в режиме webhook или long-polling
• Онбординг пользователей: шаги awaiting_contact, awaiting_consent и completed с записью телефона и маркетингового согласия
• Модуль рассылок: создание сообщений с текстом и медиа (фото/видео/gif), расписание (once/daily/weekly/monthly), ручной запуск
• Очередь доставки на BullMQ + Redis: один job на получателя, параллельная обработка до 25 воркеров
• Глобальный rate limiter для MAX API: 25 rps с запасом до платформенного потолка 30 rps
• Retry-логика: до 5 попыток с экспоненциальным backoff, счётчики delivered/failed по каждому запуску
• Модуль розыгрышей: статусы draft/scheduled/active/finished, медиа-прикрепление, дата начала/конца, количество победителей, проверка подписки на каналы
• Deeplink-участие в розыгрыше: кнопка со ссылкой ?start=g_<id> открывает бота и фиксирует участие автоматически после онбординга
• Управление каналами: привязка розыгрышей к каналам, проверка подписки пользователя перед участием
• Статистика: дашборд с аналитикой аудитории, рассылок и розыгрышей в веб-панели
• Cron-задачи: финализатор розыгрышей и планировщик рассылок каждые 15 секунд
• База данных через Prisma ORM с PostgreSQL: модели AudienceUser, Mailing, MailingRun, Giveaway, GiveawayEntry, Job и другие
• Docker Compose: postgres + redis + bot-api + bot-worker + admin-web в отдельных контейнерах

• Двухрежимный приём обновлений: long-polling для локальной разработки, webhook через отдельный сервис для production
• Очередь рассылок с гарантированной доставкой: BullMQ обеспечивает retry, rate limiting и инкрементальные счётчики без блокировки API
• Онбординг как gate: рассылки уходят только пользователям с completed-онбордингом и зафиксированным маркетинговым согласием
• Deeplink вместо callback-кнопок: участие в розыгрыше через ?start=g_<id>, надёжнее legacy-кнопок и работает при переподписке
• Многоканальные розыгрыши: проверка обязательной подписки на несколько каналов перед регистрацией участия
• Раздельный worker: update-worker обрабатывает входящие обновления асинхронно через таблицу Job, изолируя доставку от бизнес-логики
• Гибкое расписание рассылок: разовые, ежедневные, еженедельные и ежемесячные, с ручным триггером из панели
• Веб-панель на React + Vite: три раздела (статистика, розыгрыши, рассылки) с единым AppShell