""" XP-фундамент Pleily. Единая точка начисления опыта: - RANKS — 48 званий × 4 языка - level_for(total_xp) → (level, xp_in_level, xp_needed, rank_key) - award_xp(conn, user_id, game, stars) → dict XP-кривая (по решению от 08.10.2026): Ур.1 → нужно 1000 XP Ур.2 → нужно 1500 XP Ур.3 → нужно 2000 XP ... Ур.N → нужно 1000 + (N-1) * 500 Ур.47 → нужно 24000 XP (потолок, потом расширим до 100) Множитель ×1.5: игра дня (определяется по Europe/Warsaw). """ from __future__ import annotations import logging from datetime import datetime, timezone, timedelta from typing import Optional from zoneinfo import ZoneInfo logger = logging.getLogger(__name__) # ============ Константы ============ WARSAW_TZ = ZoneInfo("Europe/Warsaw") # Игры по кругу (для featured) GAMES = ["wordsearch", "choose", "sentence", "bubbles"] # Множитель игры дня FEATURED_MULTIPLIER = 1.5 # Коэффициенты баланса (настроить после первых 1000 сессий) # Применяются к base_points ДО множителя игры дня. GAME_XP_COEF: dict[str, float] = { "wordsearch": 1.0, "choose": 1.0, "sentence": 1.0, "bubbles": 1.0, } # Максимальный уровень (потом расширим до 100) MAX_LEVEL = 47 # ============ Звания (48 штук × 4 языка) ============ RANKS: list[dict] = [ {"key": "rank_00", "pl": "Nowicjusz", "ru": "Новичок", "uk": "Новачок", "en": "Novice"}, {"key": "rank_01", "pl": "Ciekawski", "ru": "Любопытный", "uk": "Допитливий", "en": "Curious"}, {"key": "rank_02", "pl": "Uczeń", "ru": "Ученик", "uk": "Учень", "en": "Learner"}, {"key": "rank_03", "pl": "Odkrywca", "ru": "Первооткрыватель", "uk": "Першовідкривач", "en": "Pioneer"}, {"key": "rank_04", "pl": "Poszukiwacz", "ru": "Искатель", "uk": "Шукач", "en": "Seeker"}, {"key": "rank_05", "pl": "Tropiciel", "ru": "Следопыт", "uk": "Слідопит", "en": "Pathfinder"}, {"key": "rank_06", "pl": "Obserwator", "ru": "Наблюдатель", "uk": "Спостерігач", "en": "Observer"}, {"key": "rank_07", "pl": "Czytelnik słów", "ru": "Читатель слов", "uk": "Читач слів", "en": "Word Reader"}, {"key": "rank_08", "pl": "Rozmówca", "ru": "Собеседник", "uk": "Співрозмовник", "en": "Conversationalist"}, {"key": "rank_09", "pl": "Praktyk", "ru": "Практик", "uk": "Практик", "en": "Practitioner"}, {"key": "rank_10", "pl": "Gaduła", "ru": "Говорун", "uk": "Балакун", "en": "Chatterbox"}, {"key": "rank_11", "pl": "Znawca liter", "ru": "Знаток букв", "uk": "Знавець літер", "en": "Letter Expert"}, {"key": "rank_12", "pl": "Piśmienny", "ru": "Грамотей", "uk": "Грамотій", "en": "Literate"}, {"key": "rank_13", "pl": "Badacz", "ru": "Исследователь", "uk": "Дослідник", "en": "Explorer"}, {"key": "rank_14", "pl": "Podróżnik", "ru": "Путешественник", "uk": "Мандрівник", "en": "Traveler"}, {"key": "rank_15", "pl": "Pewny siebie", "ru": "Уверенный", "uk": "Впевнений", "en": "Confident"}, {"key": "rank_16", "pl": "Mól książkowy", "ru": "Книгочей", "uk": "Книголюб", "en": "Bookworm"}, {"key": "rank_17", "pl": "Filolog", "ru": "Словесник", "uk": "Філолог", "en": "Wordsmith"}, {"key": "rank_18", "pl": "Krasomówca", "ru": "Краснобай", "uk": "Красномовець", "en": "Smooth Talker"}, {"key": "rank_19", "pl": "Znawca", "ru": "Знаток", "uk": "Знавець", "en": "Connoisseur"}, {"key": "rank_20", "pl": "Mistrz podstaw", "ru": "Мастер азов", "uk": "Майстер основ", "en": "Master of Basics"}, {"key": "rank_21", "pl": "Lingwista amator", "ru": "Лингвист-любитель", "uk": "Лінгвіст-аматор", "en": "Amateur Linguist"}, {"key": "rank_22", "pl": "Tłumacz", "ru": "Переводчик", "uk": "Перекладач", "en": "Translator"}, {"key": "rank_23", "pl": "Poliglota", "ru": "Полиглот", "uk": "Поліглот", "en": "Polyglot"}, {"key": "rank_24", "pl": "Złotousty", "ru": "Златоуст", "uk": "Золотоустий", "en": "Golden Tongue"}, {"key": "rank_25", "pl": "Mistrz słowa", "ru": "Мастер слов", "uk": "Майстер слова", "en": "Word Master"}, {"key": "rank_26", "pl": "Ekspert", "ru": "Эксперт", "uk": "Експерт", "en": "Expert"}, {"key": "rank_27", "pl": "Wirtuoz", "ru": "Виртуоз", "uk": "Віртуоз", "en": "Virtuoso"}, {"key": "rank_28", "pl": "Mentor", "ru": "Наставник", "uk": "Наставник", "en": "Mentor"}, {"key": "rank_29", "pl": "Mędrzec", "ru": "Мудрец", "uk": "Мудрець", "en": "Sage"}, {"key": "rank_30", "pl": "Magister", "ru": "Магистр", "uk": "Магістр", "en": "Magister"}, {"key": "rank_31", "pl": "Profesor", "ru": "Профессор", "uk": "Професор", "en": "Professor"}, {"key": "rank_32", "pl": "Uczony", "ru": "Академик", "uk": "Академік", "en": "Academician"}, {"key": "rank_33", "pl": "Arcymistrz", "ru": "Гроссмейстер", "uk": "Гросмейстер", "en": "Grandmaster"}, {"key": "rank_34", "pl": "Strażnik słów", "ru": "Хранитель слов", "uk": "Хранитель слів", "en": "Keeper of Words"}, {"key": "rank_35", "pl": "Wyrocznia", "ru": "Оракул", "uk": "Оракул", "en": "Oracle"}, {"key": "rank_36", "pl": "Archiwista", "ru": "Архивариус", "uk": "Архіваріус", "en": "Archivist"}, {"key": "rank_37", "pl": "Legenda", "ru": "Легенда", "uk": "Легенда", "en": "Legend"}, {"key": "rank_38", "pl": "Tytan", "ru": "Титан", "uk": "Титан", "en": "Titan"}, {"key": "rank_39", "pl": "Wielki Mistrz", "ru": "Великий мастер", "uk": "Великий майстер", "en": "Great Master"}, {"key": "rank_40", "pl": "Patriarcha języka", "ru": "Патриарх языка", "uk": "Патріарх мови", "en": "Patriarch of Language"}, {"key": "rank_41", "pl": "Gwiazda Pleily", "ru": "Звезда Pleily", "uk": "Зірка Pleily", "en": "Pleily Star"}, {"key": "rank_42", "pl": "Supernowa", "ru": "Сверхновая", "uk": "Наднова", "en": "Supernova"}, {"key": "rank_43", "pl": "Nieśmiertelny", "ru": "Бессмертный", "uk": "Безсмертний", "en": "Immortal"}, {"key": "rank_44", "pl": "Najwyższy poliglota", "ru": "Верховный полиглот", "uk": "Верховний поліглот", "en": "Supreme Polyglot"}, {"key": "rank_45", "pl": "Władca słów", "ru": "Повелитель слов", "uk": "Володар слів", "en": "Lord of Words"}, {"key": "rank_46", "pl": "Żywa legenda", "ru": "Живая легенда", "uk": "Жива легенда", "en": "Living Legend"}, {"key": "rank_47", "pl": "Wieczny poliglota", "ru": "Вечный полиглот", "uk": "Вічний поліглот", "en": "Eternal Polyglot"}, ] # Быстрый доступ: rank_key → dict RANKS_BY_KEY: dict[str, dict] = {r["key"]: r for r in RANKS} # ============ Уровни ============ def xp_needed_for_level(level: int) -> int: """Сколько XP нужно, чтобы перейти с уровня `level` на `level+1`.""" return 1000 + (level - 1) * 500 def level_for(total_xp: int) -> tuple[int, int, int, str]: """ Возвращает (level, xp_in_level, xp_needed_for_next, rank_key). level — от 1 до MAX_LEVEL (47). Если XP больше, level=47, xp_in_level продолжает расти, но xp_needed фиксируется на 24000. """ if total_xp < 0: total_xp = 0 level = 1 need = xp_needed_for_level(1) remaining = total_xp while remaining >= need and level < MAX_LEVEL: remaining -= need level += 1 need = xp_needed_for_level(level) # rank_key — 0-based: level 1 → rank_00, level 2 → rank_01, ... rank_index = min(level - 1, len(RANKS) - 1) rank_key = RANKS[rank_index]["key"] return level, remaining, need, rank_key def rank_for(level: int, lang: str = "ru") -> str: """Название звания для уровня на языке lang.""" idx = min(max(level - 1, 0), len(RANKS) - 1) rank = RANKS[idx] return rank.get(lang) or rank.get("en") or rank["key"] # ============ Игра дня ============ def featured_game(now: Optional[datetime] = None) -> str: """ Игра дня по кругу: wordsearch → choose → sentence → bubbles. Граница суток — Europe/Warsaw. """ if now is None: now = datetime.now(WARSAW_TZ) elif now.tzinfo is None: now = now.replace(tzinfo=WARSAW_TZ) else: now = now.astimezone(WARSAW_TZ) return GAMES[now.date().toordinal() % 4] def featured_seconds_left(now: Optional[datetime] = None) -> int: """Сколько секунд осталось до смены игры дня (до полуночи по Варшаве).""" if now is None: now = datetime.now(WARSAW_TZ) elif now.tzinfo is None: now = now.replace(tzinfo=WARSAW_TZ) else: now = now.astimezone(WARSAW_TZ) tomorrow = (now + timedelta(days=1)).replace( hour=0, minute=0, second=0, microsecond=0 ) return int((tomorrow - now).total_seconds()) # ============ Начисление XP ============ async def award_xp( conn, user_id: int, game: str, points: int, ) -> dict: """ Единая функция начисления опыта. Args: conn: asyncpg connection (уже acquired) user_id: telegram_id (может быть отрицательным для Pleily) game: 'wordsearch' | 'choose' | 'sentence' | 'bubbles' points: готовые очки за уровень (20–110), формула считается до вызова Returns: { "base_points": int, "multiplier": float, "points": int, "featured": bool, "level_up": {"from": int, "to": int, "rank_key": str} | None, "total_xp": int, # после начисления "level": int, # после начисления "rank_key": str, "xp_in_level": int, "xp_needed": int, } """ # 1. Валидация if game not in GAME_XP_COEF: raise ValueError(f"Unknown game: {game}") # 2. База с коэффициентом игры (для баланса) base_points = int(round(points * GAME_XP_COEF.get(game, 1.0))) # 3. Множитель игры дня is_featured = (game == featured_game()) multiplier = FEATURED_MULTIPLIER if is_featured else 1.0 final_points = int(round(base_points * multiplier)) # 4. Читаем текущий total_xp row = await conn.fetchrow( "SELECT total_xp FROM user_profile WHERE user_id = $1", user_id, ) if row is None: # Создаём профиль, если нет await conn.execute( """ INSERT INTO user_profile (user_id, total_xp, weekly_xp) VALUES ($1, 0, 0) ON CONFLICT (user_id) DO NOTHING """, user_id, ) old_total = 0 else: old_total = int(row["total_xp"] or 0) old_level, _, _, _ = level_for(old_total) # 5. Пишем в xp_log await conn.execute( """ INSERT INTO xp_log (user_id, game, stars, base_points, multiplier, points) VALUES ($1, $2, $3, $4, $5, $6) """, user_id, game, 0, base_points, multiplier, final_points, ) # 6. Обновляем user_profile new_total = old_total + points await conn.execute( """ UPDATE user_profile SET total_xp = total_xp + $2, weekly_xp = weekly_xp + $2, updated_at = NOW() WHERE user_id = $1 """, user_id, points, ) # 7. Считаем новый уровень new_level, xp_in_level, xp_needed, rank_key = level_for(new_total) level_up = None if new_level > old_level: level_up = { "from": old_level, "to": new_level, "rank_key": rank_key, } logger.info( "[xp] user=%s level_up %s → %s (%s), +%s xp", user_id, old_level, new_level, rank_key, points, ) return { "stars": stars, "base_points": base, "multiplier": multiplier, "points": points, "featured": is_featured, "level_up": level_up, "total_xp": new_total, "level": new_level, "rank_key": rank_key, "xp_in_level": xp_in_level, "xp_needed": xp_needed, }