Описание проекта
Проект представляет собой VK Mini App для создания и проведения розыгрышей во ВКонтакте. Приложение помогает администраторам сообществ, SMM-специалистам, авторам каналов и бизнесу быстро запускать конкурсы, настраивать условия участия, подключать сообщества и внешние каналы, размещать виджеты и подводить итоги без ручной проверки участников.
Решаемая задача
Проведение розыгрышей во ВКонтакте часто требует много ручной работы: нужно создать конкурсный пост, собрать участников, проверить выполнение условий, учесть подписки на сообщества или внешние каналы, выбрать победителей и корректно опубликовать результаты.
Без автоматизации организатор тратит время на рутинные действия, повышается риск ошибок при проверке участников, а сам процесс становится менее прозрачным для аудитории.
Приложение решает эту задачу за счёт единого интерфейса, где организатор может настроить розыгрыш, управлять им и подвести итоги внутри VK Mini App. А так же проект сильно снижает кол-во ботов в розыгрышах.
Функциональность
Для организатора доступны
RaffleApp объединяет все действия организатора в одном интерфейсе: создание розыгрыша, настройку условий, подключение сообществ и каналов, размещение виджета, управление конкурсом и подведение итогов.
Для участника доступны
Участник проходит весь путь внутри VK: открывает розыгрыш, видит условия, выполняет действия, принимает участие и после завершения конкурса смотрит результаты.
Целевая аудитория
Основная целевая аудитория проекта — пользователи и команды, которые регулярно проводят конкурсы, акции и розыгрыши во ВКонтакте.
RaffleApp подходит всем, кто использует розыгрыши как инструмент продвижения: администраторам VK-сообществ, SMM-специалистам, бизнесу, маркетологам, блогерам и партнёрским сообществам.
Ссылка на работающий продукт
Проект доступен как VK Mini App и открывается напрямую внутри ВКонтакте. Пользователь может перейти по ссылке, протестировать интерфейс, посмотреть сценарии работы с розыгрышами, условиями участия, сообществами, уведомлениями и интеграциями.
Архитектура решения
Приложение построено по клиент-серверной архитектуре. Пользователь работает с VK Mini App, который написан на React, TypeScript и VKUI. Через VK Bridge приложение взаимодействует с платформой VK. Основная бизнес-логика вынесена на backend на FastAPI: он хранит розыгрыши, участников, сообщества, уведомления и результаты. Данные лежат в PostgreSQL. Интеграции с Telegram и MAX вынесены в отдельный gRPC-слой, чтобы можно было проверять подписки и расширять механику розыгрышей за пределы VK
История разработки
RaffleApp разрабатывался итерационно с активным использованием ИИ (Cursor). ИИ применялся не только для генерации кода, но и как технический помощник: для проектирования архитектуры, разбиения компонентов, настройки API, исправления ошибок, интеграций Telegram/MAX и адаптации интерфейса под VK Mini App.
Разработка шла через серию практических задач: от создания экранов и карточек розыгрышей до решения проблем с CORS, gRPC, сертификатами, VK API, уведомлениями, виджетами и мобильной версткой.
Финальные решения проверялись и дорабатывались вручную: тестировались сценарии администратора и участника, корректность условий участия, работа интеграций, отображение результатов и стабильность приложения внутри VK.
Оценка вклада
Примерное соотношение вклада в разработку RaffleApp:
60–70% — AI-assisted code Генерация компонентов, экранов, API-модулей, рефакторинг, поиск ошибок, помощь с архитектурой и интеграциями.
30–40% — ручная разработка и доработка Продуктовая логика, настройка VK Mini App, проверка сценариев, интеграции, тестирование, исправление ошибок и финальная сборка.
ИИ ускорил разработку, но ключевые решения и проверка продукта выполнялись вручную. Особенно это касалось работы внутри VK, интеграций Telegram/MAX, проверки условий участия, мобильной адаптации и подготовки приложения к демонстрации.
