initial
This commit is contained in:
375
CONCEPT.md
Normal file
375
CONCEPT.md
Normal file
@@ -0,0 +1,375 @@
|
||||
# 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. **Профиль** — настройки, статистика
|
||||
Reference in New Issue
Block a user