game-marathon/CONCEPT.md

# Game Marathon — Концепция

## Общее описание

**Game Marathon** — закрытая платформа для проведения игровых марафонов среди друзей (~10 человек), где за месяц нужно набрать максимум очков, выполняя случайные челленджи в случайных играх.

### Ключевые особенности

- Колесо рандома (игра → челлендж)
- Игры добавляют сами участники + ссылки на скачивание
- Челленджи генерирует нейросеть (интегрированное API)
- Пруфы обязательны (скриншоты/видео/Steam ачивки) — загружаются на сервер
- Социальные механики (вызовы, ставки, события)
- Уведомления через Telegram-бота
- Авторизация по логину/паролю

---

## Жизненный цикл марафона

### Фаза 1: Подготовка (3-7 дней до старта)

**Действия участников:**

1. Присоединяются к марафону (по ссылке-приглашению)
2. Добавляют игры (название + ссылка на скачивание + обложка)
3. Когда все готовы — организатор "закрывает" список игр
4. Система (нейросеть) генерирует челленджи для каждой игры
5. Участники могут посмотреть/предложить правки к челленджам
6. Организатор запускает марафон

**Добавление игры включает:**

- Название игры
- Ссылка на скачивание (для платных игр — сторонние ресурсы)
- Обложка (загрузка или URL)
- Жанр (опционально)

### Фаза 2: Генерация челленджей

После закрытия списка игр — автоматический запрос к API нейросети.

**Для каждой игры генерируется 5-7 челленджей:**

- 2 лёгких (15-30 минут)
- 2-3 средних (1-2 часа)
- 1-2 сложных (3+ часов)

**Каждый челлендж содержит:**

- Название
- Описание
- Тип (completion/no-death/speedrun/collection/achievement/etc)
- Примерное время выполнения
- Способ проверки (скриншот/видео/Steam ачивка)
- Количество очков

После генерации участники могут предложить правки или добавить свои челленджи.

### Фаза 3: Активный марафон (1 месяц)

**Процесс выполнения:**

```
1. Крутишь колесо игр
         ↓
   Выпадает случайная игра
         ↓
2. Крутишь колесо челленджей (для этой игры)
         ↓
   Выпадает случайный челлендж
         ↓
3. Выбор:
   • Принять → идёшь выполнять
   • Дроп → штраф, крутишь заново
         ↓
4. Выполняешь задание
         ↓
5. Загружаешь пруф (скрин/видео/ссылка на Steam профиль)
         ↓
6. Получаешь очки + streak продолжается
         ↓
7. Можешь крутить снова
```

---

## Система очков

### Базовые очки

Зависят от сложности челленджа (определяет нейросеть при генерации):

| Сложность | Очки |
|-----------|------|
| Лёгкий | 30-50 |
| Средний | 60-100 |
| Сложный | 120-200 |

### Streak бонус

Последовательное выполнение заданий без дропов:

| Streak | Бонус |
|--------|-------|
| 1 | +0% |
| 2 | +10% |
| 3 | +20% |
| 4 | +30% |
| 5+ | +40% (максимум) |

### Дроп штрафы

Прогрессивная система штрафов:

| Дроп # | Штраф |
|--------|-------|
| 1 | Бесплатно (streak сбрасывается) |
| 2 | -10 очков |
| 3 | -25 очков |
| 4 | -50 очков |
| 5+ | -50 очков + кулдаун 2 часа |

Штрафы сбрасываются после успешного выполнения задания.

---

## Подтверждение выполнения

### Типы пруфов

- **Скриншот** — загружается на сервер
- **Видео** — загружается на сервер или ссылка (YouTube)
- **Steam Achievement** — ссылка на профиль Steam с ачивкой

### Процесс верификации

1. Участник загружает пруф + опциональный комментарий
2. Пруф виден всем участникам в ленте активности
3. Любой участник может "оспорить" пруф (если считает невалидным)
4. Если нет споров за 24 часа — автоматически засчитывается
5. При споре — голосование участников или решение организатора

---

## Социальные механики

### Лента активности

Отображает в реальном времени:

- Выполненные челленджи (с пруфами)
- Дропы
- Кто крутит колесо и что выпало
- События марафона
- Вызовы между участниками

### Вызов (Challenge)

Когда участник выполнил челлендж, другие могут "вызвать" себя на тот же:

- Вызов заменяет текущее активное задание
- Награда: стандартные очки за челлендж
- Бонус: +30 очков если выполнить быстрее оригинального исполнителя

### Ставка (Bet)

Перед началом выполнения участник может поставить часть своих очков:

- **Выполнил:** награда + ставка x2
- **Дропнул/провалил:** теряет ставку

