MVP платформы для челенджей

**Cappuccino Challenge** — это мобильная UGC-игра, в которой гости кофеен получают мгновенные скидки на кофе и шанс выиграть раз в месяц главный приз (iPhone) за публикацию короткого Reels/TikTok-ролика с отметкой заведения.

## **Механика**

Гость сканирует QR-код, получает задание в WhatsApp, выкладывает видео, предъявляет одноразовый код кассиру и сразу забирает скидку. Все свои ролики, просмотры и место в ежемесячном рейтинге он отслеживает в Telegram-кабинете. По итогам месяца автор ролика с максимумом просмотров получает гланый приз

## **Цель MVP**

Реализовать поток: **QR-скан – WhatsApp-бот – ролик – код – скидка – Telegram-кабинет – рейтинг – приз – отчет**

## **Ключевой функционал**

1. **Регистрация заведения** в системе с получением дальнейших инструкций.
2. **Уникальные QR-коды** для заведений, генерация и печать.
3. **Серый WhatsApp-бот**
    – приветствие, инструкция, валидация ссылки на Reels/TikTok;
    – выдача одноразового кода
4. **Телеграм-кабинет участника**
    – счётчик просмотров роликов;
    – рейтинг месяца;
    – список заведений поблизости принимающих участие в челлендже.
5. **Кассовая логика**
    – владелец добавляет кассиров в Telegram-бот;
    – кассир присылает одноразовый код гостя + фото гостя с напитком/QR;
    – бот деактивирует код, фиксирует фото;
    – владелец видит, что «1 человек = 1 участие» в своей панели.
6. **Панель заведений** (регистрация, заказ промо-материалов, отчёты, вкл/выкл участия, добавление/удаление сотрудников).
7. **Админ-панель** (заявки от заведений на печать, статус доставки, активация точек по видео-доказательству, блокировки, настройка месячного челленджа).
8. **Контент-модерация** ТОП-100 роликов, анти-накрутка просмотров.
9. **CRM-триггеры** WhatsApp (48 ч без перехода в TG) и A/B-тест пушей.

## **Желаемый стек**
**Backend:** TypeScript + NestJS или Python (FastAPI); REST/GraphQL
**БД:** PostgreSQL (Supabase)
**Bots:** WhatsApp gray API, Telegram Bot API (Telegraf / aiogram)
**Frontend панели:** React + Vite (или Next.js) + Tailwind
**CI/CD:** Docker, GitHub Actions, Coolify
Если у вас есть готовые библиотеки/SDK на другом стеке готов рассмотреть

## **Предварительные задачи спринтов:**

1. **Bot-core & QR API** (30 часов)
2. **Telegram-кабинет + рейтинг** (20 часов)
3. **Панель заведений + логистика печати** (20 часов)
4. **Админ-/модератор-панель + анти-накрутка** (20 часов)
5. **Release Pilot (5–10 точек), баг-фикс** (30 часов)

### **Кого ищем**
- Опыт продакшн-ботов с серым WhatsApp и Telegram.
- Умение строить чистое, документированное API.
- Практика с QR-генерацией, одноразовыми токенами.
- Знание анти-спам / анти-накрутка подходов приветствуется.

---
### **Что прислать в отклике**
- 2–3 похожих проекта (боты / UGC / промо-механики).
- Оценку сроков по перечисленным задачам.
- Ставку за проект или диапазон за спринт.