Достижения (Achievements)

Сервис достижений является одним из ключевых элементов геймификации платформы. Он позволяет создавать, управлять и отслеживать прогресс пользователей в выполнении различных достижений.

Основные концепции

Достижение (Achievement)

Достижение - это награда, которую пользователь может получить за выполнение определенных условий. Каждое достижение имеет:

• Название и описание (с поддержкой мультиязычности)
• Изображение (значок достижения)
• Условия получения
• Награды за выполнение
• Статус активности (активно/неактивно)

Условия достижения (AchievementCondition)

Условия определяют, при каких обстоятельствах пользователь получает достижение:

• Тип события - какое событие должно произойти (например, выполнение задания, посещение стрима)
• Количество событий - сколько раз должно произойти событие
• Временные рамки - период, в течение которого должны произойти события
• Ограничения - дополнительные условия (например, только для определенных игр или активностей)
• Доступное количество - ограничение на количество пользователей, которые могут получить достижение (или unlimited для неограниченного количества)

Награды за достижения (AchievementReward)

За выполнение достижения пользователь может получить различные награды:

• Внутриигровая валюта
• Опыт
• Предметы из магазина
• Особые статусы или титулы
• Доступ к эксклюзивному контенту

Пакет выдачи (AchievementBatch)

Система обрабатывает выдачу достижений пакетами:

• Создается пакет пользователей, подходящих под условия достижения
• Каждый пользователь в пакете получает достижение и соответствующие награды
• Система отслеживает, кто и когда получил достижение

Бизнес-процессы

Создание достижения

1. Администратор создает новое достижение, указывая:

   • Название и описание на всех поддерживаемых языках
   • Загружает изображение достижения
   • Определяет, будет ли достижение активным сразу после создания

2. Администратор настраивает условия получения достижения:

   • Выбирает тип события (из доступных типов событий)
   • Указывает необходимое количество событий
   • Устанавливает временные рамки (если применимо)
   • Определяет максимальное количество пользователей, которые могут получить достижение

3. Администратор настраивает награды за достижение:

   • Выбирает тип наград (валюта, опыт, предметы)
   • Указывает количество для каждого типа награды

4. Система активирует достижение, делая его доступным для получения пользователями

Получение достижения пользователем

Достижения могут выдаваться двумя способами:

1. Автоматическая выдача на основе событий

1. Пользователь выполняет действие в системе (например, завершает задание)
2. Система генерирует соответствующее событие
3. Сервис достижений получает событие и проверяет, соответствует ли оно условиям каких-либо достижений
4. Если условия достижения выполнены:
   • Создается запись о получении достижения пользователем
   • Пользователю начисляются соответствующие награды
   • Пользователь получает уведомление о получении достижения

2. Периодическая обработка (для сложных условий)

1. Система периодически запускает задачу проверки достижений
2. Для каждого активного достижения:
   • Определяются пользователи, выполнившие условия достижения
   • Формируется пакет выдачи достижения
   • Пользователям начисляются соответствующие награды
   • Отправляются уведомления о получении достижения

Отображение достижений пользователя

1. Пользователь открывает раздел достижений в своем профиле
2. Система отображает:
   • Полученные достижения
   • Достижения в процессе выполнения с индикатором прогресса
   • Доступные, но еще не полученные достижения
   • Награды за каждое достижение

Типы событий для достижений

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

1. Выполнение заданий - события, связанные с выполнением заданий из сервиса задач
2. Игровые события - события из интегрированных игр (Dota 2, CS2)
3. Социальная активность - события из социальных интеграций (Discord, Twitch и т.д.)
4. Взаимодействие с платформой - события, связанные с использованием самой платформы
5. Клановая активность - события, связанные с деятельностью в кланах
6. Транзакции магазина - события покупок в магазине
7. Временные события - события, связанные с определенными временными рамками или датами

Теги достижений

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

• По игре (Dota 2, CS2)
• По типу активности (социальные, игровые, платформенные)
• По сложности (легкие, средние, сложные)
• По сезону или мероприятию
• По тематике

Интеграция с другими сервисами

Сервис достижений тесно интегрирован с другими сервисами системы:

• Сервис задач - достижения могут быть получены за выполнение заданий
• Сервис магазина - предметы из магазина могут быть наградами за достижения
• Сервис пользователей - отслеживание прогресса и выдача достижений пользователям
• Сервис уведомлений - отправка уведомлений о получении достижений
• Игровые сервисы - достижения на основе игровых событий
• Социальные сервисы - достижения за активность в социальных сетях