Варианты ставок: 0 / 25 / 50 / 100 очков

---

## Система событий

Случайные события во время марафона (1-2 раза в неделю). Могут запускаться автоматически или вручную организатором.

| Событие | Описание | Длительность |
|---------|----------|--------------|
| **Золотой час** | Все очки x1.5 | 30-60 минут |
| **Общий враг** | Все получают одинаковое задание, топ-3 = бонус | До выполнения |
| **Двойной риск** | Дропы бесплатны, но очки x0.5 | 2 часа |
| **Джекпот** | Следующему кто крутит — гарантированно сложный челлендж с x3 очками | 1 спин |
| **Обмен** | Можно поменяться заданием с другим участником | 1 час |
| **Реванш** | Можно переделать любой свой проваленный челлендж за 50% очков | 4 часа |

---

## Таблица лидеров

Отображает для каждого участника:

- Место в рейтинге
- Общее количество очков
- Текущий streak
- Количество выполненных челленджей
- Количество дропов

---

## Модель данных

### User (Пользователь)

```
- id
- login
- password_hash
- nickname
- avatar
- telegram_id (для уведомлений)
- created_at
```

### Marathon (Марафон)

```
- id
- title
- description
- organizer_id (User)
- start_date
- end_date
- status: preparing | active | finished
- invite_code
- settings (JSON: события вкл/выкл, etc)
- created_at
```

### Participant (Участник марафона)

```
- id
- user_id
- marathon_id
- total_points
- current_streak
- drop_count (текущий счётчик для штрафов)
- joined_at
```

### Game (Игра)

```
- id
- marathon_id
- title
- cover_image (путь к файлу на сервере)
- download_link
- genre
- added_by (User)
- created_at
```

### Challenge (Челлендж)

```
- id
- game_id
- title
- description
- type: completion | no_death | speedrun | collection | achievement | challenge_run | score_attack | time_trial
- difficulty: easy | medium | hard
- points
- estimated_time (в минутах)
- proof_type: screenshot | video | steam_achievement
- is_generated (boolean — создан AI или вручную)
- created_at
```

### Assignment (Задание — выпавшее участнику)

```
- id
- participant_id
- challenge_id
- status: active | completed | dropped
- proof_file (путь к файлу на сервере)
- proof_url (опционально — ссылка)
- proof_comment
- points_earned
- bet_amount
- started_at
- completed_at
```

### Event (Событие)

```
- id
- marathon_id
- type: golden_hour | common_enemy | double_risk | jackpot | swap | rematch
- start_time
- end_time
- is_active
- data (JSON — доп. данные события)
```

### Dispute (Оспаривание пруфа)

```
- id
- assignment_id
- raised_by (User)
- reason
- status: open | resolved_valid | resolved_invalid
- resolved_by (User — организатор или голосование)
- created_at
- resolved_at
```

---

## Уведомления (Telegram-бот)

### Типы уведомлений

- Марафон скоро начнётся
- Кто-то выполнил челлендж
- Тебя вызвали на челлендж
- Твой пруф оспорен
- Началось событие (Золотой час и т.д.)
- Напоминание: у тебя нет активного задания
- Марафон завершён — итоги

### Настройки

Пользователь может включить/выключить отдельные типы уведомлений.

---

## Технические решения

| Аспект | Решение |
|--------|---------|
| Авторизация | Логин/пароль |
| Хранение пруфов | Загрузка на сервер |
| Уведомления | Telegram-бот |
| Генерация челленджей | Интегрированное API нейросети |
| Формат марафона | 1 месяц (с перспективой других режимов) |

---

## Перспективы развития

### Дополнительные режимы марафонов

- **Sprint** (4-12 часов) — интенсивный формат
- **Daily Challenge** (1 неделя) — по 1-3 задания в день
- **Tournament** — несколько раундов, выбывание

### Дополнительные механики

- Колесо модификаторов (без звука, одной рукой, и т.д.)
- Командные марафоны (2v2, 3v3)
- Глобальная статистика и достижения пользователя
- Рейтинговая система игроков

---

## UI/UX — Основные экраны

1. **Главная** — список марафонов (активные, завершённые)
2. **Авторизация** — вход/регистрация
3. **Создание марафона** — форма с настройками
4. **Лобби марафона** — подготовка, добавление игр
5. **Колесо** — основной геймплей (спин игры → спин челленджа)
6. **Текущее задание** — детали + загрузка пруфа
7. **Лента активности** — действия всех участников
8. **Таблица лидеров** — рейтинг участников
9. **История заданий** — все выполненные/дропнутые
10. **Профиль** — настройки, статистика