Gamification

Модуль BPM2B base gamification — это фреймворк геймификации для платформы BPM2B. Он предоставляет сущности (транзакции баллов, медали, серии активности, отчётные периоды), абстрактные классы и интерфейсы; конкретные процессоры начисления баллов и условия выдачи медалей реализуются в потребляющих модулях через декларативные настройки в metadata.

Основные функциональные возможности:

• Сущность GameTransaction: транзакция начисления / списания баллов — points (float), rule, track, статус pending / completed / cancelled / converted и parent (linkParent на сущность-источник баллов).
• Сущность GameEarnedBadge: заработанная медаль — badge, track, earnedAt, статус active / revoked; дедупликация по badge + user.
• Сущность GameStreak: серия активности — intervalType (daily / weekly / monthly), counter, expiresAt, modifierValue, threshold; статус active → expired или completed.
• Metadata-driven конфигурация: вся настройка треков, правил и медалей в app/gamification.json — tracksMeta, rulesMeta, badges с локализованными именами (nameEn / nameRu / nameKz), иконками, цветами и условиями получения; entityProcessors маппит entityType → класс процессора.
• Глобальный AfterSave-хук: GamificationProcessorHook по любой сущности читает app.gamification.entityProcessors[entityType], создаёт процессор через InjectableFactory, вызывает process() и затем streakCalculator.calculate().
• Абстрактные базовые классы: AbstractGamificationProcessor (createTransaction, hasTransaction, awardBadge, hasBadge, getTotalPoints, getOrCreateStreak), AbstractStreakCalculator (findActiveStreak, updateStreak, calculateExpiryDate) — потребляющие модули наследуются и реализуют только специфическую логику.
• Истечение серий: ScheduledJob ExpireStreaks каждые 15 минут переводит active-серии с истёкшим expiresAt в expired.
• Дашлеты Leaderboard и Badge Honor Board: GET /Leaderboard агрегирует транзакции по активному GameReportingPeriod и сравнивает с предыдущим (change indicators); GET /BadgeHonorBoard группирует медали по пользователям с rarity-скорингом (legendary=100, epic=50, rare=25, uncommon=10, common=5).

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