Трекер приколов (Prankster)

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

• Быстрый прикол — за ~10 секунд из Mini App или отправив фото боту.
• Друзья — добавляешь по @username; только друзей можно выбрать свидетелем.
• Свидетель — друг подтверждает прикол (кнопка в боте или в приложении), прикол помечается «Подтверждён».
• Планирование по кнопке — дата/время показываются только если нажал «Запланировать на потом».
• Лимит — 30 активных приколов; архив с поиском по участникам («Помнишь, как мы разыграли Петю?»).

Авторизация через Telegram; интерфейс — Mini App в Telegram.

Zero-cost MVP: рассчитан на работу без платных API при числе пользователей до порядка 1000: бесплатные тарифы БД (Neon/Supabase), файлы на диске.

Стек

• Backend: Node.js, Fastify, Prisma, PostgreSQL
• Bot: Telegraf
• Webapp: React, Vite, TypeScript, Tailwind CSS
• Shared: общие типы и Zod-схемы

Требования

• Node.js 20+
• PostgreSQL
• Telegram-бот (токен от @BotFather)

Установка

npm install
npm run build -w @prankster/shared

Настройка

1. Скопируйте .env.example в .env.
2. Заполните:
   • TELEGRAM_BOT_TOKEN — токен бота от BotFather
   • DATABASE_URL — строка подключения к PostgreSQL (для zero-cost можно использовать Neon или Supabase)
   • MINI_APP_URL — HTTPS-адрес Mini App (для разработки — например, ngrok на порт 5173)
   • BOT_SECRET (опционально) — секрет для вызовов бота к бэкенду; если не задан, используется токен бота
   • BACKEND_URL (опционально) — URL бэкенда для бота (по умолчанию http://localhost:3000)
3. Примените миграции:

npm run db:migrate

(Если PostgreSQL ещё не запущен, можно создать миграцию вручную и применить позже.)

Запуск

Сборка shared (один раз после клонирования или при изменении типов):

npm run build -w @prankster/shared

Либо полная сборка всего проекта: npm run build.

Одна команда (backend + bot + webapp + туннель):

npm run dev

В одном терминале поднимаются: API (порт 3000), Telegram-бот, Mini App (порт 5173) и один туннель Cloudflare на 5173. Запросы к /api из браузера проксируются с dev-сервера Vite на бэкенд, второй туннель не нужен.

• Нужен cloudflared: brew install cloudflare/cloudflare/cloudflared (macOS).
• В выводе найдите URL туннеля вида https://....trycloudflare.com (префикс [tunnel]). Кнопка «Открыть приложение» в боте обновится на этот URL автоматически (бот читает .tunnel-url через 5 и 20 с). Вручную править MINI_APP_URL в .env при каждом новом запуске не нужно. Если вывод бота не виден в терминале — проверьте файл .bot-menu.log в корне проекта: там будет записано, какой URL был установлен в кнопку.
• Для этого режима не задавайте VITE_API_URL (или оставьте пустым) — API идёт через тот же хост и прокси.

Запуск по отдельности (без туннеля):

• npm run dev:backend — API на http://localhost:3000
• npm run dev:bot — Telegram-бот
• npm run dev:webapp — Mini App на http://localhost:5173
• npm run dev:tunnel — туннель на 5173 (для доступа из Telegram)

Локально в браузере (без Telegram): при запуске только webapp и backend без туннеля укажите в корневом .env: VITE_API_URL=http://localhost:3000. Перезапустите webapp после изменения.

Фазы продукта

1. Ядро — участники (одно поле), дата скрыта по умолчанию, лимит 30 активных, статус «Случилось», поиск по участникам в архиве.
2. Друзья — заявки в друзья по @username, входящие/принять/отклонить, уведомления в боте.
3. Верификация свидетелем — при создании прикола можно выбрать друга-свидетеля; свидетель подтверждает в боте или в приложении.
4. Быстрый прикол из бота — отправил фото (и подпись) боту → прикол создаётся, кнопка «Открыть в приложении».
5. Документация и zero-cost — README, пример .env, без платных API.

Скрипты

Команда	Описание
npm run dev	Запуск backend, bot, webapp и туннеля (один терминал)
npm run build	Сборка shared, backend и webapp
npm run db:generate	Генерация Prisma Client
npm run db:migrate	Применение миграций
npm run db:push	Синхронизация схемы с БД (без миграций)

Структура

packages/
  shared/    — типы, Zod-схемы
  backend/   — Fastify API, Prisma, генерация иконок
  bot/       — Telegraf-бот, кнопка Mini App
  webapp/    — React Mini App (Vite)
uploads/     — файлы иконок и медиа (создаётся при первом запуске)

API (MVP)

• POST /api/users/me — создание/обновление пользователя по initData
• GET /api/pranks — список приколов (?status=planned|completed, ?participantsQuery=... для поиска по участникам в архиве)
• GET /api/pranks/active-count — число активных приколов (для счётчика X/30)
• POST /api/pranks — создание прикола (JSON или multipart: title, participants, опционально witnessUserId, scheduledAt, иконка/фото)
• GET /api/pranks/:id — детали прикола (в т.ч. confirmed)
• POST /api/pranks/:id/confirm — подтвердить прикол (только свидетель)
• PATCH /api/pranks/:id — обновление (статус «Случилось», рассказ, witnessUserId и др.)
• POST /api/pranks/:id/icon — загрузка иконки (multipart)
• GET /api/friends — список друзей
• POST /api/friends/request — отправить заявку в друзья (body: { username })
• GET /api/friends/requests — входящие заявки
• POST /api/friends/requests/:id/accept, POST /api/friends/requests/:id/reject — принять/отклонить
• GET /api/files/* — отдача файлов (с проверкой доступа по initData)

Внутренние вызовы от бота (заявки в друзья, подтверждение прикола, быстрый прикол) защищены заголовком X-Bot-Secret.

Все остальные защищённые эндпоинты требуют заголовок x-telegram-init-data (передаётся Mini App автоматически).