feat: add giftbox and prestige systems — two new money sinks

Gift boxes (/giftbox):
- 3 tiers: small (50💎), medium (200💎), large (500💎)
- Random rewards: diamonds, titles, or nothing
- Already-owned titles refund 50% as diamonds
- 2 min cooldown between boxes

Prestige (/prestige):
- Costs 50,000💎 — resets balance to 0
- Grants permanent +5% income per level (max 10 = +50%)
- Prestige bonus applies to all /job earnings
- Shows in /profile with star display

Also:
- Updated help text with new commands
- Migration 011: prestige_level column

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: thehaffk

alembic/versions/011_prestige_level.py

@@ -0,0 +1,19 @@
+"""Add prestige_level column to users.
+
+Revision ID: 011
+Revises: 010
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+revision = "011"
+down_revision = "010"
+
+
+def upgrade():
+    op.add_column("users", sa.Column("prestige_level", sa.Integer(), nullable=False, server_default="0"))
+
+
+def downgrade():
+    op.drop_column("users", "prestige_level")

app/bot.py

@@ -17,13 +17,15 @@
 from app.handlers.children import register_children_handlers
 from app.handlers.duel import register_duel_handlers
 from app.handlers.economy import register_economy_handlers
+from app.handlers.giftbox import register_giftbox_handlers
 from app.handlers.feedback import register_feedback_handlers
 from app.handlers.house import register_house_handlers
 from app.handlers.lottery import register_lottery_handlers
 from app.handlers.marriage import register_marriage_handlers
 from app.handlers.menu import register_menu_handlers
 from app.handlers.mine import register_mine_handlers
 from app.handlers.pet import register_pet_handlers
+from app.handlers.prestige import register_prestige_handlers
 from app.handlers.quest import initialize_quests, register_quest_handlers
 from app.handlers.scratch import register_scratch_handlers
 from app.handlers.shop import register_shop_handlers
@@ -99,6 +101,8 @@ def create_bot() -> Application:
     register_scratch_handlers(application)
     register_blackjack_handlers(application)
     register_shop_handlers(application)
+    register_giftbox_handlers(application)
+    register_prestige_handlers(application)
     register_feedback_handlers(application)
     register_admin_handlers(application)
 

app/database/models.py

@@ -33,6 +33,7 @@ class User(Base):
     last_daily_at = Column(DateTime, nullable=True)
     active_title = Column(String(100), nullable=True)
     purchased_titles = Column(String(1000), default="", nullable=False)
+    prestige_level = Column(Integer, default=0, nullable=False)
     created_at = Column(DateTime, default=func.now(), nullable=False)
     updated_at = Column(DateTime, default=func.now(), onupdate=func.now(), nullable=False)
 

app/handlers/giftbox.py

@@ -0,0 +1,197 @@
+"""Gift box (mystery box) command handlers — money sink."""
+
+import random
+from datetime import datetime, timedelta
+
+import structlog
+from telegram import Update
+from telegram.ext import CommandHandler, ContextTypes
+
+from app.database.connection import get_db
+from app.database.models import Cooldown, User
+from app.handlers.quest import update_quest_progress
+from app.handlers.shop import SHOP_TITLES, add_user_title, get_user_titles
+from app.utils.decorators import require_registered
+from app.utils.formatters import format_diamonds
+
+logger = structlog.get_logger()
+
+GIFTBOX_COOLDOWN_SECONDS = 120  # 2 min between boxes
+
+# Box tiers
+BOXES = {
+    "small": {
+        "name": "🎁 Маленький бокс",
+        "price": 50,
+        "rewards": [
+            {"type": "diamonds", "amount": 10, "label": "10💎", "weight": 30},
+            {"type": "diamonds", "amount": 25, "label": "25💎", "weight": 25},
+            {"type": "diamonds", "amount": 50, "label": "50💎", "weight": 15},
+            {"type": "diamonds", "amount": 100, "label": "100💎", "weight": 5},
+            {"type": "nothing", "amount": 0, "label": "Пусто", "weight": 25},
+        ],
+        # EV = 0.30*10 + 0.25*25 + 0.15*50 + 0.05*100 + 0.25*0 = 3+6.25+7.5+5 = 21.75
+        # House edge = (50-21.75)/50 = 56.5%
+    },
+    "medium": {
+        "name": "🎁 Средний бокс",
+        "price": 200,
+        "rewards": [
+            {"type": "diamonds", "amount": 50, "label": "50💎", "weight": 25},
+            {"type": "diamonds", "amount": 100, "label": "100💎", "weight": 20},
+            {"type": "diamonds", "amount": 200, "label": "200💎", "weight": 12},
+            {"type": "diamonds", "amount": 500, "label": "500💎", "weight": 3},
+            {"type": "title", "title_id": "shadow", "label": "☠️ Титул «Тень»", "weight": 5},
+            {"type": "title", "title_id": "fire", "label": "🔥 Титул «Огненный»", "weight": 5},
+            {"type": "nothing", "amount": 0, "label": "Пусто", "weight": 30},
+        ],
+        # EV diamonds = 0.25*50 + 0.20*100 + 0.12*200 + 0.03*500 = 12.5+20+24+15 = 71.5
+        # Titles worth ~1000-1500 each, 10% chance = ~100-150 EV
+        # Total EV ~170-220 vs 200 cost = ~10-15% house edge on average
+    },
+    "large": {
+        "name": "🎁 Большой бокс",
+        "price": 500,
+        "rewards": [
+            {"type": "diamonds", "amount": 100, "label": "100💎", "weight": 20},
+            {"type": "diamonds", "amount": 250, "label": "250💎", "weight": 18},
+            {"type": "diamonds", "amount": 500, "label": "500💎", "weight": 10},
+            {"type": "diamonds", "amount": 1000, "label": "1000💎", "weight": 3},
+            {"type": "diamonds", "amount": 2500, "label": "2500💎 ДЖЕКПОТ!", "weight": 1},
+            {"type": "title", "title_id": "legend", "label": "⭐ Титул «Легенда»", "weight": 4},
+            {"type": "title", "title_id": "angel", "label": "😇 Титул «Ангел»", "weight": 4},
+            {"type": "title", "title_id": "devil", "label": "😈 Титул «Дьявол»", "weight": 4},
+            {"type": "nothing", "amount": 0, "label": "Пусто", "weight": 36},
+        ],
+        # EV diamonds = 0.20*100 + 0.18*250 + 0.10*500 + 0.03*1000 + 0.01*2500 = 20+45+50+30+25 = 170
+        # Titles worth 2000-2500 each, 12% chance = ~240-300
+        # Total EV ~410-470 vs 500 cost = ~6-18% house edge
+    },
+}
+
+
+def roll_reward(box_type: str) -> dict:
+    """Roll a random reward from a box."""
+    box = BOXES[box_type]
+    rewards = box["rewards"]
+    weights = [r["weight"] for r in rewards]
+    return random.choices(rewards, weights=weights, k=1)[0]
+
+
+@require_registered
+async def giftbox_command(update: Update, context: ContextTypes.DEFAULT_TYPE):
+    """Handle /giftbox [small|medium|large] command."""
+    if not update.effective_user or not update.message:
+        return
+
+    user_id = update.effective_user.id
+
+    # Parse box type
+    if not context.args:
+        text = (
+            "🎁 <b>Гифт-боксы</b>\n\n"
+            "Открой бокс и получи случайный приз!\n\n"
+            f"🎁 /giftbox small — {format_diamonds(BOXES['small']['price'])}\n"
+            "   Алмазы 10-100 или пусто\n\n"
+            f"🎁 /giftbox medium — {format_diamonds(BOXES['medium']['price'])}\n"
+            "   Алмазы 50-500 или титул\n\n"
+            f"🎁 /giftbox large — {format_diamonds(BOXES['large']['price'])}\n"
+            "   Алмазы 100-2500 или редкий титул\n\n"
+            "💡 Можно получить титул из магазина бесплатно!"
+        )
+        await update.message.reply_text(text, parse_mode="HTML")
+        return
+
+    box_type = context.args[0].lower()
+    if box_type not in BOXES:
+        await update.message.reply_text("❌ Выбери: small, medium или large")
+        return
+
+    box = BOXES[box_type]
+
+    with get_db() as db:
+        user = db.query(User).filter(User.telegram_id == user_id).first()
+
+        # Check balance
+        if user.balance < box["price"]:
+            await update.message.reply_text(
+                f"❌ Недостаточно алмазов\n\n"
+                f"Цена: {format_diamonds(box['price'])}\n"
+                f"У тебя: {format_diamonds(user.balance)}"
+            )
+            return
+
+        # Check cooldown
+        cooldown = db.query(Cooldown).filter(Cooldown.user_id == user_id, Cooldown.action == "giftbox").first()
+        if cooldown and cooldown.expires_at > datetime.utcnow():
+            remaining = cooldown.expires_at - datetime.utcnow()
+            seconds_left = int(remaining.total_seconds())
+            await update.message.reply_text(f"⏰ Следующий бокс через {seconds_left}с")
+            return
+
+        # Deduct payment
+        user.balance -= box["price"]
+
+        # Set cooldown
+        expires_at = datetime.utcnow() + timedelta(seconds=GIFTBOX_COOLDOWN_SECONDS)
+        if cooldown:
+            cooldown.expires_at = expires_at
+        else:
+            db.add(Cooldown(user_id=user_id, action="giftbox", expires_at=expires_at))
+
+        # Roll reward
+        reward = roll_reward(box_type)
+
+        # Apply reward
+        reward_text = ""
+        if reward["type"] == "diamonds":
+            amount = reward["amount"]
+            user.balance += amount
+            reward_text = f"💎 +{format_diamonds(amount)}"
+        elif reward["type"] == "title":
+            title_id = reward["title_id"]
+            owned = get_user_titles(user)
+            if title_id in owned:
+                # Already has title — give diamond equivalent instead
+                title_data = SHOP_TITLES.get(title_id, {})
+                refund = title_data.get("price", 500) // 2
+                user.balance += refund
+                reward_text = f"🔄 Титул уже есть → +{format_diamonds(refund)}"
+            else:
+                add_user_title(user, title_id)
+                user.active_title = title_id
+                reward_text = f"🏆 {reward['label']} — установлен!"
+        else:
+            reward_text = "💨 Пусто... Повезёт в следующий раз!"
+
+        balance = user.balance
+
+    # Build message
+    text = (
+        f"{box['name']}\n\n"
+        f"Потрачено: {format_diamonds(box['price'])}\n\n"
+        f"<b>{reward_text}</b>\n\n"
+        f"💰 Баланс: {format_diamonds(balance)}"
+    )
+
+    await update.message.reply_text(text, parse_mode="HTML")
+
+    try:
+        update_quest_progress(user_id, "casino")
+    except Exception:
+        pass
+
+    logger.info(
+        "Giftbox opened",
+        user_id=user_id,
+        box_type=box_type,
+        reward_type=reward["type"],
+        reward_label=reward["label"],
+        cost=box["price"],
+    )
+
+
+def register_giftbox_handlers(application):
+    """Register giftbox handlers."""
+    application.add_handler(CommandHandler("giftbox", giftbox_command))
+    logger.info("Giftbox handlers registered")