Merge branch 'Fr1ngg:main' into main

.env.example

@@ -34,6 +34,7 @@ POSTGRES_PASSWORD=secure_password_123
 
 # SQLite настройки (для локального запуска)
 SQLITE_PATH=./data/bot.db
+LOCALES_PATH=./locales
 
 # Redis
 REDIS_URL=redis://redis:6379/0
@@ -112,6 +113,11 @@ PRICE_90_DAYS=36900
 PRICE_180_DAYS=69900
 PRICE_360_DAYS=109900
 
+# Скидка для Базовых Юзеров (Для других Промогрупп не работает!)
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS_ENABLED=false
+# 60:10 = скидка 10% на все доп услуги. 90:20 = 20% за 90 дней и тд
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS=60:10,90:20,180:40,360:70
+
 # Выводимые пакеты трафика и их цены в копейках
 TRAFFIC_PACKAGES_CONFIG="5:2000:false,10:3500:false,25:7000:false,50:11000:true,100:15000:true,250:17000:false,500:19000:false,1000:19500:true,0:20000:true"
 
@@ -267,6 +273,7 @@ MAINTENANCE_AUTO_ENABLE=true
 MAINTENANCE_MESSAGE=Ведутся технические работы. Сервис временно недоступен. Попробуйте позже.
 
 # ===== ЛОКАЛИЗАЦИЯ =====
+# Укажите язык из AVAILABLE_LANGUAGES. При некорректном значении используется ru.
 DEFAULT_LANGUAGE=ru
 AVAILABLE_LANGUAGES=ru,en
 

.github/workflows/docker-hub.yml

@@ -36,15 +36,15 @@ jobs:
           TAGS="fr1ngg/remnawave-bedolaga-telegram-bot:latest,fr1ngg/remnawave-bedolaga-telegram-bot:${VERSION}"
           echo "🏷️ Собираем релизную версию: $VERSION"
         elif [[ $GITHUB_REF == refs/heads/main ]]; then
-          VERSION="v2.3.5-$(git rev-parse --short HEAD)"
+          VERSION="v2.3.6-$(git rev-parse --short HEAD)"
           TAGS="fr1ngg/remnawave-bedolaga-telegram-bot:latest,fr1ngg/remnawave-bedolaga-telegram-bot:${VERSION}"
           echo "🚀 Собираем версию из main: $VERSION"
         elif [[ $GITHUB_REF == refs/heads/dev ]]; then
-          VERSION="v2.3.5-dev-$(git rev-parse --short HEAD)"
+          VERSION="v2.3.6-dev-$(git rev-parse --short HEAD)"
           TAGS="fr1ngg/remnawave-bedolaga-telegram-bot:dev,fr1ngg/remnawave-bedolaga-telegram-bot:${VERSION}"
           echo "🧪 Собираем dev версию: $VERSION"
         else
-          VERSION="v2.3.5-pr-$(git rev-parse --short HEAD)"
+          VERSION="v2.3.6-pr-$(git rev-parse --short HEAD)"
           TAGS="fr1ngg/remnawave-bedolaga-telegram-bot:pr-$(git rev-parse --short HEAD)"
           echo "🔀 Собираем PR версию: $VERSION"
         fi

.github/workflows/docker-registry.yml

@@ -49,13 +49,13 @@ jobs:
             VERSION=${GITHUB_REF#refs/tags/}
             echo "🏷️ Building release version: $VERSION"
           elif [[ $GITHUB_REF == refs/heads/main ]]; then
-            VERSION="v2.3.5-$(git rev-parse --short HEAD)"
+            VERSION="v2.3.6-$(git rev-parse --short HEAD)"
             echo "🚀 Building main version: $VERSION"
           elif [[ $GITHUB_REF == refs/heads/dev ]]; then
-            VERSION="v2.3.5-dev-$(git rev-parse --short HEAD)"
+            VERSION="v2.3.6-dev-$(git rev-parse --short HEAD)"
             echo "🧪 Building dev version: $VERSION"
           else
-            VERSION="v2.3.5-pr-$(git rev-parse --short HEAD)"
+            VERSION="v2.3.6-pr-$(git rev-parse --short HEAD)"
             echo "🔀 Building PR version: $VERSION"
           fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT

.gitignore

@@ -12,6 +12,8 @@
 # Разрешаем папку app/ и все её содержимое рекурсивно
 !app/
 !app/**
+!locales/
+!locales/**
 
 # Дополнительно разрешаем README и лицензию (опционально)
 !README.md

Dockerfile

@@ -14,7 +14,7 @@ RUN pip install --no-cache-dir --upgrade pip && \
 
 FROM python:3.13-slim
 
-ARG VERSION="v2.3.5"
+ARG VERSION="v2.3.6"
 ARG BUILD_DATE
 ARG VCS_REF
 

README.md

@@ -159,6 +159,12 @@ PRICE_90_DAYS=36900
 PRICE_180_DAYS=69900
 PRICE_360_DAYS=109900
 
+# Скидка для Базовых Юзеров (Для других Промогрупп не работает!)
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS_ENABLED=false
+# 60:10 = скидка 10% на все доп услуги. 90:20 = 20% за 90 дней и тд
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS=60:10,90:20,180:40,360:70
+
+
 # Выводимые пакеты трафика и их цены в копейках
 TRAFFIC_PACKAGES_CONFIG="5:2000:false,10:3500:false,25:7000:false,50:11000:true,100:15000:true,250:17000:false,500:19000:false,1000:19500:true,0:20000:true"
 
@@ -331,6 +337,11 @@ PRICE_90_DAYS=36900
 PRICE_180_DAYS=69900
 PRICE_360_DAYS=109900
 
+# Скидка для Базовых Юзеров (Для других Промогрупп не работает!)
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS_ENABLED=false
+# 60:10 = скидка 10% на все доп услуги. 90:20 = 20% за 90 дней и тд
+BASE_PROMO_GROUP_PERIOD_DISCOUNTS=60:10,90:20,180:40,360:70
+
 # Выводимые пакеты трафика и их цены в копейках
 TRAFFIC_PACKAGES_CONFIG="5:2000:false,10:3500:false,25:7000:false,50:11000:true,100:15000:true,250:17000:false,500:19000:false,1000:19500:true,0:20000:true"
 
@@ -479,6 +490,7 @@ MAINTENANCE_AUTO_ENABLE=true
 MAINTENANCE_MESSAGE=Ведутся технические работы. Сервис временно недоступен. Попробуйте позже.
 
 # ===== ЛОКАЛИЗАЦИЯ =====
+# Укажите язык из AVAILABLE_LANGUAGES. При некорректном значении используется ru.
 DEFAULT_LANGUAGE=ru
 AVAILABLE_LANGUAGES=ru,en
 
@@ -537,35 +549,37 @@ WEBHOOK_PATH=/webhook
 🛒 **Умная покупка подписок**
 - 📅 Гибкие периоды (14-360 дней)
 - 📊 Выбор трафика или фиксированный лимит
-- 🌍 Автоматический выбор серверов(для одного сквада) или ручной выбор из множества
-- 📱 Настройка количества устройств
+- 🌍 Автоматический выбор серверов (для одного сквада) или ручной выбор из множества
+- 📱 Настройка количества устройств и серверов прямо при оформлении
+- 🧾 Понятный калькулятор стоимости с учетом всех опций
 
 🧪 **Тестовая подписка**
 - Настраиваемый триал-период
-- Уведомления об истечении
-- Плавный переход на платную версию
-- Приветственное сообщение с предложением активации триала (С возможностью отключения)
+- Уведомления об истечении и сценарий мягкой конверсии в платную подписку
+- Приветственное сообщение с предложением активации триала (с возможностью отключения)
+- Поддержка рекламных кампаний с автоматической выдачей бонусных подписок
 
 💰 **Удобные платежи**
-- ⭐ Telegram Stars 
-- 💳 Tribute 
-- 💳 YooKassa
-- 💰 CryptoBot
-- 🎁 Реферальные бонусы
-- Детальная история транзакций 
+- ⭐ Telegram Stars
+- 💳 Tribute
+- 💳 YooKassa (включая СБП и онлайн-чек)
+- 💰 CryptoBot (мультивалюта и срок жизни инвойсов)
+- 🎁 Реферальные и промо-бонусы
+- Детальная история транзакций и чеков
 
 📱 **Управление подписками**
-- 📈 Статистика использования в реальном времени (Используемый трафик, подключенные устройства)
-- 🔄 Автопродление с баланса
-- 🔄 Управление трафиком
-- 🌍 Переключение серверов на лету
+- 📈 Статистика использования в реальном времени (трафик, устройства, серверы)
+- 🔄 Автопродление с баланса с настройкой дней и мгновенными уведомлениями
+- 🔄 Управление трафиком и лимитами без участия оператора
+- 🌍 Переключение серверов Remnawave на лету
 - 📱 Управление устройствами + сброс HWID
+- 🧩 Смена языка и персональных настроек
 
 🎁 **Бонусная система**
-- 🎫 Промокоды на деньги/дни/триал
-- 👥 Защищенная реферальная программа с комиссиями
-- 🔔 Своевременные уведомления
-- 📊 Детальная статистика рефералов
+- 🎫 Промокоды на деньги/дни/длинный триал
+- 👥 Защищенная реферальная программа с комиссиями и антифродом
+- 📊 Детальная статистика рефералов и кампаний
+- 📨 Персональные рассылки и уведомления о новых бонусах
 
 </td>
 <td width="50%" valign="top">
@@ -573,65 +587,98 @@ WEBHOOK_PATH=/webhook
 ### ⚙️ **Для администраторов**
 
 📊 **Мощная аналитика**
-- 👥 Детальная статистика пользователей
-- 💰 Анализ подписок и платежей
-- 🖥️ Мониторинг серверов Remnawave
-- 📈 Финансовые отчеты и тренды
+- 👥 Детальная статистика пользователей и подписок
+- 💰 Анализ платежей по источникам (Stars, YooKassa, Tribute, CryptoBot)
+- 🖥️ Мониторинг серверов Remnawave и статуса сквадов
+- 📈 Финансовые отчеты, конверсии и эффективность рекламных кампаний
 
 👥 **Управление пользователями**
 - 🔍 Поиск и редактирование профилей
-- 💰 Управление балансами
+- 💰 Управление балансами и ручные начисления
 - 📱 Изменение лимита устройств (1-X)
-- 📊 Настройка лимитов трафика (0-10000 ГБ)
-- 🌍 Мультивыбор серверов
-- 🔄 Сброс HWID устройств
+- 📊 Настройка лимитов трафика (0-10000 ГБ) и подключенных сквадов
+- 🌍 Мультивыбор серверов и мгновенная синхронизация с панелью
+- 🔄 Сброс HWID устройств и обновление конфигураций
 - 👥 Детальная реферальная статистика в профиле пользователя
-- 🔄 **НОВОЕ**: Изминение типа подписки триал/платная
-- 🚫 Блокировка/разблокировка/удаление
+- 🔄 Изменение типа подписки триал/платная и ручное продление
+- 🚫 Блокировка/разблокировка/удаление аккаунтов
 
-🎫 **Промо-система**
-- 🎁 Создание промокодов (деньги/дни/длинный триал)
-- 📊 Детальная статистика использования
-- ⚙️ Полное редактирование промокодов
+🎯 **Маркетинг и продажи**
+- 🎫 Гибкая промо-система (деньги/дни/длинный триал)
+- 📣 Рекламные кампании с автоматическими бонусами за регистрацию
+- 📊 Детальная статистика использования промокодов и кампаний
+- 📨 Рассылки по сегментам с фильтрами по активности, подпискам и языкам
 
 🖥️ **Умный мониторинг**
-- 💚 Состояние Remnawave панели в реальном времени
-- 🔄 Автоматическая синхронизация данных
-- 🌐 Управление сквадами с актуальным статусом
-- 🚧 **Автоматический режим тех. работ**
-- 📋 Логи и диагностика
+- 💚 Контроль доступности Remnawave панели в реальном времени
+- 🔄 Автоматическая синхронизация данных и реконнект при ошибках
+- 🌐 Управление сквадами с актуальным статусом и массовыми действиями
+- 🚧 Автоматический режим тех. работ с уведомлениями пользователей
+- 📋 Логи и диагностика, включая журнал сбоев и действий бота
+- 📦 Проверка обновлений проекта и уведомления о новых релизах
 
-📨 **Коммуникации**
-- 📢 Рассылки по сегментам
-- 🔔 Автоуведомления о продлении
-- 💬 Система поддержки с HTML разметкой
-- 📝 Настройка правил сервиса
+📨 **Коммуникации и поддержка**
+- 📢 Рассылки по сегментам и мгновенные оповещения
+- 🔔 Автоуведомления о продлении, задолженностях и автоплатежах
+- 💬 Система поддержки с HTML разметкой и история обращений
+- 📝 Настройка правил сервиса, FAQ и приветственных экранов
 - 🧪 Настраиваемое приветственное сообщение с предложением активации триала
 
 📨 **Уведомления в закрытый канал**
-- 🎯 Активация триала
-- 💎 Покупка подписки
-- 🔄 Конверсия из триала в платную
-- ⏰ Продление подписки
-- 💰 Пополнение баланса
-- ♻️ Выход обновлений бота
-- 🚧 Потеря соелинения с апи Remnawave
-- 🗄️ **Бекапы/Восстановление бд**
-- 🗄️ Отправка бд файлов в отдельный чат/топики
-- ⚙️ Изменение параметров подписки юзером (Уменьшение/Увеличение трафика/серверов/устройств на подписке)
+- 🎯 Активация триала, продления и конверсии в платную подписку
+- 💎 Покупка подписки и пополнение баланса
+- 🔄 Изменения параметров подписки пользователем
+- 🚧 Потеря соединения с Remnawave и включение техработ
+- 🗄️ Авто- и ручные бекапы/восстановления с отправкой файлов
+- ♻️ Выхлоп новых версий бота и результаты автоплатежей
 
-🗄️ **Бекапы/Восстановление**
-- Ручной запуск бекапа
-- Восстановление бд
-- Включение/Отключение автобекапов
-- Отправка копии бд файла в отдеьный чат/топик
+🗄️ **Бекапы и восстановление**
+- Ручной запуск бекапа с выбором содержимого (включая логи)
+- Автоматические бекапы по расписанию и управление retention-политикой
+- Восстановление из бекапа без остановки сервиса
+- Отправка копии бекапа в выделенный чат/топик и ведение метаданных
+
+💳 **Автоплатежи и биллинг**
+- Настройки автоплатежа на уровне пользователя (вкл/выкл, дни до списания)
+- Принудительная проверка готовности автосписаний
+- Уведомления об успешных и неудачных автоплатежах с подсказками действий
+- Настройка минимального баланса и логирование всех списаний
 
 </td>
 </tr>
 </table>
 
+### 🤖 Автоматизация и экосистема
+
+- 🔄 **Мониторинг Remnawave** — регулярная проверка API, автоматическое включение/выключение техработ и сообщения в топики.
+- 🛡️ **Антифрод** — валидация обязательной подписки на канал, проверка уникальности устройств и логирование действий.
+- 🧠 **Асинхронная архитектура** — aiogram 3, PostgreSQL/SQLite, Redis и очередь задач для стабильной работы под нагрузкой.
+- 🌐 **Мультиязычность** — локализации в `locales/`, быстрый выбор языка пользователем, готовность к расширению.
+- 📦 **Интеграция с Remnawave API** — автоматическое создание пользователей, управление сквадами и синхронизация подписок.
+- 🧾 **История операций** — хранение транзакций, уведомлений, рассылок, кампаний и бекапов для аудита.
+
+### 🧭 Навигация по проекту
+
+- `app/bot.py` — точка входа бота и регистрация middlewares/handlers.
+- `app/handlers/` — сценарии общения (пользовательские и административные).
+- `app/services/` — бизнес-логика: подписки, платежи, мониторинг, бекапы, кампании, версия.
+- `app/database/` — модели SQLAlchemy, CRUD и миграции Alembic.
+- `app/localization/` и `locales/` — тексты интерфейса и переводов.
+- `migrations/` — текущие миграции БД для PostgreSQL.
+
+## Локализации
+
+- Каталог `locales/` содержит файлы локализаций в формате `.yml` или `.json` (например, `ru.yml`, `en.yml`). Эти файлы можно редактировать напрямую на рабочем сервере.
+- Структура YAML/JSON повторяет иерархию ключей, объявленных в `app/localization/texts.py`. Например, блок `MENU:` и пара `BALANCE: "Баланс"` соответствуют ключу `MENU_BALANCE`. При добавлении новых ключей сохраняйте верхний регистр и единый стиль именования.
+- Порядок внесения правок:
+  1. Измените нужные значения в файле `locales/<язык>.yml` (или `.json`).
+  2. Перезапустите бота/контейнер (`docker compose restart bot` в Docker) — при старте приложение перечитает локали.
+- Путь до пользовательских локалей задаётся переменной `LOCALES_PATH` (`./locales` по умолчанию; в Docker каталог монтируется в `/app/locales`, см. `docker-compose.yml`).
+- При первом запуске, если каталог пуст, бот копирует шаблоны `ru.yml` и `en.yml` — благодаря этому у владельца сразу есть заготовки для редактирования.
+
 ---
 
+
 ## 🐳 Docker развертывание
 
 ### 📄 docker-compose.yml

app/bot.py

@@ -31,6 +31,7 @@ from app.handlers.admin import (
     statistics as admin_statistics,
     servers as admin_servers,
     maintenance as admin_maintenance,
+    promo_groups as admin_promo_groups,
     campaigns as admin_campaigns,
     user_messages as admin_user_messages,
     updates as admin_updates,
@@ -127,6 +128,7 @@ async def setup_bot() -> tuple[Bot, Dispatcher]:
     admin_rules.register_handlers(dp)
     admin_remnawave.register_handlers(dp)
     admin_statistics.register_handlers(dp)
+    admin_promo_groups.register_handlers(dp)
     admin_campaigns.register_handlers(dp)
     admin_maintenance.register_handlers(dp)
     admin_user_messages.register_handlers(dp)

app/config.py

@@ -31,6 +31,7 @@ class Settings(BaseSettings):
     POSTGRES_PASSWORD: str = "secure_password_123"
     
     SQLITE_PATH: str = "./data/bot.db"
+    LOCALES_PATH: str = "./locales"
     
     DATABASE_MODE: str = "auto"
     
@@ -71,7 +72,7 @@ class Settings(BaseSettings):
     PRICE_90_DAYS: int = 269000
     PRICE_180_DAYS: int = 499000
     PRICE_360_DAYS: int = 899000
-    
+
     PRICE_TRAFFIC_5GB: int = 2000
     PRICE_TRAFFIC_10GB: int = 3500
     PRICE_TRAFFIC_25GB: int = 7000
@@ -83,9 +84,12 @@ class Settings(BaseSettings):
     PRICE_TRAFFIC_UNLIMITED: int = 20000
     
     TRAFFIC_PACKAGES_CONFIG: str = ""
-    
+
     PRICE_PER_DEVICE: int = 5000
-    
+
+    BASE_PROMO_GROUP_PERIOD_DISCOUNTS_ENABLED: bool = False
+    BASE_PROMO_GROUP_PERIOD_DISCOUNTS: str = ""
+
     TRAFFIC_SELECTION_MODE: str = "selectable" 
     FIXED_TRAFFIC_LIMIT_GB: int = 100 
     
@@ -398,7 +402,46 @@ class Settings(BaseSettings):
     
     def get_maintenance_check_interval(self) -> int:
         return self.MAINTENANCE_CHECK_INTERVAL
-    
+
+    def is_base_promo_group_period_discount_enabled(self) -> bool:
+        return self.BASE_PROMO_GROUP_PERIOD_DISCOUNTS_ENABLED
+
+    def get_base_promo_group_period_discounts(self) -> Dict[int, int]:
+        try:
+            config_str = (self.BASE_PROMO_GROUP_PERIOD_DISCOUNTS or "").strip()
+            if not config_str:
+                return {}
+
+            discounts: Dict[int, int] = {}
+            for part in config_str.split(','):
+                part = part.strip()
+                if not part:
+                    continue
+
+                period_and_discount = part.split(':')
+                if len(period_and_discount) != 2:
+                    continue
+
+                period_str, discount_str = period_and_discount
+                try:
+                    period_days = int(period_str.strip())
+                    discount_percent = int(discount_str.strip())
+                except ValueError:
+                    continue
+
+                discounts[period_days] = max(0, min(100, discount_percent))
+
+            return discounts
+        except Exception:
+            return {}
+
+    def get_base_promo_group_period_discount(self, period_days: Optional[int]) -> int:
+        if not period_days or not self.is_base_promo_group_period_discount_enabled():
+            return 0
+
+        discounts = self.get_base_promo_group_period_discounts()
+        return discounts.get(period_days, 0)
+
     def is_maintenance_auto_enable(self) -> bool:
         return self.MAINTENANCE_AUTO_ENABLE
 

app/database/crud/promo_group.py

@@ -0,0 +1,145 @@
+import logging
+from typing import List, Optional, Tuple
+
+from sqlalchemy import func, select, update
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.orm import selectinload
+
+from app.database.models import PromoGroup, User
+
+logger = logging.getLogger(__name__)
+
+
+async def get_promo_groups_with_counts(
+    db: AsyncSession,
+) -> List[Tuple[PromoGroup, int]]:
+    result = await db.execute(
+        select(PromoGroup, func.count(User.id))
+        .outerjoin(User, User.promo_group_id == PromoGroup.id)
+        .group_by(PromoGroup.id)
+        .order_by(PromoGroup.is_default.desc(), PromoGroup.name)
+    )
+    return result.all()
+
+
+async def get_promo_group_by_id(db: AsyncSession, group_id: int) -> Optional[PromoGroup]:
+    return await db.get(PromoGroup, group_id)
+
+
+async def get_default_promo_group(db: AsyncSession) -> Optional[PromoGroup]:
+    result = await db.execute(
+        select(PromoGroup).where(PromoGroup.is_default.is_(True))
+    )
+    return result.scalars().first()
+
+
+async def create_promo_group(
+    db: AsyncSession,
+    name: str,
+    *,
+    server_discount_percent: int,
+    traffic_discount_percent: int,
+    device_discount_percent: int,
+) -> PromoGroup:
+    promo_group = PromoGroup(
+        name=name.strip(),
+        server_discount_percent=max(0, min(100, server_discount_percent)),
+        traffic_discount_percent=max(0, min(100, traffic_discount_percent)),
+        device_discount_percent=max(0, min(100, device_discount_percent)),
+        is_default=False,
+    )
+
+    db.add(promo_group)
+    await db.commit()
+    await db.refresh(promo_group)
+
+    logger.info(
+        "Создана промогруппа '%s' с скидками (servers=%s%%, traffic=%s%%, devices=%s%%)",
+        promo_group.name,
+        promo_group.server_discount_percent,
+        promo_group.traffic_discount_percent,
+        promo_group.device_discount_percent,
+    )
+
+    return promo_group
+
+
+async def update_promo_group(
+    db: AsyncSession,
+    group: PromoGroup,
+    *,
+    name: Optional[str] = None,
+    server_discount_percent: Optional[int] = None,
+    traffic_discount_percent: Optional[int] = None,
+    device_discount_percent: Optional[int] = None,
+) -> PromoGroup:
+    if name is not None:
+        group.name = name.strip()
+    if server_discount_percent is not None:
+        group.server_discount_percent = max(0, min(100, server_discount_percent))
+    if traffic_discount_percent is not None:
+        group.traffic_discount_percent = max(0, min(100, traffic_discount_percent))
+    if device_discount_percent is not None:
+        group.device_discount_percent = max(0, min(100, device_discount_percent))
+
+    await db.commit()
+    await db.refresh(group)
+
+    logger.info(
+        "Обновлена промогруппа '%s' (id=%s)",
+        group.name,
+        group.id,
+    )
+    return group
+
+
+async def delete_promo_group(db: AsyncSession, group: PromoGroup) -> bool:
+    if group.is_default:
+        logger.warning("Попытка удалить базовую промогруппу запрещена")
+        return False
+
+    default_group = await get_default_promo_group(db)
+    if not default_group:
+        logger.error("Не найдена базовая промогруппа для reassignment")
+        return False
+
+    await db.execute(
+        update(User)
+        .where(User.promo_group_id == group.id)
+        .values(promo_group_id=default_group.id)
+    )
+    await db.delete(group)
+    await db.commit()
+
+    logger.info(
+        "Промогруппа '%s' (id=%s) удалена, пользователи переведены в '%s'",
+        group.name,
+        group.id,
+        default_group.name,
+    )
+    return True
+
+
+async def get_promo_group_members(
+    db: AsyncSession,
+    group_id: int,
+    *,
+    offset: int = 0,
+    limit: int = 20,
+) -> List[User]:
+    result = await db.execute(
+        select(User)
+        .options(selectinload(User.subscription))
+        .where(User.promo_group_id == group_id)
+        .order_by(User.created_at.desc())
+        .offset(offset)
+        .limit(limit)
+    )
+    return result.scalars().all()
+
+
+async def count_promo_group_members(db: AsyncSession, group_id: int) -> int:
+    result = await db.execute(
+        select(func.count(User.id)).where(User.promo_group_id == group_id)
+    )
+    return result.scalar_one()

app/database/crud/subscription.py

@@ -6,8 +6,11 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 
 from app.database.models import (
-    Subscription, SubscriptionStatus, User,
-    SubscriptionServer
+    Subscription,
+    SubscriptionStatus,
+    User,
+    SubscriptionServer,
+    PromoGroup,
 )
 from app.database.crud.notification import clear_notifications
 from app.utils.pricing_utils import calculate_months_from_days, get_remaining_months
@@ -495,12 +498,34 @@ async def get_servers_monthly_prices(
         prices.append(price)
     return prices
 
+def _get_discount_percent(
+    user: Optional[User],
+    promo_group: Optional[PromoGroup],
+    category: str,
+    *,
+    period_days: Optional[int] = None,
+) -> int:
+    if user is not None:
+        try:
+            return user.get_promo_discount(category, period_days)
+        except AttributeError:
+            pass
+
+    if promo_group is not None:
+        return promo_group.get_discount_percent(category, period_days)
+
+    return 0
+
+
 async def calculate_subscription_total_cost(
     db: AsyncSession,
     period_days: int,
     traffic_gb: int,
     server_squad_ids: List[int],
-    devices: int
+    devices: int,
+    *,
+    user: Optional[User] = None,
+    promo_group: Optional[PromoGroup] = None,
 ) -> Tuple[int, dict]:
     from app.config import PERIOD_PRICES
     
@@ -508,39 +533,98 @@ async def calculate_subscription_total_cost(
     
     base_price = PERIOD_PRICES.get(period_days, 0)
     
+    promo_group = promo_group or (user.promo_group if user else None)
+
     traffic_price_per_month = settings.get_traffic_price(traffic_gb)
-    total_traffic_price = traffic_price_per_month * months_in_period
-    
+    traffic_discount_percent = _get_discount_percent(
+        user,
+        promo_group,
+        "traffic",
+        period_days=period_days,
+    )
+    traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+    discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+    total_traffic_price = discounted_traffic_per_month * months_in_period
+    total_traffic_discount = traffic_discount_per_month * months_in_period
+
     servers_prices = await get_servers_monthly_prices(db, server_squad_ids)
     servers_price_per_month = sum(servers_prices)
-    total_servers_price = servers_price_per_month * months_in_period
-    
+    servers_discount_percent = _get_discount_percent(
+        user,
+        promo_group,
+        "servers",
+        period_days=period_days,
+    )
+    servers_discount_per_month = servers_price_per_month * servers_discount_percent // 100
+    discounted_servers_per_month = servers_price_per_month - servers_discount_per_month
+    total_servers_price = discounted_servers_per_month * months_in_period
+    total_servers_discount = servers_discount_per_month * months_in_period
+
     additional_devices = max(0, devices - settings.DEFAULT_DEVICE_LIMIT)
     devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-    total_devices_price = devices_price_per_month * months_in_period
-    
+    devices_discount_percent = _get_discount_percent(
+        user,
+        promo_group,
+        "devices",
+        period_days=period_days,
+    )
+    devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+    discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+    total_devices_price = discounted_devices_per_month * months_in_period
+    total_devices_discount = devices_discount_per_month * months_in_period
+
     total_cost = base_price + total_traffic_price + total_servers_price + total_devices_price
-    
+
     details = {
         'base_price': base_price,
         'traffic_price_per_month': traffic_price_per_month,
+        'traffic_discount_percent': traffic_discount_percent,
+        'traffic_discount_total': total_traffic_discount,
         'total_traffic_price': total_traffic_price,
         'servers_price_per_month': servers_price_per_month,
+        'servers_discount_percent': servers_discount_percent,
+        'servers_discount_total': total_servers_discount,
         'total_servers_price': total_servers_price,
         'devices_price_per_month': devices_price_per_month,
+        'devices_discount_percent': devices_discount_percent,
+        'devices_discount_total': total_devices_discount,
         'total_devices_price': total_devices_price,
         'months_in_period': months_in_period,
-        'servers_individual_prices': [price * months_in_period for price in servers_prices]
+        'servers_individual_prices': [
+            (price - (price * servers_discount_percent // 100)) * months_in_period
+            for price in servers_prices
+        ]
     }
-    
+
     logger.info(f"📊 Расчет стоимости подписки на {period_days} дней ({months_in_period} мес):")
     logger.info(f"   Базовый период: {base_price/100}₽")
     if total_traffic_price > 0:
-        logger.info(f"   Трафик: {traffic_price_per_month/100}₽/мес × {months_in_period} = {total_traffic_price/100}₽")
+        message = (
+            f"   Трафик: {traffic_price_per_month/100}₽/мес × {months_in_period} = {total_traffic_price/100}₽"
+        )
+        if total_traffic_discount > 0:
+            message += (
+                f" (скидка {traffic_discount_percent}%: -{total_traffic_discount/100}₽)"
+            )
+        logger.info(message)
     if total_servers_price > 0:
-        logger.info(f"   Серверы: {servers_price_per_month/100}₽/мес × {months_in_period} = {total_servers_price/100}₽")
+        message = (
+            f"   Серверы: {servers_price_per_month/100}₽/мес × {months_in_period} = {total_servers_price/100}₽"
+        )
+        if total_servers_discount > 0:
+            message += (
+                f" (скидка {servers_discount_percent}%: -{total_servers_discount/100}₽)"
+            )
+        logger.info(message)
     if total_devices_price > 0:
-        logger.info(f"   Устройства: {devices_price_per_month/100}₽/мес × {months_in_period} = {total_devices_price/100}₽")
+        message = (
+            f"   Устройства: {devices_price_per_month/100}₽/мес × {months_in_period} = {total_devices_price/100}₽"
+        )
+        if total_devices_discount > 0:
+            message += (
+                f" (скидка {devices_discount_percent}%: -{total_devices_discount/100}₽)"
+            )
+        logger.info(message)
     logger.info(f"   ИТОГО: {total_cost/100}₽")
     
     return total_cost, details
@@ -614,19 +698,33 @@ async def remove_subscription_servers(
 async def get_subscription_renewal_cost(
     db: AsyncSession,
     subscription_id: int,
-    period_days: int
+    period_days: int,
+    *,
+    user: Optional[User] = None,
+    promo_group: Optional[PromoGroup] = None,
 ) -> int:
     try:
         from app.config import PERIOD_PRICES
-        
+
         months_in_period = calculate_months_from_days(period_days)
-        
+
         base_price = PERIOD_PRICES.get(period_days, 0)
-        
-        subscription = await db.get(Subscription, subscription_id)
+
+        result = await db.execute(
+            select(Subscription)
+            .options(
+                selectinload(Subscription.user).selectinload(User.promo_group),
+            )
+            .where(Subscription.id == subscription_id)
+        )
+        subscription = result.scalar_one_or_none()
         if not subscription:
             return base_price
-        
+
+        if user is None:
+            user = subscription.user
+        promo_group = promo_group or (user.promo_group if user else None)
+
         servers_info = await get_subscription_servers(db, subscription_id)
         servers_price_per_month = 0
         for server_info in servers_info:
@@ -637,26 +735,74 @@ async def get_subscription_renewal_cost(
             )
             current_server_price = result.scalar() or 0
             servers_price_per_month += current_server_price
-        
-        total_servers_cost = servers_price_per_month * months_in_period
-        
+
+        servers_discount_percent = _get_discount_percent(
+            user,
+            promo_group,
+            "servers",
+            period_days=period_days,
+        )
+        servers_discount_per_month = servers_price_per_month * servers_discount_percent // 100
+        discounted_servers_per_month = servers_price_per_month - servers_discount_per_month
+        total_servers_cost = discounted_servers_per_month * months_in_period
+        total_servers_discount = servers_discount_per_month * months_in_period
+
         traffic_price_per_month = settings.get_traffic_price(subscription.traffic_limit_gb)
-        total_traffic_cost = traffic_price_per_month * months_in_period
-        
+        traffic_discount_percent = _get_discount_percent(
+            user,
+            promo_group,
+            "traffic",
+            period_days=period_days,
+        )
+        traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+        discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+        total_traffic_cost = discounted_traffic_per_month * months_in_period
+        total_traffic_discount = traffic_discount_per_month * months_in_period
+
         additional_devices = max(0, subscription.device_limit - settings.DEFAULT_DEVICE_LIMIT)
         devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-        total_devices_cost = devices_price_per_month * months_in_period
-        
+        devices_discount_percent = _get_discount_percent(
+            user,
+            promo_group,
+            "devices",
+            period_days=period_days,
+        )
+        devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+        discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+        total_devices_cost = discounted_devices_per_month * months_in_period
+        total_devices_discount = devices_discount_per_month * months_in_period
+
         total_cost = base_price + total_servers_cost + total_traffic_cost + total_devices_cost
-        
+
         logger.info(f"💰 Расчет продления подписки {subscription_id} на {period_days} дней ({months_in_period} мес):")
         logger.info(f"   📅 Период: {base_price/100}₽")
         if total_servers_cost > 0:
-            logger.info(f"   🌍 Серверы: {servers_price_per_month/100}₽/мес × {months_in_period} = {total_servers_cost/100}₽")
+            message = (
+                f"   🌍 Серверы: {servers_price_per_month/100}₽/мес × {months_in_period} = {total_servers_cost/100}₽"
+            )
+            if total_servers_discount > 0:
+                message += (
+                    f" (скидка {servers_discount_percent}%: -{total_servers_discount/100}₽)"
+                )
+            logger.info(message)
         if total_traffic_cost > 0:
-            logger.info(f"   📊 Трафик: {traffic_price_per_month/100}₽/мес × {months_in_period} = {total_traffic_cost/100}₽")
+            message = (
+                f"   📊 Трафик: {traffic_price_per_month/100}₽/мес × {months_in_period} = {total_traffic_cost/100}₽"
+            )
+            if total_traffic_discount > 0:
+                message += (
+                    f" (скидка {traffic_discount_percent}%: -{total_traffic_discount/100}₽)"
+                )
+            logger.info(message)
         if total_devices_cost > 0:
-            logger.info(f"   📱 Устройства: {devices_price_per_month/100}₽/мес × {months_in_period} = {total_devices_cost/100}₽")
+            message = (
+                f"   📱 Устройства: {devices_price_per_month/100}₽/мес × {months_in_period} = {total_devices_cost/100}₽"
+            )
+            if total_devices_discount > 0:
+                message += (
+                    f" (скидка {devices_discount_percent}%: -{total_devices_discount/100}₽)"
+                )
+            logger.info(message)
         logger.info(f"   💎 ИТОГО: {total_cost/100}₽")
         
         return total_cost
@@ -671,27 +817,65 @@ async def calculate_addon_cost_for_remaining_period(
     subscription: Subscription,
     additional_traffic_gb: int = 0,
     additional_devices: int = 0,
-    additional_server_ids: List[int] = None
+    additional_server_ids: List[int] = None,
+    *,
+    user: Optional[User] = None,
+    promo_group: Optional[PromoGroup] = None,
 ) -> int:
     if additional_server_ids is None:
         additional_server_ids = []
-    
+
     months_to_pay = get_remaining_months(subscription.end_date)
-    
+    period_hint_days = months_to_pay * 30 if months_to_pay > 0 else None
+
     total_cost = 0
-    
+
+    if user is None:
+        user = getattr(subscription, "user", None)
+    promo_group = promo_group or (user.promo_group if user else None)
+
     if additional_traffic_gb > 0:
         traffic_price_per_month = settings.get_traffic_price(additional_traffic_gb)
-        traffic_total_cost = traffic_price_per_month * months_to_pay
+        traffic_discount_percent = _get_discount_percent(
+            user,
+            promo_group,
+            "traffic",
+            period_days=period_hint_days,
+        )
+        traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+        discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+        traffic_total_cost = discounted_traffic_per_month * months_to_pay
         total_cost += traffic_total_cost
-        logger.info(f"Трафик +{additional_traffic_gb}ГБ: {traffic_price_per_month/100}₽/мес × {months_to_pay} = {traffic_total_cost/100}₽")
-    
+        message = (
+            f"Трафик +{additional_traffic_gb}ГБ: {traffic_price_per_month/100}₽/мес × {months_to_pay} = {traffic_total_cost/100}₽"
+        )
+        if traffic_discount_per_month > 0:
+            message += (
+                f" (скидка {traffic_discount_percent}%: -{traffic_discount_per_month * months_to_pay/100}₽)"
+            )
+        logger.info(message)
+
     if additional_devices > 0:
         devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-        devices_total_cost = devices_price_per_month * months_to_pay
+        devices_discount_percent = _get_discount_percent(
+            user,
+            promo_group,
+            "devices",
+            period_days=period_hint_days,
+        )
+        devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+        discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+        devices_total_cost = discounted_devices_per_month * months_to_pay
         total_cost += devices_total_cost
-        logger.info(f"Устройства +{additional_devices}: {devices_price_per_month/100}₽/мес × {months_to_pay} = {devices_total_cost/100}₽")
-    
+        message = (
+            f"Устройства +{additional_devices}: {devices_price_per_month/100}₽/мес × {months_to_pay} = {devices_total_cost/100}₽"
+        )
+        if devices_discount_per_month > 0:
+            message += (
+                f" (скидка {devices_discount_percent}%: -{devices_discount_per_month * months_to_pay/100}₽)"
+            )
+        logger.info(message)
+
     if additional_server_ids:
         from app.database.models import ServerSquad
         for server_id in additional_server_ids:
@@ -702,9 +886,24 @@ async def calculate_addon_cost_for_remaining_period(
             server_data = result.first()
             if server_data:
                 server_price_per_month, server_name = server_data
-                server_total_cost = server_price_per_month * months_to_pay
+                servers_discount_percent = _get_discount_percent(
+                    user,
+                    promo_group,
+                    "servers",
+                    period_days=period_hint_days,
+                )
+                server_discount_per_month = server_price_per_month * servers_discount_percent // 100
+                discounted_server_per_month = server_price_per_month - server_discount_per_month
+                server_total_cost = discounted_server_per_month * months_to_pay
                 total_cost += server_total_cost
-                logger.info(f"Сервер {server_name}: {server_price_per_month/100}₽/мес × {months_to_pay} = {server_total_cost/100}₽")
+                message = (
+                    f"Сервер {server_name}: {server_price_per_month/100}₽/мес × {months_to_pay} = {server_total_cost/100}₽"
+                )
+                if server_discount_per_month > 0:
+                    message += (
+                        f" (скидка {servers_discount_percent}%: -{server_discount_per_month * months_to_pay/100}₽)"
+                    )
+                logger.info(message)
     
     logger.info(f"💰 Итого доплата за {months_to_pay} мес: {total_cost/100}₽")
     return total_cost

app/database/crud/user.py

@@ -7,8 +7,9 @@ from sqlalchemy import select, and_, or_, func
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 
-from app.database.models import User, UserStatus, Subscription, Transaction
+from app.database.models import User, UserStatus, Subscription, Transaction, PromoGroup
 from app.config import settings
+from app.database.crud.promo_group import get_default_promo_group
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +23,10 @@ def generate_referral_code() -> str:
 async def get_user_by_id(db: AsyncSession, user_id: int) -> Optional[User]:
     result = await db.execute(
         select(User)
-        .options(selectinload(User.subscription)) 
+        .options(
+            selectinload(User.subscription),
+            selectinload(User.promo_group),
+        )
         .where(User.id == user_id)
     )
     user = result.scalar_one_or_none()
@@ -36,7 +40,10 @@ async def get_user_by_id(db: AsyncSession, user_id: int) -> Optional[User]:
 async def get_user_by_telegram_id(db: AsyncSession, telegram_id: int) -> Optional[User]:
     result = await db.execute(
         select(User)
-        .options(selectinload(User.subscription)) 
+        .options(
+            selectinload(User.subscription),
+            selectinload(User.promo_group),
+        )
         .where(User.telegram_id == telegram_id)
     )
     user = result.scalar_one_or_none()
@@ -49,7 +56,9 @@ async def get_user_by_telegram_id(db: AsyncSession, telegram_id: int) -> Optiona
 
 async def get_user_by_referral_code(db: AsyncSession, referral_code: str) -> Optional[User]:
     result = await db.execute(
-        select(User).where(User.referral_code == referral_code)
+        select(User)
+        .options(selectinload(User.promo_group))
+        .where(User.referral_code == referral_code)
     )
     return result.scalar_one_or_none()
 
@@ -82,6 +91,20 @@ async def create_user(
         from app.utils.user_utils import generate_unique_referral_code
         referral_code = await generate_unique_referral_code(db, telegram_id)
     
+    default_group = await get_default_promo_group(db)
+    if not default_group:
+        default_group = PromoGroup(
+            name="Базовый юзер",
+            server_discount_percent=0,
+            traffic_discount_percent=0,
+            device_discount_percent=0,
+            is_default=True,
+        )
+        db.add(default_group)
+        await db.flush()
+
+    promo_group_id = default_group.id
+
     user = User(
         telegram_id=telegram_id,
         username=username,
@@ -92,15 +115,19 @@ async def create_user(
         referral_code=referral_code,
         balance_kopeks=0,
         has_had_paid_subscription=False,
-        has_made_first_topup=False 
+        has_made_first_topup=False,
+        promo_group_id=promo_group_id,
     )
     
     db.add(user)
     await db.commit()
     await db.refresh(user)
     
+    if default_group:
+        user.promo_group = default_group
+
     logger.info(f"✅ Создан пользователь {telegram_id} с реферальным кодом {referral_code}")
-    
+
     return user
 
 
@@ -281,7 +308,10 @@ async def get_users_count(
 async def get_referrals(db: AsyncSession, user_id: int) -> List[User]:
     result = await db.execute(
         select(User)
-        .options(selectinload(User.subscription))
+        .options(
+            selectinload(User.subscription),
+            selectinload(User.promo_group),
+        )
         .where(User.referred_by_id == user_id)
         .order_by(User.created_at.desc())
     )
@@ -293,7 +323,10 @@ async def get_inactive_users(db: AsyncSession, months: int = 3) -> List[User]:
     
     result = await db.execute(
         select(User)
-        .options(selectinload(User.subscription))
+        .options(
+            selectinload(User.subscription),
+            selectinload(User.promo_group),
+        )
         .where(
             and_(
                 User.last_activity < threshold_date,

app/database/models.py

@@ -155,6 +155,42 @@ class CryptoBotPayment(Base):
         return f"<CryptoBotPayment(id={self.id}, invoice_id={self.invoice_id}, amount={self.amount} {self.asset}, status={self.status})>"
 
 
+class PromoGroup(Base):
+    __tablename__ = "promo_groups"
+
+    id = Column(Integer, primary_key=True, index=True)
+    name = Column(String(255), unique=True, nullable=False)
+    server_discount_percent = Column(Integer, nullable=False, default=0)
+    traffic_discount_percent = Column(Integer, nullable=False, default=0)
+    device_discount_percent = Column(Integer, nullable=False, default=0)
+    is_default = Column(Boolean, nullable=False, default=False)
+    created_at = Column(DateTime, default=func.now())
+    updated_at = Column(DateTime, default=func.now(), onupdate=func.now())
+
+    users = relationship("User", back_populates="promo_group")
+
+    def get_discount_percent(self, category: str, period_days: Optional[int] = None) -> int:
+        mapping = {
+            "servers": self.server_discount_percent,
+            "traffic": self.traffic_discount_percent,
+            "devices": self.device_discount_percent,
+        }
+        percent = mapping.get(category, 0)
+
+        if self.is_default and period_days is not None:
+            try:
+                from app.config import settings
+
+                discounts = settings.get_base_promo_group_period_discounts()
+                if period_days in discounts:
+                    period_discount = discounts[period_days]
+                    percent = period_discount
+            except Exception:
+                pass
+
+        return max(0, min(100, percent))
+
+
 class User(Base):
     __tablename__ = "users"
     
@@ -185,6 +221,8 @@ class User(Base):
     vless_uuid = Column(String(255), nullable=True)
     ss_password = Column(String(255), nullable=True)
     has_made_first_topup: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
+    promo_group_id = Column(Integer, ForeignKey("promo_groups.id", ondelete="RESTRICT"), nullable=False, index=True)
+    promo_group = relationship("PromoGroup", back_populates="users")
     
     @property
     def balance_rubles(self) -> float:
@@ -194,6 +232,11 @@ class User(Base):
     def full_name(self) -> str:
         parts = [self.first_name, self.last_name]
         return " ".join(filter(None, parts)) or self.username or f"ID{self.telegram_id}"
+
+    def get_promo_discount(self, category: str, period_days: Optional[int] = None) -> int:
+        if not self.promo_group:
+            return 0
+        return self.promo_group.get_discount_percent(category, period_days)
     
     def add_balance(self, kopeks: int) -> None:
         self.balance_kopeks += kopeks

app/database/universal_migration.py

@@ -74,6 +74,104 @@ async def check_column_exists(table_name: str, column_name: str) -> bool:
         logger.error(f"Ошибка проверки существования колонки {column_name}: {e}")
         return False
 
+
+async def check_constraint_exists(table_name: str, constraint_name: str) -> bool:
+    try:
+        async with engine.begin() as conn:
+            db_type = await get_database_type()
+
+            if db_type == "postgresql":
+                result = await conn.execute(
+                    text(
+                        """
+                    SELECT 1
+                    FROM information_schema.table_constraints
+                    WHERE table_schema = 'public'
+                      AND table_name = :table_name
+                      AND constraint_name = :constraint_name
+                """
+                    ),
+                    {"table_name": table_name, "constraint_name": constraint_name},
+                )
+                return result.fetchone() is not None
+
+            if db_type == "mysql":
+                result = await conn.execute(
+                    text(
+                        """
+                    SELECT 1
+                    FROM information_schema.table_constraints
+                    WHERE table_schema = DATABASE()
+                      AND table_name = :table_name
+                      AND constraint_name = :constraint_name
+                """
+                    ),
+                    {"table_name": table_name, "constraint_name": constraint_name},
+                )
+                return result.fetchone() is not None
+
+            if db_type == "sqlite":
+                result = await conn.execute(text(f"PRAGMA foreign_key_list({table_name})"))
+                rows = result.fetchall()
+                return any(row[5] == constraint_name for row in rows)
+
+            return False
+
+    except Exception as e:
+        logger.error(
+            f"Ошибка проверки существования ограничения {constraint_name} для {table_name}: {e}"
+        )
+        return False
+
+
+async def check_index_exists(table_name: str, index_name: str) -> bool:
+    try:
+        async with engine.begin() as conn:
+            db_type = await get_database_type()
+
+            if db_type == "postgresql":
+                result = await conn.execute(
+                    text(
+                        """
+                    SELECT 1
+                    FROM pg_indexes
+                    WHERE schemaname = 'public'
+                      AND tablename = :table_name
+                      AND indexname = :index_name
+                """
+                    ),
+                    {"table_name": table_name, "index_name": index_name},
+                )
+                return result.fetchone() is not None
+
+            if db_type == "mysql":
+                result = await conn.execute(
+                    text(
+                        """
+                    SELECT 1
+                    FROM information_schema.statistics
+                    WHERE table_schema = DATABASE()
+                      AND table_name = :table_name
+                      AND index_name = :index_name
+                """
+                    ),
+                    {"table_name": table_name, "index_name": index_name},
+                )
+                return result.fetchone() is not None
+
+            if db_type == "sqlite":
+                result = await conn.execute(text(f"PRAGMA index_list({table_name})"))
+                rows = result.fetchall()
+                return any(row[1] == index_name for row in rows)
+
+            return False
+
+    except Exception as e:
+        logger.error(
+            f"Ошибка проверки существования индекса {index_name} для {table_name}: {e}"
+        )
+        return False
+
 async def create_cryptobot_payments_table():
     table_exists = await check_table_exists('cryptobot_payments')
     if table_exists:
@@ -248,6 +346,276 @@ async def create_user_messages_table():
         logger.error(f"Ошибка создания таблицы user_messages: {e}")
         return False
 
+
+async def ensure_promo_groups_setup():
+    logger.info("=== НАСТРОЙКА ПРОМО ГРУПП ===")
+
+    try:
+        promo_table_exists = await check_table_exists("promo_groups")
+
+        async with engine.begin() as conn:
+            db_type = await get_database_type()
+
+            if not promo_table_exists:
+                if db_type == "sqlite":
+                    await conn.execute(
+                        text(
+                            """
+                            CREATE TABLE IF NOT EXISTS promo_groups (
+                                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                                name VARCHAR(255) NOT NULL,
+                                server_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                traffic_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                device_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                is_default BOOLEAN NOT NULL DEFAULT 0,
+                                created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+                                updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+                            )
+                        """
+                        )
+                    )
+                    await conn.execute(
+                        text(
+                            "CREATE UNIQUE INDEX IF NOT EXISTS uq_promo_groups_name ON promo_groups(name)"
+                        )
+                    )
+                elif db_type == "postgresql":
+                    await conn.execute(
+                        text(
+                            """
+                            CREATE TABLE IF NOT EXISTS promo_groups (
+                                id SERIAL PRIMARY KEY,
+                                name VARCHAR(255) NOT NULL,
+                                server_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                traffic_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                device_discount_percent INTEGER NOT NULL DEFAULT 0,
+                                is_default BOOLEAN NOT NULL DEFAULT FALSE,
+                                created_at TIMESTAMP WITHOUT TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+                                updated_at TIMESTAMP WITHOUT TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+                                CONSTRAINT uq_promo_groups_name UNIQUE (name)
+                            )
+                        """
+                        )
+                    )
+                elif db_type == "mysql":
+                    await conn.execute(
+                        text(
+                            """
+                            CREATE TABLE IF NOT EXISTS promo_groups (
+                                id INT AUTO_INCREMENT PRIMARY KEY,
+                                name VARCHAR(255) NOT NULL,
+                                server_discount_percent INT NOT NULL DEFAULT 0,
+                                traffic_discount_percent INT NOT NULL DEFAULT 0,
+                                device_discount_percent INT NOT NULL DEFAULT 0,
+                                is_default TINYINT(1) NOT NULL DEFAULT 0,
+                                created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+                                updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+                                UNIQUE KEY uq_promo_groups_name (name)
+                            ) ENGINE=InnoDB
+                        """
+                        )
+                    )
+                else:
+                    logger.error(f"Неподдерживаемый тип БД для promo_groups: {db_type}")
+                    return False
+
+                logger.info("Создана таблица promo_groups")
+
+            if db_type == "postgresql" and not await check_constraint_exists(
+                "promo_groups", "uq_promo_groups_name"
+            ):
+                try:
+                    await conn.execute(
+                        text(
+                            "ALTER TABLE promo_groups ADD CONSTRAINT uq_promo_groups_name UNIQUE (name)"
+                        )
+                    )
+                except Exception as e:
+                    logger.warning(
+                        f"Не удалось добавить уникальное ограничение uq_promo_groups_name: {e}"
+                    )
+
+            column_exists = await check_column_exists("users", "promo_group_id")
+
+            if not column_exists:
+                if db_type == "sqlite":
+                    await conn.execute(text("ALTER TABLE users ADD COLUMN promo_group_id INTEGER"))
+                elif db_type == "postgresql":
+                    await conn.execute(text("ALTER TABLE users ADD COLUMN promo_group_id INTEGER"))
+                elif db_type == "mysql":
+                    await conn.execute(text("ALTER TABLE users ADD COLUMN promo_group_id INT"))
+                else:
+                    logger.error(f"Неподдерживаемый тип БД для promo_group_id: {db_type}")
+                    return False
+
+                logger.info("Добавлена колонка users.promo_group_id")
+
+            index_exists = await check_index_exists("users", "ix_users_promo_group_id")
+
+            if not index_exists:
+                try:
+                    if db_type == "sqlite":
+                        await conn.execute(
+                            text("CREATE INDEX IF NOT EXISTS ix_users_promo_group_id ON users(promo_group_id)")
+                        )
+                    elif db_type == "postgresql":
+                        await conn.execute(
+                            text("CREATE INDEX IF NOT EXISTS ix_users_promo_group_id ON users(promo_group_id)")
+                        )
+                    elif db_type == "mysql":
+                        await conn.execute(
+                            text("CREATE INDEX ix_users_promo_group_id ON users(promo_group_id)")
+                        )
+                    logger.info("Создан индекс ix_users_promo_group_id")
+                except Exception as e:
+                    logger.warning(f"Не удалось создать индекс ix_users_promo_group_id: {e}")
+
+            default_group_name = "Базовый юзер"
+            default_group_id = None
+
+            result = await conn.execute(
+                text(
+                    "SELECT id, is_default FROM promo_groups WHERE name = :name LIMIT 1"
+                ),
+                {"name": default_group_name},
+            )
+            row = result.fetchone()
+
+            if row:
+                default_group_id = row[0]
+                if not row[1]:
+                    await conn.execute(
+                        text(
+                            "UPDATE promo_groups SET is_default = :is_default WHERE id = :group_id"
+                        ),
+                        {"is_default": True, "group_id": default_group_id},
+                    )
+            else:
+                result = await conn.execute(
+                    text(
+                        "SELECT id FROM promo_groups WHERE is_default = :is_default LIMIT 1"
+                    ),
+                    {"is_default": True},
+                )
+                existing_default = result.fetchone()
+
+                if existing_default:
+                    default_group_id = existing_default[0]
+                else:
+                    await conn.execute(
+                        text(
+                            """
+                            INSERT INTO promo_groups (
+                                name,
+                                server_discount_percent,
+                                traffic_discount_percent,
+                                device_discount_percent,
+                                is_default
+                            ) VALUES (:name, 0, 0, 0, :is_default)
+                        """
+                        ),
+                        {"name": default_group_name, "is_default": True},
+                    )
+
+                    result = await conn.execute(
+                        text(
+                            "SELECT id FROM promo_groups WHERE name = :name LIMIT 1"
+                        ),
+                        {"name": default_group_name},
+                    )
+                    row = result.fetchone()
+                    default_group_id = row[0] if row else None
+
+            if default_group_id is None:
+                logger.error("Не удалось определить идентификатор базовой промо-группы")
+                return False
+
+            await conn.execute(
+                text(
+                    """
+                    UPDATE users
+                    SET promo_group_id = :group_id
+                    WHERE promo_group_id IS NULL
+                """
+                ),
+                {"group_id": default_group_id},
+            )
+
+            if db_type == "postgresql":
+                constraint_exists = await check_constraint_exists(
+                    "users", "fk_users_promo_group_id_promo_groups"
+                )
+                if not constraint_exists:
+                    try:
+                        await conn.execute(
+                            text(
+                                """
+                                ALTER TABLE users
+                                ADD CONSTRAINT fk_users_promo_group_id_promo_groups
+                                FOREIGN KEY (promo_group_id)
+                                REFERENCES promo_groups(id)
+                                ON DELETE RESTRICT
+                            """
+                            )
+                        )
+                        logger.info("Добавлен внешний ключ users -> promo_groups")
+                    except Exception as e:
+                        logger.warning(
+                            f"Не удалось добавить внешний ключ users.promo_group_id: {e}"
+                        )
+
+                try:
+                    await conn.execute(
+                        text(
+                            "ALTER TABLE users ALTER COLUMN promo_group_id SET NOT NULL"
+                        )
+                    )
+                except Exception as e:
+                    logger.warning(
+                        f"Не удалось сделать users.promo_group_id NOT NULL: {e}"
+                    )
+
+            elif db_type == "mysql":
+                constraint_exists = await check_constraint_exists(
+                    "users", "fk_users_promo_group_id_promo_groups"
+                )
+                if not constraint_exists:
+                    try:
+                        await conn.execute(
+                            text(
+                                """
+                                ALTER TABLE users
+                                ADD CONSTRAINT fk_users_promo_group_id_promo_groups
+                                FOREIGN KEY (promo_group_id)
+                                REFERENCES promo_groups(id)
+                                ON DELETE RESTRICT
+                            """
+                            )
+                        )
+                        logger.info("Добавлен внешний ключ users -> promo_groups")
+                    except Exception as e:
+                        logger.warning(
+                            f"Не удалось добавить внешний ключ users.promo_group_id: {e}"
+                        )
+
+                try:
+                    await conn.execute(
+                        text(
+                            "ALTER TABLE users MODIFY promo_group_id INT NOT NULL"
+                        )
+                    )
+                except Exception as e:
+                    logger.warning(
+                        f"Не удалось сделать users.promo_group_id NOT NULL: {e}"
+                    )
+
+            logger.info("✅ Промо группы настроены")
+            return True
+
+    except Exception as e:
+        logger.error(f"Ошибка настройки промо групп: {e}")
+        return False
+
 async def add_welcome_text_is_enabled_column():
     column_exists = await check_column_exists('welcome_texts', 'is_enabled')
     if column_exists:
@@ -688,7 +1056,14 @@ async def run_universal_migration():
             logger.info("✅ Медиа поля в broadcast_history готовы")
         else:
             logger.warning("⚠️ Проблемы с добавлением медиа полей")
-        
+
+        logger.info("=== НАСТРОЙКА ПРОМО ГРУПП ===")
+        promo_groups_ready = await ensure_promo_groups_setup()
+        if promo_groups_ready:
+            logger.info("✅ Промо группы готовы")
+        else:
+            logger.warning("⚠️ Проблемы с настройкой промо групп")
+
         logger.info("=== ОБНОВЛЕНИЕ ВНЕШНИХ КЛЮЧЕЙ ===")
         fk_updated = await fix_foreign_keys_for_user_deletion()
         if fk_updated:
@@ -756,10 +1131,12 @@ async def check_migration_status():
             "cryptobot_table": False,
             "user_messages_table": False,
             "welcome_texts_table": False,
-            "welcome_texts_is_enabled_column": False,  
-            "broadcast_history_media_fields": False, 
+            "welcome_texts_is_enabled_column": False,
+            "broadcast_history_media_fields": False,
             "subscription_duplicates": False,
-            "subscription_conversions_table": False
+            "subscription_conversions_table": False,
+            "promo_groups_table": False,
+            "users_promo_group_column": False
         }
         
         status["has_made_first_topup_column"] = await check_column_exists('users', 'has_made_first_topup')
@@ -768,8 +1145,10 @@ async def check_migration_status():
         status["user_messages_table"] = await check_table_exists('user_messages')
         status["welcome_texts_table"] = await check_table_exists('welcome_texts')
         status["subscription_conversions_table"] = await check_table_exists('subscription_conversions')
-        
+        status["promo_groups_table"] = await check_table_exists('promo_groups')
+
         status["welcome_texts_is_enabled_column"] = await check_column_exists('welcome_texts', 'is_enabled')
+        status["users_promo_group_column"] = await check_column_exists('users', 'promo_group_id')
         
         media_fields_exist = (
             await check_column_exists('broadcast_history', 'has_media') and
@@ -797,9 +1176,11 @@ async def check_migration_status():
             "user_messages_table": "Таблица пользовательских сообщений",
             "welcome_texts_table": "Таблица приветственных текстов",
             "welcome_texts_is_enabled_column": "Поле is_enabled в welcome_texts",
-            "broadcast_history_media_fields": "Медиа поля в broadcast_history", 
+            "broadcast_history_media_fields": "Медиа поля в broadcast_history",
             "subscription_conversions_table": "Таблица конверсий подписок",
-            "subscription_duplicates": "Отсутствие дубликатов подписок"
+            "subscription_duplicates": "Отсутствие дубликатов подписок",
+            "promo_groups_table": "Таблица промо-групп",
+            "users_promo_group_column": "Колонка promo_group_id у пользователей"
         }
         
         for check_key, check_status in status.items():

app/handlers/admin/promo_groups.py

@@ -0,0 +1,617 @@
+import logging
+from typing import Optional
+
+from aiogram import Dispatcher, types, F
+from aiogram.fsm.context import FSMContext
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.database.crud.promo_group import (
+    get_promo_groups_with_counts,
+    get_promo_group_by_id,
+    create_promo_group,
+    update_promo_group,
+    delete_promo_group,
+    get_promo_group_members,
+    count_promo_group_members,
+)
+from app.database.models import PromoGroup
+from app.localization.texts import get_texts
+from app.states import AdminStates
+from app.utils.decorators import admin_required, error_handler
+from app.keyboards.admin import (
+    get_admin_pagination_keyboard,
+    get_confirmation_keyboard,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _format_discount_line(texts, group) -> str:
+    return texts.t(
+        "ADMIN_PROMO_GROUPS_DISCOUNTS",
+        "Скидки — серверы: {servers}%, трафик: {traffic}%, устройства: {devices}%",
+    ).format(
+        servers=group.server_discount_percent,
+        traffic=group.traffic_discount_percent,
+        devices=group.device_discount_percent,
+    )
+
+
+@admin_required
+@error_handler
+async def show_promo_groups_menu(
+    callback: types.CallbackQuery,
+    db_user,
+    db: AsyncSession,
+):
+    texts = get_texts(db_user.language)
+    groups = await get_promo_groups_with_counts(db)
+
+    total_members = sum(count for _, count in groups)
+    header = texts.t("ADMIN_PROMO_GROUPS_TITLE", "💳 <b>Промогруппы</b>")
+
+    if groups:
+        summary = texts.t(
+            "ADMIN_PROMO_GROUPS_SUMMARY",
+            "Всего групп: {count}\nВсего участников: {members}",
+        ).format(count=len(groups), members=total_members)
+        lines = [header, "", summary, ""]
+
+        keyboard_rows = []
+        for group, member_count in groups:
+            default_suffix = (
+                texts.t("ADMIN_PROMO_GROUPS_DEFAULT_LABEL", " (базовая)")
+                if group.is_default
+                else ""
+            )
+            lines.extend(
+                [
+                    f"{'⭐' if group.is_default else '🎯'} <b>{group.name}</b>{default_suffix}",
+                    _format_discount_line(texts, group),
+                    texts.t(
+                        "ADMIN_PROMO_GROUPS_MEMBERS_COUNT",
+                        "Участников: {count}",
+                    ).format(count=member_count),
+                    "",
+                ]
+            )
+            keyboard_rows.append([
+                types.InlineKeyboardButton(
+                    text=f"{'⭐' if group.is_default else '🎯'} {group.name}",
+                    callback_data=f"promo_group_manage_{group.id}",
+                )
+            ])
+    else:
+        lines = [header, "", texts.t("ADMIN_PROMO_GROUPS_EMPTY", "Промогруппы не найдены.")]
+        keyboard_rows = []
+
+    keyboard_rows.append(
+        [types.InlineKeyboardButton(text="➕ Создать", callback_data="admin_promo_group_create")]
+    )
+    keyboard_rows.append(
+        [types.InlineKeyboardButton(text=texts.BACK, callback_data="admin_submenu_promo")]
+    )
+
+    await callback.message.edit_text(
+        "\n".join(line for line in lines if line is not None),
+        reply_markup=types.InlineKeyboardMarkup(inline_keyboard=keyboard_rows),
+        parse_mode="HTML",
+    )
+    await callback.answer()
+
+
+async def _get_group_or_alert(
+    callback: types.CallbackQuery,
+    db: AsyncSession,
+) -> Optional[PromoGroup]:
+    group_id = int(callback.data.split("_")[-1])
+    group = await get_promo_group_by_id(db, group_id)
+    if not group:
+        await callback.answer("❌ Промогруппа не найдена", show_alert=True)
+        return None
+    return group
+
+
+@admin_required
+@error_handler
+async def show_promo_group_details(
+    callback: types.CallbackQuery,
+    db_user,
+    db: AsyncSession,
+):
+    group = await _get_group_or_alert(callback, db)
+    if not group:
+        return
+
+    texts = get_texts(db_user.language)
+    member_count = await count_promo_group_members(db, group.id)
+
+    default_note = (
+        "\n" + texts.t("ADMIN_PROMO_GROUP_DETAILS_DEFAULT", "Это базовая группа.")
+        if group.is_default
+        else ""
+    )
+
+    text = "\n".join(
+        [
+            texts.t(
+                "ADMIN_PROMO_GROUP_DETAILS_TITLE",
+                "💳 <b>Промогруппа:</b> {name}",
+            ).format(name=group.name),
+            _format_discount_line(texts, group),
+            texts.t(
+                "ADMIN_PROMO_GROUP_DETAILS_MEMBERS",
+                "Участников: {count}",
+            ).format(count=member_count),
+            default_note,
+        ]
+    )
+
+    keyboard_rows = []
+    if member_count > 0:
+        keyboard_rows.append(
+            [
+                types.InlineKeyboardButton(
+                    text=texts.t("ADMIN_PROMO_GROUP_MEMBERS_BUTTON", "👥 Участники"),
+                    callback_data=f"promo_group_members_{group.id}_page_1",
+                )
+            ]
+        )
+
+    keyboard_rows.append(
+        [
+            types.InlineKeyboardButton(
+                text=texts.t("ADMIN_PROMO_GROUP_EDIT_BUTTON", "✏️ Изменить"),
+                callback_data=f"promo_group_edit_{group.id}",
+            )
+        ]
+    )
+
+    if not group.is_default:
+        keyboard_rows.append(
+            [
+                types.InlineKeyboardButton(
+                    text=texts.t("ADMIN_PROMO_GROUP_DELETE_BUTTON", "🗑️ Удалить"),
+                    callback_data=f"promo_group_delete_{group.id}",
+                )
+            ]
+        )
+
+    keyboard_rows.append(
+        [types.InlineKeyboardButton(text=texts.BACK, callback_data="admin_promo_groups")]
+    )
+
+    await callback.message.edit_text(
+        text.strip(),
+        reply_markup=types.InlineKeyboardMarkup(inline_keyboard=keyboard_rows),
+        parse_mode="HTML",
+    )
+    await callback.answer()
+
+
+def _validate_percent(value: str) -> int:
+    percent = int(value)
+    if percent < 0 or percent > 100:
+        raise ValueError
+    return percent
+
+
+async def _prompt_for_discount(
+    message: types.Message,
+    state: FSMContext,
+    prompt_key: str,
+    default_text: str,
+):
+    data = await state.get_data()
+    texts = get_texts(data.get("language", "ru"))
+    await message.answer(texts.t(prompt_key, default_text))
+
+
+@admin_required
+@error_handler
+async def start_create_promo_group(
+    callback: types.CallbackQuery,
+    db_user,
+    state: FSMContext,
+    db: AsyncSession,
+):
+    texts = get_texts(db_user.language)
+    await state.set_state(AdminStates.creating_promo_group_name)
+    await state.update_data(language=db_user.language)
+    await callback.message.edit_text(
+        texts.t("ADMIN_PROMO_GROUP_CREATE_NAME_PROMPT", "Введите название новой промогруппы:"),
+        reply_markup=types.InlineKeyboardMarkup(
+            inline_keyboard=[
+                [types.InlineKeyboardButton(text=texts.BACK, callback_data="admin_promo_groups")]
+            ]
+        ),
+    )
+    await callback.answer()
+
+
+async def process_create_group_name(message: types.Message, state: FSMContext):
+    name = message.text.strip()
+    if not name:
+        texts = get_texts((await state.get_data()).get("language", "ru"))
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_NAME", "Название не может быть пустым."))
+        return
+
+    await state.update_data(new_group_name=name)
+    await state.set_state(AdminStates.creating_promo_group_traffic_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_CREATE_TRAFFIC_PROMPT",
+        "Введите скидку на трафик (0-100):",
+    )
+
+
+async def process_create_group_traffic(message: types.Message, state: FSMContext):
+    texts = get_texts((await state.get_data()).get("language", "ru"))
+    try:
+        value = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    await state.update_data(new_group_traffic=value)
+    await state.set_state(AdminStates.creating_promo_group_server_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_CREATE_SERVERS_PROMPT",
+        "Введите скидку на серверы (0-100):",
+    )
+
+
+async def process_create_group_servers(message: types.Message, state: FSMContext):
+    texts = get_texts((await state.get_data()).get("language", "ru"))
+    try:
+        value = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    await state.update_data(new_group_servers=value)
+    await state.set_state(AdminStates.creating_promo_group_device_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_CREATE_DEVICES_PROMPT",
+        "Введите скидку на устройства (0-100):",
+    )
+
+
+@admin_required
+@error_handler
+async def process_create_group_devices(
+    message: types.Message,
+    state: FSMContext,
+    db_user,
+    db: AsyncSession,
+):
+    data = await state.get_data()
+    texts = get_texts(data.get("language", db_user.language))
+
+    try:
+        devices_discount = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    try:
+        group = await create_promo_group(
+            db,
+            data["new_group_name"],
+            traffic_discount_percent=data["new_group_traffic"],
+            server_discount_percent=data["new_group_servers"],
+            device_discount_percent=devices_discount,
+        )
+    except Exception as e:
+        logger.error(f"Не удалось создать промогруппу: {e}")
+        await message.answer(texts.ERROR)
+        await state.clear()
+        return
+
+    await state.clear()
+    await message.answer(
+        texts.t("ADMIN_PROMO_GROUP_CREATED", "Промогруппа «{name}» создана.").format(name=group.name)
+    )
+
+
+@admin_required
+@error_handler
+async def start_edit_promo_group(
+    callback: types.CallbackQuery,
+    db_user,
+    state: FSMContext,
+    db: AsyncSession,
+):
+    group = await _get_group_or_alert(callback, db)
+    if not group:
+        return
+
+    texts = get_texts(db_user.language)
+    await state.set_state(AdminStates.editing_promo_group_name)
+    await state.update_data(edit_group_id=group.id, language=db_user.language)
+
+    await callback.message.edit_text(
+        texts.t(
+            "ADMIN_PROMO_GROUP_EDIT_NAME_PROMPT",
+            "Введите новое название промогруппы (текущее: {name}):",
+        ).format(name=group.name),
+        reply_markup=types.InlineKeyboardMarkup(
+            inline_keyboard=[
+                [types.InlineKeyboardButton(text=texts.BACK, callback_data=f"promo_group_manage_{group.id}")]
+            ]
+        ),
+    )
+    await callback.answer()
+
+
+async def process_edit_group_name(message: types.Message, state: FSMContext):
+    name = message.text.strip()
+    if not name:
+        texts = get_texts((await state.get_data()).get("language", "ru"))
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_NAME", "Название не может быть пустым."))
+        return
+
+    await state.update_data(edit_group_name=name)
+    await state.set_state(AdminStates.editing_promo_group_traffic_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_EDIT_TRAFFIC_PROMPT",
+        "Введите новую скидку на трафик (0-100):",
+    )
+
+
+async def process_edit_group_traffic(message: types.Message, state: FSMContext):
+    texts = get_texts((await state.get_data()).get("language", "ru"))
+    try:
+        value = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    await state.update_data(edit_group_traffic=value)
+    await state.set_state(AdminStates.editing_promo_group_server_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_EDIT_SERVERS_PROMPT",
+        "Введите новую скидку на серверы (0-100):",
+    )
+
+
+async def process_edit_group_servers(message: types.Message, state: FSMContext):
+    texts = get_texts((await state.get_data()).get("language", "ru"))
+    try:
+        value = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    await state.update_data(edit_group_servers=value)
+    await state.set_state(AdminStates.editing_promo_group_device_discount)
+    await _prompt_for_discount(
+        message,
+        state,
+        "ADMIN_PROMO_GROUP_EDIT_DEVICES_PROMPT",
+        "Введите новую скидку на устройства (0-100):",
+    )
+
+
+@admin_required
+@error_handler
+async def process_edit_group_devices(
+    message: types.Message,
+    state: FSMContext,
+    db_user,
+    db: AsyncSession,
+):
+    data = await state.get_data()
+    texts = get_texts(data.get("language", db_user.language))
+
+    try:
+        devices_discount = _validate_percent(message.text)
+    except (ValueError, TypeError):
+        await message.answer(texts.t("ADMIN_PROMO_GROUP_INVALID_PERCENT", "Введите число от 0 до 100."))
+        return
+
+    group = await get_promo_group_by_id(db, data["edit_group_id"])
+    if not group:
+        await message.answer("❌ Промогруппа не найдена")
+        await state.clear()
+        return
+
+    await update_promo_group(
+        db,
+        group,
+        name=data["edit_group_name"],
+        traffic_discount_percent=data["edit_group_traffic"],
+        server_discount_percent=data["edit_group_servers"],
+        device_discount_percent=devices_discount,
+    )
+
+    await state.clear()
+    await message.answer(
+        texts.t("ADMIN_PROMO_GROUP_UPDATED", "Промогруппа «{name}» обновлена.").format(name=group.name)
+    )
+
+
+@admin_required
+@error_handler
+async def show_promo_group_members(
+    callback: types.CallbackQuery,
+    db_user,
+    db: AsyncSession,
+):
+    parts = callback.data.split("_")
+    group_id = int(parts[3])
+    page = int(parts[-1])
+    limit = 10
+    offset = (page - 1) * limit
+
+    group = await get_promo_group_by_id(db, group_id)
+    if not group:
+        await callback.answer("❌ Промогруппа не найдена", show_alert=True)
+        return
+
+    texts = get_texts(db_user.language)
+    members = await get_promo_group_members(db, group_id, offset=offset, limit=limit)
+    total_members = await count_promo_group_members(db, group_id)
+    total_pages = max(1, (total_members + limit - 1) // limit)
+
+    title = texts.t(
+        "ADMIN_PROMO_GROUP_MEMBERS_TITLE",
+        "👥 Участники группы {name}",
+    ).format(name=group.name)
+
+    if not members:
+        body = texts.t("ADMIN_PROMO_GROUP_MEMBERS_EMPTY", "В этой группе пока нет участников.")
+    else:
+        lines = []
+        for index, user in enumerate(members, start=offset + 1):
+            username = f"@{user.username}" if user.username else "—"
+            lines.append(
+                f"{index}. {user.full_name} (ID {user.id}, {username}, TG {user.telegram_id})"
+            )
+        body = "\n".join(lines)
+
+    keyboard = []
+    if total_pages > 1:
+        pagination = get_admin_pagination_keyboard(
+            page,
+            total_pages,
+            f"promo_group_members_{group_id}",
+            f"promo_group_manage_{group_id}",
+            db_user.language,
+        )
+        keyboard.extend(pagination.inline_keyboard)
+
+    keyboard.append(
+        [types.InlineKeyboardButton(text=texts.BACK, callback_data=f"promo_group_manage_{group_id}")]
+    )
+
+    await callback.message.edit_text(
+        f"{title}\n\n{body}",
+        reply_markup=types.InlineKeyboardMarkup(inline_keyboard=keyboard),
+    )
+    await callback.answer()
+
+
+@admin_required
+@error_handler
+async def request_delete_promo_group(
+    callback: types.CallbackQuery,
+    db_user,
+    db: AsyncSession,
+):
+    group = await _get_group_or_alert(callback, db)
+    if not group:
+        return
+
+    texts = get_texts(db_user.language)
+
+    if group.is_default:
+        await callback.answer(
+            texts.t("ADMIN_PROMO_GROUP_DELETE_FORBIDDEN", "Базовую промогруппу нельзя удалить."),
+            show_alert=True,
+        )
+        return
+
+    confirm_text = texts.t(
+        "ADMIN_PROMO_GROUP_DELETE_CONFIRM",
+        "Удалить промогруппу «{name}»? Все пользователи будут переведены в базовую группу.",
+    ).format(name=group.name)
+
+    await callback.message.edit_text(
+        confirm_text,
+        reply_markup=get_confirmation_keyboard(
+            confirm_action=f"promo_group_delete_confirm_{group.id}",
+            cancel_action=f"promo_group_manage_{group.id}",
+            language=db_user.language,
+        ),
+    )
+    await callback.answer()
+
+
+@admin_required
+@error_handler
+async def delete_promo_group_confirmed(
+    callback: types.CallbackQuery,
+    db_user,
+    db: AsyncSession,
+):
+    group = await _get_group_or_alert(callback, db)
+    if not group:
+        return
+
+    texts = get_texts(db_user.language)
+
+    success = await delete_promo_group(db, group)
+    if not success:
+        await callback.answer(
+            texts.t("ADMIN_PROMO_GROUP_DELETE_FORBIDDEN", "Базовую промогруппу нельзя удалить."),
+            show_alert=True,
+        )
+        return
+
+    await callback.message.edit_text(
+        texts.t("ADMIN_PROMO_GROUP_DELETED", "Промогруппа «{name}» удалена.").format(name=group.name),
+        reply_markup=types.InlineKeyboardMarkup(
+            inline_keyboard=[
+                [types.InlineKeyboardButton(text=texts.BACK, callback_data="admin_promo_groups")]
+            ]
+        ),
+    )
+    await callback.answer()
+
+
+def register_handlers(dp: Dispatcher):
+    dp.callback_query.register(show_promo_groups_menu, F.data == "admin_promo_groups")
+    dp.callback_query.register(show_promo_group_details, F.data.startswith("promo_group_manage_"))
+    dp.callback_query.register(start_create_promo_group, F.data == "admin_promo_group_create")
+    dp.callback_query.register(start_edit_promo_group, F.data.startswith("promo_group_edit_"))
+    dp.callback_query.register(
+        request_delete_promo_group,
+        F.data.startswith("promo_group_delete_")
+        & ~F.data.startswith("promo_group_delete_confirm_"),
+    )
+    dp.callback_query.register(
+        delete_promo_group_confirmed,
+        F.data.startswith("promo_group_delete_confirm_"),
+    )
+    dp.callback_query.register(
+        show_promo_group_members,
+        F.data.regexp(r"^promo_group_members_\d+_page_\d+$"),
+    )
+
+    dp.message.register(process_create_group_name, AdminStates.creating_promo_group_name)
+    dp.message.register(
+        process_create_group_traffic,
+        AdminStates.creating_promo_group_traffic_discount,
+    )
+    dp.message.register(
+        process_create_group_servers,
+        AdminStates.creating_promo_group_server_discount,
+    )
+    dp.message.register(
+        process_create_group_devices,
+        AdminStates.creating_promo_group_device_discount,
+    )
+
+    dp.message.register(process_edit_group_name, AdminStates.editing_promo_group_name)
+    dp.message.register(
+        process_edit_group_traffic,
+        AdminStates.editing_promo_group_traffic_discount,
+    )
+    dp.message.register(
+        process_edit_group_servers,
+        AdminStates.editing_promo_group_server_discount,
+    )
+    dp.message.register(
+        process_edit_group_devices,
+        AdminStates.editing_promo_group_device_discount,
+    )

app/handlers/admin/users.py

@@ -12,10 +12,11 @@ from app.database.crud.user import get_user_by_id
 from app.keyboards.admin import (
     get_admin_users_keyboard, get_user_management_keyboard,
     get_admin_pagination_keyboard, get_confirmation_keyboard,
-    get_admin_users_filters_keyboard
+    get_admin_users_filters_keyboard, get_user_promo_group_keyboard
 )
 from app.localization.texts import get_texts
 from app.services.user_service import UserService
+from app.database.crud.promo_group import get_promo_groups_with_counts
 from app.utils.decorators import admin_required, error_handler
 from app.utils.formatters import format_datetime, format_time_ago
 from app.services.remnawave_service import RemnaWaveService
@@ -820,7 +821,20 @@ async def show_user_management(
 """
     else:
         text += "\n<b>Подписка:</b> Отсутствует"
-    
+
+    if user.promo_group:
+        promo_group = user.promo_group
+        text += f"""
+
+<b>Промогруппа:</b>
+• Название: {promo_group.name}
+• Скидка на сервера: {promo_group.server_discount_percent}%
+• Скидка на трафик: {promo_group.traffic_discount_percent}%
+• Скидка на устройства: {promo_group.device_discount_percent}%
+"""
+    else:
+        text += "\n<b>Промогруппа:</b> Не назначена"
+
     # Проверяем состояние, чтобы определить, откуда пришел пользователь
     current_state = await state.get_state()
     if current_state == AdminStates.viewing_user_from_balance_list:
@@ -833,6 +847,115 @@ async def show_user_management(
     await callback.answer()
 
 
+async def _render_user_promo_group(
+    message: types.Message,
+    language: str,
+    user: User,
+    promo_groups: list
+) -> None:
+    texts = get_texts(language)
+
+    current_group = user.promo_group
+
+    if current_group:
+        current_line = texts.ADMIN_USER_PROMO_GROUP_CURRENT.format(name=current_group.name)
+        discount_line = texts.ADMIN_USER_PROMO_GROUP_DISCOUNTS.format(
+            servers=current_group.server_discount_percent,
+            traffic=current_group.traffic_discount_percent,
+            devices=current_group.device_discount_percent,
+        )
+        current_group_id = current_group.id
+    else:
+        current_line = texts.ADMIN_USER_PROMO_GROUP_CURRENT_NONE
+        discount_line = texts.ADMIN_USER_PROMO_GROUP_DISCOUNTS_NONE
+        current_group_id = None
+
+    text = (
+        f"{texts.ADMIN_USER_PROMO_GROUP_TITLE}\n\n"
+        f"{current_line}\n"
+        f"{discount_line}\n\n"
+        f"{texts.ADMIN_USER_PROMO_GROUP_SELECT}"
+    )
+
+    await message.edit_text(
+        text,
+        reply_markup=get_user_promo_group_keyboard(
+            promo_groups,
+            user.id,
+            current_group_id,
+            language
+        )
+    )
+
+
+@admin_required
+@error_handler
+async def show_user_promo_group(
+    callback: types.CallbackQuery,
+    db_user: User,
+    db: AsyncSession
+):
+
+    user_id = int(callback.data.split('_')[-1])
+
+    user = await get_user_by_id(db, user_id)
+    if not user:
+        await callback.answer("❌ Пользователь не найден", show_alert=True)
+        return
+
+    promo_groups = await get_promo_groups_with_counts(db)
+    if not promo_groups:
+        texts = get_texts(db_user.language)
+        await callback.answer(texts.ADMIN_PROMO_GROUPS_EMPTY, show_alert=True)
+        return
+
+    await _render_user_promo_group(callback.message, db_user.language, user, promo_groups)
+    await callback.answer()
+
+
+@admin_required
+@error_handler
+async def set_user_promo_group(
+    callback: types.CallbackQuery,
+    db_user: User,
+    db: AsyncSession
+):
+
+    parts = callback.data.split('_')
+    user_id = int(parts[-2])
+    group_id = int(parts[-1])
+
+    texts = get_texts(db_user.language)
+
+    user = await get_user_by_id(db, user_id)
+    if not user:
+        await callback.answer("❌ Пользователь не найден", show_alert=True)
+        return
+
+    if user.promo_group_id == group_id:
+        await callback.answer(texts.ADMIN_USER_PROMO_GROUP_ALREADY, show_alert=True)
+        return
+
+    user_service = UserService()
+    success, updated_user, new_group = await user_service.update_user_promo_group(
+        db,
+        user_id,
+        group_id
+    )
+
+    if not success or not updated_user or not new_group:
+        await callback.answer(texts.ADMIN_USER_PROMO_GROUP_ERROR, show_alert=True)
+        return
+
+    promo_groups = await get_promo_groups_with_counts(db)
+
+    await _render_user_promo_group(callback.message, db_user.language, updated_user, promo_groups)
+    await callback.answer(
+        texts.ADMIN_USER_PROMO_GROUP_UPDATED.format(name=new_group.name),
+        show_alert=True
+    )
+
+
 
 @admin_required
 @error_handler
@@ -2922,7 +3045,17 @@ def register_handlers(dp: Dispatcher):
         show_user_management,
         F.data.startswith("admin_user_manage_")
     )
-    
+
+    dp.callback_query.register(
+        show_user_promo_group,
+        F.data.startswith("admin_user_promo_group_") & ~F.data.contains("_set_")
+    )
+
+    dp.callback_query.register(
+        set_user_promo_group,
+        F.data.startswith("admin_user_promo_group_set_")
+    )
+
     dp.callback_query.register(
         start_balance_edit,
         F.data.startswith("admin_user_balance_")

app/handlers/balance.py

@@ -186,7 +186,7 @@ async def show_payment_methods(
     from app.utils.payment_utils import get_payment_methods_text
     
     texts = get_texts(db_user.language)
-    payment_text = get_payment_methods_text()
+    payment_text = get_payment_methods_text(db_user.language)
     
     await callback.message.edit_text(
         payment_text,
@@ -204,8 +204,10 @@ async def handle_payment_methods_unavailable(
     texts = get_texts(db_user.language)
     
     await callback.answer(
-        "⚠️ В данный момент автоматические способы оплаты временно недоступны. "
-        "Для пополнения баланса обратитесь в техподдержку.",
+        texts.t(
+            "PAYMENT_METHODS_UNAVAILABLE_ALERT",
+            "⚠️ В данный момент автоматические способы оплаты временно недоступны. Для пополнения баланса обратитесь в техподдержку.",
+        ),
         show_alert=True
     )
 

app/handlers/common.py

@@ -4,7 +4,7 @@ from aiogram.fsm.context import FSMContext
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.database.models import User
-from app.localization.texts import get_texts
+from app.localization.texts import get_texts, get_rules
 from app.keyboards.inline import get_back_keyboard
 
 logger = logging.getLogger(__name__)
@@ -18,8 +18,11 @@ async def handle_unknown_callback(
     texts = get_texts(db_user.language if db_user else "ru")
     
     await callback.answer(
-        "❓ Неизвестная команда. Попробуйте ещё раз.",
-        show_alert=True
+        texts.t(
+            "UNKNOWN_CALLBACK_ALERT",
+            "❓ Неизвестная команда. Попробуйте ещё раз.",
+        ),
+        show_alert=True,
     )
     
     logger.warning(f"Неизвестный callback: {callback.data} от пользователя {callback.from_user.id}")
@@ -49,8 +52,11 @@ async def handle_unknown_message(
     texts = get_texts(db_user.language if db_user else "ru")
     
     await message.answer(
-        "❓ Не понимаю эту команду. Используйте кнопки меню.",
-        reply_markup=get_back_keyboard(db_user.language if db_user else "ru")
+        texts.t(
+            "UNKNOWN_COMMAND_MESSAGE",
+            "❓ Не понимаю эту команду. Используйте кнопки меню.",
+        ),
+        reply_markup=get_back_keyboard(db_user.language if db_user else "ru"),
     )
 
 
@@ -61,8 +67,8 @@ async def show_rules(
 ):
     
     texts = get_texts(db_user.language)
-    
-    rules_text = texts.RULES_TEXT
+
+    rules_text = await get_rules(db_user.language)
     
     await callback.message.edit_text(
         rules_text,

app/handlers/menu.py

@@ -7,7 +7,7 @@ from datetime import datetime, timedelta
 from app.config import settings
 from app.database.crud.user import get_user_by_telegram_id, update_user
 from app.keyboards.inline import get_main_menu_keyboard
-from app.localization.texts import get_texts
+from app.localization.texts import get_texts, get_rules
 from app.database.models import User
 from app.utils.user_utils import mark_user_as_had_paid_subscription
 from app.database.crud.user_message import get_random_active_message
@@ -70,34 +70,22 @@ async def mark_user_as_had_paid_subscription(
 
 
 async def show_service_rules(
-    callback: types.CallbackQuery,
-    db_user: User,
+    callback: types.CallbackQuery, 
+    db_user: User, 
     db: AsyncSession
 ):
     from app.database.crud.rules import get_current_rules_content
-    
+
+    texts = get_texts(db_user.language)
     rules_text = await get_current_rules_content(db, db_user.language)
-    
+
     if not rules_text:
-        texts = get_texts(db_user.language)
-        rules_text = texts._get_default_rules(db_user.language) if hasattr(texts, '_get_default_rules') else """
-📋 <b>Правила использования сервиса</b>
+        rules_text = await get_rules(db_user.language)
 
-1. Запрещается использование сервиса для незаконной деятельности
-2. Запрещается нарушение авторских прав
-3. Запрещается спам и рассылка вредоносного ПО
-4. Запрещается использование сервиса для DDoS атак
-5. Один аккаунт - один пользователь
-6. Возврат средств производится только в исключительных случаях
-7. Администрация оставляет за собой право заблокировать аккаунт при нарушении правил
-
-<b>Принимая правила, вы соглашаетесь соблюдать их.</b>
-"""
-    
     await callback.message.edit_text(
-        f"📋 <b>Правила сервиса</b>\n\n{rules_text}",
+        f"{texts.t('RULES_HEADER', '📋 <b>Правила сервиса</b>')}\n\n{rules_text}",
         reply_markup=types.InlineKeyboardMarkup(inline_keyboard=[
-            [types.InlineKeyboardButton(text="⬅️ Назад", callback_data="back_to_menu")]
+            [types.InlineKeyboardButton(text=texts.BACK, callback_data="back_to_menu")]
         ])
     )
     await callback.answer()
@@ -142,53 +130,92 @@ async def handle_back_to_menu(
 
 def _get_subscription_status(user: User, texts) -> str:
     if not user.subscription:
-        return "❌ Отсутствует"
+        return texts.t("SUB_STATUS_NONE", "❌ Отсутствует")
     
     subscription = user.subscription
     current_time = datetime.utcnow()
     
     if subscription.end_date <= current_time:
-        return f"🔴 Истекла\n📅 {subscription.end_date.strftime('%d.%m.%Y')}"
+        return texts.t(
+            "SUB_STATUS_EXPIRED",
+            "🔴 Истекла\n📅 {end_date}",
+        ).format(end_date=subscription.end_date.strftime('%d.%m.%Y'))
     
     days_left = (subscription.end_date - current_time).days
     
     if subscription.is_trial:
         if days_left > 1:
-            return f"🎁 Тестовая подписка\n📅 до {subscription.end_date.strftime('%d.%m.%Y')} ({days_left} дн.)"
+            return texts.t(
+                "SUB_STATUS_TRIAL_ACTIVE",
+                "🎁 Тестовая подписка\n📅 до {end_date} ({days} дн.)",
+            ).format(
+                end_date=subscription.end_date.strftime('%d.%m.%Y'),
+                days=days_left,
+            )
         elif days_left == 1:
-            return f"🎁 Тестовая подписка\n⚠️ истекает завтра!"
+            return texts.t(
+                "SUB_STATUS_TRIAL_TOMORROW",
+                "🎁 Тестовая подписка\n⚠️ истекает завтра!",
+            )
         else:
-            return f"🎁 Тестовая подписка\n⚠️ истекает сегодня!"
-    
+            return texts.t(
+                "SUB_STATUS_TRIAL_TODAY",
+                "🎁 Тестовая подписка\n⚠️ истекает сегодня!",
+            )
+
     else: 
         if days_left > 7:
-            return f"💎 Активна\n📅 до {subscription.end_date.strftime('%d.%m.%Y')} ({days_left} дн.)"
+            return texts.t(
+                "SUB_STATUS_ACTIVE_LONG",
+                "💎 Активна\n📅 до {end_date} ({days} дн.)",
+            ).format(
+                end_date=subscription.end_date.strftime('%d.%m.%Y'),
+                days=days_left,
+            )
         elif days_left > 1:
-            return f"💎 Активна\n⚠️ истекает через {days_left} дн."
+            return texts.t(
+                "SUB_STATUS_ACTIVE_FEW_DAYS",
+                "💎 Активна\n⚠️ истекает через {days} дн.",
+            ).format(days=days_left)
         elif days_left == 1:
-            return f"💎 Активна\n⚠️ истекает завтра!"
+            return texts.t(
+                "SUB_STATUS_ACTIVE_TOMORROW",
+                "💎 Активна\n⚠️ истекает завтра!",
+            )
         else:
-            return f"💎 Активна\n⚠️ истекает сегодня!"
+            return texts.t(
+                "SUB_STATUS_ACTIVE_TODAY",
+                "💎 Активна\n⚠️ истекает сегодня!",
+            )
+
+
+def _insert_random_message(base_text: str, random_message: str, action_prompt: str) -> str:
+    if not random_message:
+        return base_text
+
+    prompt = action_prompt or ""
+    if prompt and prompt in base_text:
+        parts = base_text.split(prompt, 1)
+        if len(parts) == 2:
+            return f"{parts[0]}\n{random_message}\n\n{prompt}{parts[1]}"
+        return base_text.replace(prompt, f"\n{random_message}\n\n{prompt}", 1)
+
+    return f"{base_text}\n\n{random_message}"
+
 
 async def get_main_menu_text(user, texts, db: AsyncSession):
-    
+
     base_text = texts.MAIN_MENU.format(
         user_name=user.full_name,
         subscription_status=_get_subscription_status(user, texts)
     )
     
+    action_prompt = texts.t("MAIN_MENU_ACTION_PROMPT", "Выберите действие:")
+
     try:
         random_message = await get_random_active_message(db)
         if random_message:
-            if "Выберите действие:" in base_text:
-                parts = base_text.split("Выберите действие:")
-                if len(parts) == 2:
-                    return f"{parts[0]}\n{random_message}\n\nВыберите действие:{parts[1]}"
-            
-            if "Выберите действие:" in base_text:
-                return base_text.replace("Выберите действие:", f"\n{random_message}\n\nВыберите действие:")
-            else:
-                return f"{base_text}\n\n{random_message}"
+            return _insert_random_message(base_text, random_message, action_prompt)
                 
     except Exception as e:
         logger.error(f"Ошибка получения случайного сообщения: {e}")

app/handlers/promocode.py

@@ -44,7 +44,10 @@ async def process_promocode(
     
     if not code:
         await message.answer(
-            "❌ Введите корректный промокод",
+            texts.t(
+                "PROMOCODE_EMPTY_INPUT",
+                "❌ Введите корректный промокод",
+            ),
             reply_markup=get_back_keyboard(db_user.language)
         )
         return

app/handlers/referral.py

@@ -33,64 +33,149 @@ async def show_referral_info(
     bot_username = (await callback.bot.get_me()).username
     referral_link = f"https://t.me/{bot_username}?start={db_user.referral_code}"
     
-    referral_text = f"👥 <b>Реферальная программа</b>\n\n"
-    
-    referral_text += f"📊 <b>Ваша статистика:</b>\n"
-    referral_text += f"• Приглашено пользователей: <b>{summary['invited_count']}</b>\n"
-    referral_text += f"• Сделали первое пополнение: <b>{summary['paid_referrals_count']}</b>\n"
-    referral_text += f"• Активных рефералов: <b>{summary['active_referrals_count']}</b>\n"
-    referral_text += f"• Конверсия: <b>{summary['conversion_rate']}%</b>\n"
-    referral_text += f"• Заработано всего: <b>{texts.format_price(summary['total_earned_kopeks'])}</b>\n"
-    referral_text += f"• За последний месяц: <b>{texts.format_price(summary['month_earned_kopeks'])}</b>\n\n"
-    
-    referral_text += f"🎁 <b>Как работают награды:</b>\n"
-    referral_text += f"• Новый пользователь получает: <b>{texts.format_price(settings.REFERRAL_FIRST_TOPUP_BONUS_KOPEKS)}</b> при первом пополнении от <b>{texts.format_price(settings.REFERRAL_MINIMUM_TOPUP_KOPEKS)}</b>\n"
-    referral_text += f"• Вы получаете при первом пополнении реферала: <b>{texts.format_price(settings.REFERRAL_INVITER_BONUS_KOPEKS)}</b>\n"
-    referral_text += f"• Комиссия с каждого пополнения реферала: <b>{settings.REFERRAL_COMMISSION_PERCENT}%</b>\n\n"
-    
-    referral_text += f"🔗 <b>Ваша реферальная ссылка:</b>\n"
-    referral_text += f"<code>{referral_link}</code>\n\n"
-    referral_text += f"🆔 <b>Ваш код:</b> <code>{db_user.referral_code}</code>\n\n"
-    
+    referral_text = (
+        texts.t("REFERRAL_PROGRAM_TITLE", "👥 <b>Реферальная программа</b>")
+        + "\n\n"
+        + texts.t("REFERRAL_STATS_HEADER", "📊 <b>Ваша статистика:</b>")
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_INVITED",
+            "• Приглашено пользователей: <b>{count}</b>",
+        ).format(count=summary['invited_count'])
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_FIRST_TOPUPS",
+            "• Сделали первое пополнение: <b>{count}</b>",
+        ).format(count=summary['paid_referrals_count'])
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_ACTIVE",
+            "• Активных рефералов: <b>{count}</b>",
+        ).format(count=summary['active_referrals_count'])
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_CONVERSION",
+            "• Конверсия: <b>{rate}%</b>",
+        ).format(rate=summary['conversion_rate'])
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_TOTAL_EARNED",
+            "• Заработано всего: <b>{amount}</b>",
+        ).format(amount=texts.format_price(summary['total_earned_kopeks']))
+        + "\n"
+        + texts.t(
+            "REFERRAL_STATS_MONTH_EARNED",
+            "• За последний месяц: <b>{amount}</b>",
+        ).format(amount=texts.format_price(summary['month_earned_kopeks']))
+        + "\n\n"
+        + texts.t("REFERRAL_REWARDS_HEADER", "🎁 <b>Как работают награды:</b>")
+        + "\n"
+        + texts.t(
+            "REFERRAL_REWARD_NEW_USER",
+            "• Новый пользователь получает: <b>{bonus}</b> при первом пополнении от <b>{minimum}</b>",
+        ).format(
+            bonus=texts.format_price(settings.REFERRAL_FIRST_TOPUP_BONUS_KOPEKS),
+            minimum=texts.format_price(settings.REFERRAL_MINIMUM_TOPUP_KOPEKS),
+        )
+        + "\n"
+        + texts.t(
+            "REFERRAL_REWARD_INVITER",
+            "• Вы получаете при первом пополнении реферала: <b>{bonus}</b>",
+        ).format(bonus=texts.format_price(settings.REFERRAL_INVITER_BONUS_KOPEKS))
+        + "\n"
+        + texts.t(
+            "REFERRAL_REWARD_COMMISSION",
+            "• Комиссия с каждого пополнения реферала: <b>{percent}%</b>",
+        ).format(percent=settings.REFERRAL_COMMISSION_PERCENT)
+        + "\n\n"
+        + texts.t("REFERRAL_LINK_TITLE", "🔗 <b>Ваша реферальная ссылка:</b>")
+        + f"\n<code>{referral_link}</code>\n\n"
+        + texts.t("REFERRAL_CODE_TITLE", "🆔 <b>Ваш код:</b> <code>{code}</code>").format(code=db_user.referral_code)
+        + "\n\n"
+    )
+
     if summary['recent_earnings']:
         meaningful_earnings = [
-            earning for earning in summary['recent_earnings'][:5] 
+            earning for earning in summary['recent_earnings'][:5]
             if earning['amount_kopeks'] > 0
         ]
-        
+
         if meaningful_earnings:
-            referral_text += f"💰 <b>Последние начисления:</b>\n"
-            for earning in meaningful_earnings[:3]: 
+            referral_text += texts.t(
+                "REFERRAL_RECENT_EARNINGS_HEADER",
+                "💰 <b>Последние начисления:</b>",
+            ) + "\n"
+            for earning in meaningful_earnings[:3]:
                 reason_text = {
-                    "referral_first_topup": "🎉 Первое пополнение",
-                    "referral_commission_topup": "💰 Комиссия с пополнения", 
-                    "referral_commission": "💰 Комиссия с покупки"
+                    "referral_first_topup": texts.t(
+                        "REFERRAL_EARNING_REASON_FIRST_TOPUP",
+                        "🎉 Первое пополнение",
+                    ),
+                    "referral_commission_topup": texts.t(
+                        "REFERRAL_EARNING_REASON_COMMISSION_TOPUP",
+                        "💰 Комиссия с пополнения",
+                    ),
+                    "referral_commission": texts.t(
+                        "REFERRAL_EARNING_REASON_COMMISSION_PURCHASE",
+                        "💰 Комиссия с покупки",
+                    ),
                 }.get(earning['reason'], earning['reason'])
-                
-                referral_text += f"• {reason_text}: <b>{texts.format_price(earning['amount_kopeks'])}</b> от {earning['referral_name']}\n"
+
+                referral_text += texts.t(
+                    "REFERRAL_RECENT_EARNINGS_ITEM",
+                    "• {reason}: <b>{amount}</b> от {referral_name}",
+                ).format(
+                    reason=reason_text,
+                    amount=texts.format_price(earning['amount_kopeks']),
+                    referral_name=earning['referral_name'],
+                ) + "\n"
             referral_text += "\n"
-    
+
     if summary['earnings_by_type']:
-        referral_text += f"📈 <b>Доходы по типам:</b>\n"
-        
+        referral_text += texts.t(
+            "REFERRAL_EARNINGS_BY_TYPE_HEADER",
+            "📈 <b>Доходы по типам:</b>",
+        ) + "\n"
+
         if 'referral_first_topup' in summary['earnings_by_type']:
             data = summary['earnings_by_type']['referral_first_topup']
             if data['total_amount_kopeks'] > 0:
-                referral_text += f"• Бонусы за первые пополнения: <b>{data['count']}</b> ({texts.format_price(data['total_amount_kopeks'])})\n"
-        
+                referral_text += texts.t(
+                    "REFERRAL_EARNINGS_FIRST_TOPUPS",
+                    "• Бонусы за первые пополнения: <b>{count}</b> ({amount})",
+                ).format(
+                    count=data['count'],
+                    amount=texts.format_price(data['total_amount_kopeks']),
+                ) + "\n"
+
         if 'referral_commission_topup' in summary['earnings_by_type']:
             data = summary['earnings_by_type']['referral_commission_topup']
             if data['total_amount_kopeks'] > 0:
-                referral_text += f"• Комиссии с пополнений: <b>{data['count']}</b> ({texts.format_price(data['total_amount_kopeks'])})\n"
-        
+                referral_text += texts.t(
+                    "REFERRAL_EARNINGS_TOPUPS",
+                    "• Комиссии с пополнений: <b>{count}</b> ({amount})",
+                ).format(
+                    count=data['count'],
+                    amount=texts.format_price(data['total_amount_kopeks']),
+                ) + "\n"
+
         if 'referral_commission' in summary['earnings_by_type']:
             data = summary['earnings_by_type']['referral_commission']
             if data['total_amount_kopeks'] > 0:
-                referral_text += f"• Комиссии с покупок: <b>{data['count']}</b> ({texts.format_price(data['total_amount_kopeks'])})\n"
-        
+                referral_text += texts.t(
+                    "REFERRAL_EARNINGS_PURCHASES",
+                    "• Комиссии с покупок: <b>{count}</b> ({amount})",
+                ).format(
+                    count=data['count'],
+                    amount=texts.format_price(data['total_amount_kopeks']),
+                ) + "\n"
+
         referral_text += "\n"
-    
-    referral_text += "📢 Приглашайте друзей и зарабатывайте!"
+
+    referral_text += texts.t(
+        "REFERRAL_INVITE_FOOTER",
+        "📢 Приглашайте друзей и зарабатывайте!",
+    )
 
     await edit_or_answer_photo(
         callback,
@@ -128,7 +213,10 @@ async def show_referral_qr(
         await callback.message.edit_media(
             types.InputMediaPhoto(
                 media=photo,
-                caption=f"🔗 Ваша реферальная ссылка:\n{referral_link}",
+                caption=texts.t(
+                    "REFERRAL_LINK_CAPTION",
+                    "🔗 Ваша реферальная ссылка:\n{link}",
+                ).format(link=referral_link),
             ),
             reply_markup=keyboard,
         )
@@ -136,7 +224,10 @@ async def show_referral_qr(
         await callback.message.delete()
         await callback.message.answer_photo(
             photo,
-            caption=f"🔗 Ваша реферальная ссылка:\n{referral_link}",
+            caption=texts.t(
+                "REFERRAL_LINK_CAPTION",
+                "🔗 Ваша реферальная ссылка:\n{link}",
+            ).format(link=referral_link),
             reply_markup=keyboard,
         )
 
@@ -154,7 +245,10 @@ async def show_detailed_referral_list(
     if not referrals_data['referrals']:
         await edit_or_answer_photo(
             callback,
-            "📋 У вас пока нет рефералов.\n\nПоделитесь своей реферальной ссылкой, чтобы начать зарабатывать!",
+            texts.t(
+                "REFERRAL_LIST_EMPTY",
+                "📋 У вас пока нет рефералов.\n\nПоделитесь своей реферальной ссылкой, чтобы начать зарабатывать!",
+            ),
             types.InlineKeyboardMarkup(
                 inline_keyboard=[[types.InlineKeyboardButton(text=texts.BACK, callback_data="menu_referrals")]]
             ),
@@ -162,23 +256,47 @@ async def show_detailed_referral_list(
         )
         await callback.answer()
         return
-    
-    text = f"👥 <b>Ваши рефералы</b> (стр. {referrals_data['current_page']}/{referrals_data['total_pages']})\n\n"
+
+    text = texts.t(
+        "REFERRAL_LIST_HEADER",
+        "👥 <b>Ваши рефералы</b> (стр. {current}/{total})",
+    ).format(
+        current=referrals_data['current_page'],
+        total=referrals_data['total_pages'],
+    ) + "\n\n"
     
     for i, referral in enumerate(referrals_data['referrals'], 1):
         status_emoji = "🟢" if referral['status'] == 'active' else "🔴"
         
         topup_emoji = "💰" if referral['has_made_first_topup'] else "⏳"
         
-        text += f"{i}. {status_emoji} <b>{referral['full_name']}</b>\n"
-        text += f"   {topup_emoji} Пополнений: {referral['topups_count']}\n"
-        text += f"   💎 Заработано с него: {texts.format_price(referral['total_earned_kopeks'])}\n"
-        text += f"   📅 Регистрация: {referral['days_since_registration']} дн. назад\n"
-        
+        text += texts.t(
+            "REFERRAL_LIST_ITEM_HEADER",
+            "{index}. {status} <b>{name}</b>",
+        ).format(index=i, status=status_emoji, name=referral['full_name']) + "\n"
+        text += texts.t(
+            "REFERRAL_LIST_ITEM_TOPUPS",
+            "   {emoji} Пополнений: {count}",
+        ).format(emoji=topup_emoji, count=referral['topups_count']) + "\n"
+        text += texts.t(
+            "REFERRAL_LIST_ITEM_EARNED",
+            "   💎 Заработано с него: {amount}",
+        ).format(amount=texts.format_price(referral['total_earned_kopeks'])) + "\n"
+        text += texts.t(
+            "REFERRAL_LIST_ITEM_REGISTERED",
+            "   📅 Регистрация: {days} дн. назад",
+        ).format(days=referral['days_since_registration']) + "\n"
+
         if referral['days_since_activity'] is not None:
-            text += f"   🕐 Активность: {referral['days_since_activity']} дн. назад\n"
+            text += texts.t(
+                "REFERRAL_LIST_ITEM_ACTIVITY",
+                "   🕐 Активность: {days} дн. назад",
+            ).format(days=referral['days_since_activity']) + "\n"
         else:
-            text += f"   🕐 Активность: давно\n"
+            text += texts.t(
+                "REFERRAL_LIST_ITEM_ACTIVITY_LONG_AGO",
+                "   🕐 Активность: давно",
+            ) + "\n"
         
         text += "\n"
     
@@ -187,13 +305,13 @@ async def show_detailed_referral_list(
     
     if referrals_data['has_prev']:
         nav_buttons.append(types.InlineKeyboardButton(
-            text="⬅️ Назад", 
+            text=texts.t("REFERRAL_LIST_PREV_PAGE", "⬅️ Назад"),
             callback_data=f"referral_list_page_{page - 1}"
         ))
-    
+
     if referrals_data['has_next']:
         nav_buttons.append(types.InlineKeyboardButton(
-            text="Вперед ➡️", 
+            text=texts.t("REFERRAL_LIST_NEXT_PAGE", "Вперед ➡️"),
             callback_data=f"referral_list_page_{page + 1}"
         ))
     
@@ -222,21 +340,50 @@ async def show_referral_analytics(
 
     analytics = await get_referral_analytics(db, db_user.id)
 
-    text = f"📊 <b>Аналитика рефералов</b>\n\n"
+    text = texts.t("REFERRAL_ANALYTICS_TITLE", "📊 <b>Аналитика рефералов</b>") + "\n\n"
 
-    text += f"💰 <b>Доходы по периодам:</b>\n"
-    text += f"• Сегодня: {texts.format_price(analytics['earnings_by_period']['today'])}\n"
-    text += f"• За неделю: {texts.format_price(analytics['earnings_by_period']['week'])}\n"
-    text += f"• За месяц: {texts.format_price(analytics['earnings_by_period']['month'])}\n"
-    text += f"• За квартал: {texts.format_price(analytics['earnings_by_period']['quarter'])}\n\n"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_EARNINGS_HEADER",
+        "💰 <b>Доходы по периодам:</b>",
+    ) + "\n"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_EARNINGS_TODAY",
+        "• Сегодня: {amount}",
+    ).format(amount=texts.format_price(analytics['earnings_by_period']['today'])) + "\n"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_EARNINGS_WEEK",
+        "• За неделю: {amount}",
+    ).format(amount=texts.format_price(analytics['earnings_by_period']['week'])) + "\n"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_EARNINGS_MONTH",
+        "• За месяц: {amount}",
+    ).format(amount=texts.format_price(analytics['earnings_by_period']['month'])) + "\n"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_EARNINGS_QUARTER",
+        "• За квартал: {amount}",
+    ).format(amount=texts.format_price(analytics['earnings_by_period']['quarter'])) + "\n\n"
 
     if analytics['top_referrals']:
-        text += f"🏆 <b>Топ-{len(analytics['top_referrals'])} рефералов:</b>\n"
+        text += texts.t(
+            "REFERRAL_ANALYTICS_TOP_TITLE",
+            "🏆 <b>Топ-{count} рефералов:</b>",
+        ).format(count=len(analytics['top_referrals'])) + "\n"
         for i, ref in enumerate(analytics['top_referrals'], 1):
-            text += f"{i}. {ref['referral_name']}: {texts.format_price(ref['total_earned_kopeks'])} ({ref['earnings_count']} начислений)\n"
+            text += texts.t(
+                "REFERRAL_ANALYTICS_TOP_ITEM",
+                "{index}. {name}: {amount} ({count} начислений)",
+            ).format(
+                index=i,
+                name=ref['referral_name'],
+                amount=texts.format_price(ref['total_earned_kopeks']),
+                count=ref['earnings_count'],
+            ) + "\n"
         text += "\n"
 
-    text += "📈 Продолжайте развивать свою реферальную сеть!"
+    text += texts.t(
+        "REFERRAL_ANALYTICS_FOOTER",
+        "📈 Продолжайте развивать свою реферальную сеть!",
+    )
 
     await edit_or_answer_photo(
         callback,
@@ -257,16 +404,30 @@ async def create_invite_message(
     bot_username = (await callback.bot.get_me()).username
     referral_link = f"https://t.me/{bot_username}?start={db_user.referral_code}"
 
-    invite_text = f"🎉 Присоединяйся к VPN сервису!\n\n"
-    invite_text += f"💎 При первом пополнении от {texts.format_price(settings.REFERRAL_MINIMUM_TOPUP_KOPEKS)} ты получишь {texts.format_price(settings.REFERRAL_FIRST_TOPUP_BONUS_KOPEKS)} бонусом на баланс!\n\n"
-    invite_text += f"🚀 Быстрое подключение\n"
-    invite_text += f"🌍 Серверы по всему миру\n"
-    invite_text += f"🔒 Надежная защита\n\n"
-    invite_text += f"👇 Переходи по ссылке:\n{referral_link}"
+    invite_text = (
+        texts.t("REFERRAL_INVITE_TITLE", "🎉 Присоединяйся к VPN сервису!")
+        + "\n\n"
+        + texts.t(
+            "REFERRAL_INVITE_BONUS",
+            "💎 При первом пополнении от {minimum} ты получишь {bonus} бонусом на баланс!",
+        ).format(
+            minimum=texts.format_price(settings.REFERRAL_MINIMUM_TOPUP_KOPEKS),
+            bonus=texts.format_price(settings.REFERRAL_FIRST_TOPUP_BONUS_KOPEKS),
+        )
+        + "\n\n"
+        + texts.t("REFERRAL_INVITE_FEATURE_FAST", "🚀 Быстрое подключение")
+        + "\n"
+        + texts.t("REFERRAL_INVITE_FEATURE_SERVERS", "🌍 Серверы по всему миру")
+        + "\n"
+        + texts.t("REFERRAL_INVITE_FEATURE_SECURE", "🔒 Надежная защита")
+        + "\n\n"
+        + texts.t("REFERRAL_INVITE_LINK_PROMPT", "👇 Переходи по ссылке:")
+        + f"\n{referral_link}"
+    )
 
     keyboard = types.InlineKeyboardMarkup(inline_keyboard=[
         [types.InlineKeyboardButton(
-            text="📤 Поделиться",
+            text=texts.t("REFERRAL_SHARE_BUTTON", "📤 Поделиться"),
             switch_inline_query=invite_text
         )],
         [types.InlineKeyboardButton(
@@ -278,8 +439,13 @@ async def create_invite_message(
     await edit_or_answer_photo(
         callback,
         (
-            f"📝 <b>Приглашение создано!</b>\n\n"
-            f"Нажмите кнопку «📤 Поделиться» чтобы отправить приглашение в любой чат, или скопируйте текст ниже:\n\n"
+            texts.t("REFERRAL_INVITE_CREATED_TITLE", "📝 <b>Приглашение создано!</b>")
+            + "\n\n"
+            + texts.t(
+                "REFERRAL_INVITE_CREATED_INSTRUCTION",
+                "Нажмите кнопку «📤 Поделиться» чтобы отправить приглашение в любой чат, или скопируйте текст ниже:",
+            )
+            + "\n\n"
             f"<code>{invite_text}</code>"
         ),
         keyboard,

app/handlers/stars_payments.py

@@ -6,22 +6,29 @@ from app.database.models import User
 from app.services.payment_service import PaymentService
 from app.external.telegram_stars import TelegramStarsService
 from app.database.crud.user import get_user_by_telegram_id
+from app.localization.loader import DEFAULT_LANGUAGE
+from app.localization.texts import get_texts
 
 logger = logging.getLogger(__name__)
 
 
 async def handle_pre_checkout_query(query: types.PreCheckoutQuery):
+    texts = get_texts(DEFAULT_LANGUAGE)
+
     try:
         logger.info(f"📋 Pre-checkout query от {query.from_user.id}: {query.total_amount} XTR, payload: {query.invoice_payload}")
-        
+
         if not query.invoice_payload or not query.invoice_payload.startswith("balance_"):
             logger.warning(f"Невалидный payload: {query.invoice_payload}")
             await query.answer(
                 ok=False,
-                error_message="Ошибка валидации платежа. Попробуйте еще раз."
+                error_message=texts.t(
+                    "STARS_PRECHECK_INVALID_PAYLOAD",
+                    "Ошибка валидации платежа. Попробуйте еще раз.",
+                ),
             )
             return
-        
+
         try:
             from app.database.database import get_db
             async for db in get_db():
@@ -30,26 +37,36 @@ async def handle_pre_checkout_query(query: types.PreCheckoutQuery):
                     logger.warning(f"Пользователь {query.from_user.id} не найден в БД")
                     await query.answer(
                         ok=False,
-                        error_message="Пользователь не найден. Обратитесь в поддержку."
+                        error_message=texts.t(
+                            "STARS_PRECHECK_USER_NOT_FOUND",
+                            "Пользователь не найден. Обратитесь в поддержку.",
+                        ),
                     )
                     return
-                break 
+                texts = get_texts(user.language or DEFAULT_LANGUAGE)
+                break
         except Exception as db_error:
             logger.error(f"Ошибка подключения к БД в pre_checkout_query: {db_error}")
             await query.answer(
                 ok=False,
-                error_message="Техническая ошибка. Попробуйте позже."
+                error_message=texts.t(
+                    "STARS_PRECHECK_TECHNICAL_ERROR",
+                    "Техническая ошибка. Попробуйте позже.",
+                ),
             )
             return
-        
+
         await query.answer(ok=True)
         logger.info(f"✅ Pre-checkout одобрен для пользователя {query.from_user.id}")
-        
+
     except Exception as e:
         logger.error(f"Ошибка в pre_checkout_query: {e}", exc_info=True)
         await query.answer(
             ok=False,
-            error_message="Техническая ошибка. Попробуйте позже."
+            error_message=texts.t(
+                "STARS_PRECHECK_TECHNICAL_ERROR",
+                "Техническая ошибка. Попробуйте позже.",
+            ),
         )
 
 
@@ -58,25 +75,32 @@ async def handle_successful_payment(
     db: AsyncSession,
     **kwargs
 ):
+    texts = get_texts(DEFAULT_LANGUAGE)
+
     try:
         payment = message.successful_payment
         user_id = message.from_user.id
-        
+
         logger.info(
             f"💳 Успешный Stars платеж от {user_id}: "
             f"{payment.total_amount} XTR, "
             f"payload: {payment.invoice_payload}, "
             f"charge_id: {payment.telegram_payment_charge_id}"
         )
-        
+
         user = await get_user_by_telegram_id(db, user_id)
+        texts = get_texts(user.language if user and user.language else DEFAULT_LANGUAGE)
+
         if not user:
             logger.error(f"Пользователь {user_id} не найден при обработке Stars платежа")
             await message.answer(
-                "❌ Ошибка: пользователь не найден. Обратитесь в поддержку."
+                texts.t(
+                    "STARS_PAYMENT_USER_NOT_FOUND",
+                    "❌ Ошибка: пользователь не найден. Обратитесь в поддержку.",
+                )
             )
             return
-        
+
         payment_service = PaymentService(message.bot)
         success = await payment_service.process_stars_payment(
             db=db,
@@ -91,12 +115,21 @@ async def handle_successful_payment(
 
             keyboard = await payment_service.build_topup_success_keyboard(user)
 
+            transaction_id_short = payment.telegram_payment_charge_id[:8]
+
             await message.answer(
-                f"🎉 <b>Платеж успешно обработан!</b>\n\n"
-                f"⭐ Потрачено звезд: {payment.total_amount}\n"
-                f"💰 Зачислено на баланс: {int(rubles_amount)} ₽\n"
-                f"🆔 ID транзакции: {payment.telegram_payment_charge_id[:8]}...\n\n"
-                f"Спасибо за пополнение! 🚀",
+                texts.t(
+                    "STARS_PAYMENT_SUCCESS",
+                    "🎉 <b>Платеж успешно обработан!</b>\n\n"
+                    "⭐ Потрачено звезд: {stars_spent}\n"
+                    "💰 Зачислено на баланс: {amount} ₽\n"
+                    "🆔 ID транзакции: {transaction_id}...\n\n"
+                    "Спасибо за пополнение! 🚀",
+                ).format(
+                    stars_spent=payment.total_amount,
+                    amount=int(rubles_amount),
+                    transaction_id=transaction_id_short,
+                ),
                 parse_mode="HTML",
                 reply_markup=keyboard,
             )
@@ -108,15 +141,21 @@ async def handle_successful_payment(
         else:
             logger.error(f"Ошибка обработки Stars платежа для пользователя {user.id}")
             await message.answer(
-                "❌ Произошла ошибка при зачислении средств. "
-                "Обратитесь в поддержку, платеж будет проверен вручную."
+                texts.t(
+                    "STARS_PAYMENT_ENROLLMENT_ERROR",
+                    "❌ Произошла ошибка при зачислении средств. "
+                    "Обратитесь в поддержку, платеж будет проверен вручную.",
+                )
             )
-        
+
     except Exception as e:
         logger.error(f"Ошибка в successful_payment: {e}", exc_info=True)
         await message.answer(
-            "❌ Техническая ошибка при обработке платежа. "
-            "Обратитесь в поддержку для решения проблемы."
+            texts.t(
+                "STARS_PAYMENT_PROCESSING_ERROR",
+                "❌ Техническая ошибка при обработке платежа. "
+                "Обратитесь в поддержку для решения проблемы.",
+            )
         )
 
 

app/handlers/start.py

@@ -21,7 +21,8 @@ from app.database.models import UserStatus
 from app.keyboards.inline import (
     get_rules_keyboard, get_main_menu_keyboard, get_post_registration_keyboard
 )
-from app.localization.texts import get_texts
+from app.localization.loader import DEFAULT_LANGUAGE
+from app.localization.texts import get_texts, get_rules
 from app.services.referral_service import process_referral_registration
 from app.services.campaign_service import AdvertisingCampaignService
 from app.utils.user_utils import generate_unique_referral_code
@@ -87,34 +88,43 @@ async def handle_potential_referral_code(
     user = await get_user_by_telegram_id(db, message.from_user.id)
     if user and user.status == UserStatus.ACTIVE.value:
         return False
-    
+
+    data = await state.get_data() or {}
+    language = (
+        data.get("language")
+        or (getattr(user, "language", None) if user else None)
+        or DEFAULT_LANGUAGE
+    )
+    texts = get_texts(language)
+
     potential_code = message.text.strip()
     if len(potential_code) < 4 or len(potential_code) > 20:
         return False
-    
+
     referrer = await get_user_by_referral_code(db, potential_code)
     if not referrer:
-        await message.answer(
+        await message.answer(texts.t(
+            "REFERRAL_CODE_INVALID_HELP",
             "❌ Неверный реферальный код.\n\n"
             "💡 Если у вас есть реферальный код, убедитесь что он введен правильно.\n"
-            "⏭️ Для продолжения регистрации без реферального кода используйте команду /start"
-        )
-        return True 
-    
-    data = await state.get_data() or {}
+            "⏭️ Для продолжения регистрации без реферального кода используйте команду /start",
+        ))
+        return True
+
     data['referral_code'] = potential_code
     data['referrer_id'] = referrer.id
     await state.set_data(data)
-    
-    await message.answer("✅ Реферальный код принят!")
+
+    await message.answer(texts.t("REFERRAL_CODE_ACCEPTED", "✅ Реферальный код принят!"))
     logger.info(f"✅ Реферальный код {potential_code} применен для пользователя {message.from_user.id}")
     
     if current_state != RegistrationStates.waiting_for_referral_code.state:
-        language = data.get('language', 'ru')
+        language = data.get('language', DEFAULT_LANGUAGE)
         texts = get_texts(language)
         
+        rules_text = await get_rules(language)
         await message.answer(
-            texts.RULES_TEXT,
+            rules_text,
             reply_markup=get_rules_keyboard(language)
         )
         await state.set_state(RegistrationStates.waiting_for_rules_accept)
@@ -192,12 +202,20 @@ async def cmd_start(message: types.Message, state: FSMContext, db: AsyncSession,
 
         if referral_code and not user.referred_by_id:
             await message.answer(
-                "ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена."
+                texts.t(
+                    "ALREADY_REGISTERED_REFERRAL",
+                    "ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.",
+                )
             )
 
         if campaign:
             try:
-                await message.answer(texts.CAMPAIGN_EXISTING_USER)
+                await message.answer(
+                    texts.t(
+                        "CAMPAIGN_EXISTING_USERL",
+                        "ℹ️ Эта рекламная ссылка доступна только новым пользователям.",
+                    )
+                )
             except Exception as e:
                 logger.error(
                     f"Ошибка отправки уведомления о рекламной кампании: {e}"
@@ -290,13 +308,13 @@ async def cmd_start(message: types.Message, state: FSMContext, db: AsyncSession,
     else:
         logger.info(f"🆕 Новый пользователь, начинаем регистрацию")
     
-    language = 'ru'
+    language = DEFAULT_LANGUAGE
     texts = get_texts(language)
     
     data = await state.get_data() or {}
     data['language'] = language
     await state.set_data(data)
-    logger.info(f"💾 Установлен русский язык по умолчанию")
+    logger.info(f"💾 Установлен язык по умолчанию: {language}")
     if settings.SKIP_RULES_ACCEPT:
         logger.info("⚙️ SKIP_RULES_ACCEPT включен - пропускаем принятие правил")
         if data.get('referral_code'):
@@ -311,7 +329,10 @@ async def cmd_start(message: types.Message, state: FSMContext, db: AsyncSession,
         else:
             try:
                 await message.answer(
-                    "У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
+                    texts.t(
+                        "REFERRAL_CODE_QUESTION",
+                        "У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
+                    ),
                     reply_markup=get_referral_code_keyboard(language)
                 )
                 await state.set_state(RegistrationStates.waiting_for_referral_code)
@@ -321,8 +342,9 @@ async def cmd_start(message: types.Message, state: FSMContext, db: AsyncSession,
                 await complete_registration(message, state, db)
         return
 
+    rules_text = await get_rules(language)
     await message.answer(
-        texts.RULES_TEXT,
+        rules_text,
         reply_markup=get_rules_keyboard(language)
     )
     logger.info(f"📋 Правила отправлены")
@@ -345,11 +367,14 @@ async def process_rules_accept(
     current_state = await state.get_state()
     logger.info(f"📊 Текущее состояние: {current_state}")
     
+    language = DEFAULT_LANGUAGE
+    texts = get_texts(language)
+
     try:
         await callback.answer()
-        
-        data = await state.get_data()
-        language = data.get('language', 'ru')
+
+        data = await state.get_data() or {}
+        language = data.get('language', language)
         texts = get_texts(language)
         
         if callback.data == 'rules_accept':
@@ -362,10 +387,13 @@ async def process_rules_accept(
                 logger.warning(f"⚠️ Не удалось удалить сообщение с правилами: {e}")
                 try:
                     await callback.message.edit_text(
-                        "✅ Правила приняты! Завершаем регистрацию...",
+                        texts.t(
+                            "RULES_ACCEPTED_PROCESSING",
+                            "✅ Правила приняты! Завершаем регистрацию...",
+                        ),
                         reply_markup=None
                     )
-                except:
+                except Exception:
                     pass
             
             if data.get('referral_code'):
@@ -385,7 +413,10 @@ async def process_rules_accept(
                 else:
                     try:
                         await callback.message.answer(
-                            "У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
+                            texts.t(
+                                "REFERRAL_CODE_QUESTION",
+                                "У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
+                            ),
                             reply_markup=get_referral_code_keyboard(language)
                         )
                         await state.set_state(RegistrationStates.waiting_for_referral_code)
@@ -397,9 +428,12 @@ async def process_rules_accept(
         else:
             logger.info(f"❌ Правила отклонены пользователем {callback.from_user.id}")
             
+            rules_required_text = texts.t(
+                "RULES_REQUIRED",
+                "Для использования бота необходимо принять правила сервиса.",
+            )
+
             try:
-                rules_required_text = getattr(texts, 'RULES_REQUIRED', 
-                                             "Для использования бота необходимо принять правила сервиса.")
                 await callback.message.edit_text(
                     rules_required_text,
                     reply_markup=get_rules_keyboard(language)
@@ -407,7 +441,7 @@ async def process_rules_accept(
             except Exception as e:
                 logger.error(f"Ошибка при показе сообщения об отклонении правил: {e}")
                 await callback.message.edit_text(
-                    "Для использования бота необходимо принять правила сервиса.",
+                    rules_required_text,
                     reply_markup=get_rules_keyboard(language)
                 )
         
@@ -415,13 +449,20 @@ async def process_rules_accept(
         
     except Exception as e:
         logger.error(f"❌ Ошибка обработки правил: {e}", exc_info=True)
-        await callback.answer("❌ Произошла ошибка. Попробуйте еще раз.", show_alert=True)
-        
+        await callback.answer(
+            texts.t("ERROR_TRY_AGAIN", "❌ Произошла ошибка. Попробуйте еще раз."),
+            show_alert=True,
+        )
+
         try:
-            data = await state.get_data()
-            language = data.get('language', 'ru')
+            data = await state.get_data() or {}
+            language = data.get('language', language)
+            texts = get_texts(language)
             await callback.message.answer(
-                "Произошла ошибка. Попробуйте принять правила еще раз:",
+                texts.t(
+                    "ERROR_RULES_RETRY",
+                    "Произошла ошибка. Попробуйте принять правила еще раз:",
+                ),
                 reply_markup=get_rules_keyboard(language)
             )
             await state.set_state(RegistrationStates.waiting_for_rules_accept)
@@ -437,20 +478,20 @@ async def process_referral_code_input(
     
     logger.info(f"🎫 REFERRAL: Обработка реферального кода: {message.text}")
     
-    data = await state.get_data()
-    language = data.get('language', 'ru')
+    data = await state.get_data() or {}
+    language = data.get('language', DEFAULT_LANGUAGE)
     texts = get_texts(language)
-    
+
     referral_code = message.text.strip()
-    
+
     referrer = await get_user_by_referral_code(db, referral_code)
     if referrer:
         data['referrer_id'] = referrer.id
         await state.set_data(data)
-        await message.answer("✅ Реферальный код применен!")
+        await message.answer(texts.t("REFERRAL_CODE_ACCEPTED", "✅ Реферальный код принят!"))
         logger.info(f"✅ Реферальный код применен")
     else:
-        await message.answer("❌ Неверный реферальный код")
+        await message.answer(texts.t("REFERRAL_CODE_INVALID", "❌ Неверный реферальный код"))
         logger.info(f"❌ Неверный реферальный код")
         return
     
@@ -458,14 +499,18 @@ async def process_referral_code_input(
 
 
 async def process_referral_code_skip(
-    callback: types.CallbackQuery, 
-    state: FSMContext, 
+    callback: types.CallbackQuery,
+    state: FSMContext,
     db: AsyncSession
 ):
-    
+
     logger.info(f"⭐️ SKIP: Пропуск реферального кода от пользователя {callback.from_user.id}")
     await callback.answer()
-    
+
+    data = await state.get_data() or {}
+    language = data.get('language', DEFAULT_LANGUAGE)
+    texts = get_texts(language)
+
     try:
         await callback.message.delete()
         logger.info(f"🗑️ Сообщение с вопросом о реферальном коде удалено")
@@ -473,7 +518,7 @@ async def process_referral_code_skip(
         logger.warning(f"⚠️ Не удалось удалить сообщение с вопросом о реферальном коде: {e}")
         try:
             await callback.message.edit_text(
-                "✅ Завершаем регистрацию...",
+                texts.t("REGISTRATION_COMPLETING", "✅ Завершаем регистрацию..."),
                 reply_markup=None
             )
         except:
@@ -498,9 +543,14 @@ async def complete_registration_from_callback(
         logger.warning(f"⚠️ Пользователь {callback.from_user.id} уже активен! Показываем главное меню.")
         texts = get_texts(existing_user.language)
         
-        data = await state.get_data()
+        data = await state.get_data() or {}
         if data.get('referral_code') and not existing_user.referred_by_id:
-            await callback.message.answer("ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.")
+            await callback.message.answer(
+                texts.t(
+                    "ALREADY_REGISTERED_REFERRAL",
+                    "ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.",
+                )
+            )
         
         await db.refresh(existing_user, ['subscription'])
         
@@ -528,13 +578,18 @@ async def complete_registration_from_callback(
             )
         except Exception as e:
             logger.error(f"Ошибка при показе главного меню существующему пользователю: {e}")
-            await callback.message.answer(f"Добро пожаловать, {existing_user.full_name}!")
+            await callback.message.answer(
+                texts.t(
+                    "WELCOME_FALLBACK",
+                    "Добро пожаловать, {user_name}!",
+                ).format(user_name=existing_user.full_name)
+            )
         
         await state.clear()
         return
     
-    data = await state.get_data()
-    language = data.get('language', 'ru')
+    data = await state.get_data() or {}
+    language = data.get('language', DEFAULT_LANGUAGE)
     texts = get_texts(language)
     
     referrer_id = data.get('referrer_id')
@@ -638,7 +693,7 @@ async def complete_registration_from_callback(
         try:
             await callback.message.answer(
                 offer_text,
-                reply_markup=get_post_registration_keyboard(),
+                reply_markup=get_post_registration_keyboard(user.language),
             )
             logger.info(f"✅ Приветственное сообщение отправлено пользователю {user.telegram_id}")
         except Exception as e:
@@ -671,7 +726,12 @@ async def complete_registration_from_callback(
             logger.info(f"✅ Главное меню показано пользователю {user.telegram_id}")
         except Exception as e:
             logger.error(f"Ошибка при показе главного меню: {e}")
-            await callback.message.answer(f"Добро пожаловать, {user.full_name}!")
+            await callback.message.answer(
+                texts.t(
+                    "WELCOME_FALLBACK",
+                    "Добро пожаловать, {user_name}!",
+                ).format(user_name=user.full_name)
+            )
 
     logger.info(f"✅ Регистрация завершена для пользователя: {user.telegram_id}")
 
@@ -689,9 +749,14 @@ async def complete_registration(
         logger.warning(f"⚠️ Пользователь {message.from_user.id} уже активен! Показываем главное меню.")
         texts = get_texts(existing_user.language)
         
-        data = await state.get_data()
+        data = await state.get_data() or {}
         if data.get('referral_code') and not existing_user.referred_by_id:
-            await message.answer("ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.")
+            await message.answer(
+                texts.t(
+                    "ALREADY_REGISTERED_REFERRAL",
+                    "ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.",
+                )
+            )
         
         await db.refresh(existing_user, ['subscription'])
         
@@ -719,13 +784,18 @@ async def complete_registration(
             )
         except Exception as e:
             logger.error(f"Ошибка при показе главного меню существующему пользователю: {e}")
-            await message.answer(f"Добро пожаловать, {existing_user.full_name}!")
+            await message.answer(
+                texts.t(
+                    "WELCOME_FALLBACK",
+                    "Добро пожаловать, {user_name}!",
+                ).format(user_name=existing_user.full_name)
+            )
         
         await state.clear()
         return
     
-    data = await state.get_data()
-    language = data.get('language', 'ru')
+    data = await state.get_data() or {}
+    language = data.get('language', DEFAULT_LANGUAGE)
     texts = get_texts(language)
     
     referrer_id = data.get('referrer_id')
@@ -829,7 +899,7 @@ async def complete_registration(
         try:
             await message.answer(
                 offer_text,
-                reply_markup=get_post_registration_keyboard(),
+                reply_markup=get_post_registration_keyboard(user.language),
             )
             logger.info(f"✅ Приветственное сообщение отправлено пользователю {user.telegram_id}")
         except Exception as e:
@@ -862,54 +932,92 @@ async def complete_registration(
             logger.info(f"✅ Главное меню показано пользователю {user.telegram_id}")
         except Exception as e:
             logger.error(f"Ошибка при показе главного меню: {e}")
-            await message.answer(f"Добро пожаловать, {user.full_name}!")
+            await message.answer(
+                texts.t(
+                    "WELCOME_FALLBACK",
+                    "Добро пожаловать, {user_name}!",
+                ).format(user_name=user.full_name)
+            )
 
     logger.info(f"✅ Регистрация завершена для пользователя: {user.telegram_id}")
 
 
 def _get_subscription_status(user, texts):
-    if not user or not hasattr(user, 'subscription'):
-        return getattr(texts, 'SUBSCRIPTION_NONE', 'Нет активной подписки')
-    
-    if not user.subscription:
-        return getattr(texts, 'SUBSCRIPTION_NONE', 'Нет активной подписки')
-    
+    if not user or not hasattr(user, "subscription") or not user.subscription:
+        return texts.t("SUBSCRIPTION_NONE", "Нет активной подписки")
+
     subscription = user.subscription
-    
+
     from datetime import datetime
+
+    end_date = getattr(subscription, "end_date", None)
     current_time = datetime.utcnow()
-    
-    if hasattr(subscription, 'end_date') and subscription.end_date <= current_time:
-        return f"🔴 Истекла\n📅 {subscription.end_date.strftime('%d.%m.%Y')}"
-    
-    if hasattr(subscription, 'end_date'):
-        days_left = (subscription.end_date - current_time).days
-    else:
-        days_left = 0
-    
-    is_trial = getattr(subscription, 'is_trial', False)
-    
+
+    if end_date and end_date <= current_time:
+        return texts.t(
+            "SUB_STATUS_EXPIRED",
+            "🔴 Истекла\n📅 {end_date}",
+        ).format(end_date=end_date.strftime('%d.%m.%Y'))
+
+    if not end_date:
+        return texts.t("SUBSCRIPTION_ACTIVE", "✅ Активна")
+
+    days_left = (end_date - current_time).days
+    is_trial = getattr(subscription, "is_trial", False)
+
     if is_trial:
         if days_left > 1:
-            return f"🎁 Тестовая подписка\n📅 до {subscription.end_date.strftime('%d.%m.%Y')} ({days_left} дн.)"
-        elif days_left == 1:
-            return "🎁 Тестовая подписка\n⚠️ истекает завтра!"
-        else:
-            return "🎁 Тестовая подписка\n⚠️ истекает сегодня!"
-    else: 
-        if days_left > 7:
-            return f"💎 Активна\n📅 до {subscription.end_date.strftime('%d.%m.%Y')} ({days_left} дн.)"
-        elif days_left > 1:
-            return f"💎 Активна\n⚠️ истекает через {days_left} дн."
-        elif days_left == 1:
-            return "💎 Активна\n⚠️ истекает завтра!"
-        else:
-            return "💎 Активна\n⚠️ истекает сегодня!"
+            return texts.t(
+                "SUB_STATUS_TRIAL_ACTIVE",
+                "🎁 Тестовая подписка\n📅 до {end_date} ({days} дн.)",
+            ).format(end_date=end_date.strftime('%d.%m.%Y'), days=days_left)
+        if days_left == 1:
+            return texts.t(
+                "SUB_STATUS_TRIAL_TOMORROW",
+                "🎁 Тестовая подписка\n⚠️ истекает завтра!",
+            )
+        return texts.t(
+            "SUB_STATUS_TRIAL_TODAY",
+            "🎁 Тестовая подписка\n⚠️ истекает сегодня!",
+        )
 
+    if days_left > 7:
+        return texts.t(
+            "SUB_STATUS_ACTIVE_LONG",
+            "💎 Активна\n📅 до {end_date} ({days} дн.)",
+        ).format(end_date=end_date.strftime('%d.%m.%Y'), days=days_left)
+    if days_left > 1:
+        return texts.t(
+            "SUB_STATUS_ACTIVE_FEW_DAYS",
+            "💎 Активна\n⚠️ истекает через {days} дн.",
+        ).format(days=days_left)
+    if days_left == 1:
+        return texts.t(
+            "SUB_STATUS_ACTIVE_TOMORROW",
+            "💎 Активна\n⚠️ истекает завтра!",
+        )
+    return texts.t(
+        "SUB_STATUS_ACTIVE_TODAY",
+        "💎 Активна\n⚠️ истекает сегодня!",
+    )
 
 
 def _get_subscription_status_simple(texts):
-    return getattr(texts, 'SUBSCRIPTION_NONE', 'Нет активной подписки')
+    return texts.t("SUBSCRIPTION_NONE", "Нет активной подписки")
+
+
+def _insert_random_message(base_text: str, random_message: str, action_prompt: str) -> str:
+    if not random_message:
+        return base_text
+
+    prompt = action_prompt or ""
+    if prompt and prompt in base_text:
+        parts = base_text.split(prompt, 1)
+        if len(parts) == 2:
+            return f"{parts[0]}\n{random_message}\n\n{prompt}{parts[1]}"
+        return base_text.replace(prompt, f"\n{random_message}\n\n{prompt}", 1)
+
+    return f"{base_text}\n\n{random_message}"
 
 
 def get_referral_code_keyboard(language: str):
@@ -918,59 +1026,47 @@ def get_referral_code_keyboard(language: str):
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [InlineKeyboardButton(
-            text="⭐️ Пропустить",
+            text=texts.t("REFERRAL_CODE_SKIP", "⭐️ Пропустить"),
             callback_data="referral_skip"
         )]
     ])
 
 async def get_main_menu_text(user, texts, db: AsyncSession):
-    
+
     base_text = texts.MAIN_MENU.format(
         user_name=user.full_name,
         subscription_status=_get_subscription_status(user, texts)
     )
-    
+
+    action_prompt = texts.t("MAIN_MENU_ACTION_PROMPT", "Выберите действие:")
+
     try:
         random_message = await get_random_active_message(db)
         if random_message:
-            if "Выберите действие:" in base_text:
-                parts = base_text.split("Выберите действие:")
-                if len(parts) == 2:
-                    return f"{parts[0]}\n{random_message}\n\nВыберите действие:{parts[1]}"
-            
-            if "Выберите действие:" in base_text:
-                return base_text.replace("Выберите действие:", f"\n{random_message}\n\nВыберите действие:")
-            else:
-                return f"{base_text}\n\n{random_message}"
-                
+            return _insert_random_message(base_text, random_message, action_prompt)
+
     except Exception as e:
         logger.error(f"Ошибка получения случайного сообщения: {e}")
-    
+
     return base_text
 
 async def get_main_menu_text_simple(user_name, texts, db: AsyncSession):
-    
+
     base_text = texts.MAIN_MENU.format(
         user_name=user_name,
         subscription_status=_get_subscription_status_simple(texts)
     )
-    
+
+    action_prompt = texts.t("MAIN_MENU_ACTION_PROMPT", "Выберите действие:")
+
     try:
         random_message = await get_random_active_message(db)
         if random_message:
-            if "Выберите действие:" in base_text:
-                parts = base_text.split("Выберите действие:")
-                if len(parts) == 2:
-                    return f"{parts[0]}\n{random_message}\n\nВыберите действие:{parts[1]}"
-            
-            if "Выберите действие:" in base_text:
-                return base_text.replace("Выберите действие:", f"\n{random_message}\n\nВыберите действие:")
-            else:
-                return f"{base_text}\n\n{random_message}"
-                
+            return _insert_random_message(base_text, random_message, action_prompt)
+
     except Exception as e:
         logger.error(f"Ошибка получения случайного сообщения: {e}")
-    
+
     return base_text
 
 
@@ -981,90 +1077,90 @@ async def required_sub_channel_check(
     db: AsyncSession,
     db_user=None
 ):
+    language = DEFAULT_LANGUAGE
+    texts = get_texts(language)
+
     try:
+        state_data = await state.get_data() or {}
+
+        user = db_user
+        if not user:
+            user = await get_user_by_telegram_id(db, query.from_user.id)
+
+        if user and getattr(user, "language", None):
+            language = user.language
+        elif state_data.get("language"):
+            language = state_data["language"]
+
+        texts = get_texts(language)
+
         chat_member = await bot.get_chat_member(
             chat_id=settings.CHANNEL_SUB_ID,
             user_id=query.from_user.id
         )
-        
+
         if chat_member.status not in [ChatMemberStatus.MEMBER, ChatMemberStatus.ADMINISTRATOR, ChatMemberStatus.CREATOR]:
-            return await query.answer("❌ Вы не подписались на канал!", show_alert=True)
-        
-        await query.answer("✅ Спасибо за подписку", show_alert=True)
-        
+            return await query.answer(
+                texts.t("CHANNEL_SUBSCRIBE_REQUIRED_ALERT", "❌ Вы не подписались на канал!"),
+                show_alert=True,
+            )
+
+        await query.answer(
+            texts.t("CHANNEL_SUBSCRIBE_THANKS", "✅ Спасибо за подписку"),
+            show_alert=True,
+        )
+
         try:
             await query.message.delete()
         except Exception as e:
             logger.warning(f"Не удалось удалить сообщение: {e}")
-        
-        user = await get_user_by_telegram_id(db, query.from_user.id)
-        
+
         if user and user.status != UserStatus.DELETED.value:
-            from app.localization.texts import get_texts
-            from app.handlers.start import get_main_menu_text
-            from app.keyboards.inline import get_main_menu_keyboard
-            
-            texts = get_texts(user.language)
-            
-            has_active_subscription = user.subscription is not None
-            subscription_is_active = False
-            
-            if user.subscription:
-                subscription_is_active = user.subscription.is_active
-            
+            has_active_subscription = bool(user.subscription)
+            subscription_is_active = bool(user.subscription and user.subscription.is_active)
+
             menu_text = await get_main_menu_text(user, texts, db)
-            
+
             from app.utils.message_patch import LOGO_PATH
             from aiogram.types import FSInputFile
-            
+
+            keyboard = get_main_menu_keyboard(
+                language=user.language,
+                is_admin=settings.is_admin(user.telegram_id),
+                has_had_paid_subscription=user.has_had_paid_subscription,
+                has_active_subscription=has_active_subscription,
+                subscription_is_active=subscription_is_active,
+                balance_kopeks=user.balance_kopeks,
+                subscription=user.subscription,
+            )
+
             if settings.ENABLE_LOGO_MODE:
                 await bot.send_photo(
                     chat_id=query.from_user.id,
                     photo=FSInputFile(LOGO_PATH),
                     caption=menu_text,
-                    reply_markup=get_main_menu_keyboard(
-                        language=user.language,
-                        is_admin=settings.is_admin(user.telegram_id),
-                        has_had_paid_subscription=user.has_had_paid_subscription,
-                        has_active_subscription=has_active_subscription,
-                        subscription_is_active=subscription_is_active,
-                        balance_kopeks=user.balance_kopeks,
-                        subscription=user.subscription
-                    ),
-                    parse_mode="HTML"
+                    reply_markup=keyboard,
+                    parse_mode="HTML",
                 )
             else:
                 await bot.send_message(
                     chat_id=query.from_user.id,
                     text=menu_text,
-                    reply_markup=get_main_menu_keyboard(
-                        language=user.language,
-                        is_admin=settings.is_admin(user.telegram_id),
-                        has_had_paid_subscription=user.has_had_paid_subscription,
-                        has_active_subscription=has_active_subscription,
-                        subscription_is_active=subscription_is_active,
-                        balance_kopeks=user.balance_kopeks,
-                        subscription=user.subscription
-                    ),
-                    parse_mode="HTML"
+                    reply_markup=keyboard,
+                    parse_mode="HTML",
                 )
         else:
-            from app.localization.texts import get_texts
             from app.keyboards.inline import get_rules_keyboard
-            
-            language = 'ru'
-            texts = get_texts(language)
-            
-            data = await state.get_data() or {}
-            data['language'] = language
-            await state.set_data(data)
-            
+
+            state_data['language'] = language
+            await state.set_data(state_data)
+
             if settings.SKIP_RULES_ACCEPT:
                 if settings.SKIP_REFERRAL_CODE:
                     from app.utils.user_utils import generate_unique_referral_code
-                    
+
                     referral_code = await generate_unique_referral_code(db, query.from_user.id)
-                    
+
                     user = await create_user(
                         db=db,
                         telegram_id=query.from_user.id,
@@ -1072,44 +1168,47 @@ async def required_sub_channel_check(
                         first_name=query.from_user.first_name,
                         last_name=query.from_user.last_name,
                         language=language,
-                        referral_code=referral_code
+                        referral_code=referral_code,
                     )
-                    
+
                     await bot.send_message(
                         chat_id=query.from_user.id,
-                        text=f"Добро пожаловать, {user.full_name}!",
+                        text=texts.t("WELCOME_FALLBACK", "Добро пожаловать, {user_name}!").format(user_name=user.full_name),
                     )
                 else:
                     await bot.send_message(
                         chat_id=query.from_user.id,
-                        text="У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
-                        reply_markup=get_referral_code_keyboard(language)
+                        text=texts.t(
+                            "REFERRAL_CODE_QUESTION",
+                            "У вас есть реферальный код? Введите его или нажмите 'Пропустить'",
+                        ),
+                        reply_markup=get_referral_code_keyboard(language),
                     )
                     await state.set_state(RegistrationStates.waiting_for_referral_code)
             else:
                 from app.utils.message_patch import LOGO_PATH
                 from aiogram.types import FSInputFile
-                
+
+                rules_text = await get_rules(language)
+
                 if settings.ENABLE_LOGO_MODE:
                     await bot.send_photo(
                         chat_id=query.from_user.id,
                         photo=FSInputFile(LOGO_PATH),
-                        caption=texts.RULES_TEXT,
-                        reply_markup=get_rules_keyboard(language)
+                        caption=rules_text,
+                        reply_markup=get_rules_keyboard(language),
                     )
                 else:
                     await bot.send_message(
                         chat_id=query.from_user.id,
-                        text=texts.RULES_TEXT,
-                        reply_markup=get_rules_keyboard(language)
+                        text=rules_text,
+                        reply_markup=get_rules_keyboard(language),
                     )
                 await state.set_state(RegistrationStates.waiting_for_rules_accept)
-        
+
     except Exception as e:
         logger.error(f"Ошибка в required_sub_channel_check: {e}")
-        await query.answer("❌ Произошла ошибка!", show_alert=True)
-
-
+        await query.answer(f"{texts.ERROR}!", show_alert=True)
 
 def register_handlers(dp: Dispatcher):
     

app/keyboards/admin.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import List, Optional, Tuple, Any
 from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton
 
 from app.localization.texts import get_texts
@@ -45,6 +45,9 @@ def get_admin_promo_submenu_keyboard(language: str = "ru") -> InlineKeyboardMark
         [
             InlineKeyboardButton(text=texts.ADMIN_CAMPAIGNS, callback_data="admin_campaigns")
         ],
+        [
+            InlineKeyboardButton(text=texts.ADMIN_PROMO_GROUPS, callback_data="admin_promo_groups")
+        ],
         [
             InlineKeyboardButton(text="⬅️ Назад", callback_data="admin_panel")
         ]
@@ -390,11 +393,19 @@ def get_admin_statistics_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
 
 
 def get_user_management_keyboard(user_id: int, user_status: str, language: str = "ru", back_callback: str = "admin_users_list") -> InlineKeyboardMarkup:
+    texts = get_texts(language)
+
     keyboard = [
         [
             InlineKeyboardButton(text="💰 Баланс", callback_data=f"admin_user_balance_{user_id}"),
             InlineKeyboardButton(text="📱 Подписка и настройки", callback_data=f"admin_user_subscription_{user_id}")
         ],
+        [
+            InlineKeyboardButton(
+                text=texts.ADMIN_USER_PROMO_GROUP_BUTTON,
+                callback_data=f"admin_user_promo_group_{user_id}"
+            )
+        ],
         [
             InlineKeyboardButton(text="📊 Статистика", callback_data=f"admin_user_statistics_{user_id}")
         ],
@@ -421,7 +432,37 @@ def get_user_management_keyboard(user_id: int, user_status: str, language: str =
     keyboard.append([
         InlineKeyboardButton(text="⬅️ Назад", callback_data=back_callback)
     ])
-    
+
+    return InlineKeyboardMarkup(inline_keyboard=keyboard)
+
+
+def get_user_promo_group_keyboard(
+    promo_groups: List[Tuple[Any, int]],
+    user_id: int,
+    current_group_id: Optional[int],
+    language: str = "ru"
+) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
+
+    keyboard: List[List[InlineKeyboardButton]] = []
+
+    for group, members_count in promo_groups:
+        prefix = "✅" if current_group_id is not None and group.id == current_group_id else "👥"
+        count_text = f" ({members_count})" if members_count else ""
+        keyboard.append([
+            InlineKeyboardButton(
+                text=f"{prefix} {group.name}{count_text}",
+                callback_data=f"admin_user_promo_group_set_{user_id}_{group.id}"
+            )
+        ])
+
+    keyboard.append([
+        InlineKeyboardButton(
+            text=texts.ADMIN_USER_PROMO_GROUP_BACK,
+            callback_data=f"admin_user_manage_{user_id}"
+        )
+    ])
+
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 

app/keyboards/inline.py

@@ -6,13 +6,14 @@ from app.database.models import User
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.config import settings, PERIOD_PRICES, TRAFFIC_PRICES
+from app.localization.loader import DEFAULT_LANGUAGE
 from app.localization.texts import get_texts
 from app.utils.pricing_utils import format_period_description
 import logging
 
 logger = logging.getLogger(__name__)
 
-def get_rules_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_rules_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
@@ -21,36 +22,44 @@ def get_rules_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
         ]
     ])
 
-def get_channel_sub_keyboard(channel_link: str) -> InlineKeyboardMarkup:
+def get_channel_sub_keyboard(
+    channel_link: str,
+    language: str = DEFAULT_LANGUAGE,
+) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     return InlineKeyboardMarkup(
         inline_keyboard=[
             [
                 InlineKeyboardButton(
-                    text="🔗 Подписаться", url=channel_link
+                    text=texts.t("CHANNEL_SUBSCRIBE_BUTTON", "🔗 Подписаться"),
+                    url=channel_link,
                 )
             ],
             [
                 InlineKeyboardButton(
-                    text="✅ Я подписался", callback_data="sub_channel_check"
+                    text=texts.t("CHANNEL_CHECK_BUTTON", "✅ Я подписался"),
+                    callback_data="sub_channel_check",
                 )
-            ]
+            ],
         ]
     )
 
 
-def get_post_registration_keyboard() -> InlineKeyboardMarkup:
+def get_post_registration_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="🚀 Подключиться бесплатно 🚀", callback_data="trial_activate"
+                text=texts.t("POST_REGISTRATION_TRIAL_BUTTON", "🚀 Подключиться бесплатно 🚀"),
+                callback_data="trial_activate"
             )
         ],
-        [InlineKeyboardButton(text="Пропустить ➡️", callback_data="back_to_menu")],
+        [InlineKeyboardButton(text=texts.t("SKIP_BUTTON", "Пропустить ➡️"), callback_data="back_to_menu")],
     ])
 
 
 def get_main_menu_keyboard(
-    language: str = "ru",
+    language: str = DEFAULT_LANGUAGE,
     is_admin: bool = False,
     has_had_paid_subscription: bool = False,
     has_active_subscription: bool = False,
@@ -67,7 +76,10 @@ def get_main_menu_keyboard(
     if hasattr(texts, 'BALANCE_BUTTON') and balance_kopeks > 0:
         balance_button_text = texts.BALANCE_BUTTON.format(balance=texts.format_price(balance_kopeks))
     else:
-        balance_button_text = f"💰 Баланс: {texts.format_price(balance_kopeks)}"
+        balance_button_text = texts.t(
+            "BALANCE_BUTTON_DEFAULT",
+            "💰 Баланс: {balance}",
+        ).format(balance=texts.format_price(balance_kopeks))
     
     keyboard = []
 
@@ -76,28 +88,28 @@ def get_main_menu_keyboard(
         if connect_mode == "miniapp_subscription":
             keyboard.append([
                 InlineKeyboardButton(
-                    text="🔗 Подключиться",
+                    text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                     web_app=types.WebAppInfo(url=subscription.subscription_url)
                 )
             ])
         elif connect_mode == "miniapp_custom":
             keyboard.append([
                 InlineKeyboardButton(
-                    text="🔗 Подключиться",
+                    text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                     web_app=types.WebAppInfo(url=settings.MINIAPP_CUSTOM_URL)
                 )
             ])
         elif connect_mode == "link":
             keyboard.append([
                 InlineKeyboardButton(
-                    text="🔗 Подключиться",
+                    text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                     url=subscription.subscription_url
                 )
             ])
         else:
             keyboard.append([
                 InlineKeyboardButton(
-                    text="🔗 Подключиться",
+                    text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                     callback_data="subscription_connect"
                 )
             ])
@@ -168,7 +180,7 @@ def get_main_menu_keyboard(
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_back_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_back_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [InlineKeyboardButton(text=texts.BACK, callback_data="back_to_menu")]
@@ -176,9 +188,10 @@ def get_back_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
 
 
 def get_insufficient_balance_keyboard(
-    language: str = "ru",
+    language: str = DEFAULT_LANGUAGE,
     resume_callback: str | None = None,
-) -> InlineKeyboardMarkup:
+    ) -> InlineKeyboardMarkup:
+
     texts = get_texts(language)
     keyboard: list[list[InlineKeyboardButton]] = [
         [
@@ -203,7 +216,7 @@ def get_insufficient_balance_keyboard(
 
 
 def get_subscription_keyboard(
-    language: str = "ru", 
+    language: str = DEFAULT_LANGUAGE, 
     has_subscription: bool = False, 
     is_trial: bool = False,
     subscription=None
@@ -220,7 +233,7 @@ def get_subscription_keyboard(
             if connect_mode == "miniapp_subscription":
                 keyboard.append([
                     InlineKeyboardButton(
-                        text="🔗 Подключиться",
+                        text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                         web_app=types.WebAppInfo(url=subscription.subscription_url)
                     )
                 ])
@@ -228,21 +241,21 @@ def get_subscription_keyboard(
                 if settings.MINIAPP_CUSTOM_URL:
                     keyboard.append([
                         InlineKeyboardButton(
-                            text="🔗 Подключиться",
+                            text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"),
                             web_app=types.WebAppInfo(url=settings.MINIAPP_CUSTOM_URL)
                         )
                     ])
                 else:
                     keyboard.append([
-                        InlineKeyboardButton(text="🔗 Подключиться", callback_data="subscription_connect")
+                        InlineKeyboardButton(text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"), callback_data="subscription_connect")
                     ])
             elif connect_mode == "link":
                 keyboard.append([
-                    InlineKeyboardButton(text="🔗 Подключиться", url=subscription.subscription_url)
+                    InlineKeyboardButton(text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"), url=subscription.subscription_url)
                 ])
             else:
                 keyboard.append([
-                    InlineKeyboardButton(text="🔗 Подключиться", callback_data="subscription_connect")
+                    InlineKeyboardButton(text=texts.t("CONNECT_BUTTON", "🔗 Подключиться"), callback_data="subscription_connect")
                 ])
 
         if not is_trial:
@@ -250,7 +263,10 @@ def get_subscription_keyboard(
                 InlineKeyboardButton(text=texts.MENU_EXTEND_SUBSCRIPTION, callback_data="subscription_extend")
             ])
             keyboard.append([
-                InlineKeyboardButton(text="💳 Автоплатеж", callback_data="subscription_autopay")
+                InlineKeyboardButton(
+                    text=texts.t("AUTOPAY_BUTTON", "💳 Автоплатеж"),
+                    callback_data="subscription_autopay",
+                )
             ])
 
         if is_trial:
@@ -259,7 +275,10 @@ def get_subscription_keyboard(
             ])
         else:
             keyboard.append([
-                InlineKeyboardButton(text="⚙️ Настройки подписки", callback_data="subscription_settings")
+                InlineKeyboardButton(
+                    text=texts.t("SUBSCRIPTION_SETTINGS_BUTTON", "⚙️ Настройки подписки"),
+                    callback_data="subscription_settings",
+                )
             ])
     
     keyboard.append([
@@ -268,7 +287,6 @@ def get_subscription_keyboard(
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
-
 def get_payment_methods_keyboard_with_cart(language: str = "ru") -> InlineKeyboardMarkup:
     keyboard = get_payment_methods_keyboard(0, language)
     
@@ -318,13 +336,13 @@ def get_trial_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
-            InlineKeyboardButton(text="🎁 Активировать", callback_data="trial_activate"),
+            InlineKeyboardButton(text=texts.t("TRIAL_ACTIVATE_BUTTON", "🎁 Активировать"), callback_data="trial_activate"),
             InlineKeyboardButton(text=texts.BACK, callback_data="back_to_menu")
         ]
     ])
 
 
-def get_subscription_period_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_subscription_period_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     keyboard = []
     
@@ -355,7 +373,7 @@ def get_subscription_period_keyboard(language: str = "ru") -> InlineKeyboardMark
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_traffic_packages_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_traffic_packages_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     import logging
     logger = logging.getLogger(__name__)
     
@@ -403,7 +421,7 @@ def get_traffic_packages_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
     if not keyboard:
         keyboard.append([
             InlineKeyboardButton(
-                text="⚠️ Пакеты трафика не настроены", 
+                text=texts.t("TRAFFIC_PACKAGES_NOT_CONFIGURED", "⚠️ Пакеты трафика не настроены"), 
                 callback_data="no_traffic_packages"
             )
         ])
@@ -414,7 +432,7 @@ def get_traffic_packages_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
-def get_countries_keyboard(countries: List[dict], selected: List[str], language: str = "ru") -> InlineKeyboardMarkup:
+def get_countries_keyboard(countries: List[dict], selected: List[str], language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     keyboard = []
     
@@ -439,20 +457,20 @@ def get_countries_keyboard(countries: List[dict], selected: List[str], language:
     if not keyboard:
         keyboard.append([
             InlineKeyboardButton(
-                text="❌ Нет доступных серверов",
+                text=texts.t("NO_SERVERS_AVAILABLE", "❌ Нет доступных серверов"),
                 callback_data="no_servers"
             )
         ])
     
     keyboard.extend([
-        [InlineKeyboardButton(text="✅ Продолжить", callback_data="countries_continue")],
+        [InlineKeyboardButton(text=texts.t("CONTINUE_BUTTON", "✅ Продолжить"), callback_data="countries_continue")],
         [InlineKeyboardButton(text=texts.BACK, callback_data="subscription_config_back")]
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_devices_keyboard(current: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_devices_keyboard(current: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     keyboard = []
     
@@ -483,7 +501,7 @@ def get_devices_keyboard(current: int, language: str = "ru") -> InlineKeyboardMa
             keyboard.append([buttons[i]])
     
     keyboard.extend([
-        [InlineKeyboardButton(text="✅ Продолжить", callback_data="devices_continue")],
+        [InlineKeyboardButton(text=texts.t("CONTINUE_BUTTON", "✅ Продолжить"), callback_data="devices_continue")],
         [InlineKeyboardButton(text=texts.BACK, callback_data="subscription_config_back")]
     ])
     
@@ -497,7 +515,7 @@ def _get_device_declension(count: int) -> str:
     else:
         return "устройств"
 
-def get_subscription_confirm_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_subscription_confirm_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
@@ -507,7 +525,7 @@ def get_subscription_confirm_keyboard(language: str = "ru") -> InlineKeyboardMar
     ])
 
 
-def get_balance_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_balance_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     
     keyboard = [
@@ -523,7 +541,7 @@ def get_balance_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_payment_methods_keyboard(amount_kopeks: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_payment_methods_keyboard(amount_kopeks: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     keyboard = []
     
@@ -531,15 +549,15 @@ def get_payment_methods_keyboard(amount_kopeks: int, language: str = "ru") -> In
     if settings.TELEGRAM_STARS_ENABLED:
         keyboard.append([
             InlineKeyboardButton(
-                text="⭐ Telegram Stars", 
+                text=texts.t("PAYMENT_TELEGRAM_STARS", "⭐ Telegram Stars"), 
                 callback_data="topup_stars"
             )
         ])
-    
+
     if settings.is_yookassa_enabled():
         keyboard.append([
             InlineKeyboardButton(
-                text="💳 Банковская карта (YooKassa)", 
+                text=texts.t("PAYMENT_CARD_YOOKASSA", "💳 Банковская карта (YooKassa)"), 
                 callback_data="topup_yookassa"
             )
         ])
@@ -547,15 +565,15 @@ def get_payment_methods_keyboard(amount_kopeks: int, language: str = "ru") -> In
         if settings.YOOKASSA_SBP_ENABLED:
             keyboard.append([
                 InlineKeyboardButton(
-                    text="🏦 Оплатить по СБП (YooKassa)", 
+                    text=texts.t("PAYMENT_SBP_YOOKASSA", "🏦 Оплатить по СБП (YooKassa)"), 
                     callback_data="topup_yookassa_sbp"
                 )
             ])
-    
+
     if settings.TRIBUTE_ENABLED:
         keyboard.append([
             InlineKeyboardButton(
-                text="💳 Банковская карта (Tribute)", 
+                text=texts.t("PAYMENT_CARD_TRIBUTE", "💳 Банковская карта (Tribute)"), 
                 callback_data="topup_tribute"
             )
         ])
@@ -563,14 +581,14 @@ def get_payment_methods_keyboard(amount_kopeks: int, language: str = "ru") -> In
     if settings.is_cryptobot_enabled():
         keyboard.append([
             InlineKeyboardButton(
-                text="🪙 Криптовалюта (CryptoBot)", 
+                text=texts.t("PAYMENT_CRYPTOBOT", "🪙 Криптовалюта (CryptoBot)"), 
                 callback_data="topup_cryptobot"
             )
         ])
 
     keyboard.append([
         InlineKeyboardButton(
-            text="🛠️ Через поддержку", 
+            text=texts.t("PAYMENT_VIA_SUPPORT", "🛠️ Через поддержку"), 
             callback_data="topup_support"
         )
     ])
@@ -578,7 +596,7 @@ def get_payment_methods_keyboard(amount_kopeks: int, language: str = "ru") -> In
     if len(keyboard) == 1:  
         keyboard.insert(0, [
             InlineKeyboardButton(
-                text="⚠️ Способы оплаты временно недоступны",
+                text=texts.t("PAYMENTS_TEMPORARILY_UNAVAILABLE", "⚠️ Способы оплаты временно недоступны"),
                 callback_data="payment_methods_unavailable"
             )
         ])
@@ -593,49 +611,49 @@ def get_yookassa_payment_keyboard(
     payment_id: str, 
     amount_kopeks: int, 
     confirmation_url: str,
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
-    
+    texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="💳 Оплатить",
+                text=texts.t("PAY_NOW_BUTTON", "💳 Оплатить"),
                 url=confirmation_url
             )
         ],
         [
             InlineKeyboardButton(
-                text="📊 Проверить статус",
+                text=texts.t("CHECK_STATUS_BUTTON", "📊 Проверить статус"),
                 callback_data=f"check_yookassa_status_{payment_id}"
             )
         ],
         [
             InlineKeyboardButton(
-                text="💰 Мой баланс",
+                text=texts.t("MY_BALANCE_BUTTON", "💰 Мой баланс"),
                 callback_data="menu_balance"
             )
         ]
     ])
 
-def get_autopay_notification_keyboard(subscription_id: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_autopay_notification_keyboard(subscription_id: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="💳 Пополнить баланс", 
+                text=texts.t("TOPUP_BALANCE_BUTTON", "💳 Пополнить баланс"), 
                 callback_data="balance_topup"
             )
         ],
         [
             InlineKeyboardButton(
-                text="📱 Моя подписка", 
+                text=texts.t("MY_SUBSCRIPTION_BUTTON", "📱 Моя подписка"), 
                 callback_data="menu_subscription"
             )
         ]
     ])
 
-def get_subscription_expiring_keyboard(subscription_id: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_subscription_expiring_keyboard(subscription_id: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     
     return InlineKeyboardMarkup(inline_keyboard=[
@@ -647,43 +665,43 @@ def get_subscription_expiring_keyboard(subscription_id: int, language: str = "ru
         ],
         [
             InlineKeyboardButton(
-                text="💳 Пополнить баланс", 
+                text=texts.t("TOPUP_BALANCE_BUTTON", "💳 Пополнить баланс"), 
                 callback_data="balance_topup"
             )
         ],
         [
             InlineKeyboardButton(
-                text="📱 Моя подписка", 
+                text=texts.t("MY_SUBSCRIPTION_BUTTON", "📱 Моя подписка"), 
                 callback_data="menu_subscription"
             )
         ]
     ])
 
-def get_referral_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_referral_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     
     keyboard = [
         [
             InlineKeyboardButton(
-                text="📝 Создать приглашение",
+                text=texts.t("CREATE_INVITE_BUTTON", "📝 Создать приглашение"),
                 callback_data="referral_create_invite"
             )
         ],
         [
             InlineKeyboardButton(
-                text="📱 Показать QR код",
+                text=texts.t("SHOW_QR_BUTTON", "📱 Показать QR код"),
                 callback_data="referral_show_qr"
             )
         ],
         [
             InlineKeyboardButton(
-                text="👥 Список рефералов",
+                text=texts.t("REFERRAL_LIST_BUTTON", "👥 Список рефералов"),
                 callback_data="referral_list"
             )
         ],
         [
             InlineKeyboardButton(
-                text="📊 Аналитика",
+                text=texts.t("REFERRAL_ANALYTICS_BUTTON", "📊 Аналитика"),
                 callback_data="referral_analytics"
             )
         ],
@@ -698,7 +716,7 @@ def get_referral_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_support_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_support_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
@@ -717,8 +735,9 @@ def get_pagination_keyboard(
     current_page: int,
     total_pages: int,
     callback_prefix: str,
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> List[List[InlineKeyboardButton]]:
+    texts = get_texts(language)
     keyboard = []
     
     if total_pages > 1:
@@ -726,7 +745,7 @@ def get_pagination_keyboard(
         
         if current_page > 1:
             row.append(InlineKeyboardButton(
-                text="⬅️",
+                text=texts.t("PAGINATION_PREV", "⬅️"),
                 callback_data=f"{callback_prefix}_page_{current_page - 1}"
             ))
         
@@ -737,7 +756,7 @@ def get_pagination_keyboard(
         
         if current_page < total_pages:
             row.append(InlineKeyboardButton(
-                text="➡️",
+                text=texts.t("PAGINATION_NEXT", "➡️"),
                 callback_data=f"{callback_prefix}_page_{current_page + 1}"
             ))
         
@@ -748,7 +767,7 @@ def get_pagination_keyboard(
 def get_confirmation_keyboard(
     confirm_data: str,
     cancel_data: str = "cancel",
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
@@ -759,22 +778,24 @@ def get_confirmation_keyboard(
     ])
 
 
-def get_autopay_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_autopay_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
-            InlineKeyboardButton(text="✅ Включить", callback_data="autopay_enable"),
-            InlineKeyboardButton(text="❌ Выключить", callback_data="autopay_disable")
+            InlineKeyboardButton(text=texts.t("ENABLE_BUTTON", "✅ Включить"), callback_data="autopay_enable"),
+            InlineKeyboardButton(text=texts.t("DISABLE_BUTTON", "❌ Выключить"), callback_data="autopay_disable")
         ],
         [
-            InlineKeyboardButton(text="⚙️ Настроить дни", callback_data="autopay_set_days")
+            InlineKeyboardButton(text=texts.t("AUTOPAY_SET_DAYS_BUTTON", "⚙️ Настроить дни"), callback_data="autopay_set_days")
         ],
         [
-            InlineKeyboardButton(text="⬅️ Назад", callback_data="menu_subscription")
+            InlineKeyboardButton(text=texts.BACK, callback_data="menu_subscription")
         ]
     ])
 
 
-def get_autopay_days_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_autopay_days_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     keyboard = []
     
     for days in [1, 3, 7, 14]:
@@ -786,7 +807,7 @@ def get_autopay_days_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
         ])
     
     keyboard.append([
-        InlineKeyboardButton(text="⬅️ Назад", callback_data="subscription_autopay")
+        InlineKeyboardButton(text=texts.BACK, callback_data="subscription_autopay")
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
@@ -802,7 +823,7 @@ def _get_days_suffix(days: int) -> str:
 
 
 
-def get_extend_subscription_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_extend_subscription_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     keyboard = []
     
@@ -825,9 +846,10 @@ def get_extend_subscription_keyboard(language: str = "ru") -> InlineKeyboardMark
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_add_traffic_keyboard(language: str = "ru", subscription_end_date: datetime = None) -> InlineKeyboardMarkup:
+def get_add_traffic_keyboard(language: str = DEFAULT_LANGUAGE, subscription_end_date: datetime = None) -> InlineKeyboardMarkup:
     from app.utils.pricing_utils import get_remaining_months
     from app.config import settings
+    texts = get_texts(language)
     
     months_multiplier = 1
     period_text = ""
@@ -842,11 +864,11 @@ def get_add_traffic_keyboard(language: str = "ru", subscription_end_date: dateti
     if not enabled_packages:
         return InlineKeyboardMarkup(inline_keyboard=[
             [InlineKeyboardButton(
-                text="❌ Нет доступных пакетов" if language == "ru" else "❌ No packages available",
+                text=texts.t("NO_TRAFFIC_PACKAGES", "❌ Нет доступных пакетов"),
                 callback_data="no_traffic_packages"
             )],
             [InlineKeyboardButton(
-                text="⬅️ Назад" if language == "ru" else "⬅️ Back",
+                text=texts.BACK,
                 callback_data="menu_subscription"
             )]
         ])
@@ -875,16 +897,17 @@ def get_add_traffic_keyboard(language: str = "ru", subscription_end_date: dateti
     
     buttons.append([
         InlineKeyboardButton(
-            text="⬅️ Назад" if language == "ru" else "⬅️ Back",
+            text=texts.BACK,
             callback_data="menu_subscription"
         )
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=buttons)
     
-def get_change_devices_keyboard(current_devices: int, language: str = "ru", subscription_end_date: datetime = None) -> InlineKeyboardMarkup:
+def get_change_devices_keyboard(current_devices: int, language: str = DEFAULT_LANGUAGE, subscription_end_date: datetime = None) -> InlineKeyboardMarkup:
     from app.utils.pricing_utils import get_remaining_months
     from app.config import settings
+    texts = get_texts(language)
     
     months_multiplier = 1
     period_text = ""
@@ -943,33 +966,33 @@ def get_change_devices_keyboard(current_devices: int, language: str = "ru", subs
     
     buttons.append([
         InlineKeyboardButton(
-            text="⬅️ Назад" if language == "ru" else "⬅️ Back",
+            text=texts.BACK,
             callback_data="subscription_settings"
         )
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=buttons)
 
-def get_confirm_change_devices_keyboard(new_devices_count: int, price: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_confirm_change_devices_keyboard(new_devices_count: int, price: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     texts = get_texts(language)
     
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="✅ Подтвердить изменение",
+                text=texts.t("CONFIRM_CHANGE_BUTTON", "✅ Подтвердить изменение"),
                 callback_data=f"confirm_change_devices_{new_devices_count}_{price}"
             )
         ],
         [
             InlineKeyboardButton(
-                text="❌ Отмена",
+                text=texts.CANCEL,
                 callback_data="subscription_settings"
             )
         ]
     ])
 
 
-def get_reset_traffic_confirm_keyboard(price_kopeks: int, language: str = "ru") -> InlineKeyboardMarkup:
+def get_reset_traffic_confirm_keyboard(price_kopeks: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     from app.config import settings
     
     if settings.is_traffic_fixed():
@@ -984,19 +1007,24 @@ def get_reset_traffic_confirm_keyboard(price_kopeks: int, language: str = "ru")
             )
         ],
         [
-            InlineKeyboardButton(text="⌛ Отмена", callback_data="menu_subscription")
+            InlineKeyboardButton(
+                text=texts.t("PENDING_CANCEL_BUTTON", "⌛ Отмена"),
+                callback_data="menu_subscription",
+            )
         ]
     ])
 
 def get_manage_countries_keyboard(
-    countries: List[dict], 
-    selected: List[str], 
+    countries: List[dict],
+    selected: List[str],
     current_subscription_countries: List[str],
-    language: str = "ru",
+    language: str = DEFAULT_LANGUAGE,
     subscription_end_date: datetime = None
 ) -> InlineKeyboardMarkup:
     from app.utils.pricing_utils import get_remaining_months
-    
+
+    texts = get_texts(language)
+
     months_multiplier = 1
     if subscription_end_date:
         months_multiplier = get_remaining_months(subscription_end_date)
@@ -1052,37 +1080,38 @@ def get_manage_countries_keyboard(
     
     buttons.append([
         InlineKeyboardButton(
-            text="⬅️ Назад" if language == "ru" else "⬅️ Back",
+            text=texts.BACK,
             callback_data="menu_subscription"
         )
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=buttons)
 
-def get_device_selection_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
+def get_device_selection_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
     from app.config import settings
+    texts = get_texts(language)
     
     keyboard = [
         [
-            InlineKeyboardButton(text="📱 iOS (iPhone/iPad)", callback_data="device_guide_ios"),
-            InlineKeyboardButton(text="🤖 Android", callback_data="device_guide_android")
+            InlineKeyboardButton(text=texts.t("DEVICE_GUIDE_IOS", "📱 iOS (iPhone/iPad)"), callback_data="device_guide_ios"),
+            InlineKeyboardButton(text=texts.t("DEVICE_GUIDE_ANDROID", "🤖 Android"), callback_data="device_guide_android")
         ],
         [
-            InlineKeyboardButton(text="💻 Windows", callback_data="device_guide_windows"),
-            InlineKeyboardButton(text="🎯 macOS", callback_data="device_guide_mac")
+            InlineKeyboardButton(text=texts.t("DEVICE_GUIDE_WINDOWS", "💻 Windows"), callback_data="device_guide_windows"),
+            InlineKeyboardButton(text=texts.t("DEVICE_GUIDE_MAC", "🎯 macOS"), callback_data="device_guide_mac")
         ],
         [
-            InlineKeyboardButton(text="📺 Android TV", callback_data="device_guide_tv")
+            InlineKeyboardButton(text=texts.t("DEVICE_GUIDE_ANDROID_TV", "📺 Android TV"), callback_data="device_guide_tv")
         ]
     ]
     
     if settings.CONNECT_BUTTON_MODE == "guide":
         keyboard.append([
-            InlineKeyboardButton(text="📋 Показать ссылку подписки", callback_data="open_subscription_link")
+            InlineKeyboardButton(text=texts.t("SHOW_SUBSCRIPTION_LINK", "📋 Показать ссылку подписки"), callback_data="open_subscription_link")
         ])
     
     keyboard.append([
-        InlineKeyboardButton(text="⬅️ Назад", callback_data="menu_subscription")
+        InlineKeyboardButton(text=texts.BACK, callback_data="menu_subscription")
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
@@ -1091,9 +1120,10 @@ def get_device_selection_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
 def get_connection_guide_keyboard(
     subscription_url: str, 
     app: dict, 
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
     from app.handlers.subscription import create_deep_link
+    texts = get_texts(language)
     
     keyboard = []
     
@@ -1112,15 +1142,15 @@ def get_connection_guide_keyboard(
             keyboard.append(app_buttons)
     
     keyboard.append([
-        InlineKeyboardButton(text="📋 Скопировать ссылку подписки", url=subscription_url)
+        InlineKeyboardButton(text=texts.t("COPY_SUBSCRIPTION_LINK", "📋 Скопировать ссылку подписки"), url=subscription_url)
     ])
     
     keyboard.extend([
         [
-            InlineKeyboardButton(text="📱 Выбрать другое устройство", callback_data="subscription_connect")
+            InlineKeyboardButton(text=texts.t("CHOOSE_ANOTHER_DEVICE", "📱 Выбрать другое устройство"), callback_data="subscription_connect")
         ],
         [
-            InlineKeyboardButton(text="⬅️ К подписке", callback_data="menu_subscription")
+            InlineKeyboardButton(text=texts.t("BACK_TO_SUBSCRIPTION", "⬅️ К подписке"), callback_data="menu_subscription")
         ]
     ])
     
@@ -1130,8 +1160,9 @@ def get_connection_guide_keyboard(
 def get_app_selection_keyboard(
     device_type: str, 
     apps: list, 
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     keyboard = []
     
     for app in apps:
@@ -1148,10 +1179,10 @@ def get_app_selection_keyboard(
     
     keyboard.extend([
         [
-            InlineKeyboardButton(text="📱 Выбрать другое устройство", callback_data="subscription_connect")
+            InlineKeyboardButton(text=texts.t("CHOOSE_ANOTHER_DEVICE", "📱 Выбрать другое устройство"), callback_data="subscription_connect")
         ],
         [
-            InlineKeyboardButton(text="⬅️ К подписке", callback_data="menu_subscription")
+            InlineKeyboardButton(text=texts.t("BACK_TO_SUBSCRIPTION", "⬅️ К подписке"), callback_data="menu_subscription")
         ]
     ])
     
@@ -1162,9 +1193,10 @@ def get_specific_app_keyboard(
     subscription_url: str,
     app: dict,
     device_type: str,
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
     from app.handlers.subscription import create_deep_link
+    texts = get_texts(language)
     
     keyboard = []
     
@@ -1183,7 +1215,7 @@ def get_specific_app_keyboard(
             keyboard.append(app_buttons)
     
     keyboard.append([
-        InlineKeyboardButton(text="📋 Скопировать ссылку подписки", url=subscription_url)
+        InlineKeyboardButton(text=texts.t("COPY_SUBSCRIPTION_LINK", "📋 Скопировать ссылку подписки"), url=subscription_url)
     ])
     
     if 'additionalAfterAddSubscriptionStep' in app and 'buttons' in app['additionalAfterAddSubscriptionStep']:
@@ -1195,13 +1227,13 @@ def get_specific_app_keyboard(
     
     keyboard.extend([
         [
-            InlineKeyboardButton(text="📋 Другие приложения", callback_data=f"app_list_{device_type}")
+            InlineKeyboardButton(text=texts.t("OTHER_APPS_BUTTON", "📋 Другие приложения"), callback_data=f"app_list_{device_type}")
         ],
         [
-            InlineKeyboardButton(text="📱 Выбрать другое устройство", callback_data="subscription_connect")
+            InlineKeyboardButton(text=texts.t("CHOOSE_ANOTHER_DEVICE", "📱 Выбрать другое устройство"), callback_data="subscription_connect")
         ],
         [
-            InlineKeyboardButton(text="⬅️ К подписке", callback_data="menu_subscription")
+            InlineKeyboardButton(text=texts.t("BACK_TO_SUBSCRIPTION", "⬅️ К подписке"), callback_data="menu_subscription")
         ]
     ])
     
@@ -1224,7 +1256,7 @@ def get_extend_subscription_keyboard_with_prices(language: str, prices: dict) ->
             ])
 
     keyboard.append([
-        InlineKeyboardButton(text="⬅️ Назад", callback_data="menu_subscription")
+        InlineKeyboardButton(text=texts.BACK, callback_data="menu_subscription")
     ])
 
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
@@ -1235,25 +1267,25 @@ def get_cryptobot_payment_keyboard(
     amount_usd: float,
     asset: str,
     bot_invoice_url: str,
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
-    
+    texts = get_texts(language)
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="🪙 Оплатить",
+                text=texts.t("PAY_WITH_COINS_BUTTON", "🪙 Оплатить"),
                 url=bot_invoice_url
             )
         ],
         [
             InlineKeyboardButton(
-                text="📊 Проверить статус",
+                text=texts.t("CHECK_STATUS_BUTTON", "📊 Проверить статус"),
                 callback_data=f"check_cryptobot_{local_payment_id}"
             )
         ],
         [
             InlineKeyboardButton(
-                text="💰 Мой баланс",
+                text=texts.t("MY_BALANCE_BUTTON", "💰 Мой баланс"),
                 callback_data="menu_balance"
             )
         ]
@@ -1262,8 +1294,9 @@ def get_cryptobot_payment_keyboard(
 def get_devices_management_keyboard(
     devices: List[dict], 
     pagination,
-    language: str = "ru"
+    language: str = DEFAULT_LANGUAGE
 ) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
     
     keyboard = []
     
@@ -1288,11 +1321,11 @@ def get_devices_management_keyboard(
         if pagination.has_prev:
             nav_row.append(
                 InlineKeyboardButton(
-                    text="⬅️",
+                    text=texts.t("PAGINATION_PREV", "⬅️"),
                     callback_data=f"devices_page_{pagination.prev_page}"
                 )
             )
-        
+
         nav_row.append(
             InlineKeyboardButton(
                 text=f"{pagination.page}/{pagination.total_pages}",
@@ -1303,7 +1336,7 @@ def get_devices_management_keyboard(
         if pagination.has_next:
             nav_row.append(
                 InlineKeyboardButton(
-                    text="➡️",
+                    text=texts.t("PAGINATION_NEXT", "➡️"),
                     callback_data=f"devices_page_{pagination.next_page}"
                 )
             )
@@ -1312,14 +1345,14 @@ def get_devices_management_keyboard(
     
     keyboard.append([
         InlineKeyboardButton(
-            text="🔄 Сбросить все устройства",
+            text=texts.t("RESET_ALL_DEVICES_BUTTON", "🔄 Сбросить все устройства"),
             callback_data="reset_all_devices"
         )
     ])
     
     keyboard.append([
         InlineKeyboardButton(
-            text="⬅️ Назад" if language == "ru" else "⬅️ Back",
+            text=texts.BACK,
             callback_data="subscription_settings"
         )
     ])
@@ -1327,7 +1360,7 @@ def get_devices_management_keyboard(
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_updated_subscription_settings_keyboard(language: str = "ru", show_countries_management: bool = True) -> InlineKeyboardMarkup:
+def get_updated_subscription_settings_keyboard(language: str = DEFAULT_LANGUAGE, show_countries_management: bool = True) -> InlineKeyboardMarkup:
     from app.config import settings
     
     texts = get_texts(language)
@@ -1335,69 +1368,71 @@ def get_updated_subscription_settings_keyboard(language: str = "ru", show_countr
     
     if show_countries_management:
         keyboard.append([
-            InlineKeyboardButton(text="🌐 Добавить страны", callback_data="subscription_add_countries")
+            InlineKeyboardButton(text=texts.t("ADD_COUNTRIES_BUTTON", "🌐 Добавить страны"), callback_data="subscription_add_countries")
         ])
-    
+
     keyboard.extend([
         [
-            InlineKeyboardButton(text="📱 Изменить устройства", callback_data="subscription_change_devices") 
+            InlineKeyboardButton(text=texts.t("CHANGE_DEVICES_BUTTON", "📱 Изменить устройства"), callback_data="subscription_change_devices") 
         ],
         [
-            InlineKeyboardButton(text="🔧 Управление устройствами", callback_data="subscription_manage_devices")
+            InlineKeyboardButton(text=texts.t("MANAGE_DEVICES_BUTTON", "🔧 Управление устройствами"), callback_data="subscription_manage_devices")
         ]
     ])
-    
+
     if settings.is_traffic_selectable():
         keyboard.insert(-2, [
-            InlineKeyboardButton(text="🔄 Переключить трафик", callback_data="subscription_switch_traffic")
+            InlineKeyboardButton(text=texts.t("SWITCH_TRAFFIC_BUTTON", "🔄 Переключить трафик"), callback_data="subscription_switch_traffic")
         ])
         keyboard.insert(-2, [
-            InlineKeyboardButton(text="🔄 Сбросить трафик", callback_data="subscription_reset_traffic")
+            InlineKeyboardButton(text=texts.t("RESET_TRAFFIC_BUTTON", "🔄 Сбросить трафик"), callback_data="subscription_reset_traffic")
         ])
     
     keyboard.append([
-        InlineKeyboardButton(text="⬅️ Назад", callback_data="menu_subscription")
+        InlineKeyboardButton(text=texts.BACK, callback_data="menu_subscription")
     ])
     
     return InlineKeyboardMarkup(inline_keyboard=keyboard)
 
 
-def get_device_reset_confirm_keyboard(device_info: str, device_index: int, page: int, language: str = "ru") -> InlineKeyboardMarkup:
-    
+def get_device_reset_confirm_keyboard(device_info: str, device_index: int, page: int, language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
+
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="✅ Да, сбросить это устройство", 
+                text=texts.t("RESET_DEVICE_CONFIRM_BUTTON", "✅ Да, сбросить это устройство"), 
                 callback_data=f"confirm_reset_device_{device_index}_{page}"
             )
         ],
         [
             InlineKeyboardButton(
-                text="❌ Отмена", 
+                text=texts.CANCEL, 
                 callback_data=f"devices_page_{page}"
             )
         ]
     ])
 
 
-def get_device_management_help_keyboard(language: str = "ru") -> InlineKeyboardMarkup:
-    
+def get_device_management_help_keyboard(language: str = DEFAULT_LANGUAGE) -> InlineKeyboardMarkup:
+    texts = get_texts(language)
+
     return InlineKeyboardMarkup(inline_keyboard=[
         [
             InlineKeyboardButton(
-                text="❓ Как подключить устройство заново?",
+                text=texts.t("DEVICE_CONNECTION_HELP", "❓ Как подключить устройство заново?"),
                 callback_data="device_connection_help"
             )
         ],
         [
             InlineKeyboardButton(
-                text="🔧 Управление устройствами",
+                text=texts.t("MANAGE_DEVICES_BUTTON", "🔧 Управление устройствами"),
                 callback_data="subscription_manage_devices"
             )
         ],
         [
             InlineKeyboardButton(
-                text="⬅️ К подписке",
+                text=texts.t("BACK_TO_SUBSCRIPTION", "⬅️ К подписке"),
                 callback_data="menu_subscription"
             )
         ]

app/keyboards/reply.py

@@ -33,19 +33,19 @@ def get_admin_reply_keyboard(language: str = "ru") -> ReplyKeyboardMarkup:
     return ReplyKeyboardMarkup(
         keyboard=[
             [
-                KeyboardButton(text="👥 Пользователи"),
-                KeyboardButton(text="📱 Подписки")
+                KeyboardButton(text=texts.ADMIN_USERS),
+                KeyboardButton(text=texts.ADMIN_SUBSCRIPTIONS)
             ],
             [
-                KeyboardButton(text="🎫 Промокоды"),
-                KeyboardButton(text="📨 Рассылки")
+                KeyboardButton(text=texts.ADMIN_PROMOCODES),
+                KeyboardButton(text=texts.ADMIN_MESSAGES)
             ],
             [
-                KeyboardButton(text="📊 Статистика"),
-                KeyboardButton(text="🔧 Мониторинг")
+                KeyboardButton(text=texts.ADMIN_STATISTICS),
+                KeyboardButton(text=texts.ADMIN_MONITORING)
             ],
             [
-                KeyboardButton(text="🏠 Главное меню")
+                KeyboardButton(text=texts.t("ADMIN_MAIN_MENU", "🏠 Главное меню"))
             ]
         ],
         resize_keyboard=True,
@@ -81,9 +81,10 @@ def get_confirmation_reply_keyboard(language: str = "ru") -> ReplyKeyboardMarkup
 
 
 def get_skip_keyboard(language: str = "ru") -> ReplyKeyboardMarkup:
+    texts = get_texts(language)
     return ReplyKeyboardMarkup(
         keyboard=[
-            [KeyboardButton(text="⏭️ Пропустить")]
+            [KeyboardButton(text=texts.REFERRAL_CODE_SKIP)]
         ],
         resize_keyboard=True,
         one_time_keyboard=True
@@ -95,10 +96,11 @@ def remove_keyboard() -> ReplyKeyboardRemove:
 
 
 def get_contact_keyboard(language: str = "ru") -> ReplyKeyboardMarkup:
+    texts = get_texts(language)
     return ReplyKeyboardMarkup(
         keyboard=[
-            [KeyboardButton(text="📱 Отправить контакт", request_contact=True)],
-            [KeyboardButton(text="❌ Отмена")]
+            [KeyboardButton(text=texts.t("SEND_CONTACT_BUTTON", "📱 Отправить контакт"), request_contact=True)],
+            [KeyboardButton(text=texts.CANCEL)]
         ],
         resize_keyboard=True,
         one_time_keyboard=True
@@ -106,11 +108,12 @@ def get_contact_keyboard(language: str = "ru") -> ReplyKeyboardMarkup:
 
 
 def get_location_keyboard(language: str = "ru") -> ReplyKeyboardMarkup:
+    texts = get_texts(language)
     return ReplyKeyboardMarkup(
         keyboard=[
-            [KeyboardButton(text="📍 Отправить геолокацию", request_location=True)],
-            [KeyboardButton(text="❌ Отмена")]
+            [KeyboardButton(text=texts.t("SEND_LOCATION_BUTTON", "📍 Отправить геолокацию"), request_location=True)],
+            [KeyboardButton(text=texts.CANCEL)]
         ],
         resize_keyboard=True,
         one_time_keyboard=True
-    )
+    )

app/localization/default_locales/en.yml

@@ -0,0 +1,16 @@
+# Sample localization for English language.
+# Keys correspond to constants defined in app/localization/texts.py.
+WELCOME: |
+  Welcome to Remnawave Bedolaga Bot!
+  Update this text to greet users in your own style.
+
+MENU:
+  BALANCE: "Balance"
+  SUBSCRIPTION: "Subscription"
+
+RULES_TEXT: |
+  Remnawave service rules:
+    1. Follow the law of your jurisdiction.
+    2. Do not distribute spam or malicious content.
+    3. Respect other community members.
+

app/localization/default_locales/ru.yml

@@ -0,0 +1,16 @@
+# Пример локализации на русском языке.
+# Ключи соответствуют именам констант из app/localization/texts.py.
+WELCOME: |
+  Добро пожаловать в Remnawave Bedolaga Bot!
+  Эти строки заменят стандартное приветствие бота.
+
+MENU:
+  BALANCE: "Баланс"
+  SUBSCRIPTION: "Подписка"
+
+RULES_TEXT: |
+  Правила сервиса Remnawave:
+    1. Следуйте законам своей страны.
+    2. Не распространяйте спам и вредоносный контент.
+    3. Уважайте других пользователей.
+

app/localization/loader.py

@@ -0,0 +1,263 @@
+from __future__ import annotations
+
+import json
+import logging
+import shutil
+from functools import lru_cache
+from pathlib import Path
+from typing import Any, Dict
+
+from app.config import settings
+
+_logger = logging.getLogger(__name__)
+
+_FALLBACK_LANGUAGE = "ru"
+
+_BASE_DIR = Path(__file__).resolve().parent
+_DEFAULT_LOCALES_DIR = _BASE_DIR / "locales"
+
+
+def _normalize_language_code(value: Any) -> str:
+    if isinstance(value, str):
+        return value.strip().lower()
+    if value is None:
+        return ""
+    return str(value).strip().lower()
+
+
+def _resolve_user_locales_dir() -> Path:
+    path = Path(settings.LOCALES_PATH).expanduser()
+    if not path.is_absolute():
+        path = Path.cwd() / path
+    return path
+
+
+def _locale_file_exists(language: str) -> bool:
+    code = _normalize_language_code(language)
+    if not code:
+        return False
+
+    default_candidate = _DEFAULT_LOCALES_DIR / f"{code}.json"
+    if default_candidate.exists():
+        return True
+
+    user_dir = _resolve_user_locales_dir()
+    for extension in (".json", ".yml", ".yaml"):
+        if (user_dir / f"{code}{extension}").exists():
+            return True
+    return False
+
+
+def _select_fallback_language(available_map: Dict[str, str]) -> str:
+    candidates = []
+    if _FALLBACK_LANGUAGE:
+        candidates.append(_FALLBACK_LANGUAGE)
+    candidates.extend(available_map.values())
+
+    seen = set()
+    for candidate in candidates:
+        normalized = _normalize_language_code(candidate)
+        if not normalized or normalized in seen:
+            continue
+        seen.add(normalized)
+
+        if normalized in available_map:
+            return available_map[normalized]
+
+        if _locale_file_exists(normalized):
+            return normalized
+
+    if _FALLBACK_LANGUAGE and _locale_file_exists(_FALLBACK_LANGUAGE):
+        return _FALLBACK_LANGUAGE
+
+    return _FALLBACK_LANGUAGE or "ru"
+
+
+def _determine_default_language() -> str:
+    try:
+        raw_default = settings.DEFAULT_LANGUAGE
+    except AttributeError:
+        raw_default = None
+
+    configured = raw_default.strip() if isinstance(raw_default, str) else ""
+
+    try:
+        available_languages = settings.get_available_languages()
+    except Exception as error:  # pragma: no cover - defensive logging
+        _logger.warning("Failed to load available languages from settings: %s", error)
+        available_languages = []
+
+    available_map = {
+        _normalize_language_code(lang): lang.strip()
+        for lang in available_languages
+        if isinstance(lang, str) and lang.strip()
+    }
+
+    if configured:
+        normalized_configured = _normalize_language_code(configured)
+
+        if normalized_configured in available_map:
+            return available_map[normalized_configured]
+
+        if not available_map and _locale_file_exists(normalized_configured):
+            return normalized_configured
+
+        if _locale_file_exists(normalized_configured):
+            _logger.warning(
+                "Configured default language '%s' is not listed in AVAILABLE_LANGUAGES. Falling back to '%s'.",
+                configured,
+                _FALLBACK_LANGUAGE,
+            )
+        else:
+            _logger.warning(
+                "Configured default language '%s' is not available. Falling back to '%s'.",
+                configured,
+                _FALLBACK_LANGUAGE,
+            )
+    else:
+        _logger.debug("DEFAULT_LANGUAGE is not set. Falling back to '%s'.", _FALLBACK_LANGUAGE)
+
+    fallback_language = _select_fallback_language(available_map)
+
+    if _normalize_language_code(fallback_language) != _normalize_language_code(_FALLBACK_LANGUAGE):
+        _logger.warning(
+            "Fallback language '%s' is not available. Using '%s' instead.",
+            _FALLBACK_LANGUAGE,
+            fallback_language,
+        )
+
+    return fallback_language or _FALLBACK_LANGUAGE
+
+
+DEFAULT_LANGUAGE = _determine_default_language()
+
+
+def _normalize_key(raw_key: Any) -> str:
+    key = str(raw_key).strip().replace(" ", "_")
+    return key.upper()
+
+
+def _flatten_locale_dict(data: Dict[str, Any], parent_key: str = "") -> Dict[str, Any]:
+    flattened: Dict[str, Any] = {}
+    for key, value in (data or {}).items():
+        composite_key = _normalize_key(key)
+        if parent_key:
+            composite_key = f"{parent_key}_{composite_key}"
+
+        if isinstance(value, dict):
+            flattened.update(_flatten_locale_dict(value, composite_key))
+        else:
+            flattened[composite_key] = value
+    return flattened
+
+
+def _normalize_locale_dict(data: Dict[str, Any]) -> Dict[str, Any]:
+    normalized: Dict[str, Any] = {}
+    for key, value in (data or {}).items():
+        if isinstance(value, dict):
+            normalized.update(_flatten_locale_dict(value, _normalize_key(key)))
+        else:
+            normalized[_normalize_key(key)] = value
+    return normalized
+
+
+def ensure_locale_templates() -> None:
+    destination = _resolve_user_locales_dir()
+    try:
+        destination.mkdir(parents=True, exist_ok=True)
+    except Exception as error:
+        _logger.warning("Unable to create locales directory %s: %s", destination, error)
+        return
+
+    if any(destination.glob("*")):
+        return
+
+    if not _DEFAULT_LOCALES_DIR.exists():
+        _logger.debug("Default locales directory %s is missing", _DEFAULT_LOCALES_DIR)
+        return
+
+    for template in _DEFAULT_LOCALES_DIR.iterdir():
+        if not template.is_file():
+            continue
+        target_path = destination / template.name
+        try:
+            shutil.copyfile(template, target_path)
+        except Exception as error:
+            _logger.warning(
+                "Failed to copy default locale %s to %s: %s",
+                template,
+                target_path,
+                error,
+            )
+
+
+def _load_default_locale(language: str) -> Dict[str, Any]:
+    default_path = _DEFAULT_LOCALES_DIR / f"{language}.json"
+    if not default_path.exists():
+        return {}
+    return _normalize_locale_dict(_load_locale_file(default_path))
+
+
+def _load_user_locale(language: str) -> Dict[str, Any]:
+    user_dir = _resolve_user_locales_dir()
+    for extension in (".json", ".yml", ".yaml"):
+        candidate = user_dir / f"{language}{extension}"
+        if candidate.exists():
+            return _normalize_locale_dict(_load_locale_file(candidate))
+    return {}
+
+
+def _load_locale_file(path: Path) -> Dict[str, Any]:
+    suffix = path.suffix.lower()
+    try:
+        if suffix == ".json":
+            return json.loads(path.read_text(encoding="utf-8"))
+        if suffix in {".yml", ".yaml"}:
+            try:
+                import yaml  # type: ignore
+            except ModuleNotFoundError as import_error:
+                raise RuntimeError(
+                    "PyYAML is required to load YAML locale files. Install PyYAML or provide JSON files."
+                ) from import_error
+            return yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+    except Exception as error:
+        _logger.warning("Failed to parse locale file %s: %s", path, error)
+        return {}
+
+    _logger.warning("Unsupported locale format for %s", path)
+    return {}
+
+
+def _merge_dicts(base: Dict[str, Any], overrides: Dict[str, Any]) -> Dict[str, Any]:
+    result = dict(base)
+    for key, value in overrides.items():
+        if (
+            key in result
+            and isinstance(result[key], dict)
+            and isinstance(value, dict)
+        ):
+            result[key] = _merge_dicts(result[key], value)
+        else:
+            result[key] = value
+    return result
+
+
+@lru_cache(maxsize=None)
+def load_locale(language: str) -> Dict[str, Any]:
+    language = language or DEFAULT_LANGUAGE
+    defaults = _load_default_locale(language)
+    overrides = _load_user_locale(language)
+    merged = _merge_dicts(defaults, overrides)
+
+    if not merged and language != DEFAULT_LANGUAGE:
+        _logger.warning(
+            "Locale %s not found. Falling back to default language %s.",
+            language,
+            DEFAULT_LANGUAGE,
+        )
+        return load_locale(DEFAULT_LANGUAGE)
+    return merged
+
+
+def clear_locale_cache() -> None:
+    load_locale.cache_clear()

app/localization/locales/en.json

@@ -0,0 +1,383 @@
+{
+  "ADD_COUNTRIES_BUTTON": "🌐 Add countries",
+  "ADMIN_MAIN_MENU": "🏠 Main menu",
+  "ADMIN_CAMPAIGNS": "📣 Promotional campaigns",
+  "AUTOPAY_BUTTON": "💳 Auto payment",
+  "AUTOPAY_SET_DAYS_BUTTON": "⚙️ Configure days",
+  "BACK": "⬅️ Back",
+  "BACK_TO_SUBSCRIPTION": "⬅️ Back to subscription",
+  "BALANCE_BUTTON_DEFAULT": "💰 Balance: {balance}",
+  "CANCEL": "❌ Cancel",
+  "CHANGE_DEVICES_BUTTON": "📱 Change devices",
+  "CHANNEL_CHECK_BUTTON": "✅ I have joined",
+  "CHANNEL_REQUIRED_TEXT": "🔒 Please join the announcement channel to access the bot, then press the button below.",
+  "CHANNEL_SUBSCRIBE_BUTTON": "🔗 Subscribe",
+  "CHANNEL_SUBSCRIBE_REQUIRED_ALERT": "❌ You haven't joined the channel!",
+  "CHANNEL_SUBSCRIBE_THANKS": "✅ Thanks for subscribing",
+  "CHECK_STATUS_BUTTON": "📊 Check status",
+  "CHOOSE_ANOTHER_DEVICE": "📱 Choose another device",
+  "CONFIRM": "✅ Confirm",
+  "CONFIRM_CHANGE_BUTTON": "✅ Confirm change",
+  "CONNECT_BUTTON": "🔗 Connect",
+  "CONTINUE": "➡️ Continue",
+  "CONTINUE_BUTTON": "➡️ Continue",
+  "COPY_SUBSCRIPTION_LINK": "📋 Copy subscription link",
+  "CREATE_INVITE_BUTTON": "📝 Create invite",
+  "DEVICE_CONNECTION_HELP": "❓ How to reconnect a device?",
+  "DEVICE_GUIDE_ANDROID": "🤖 Android",
+  "DEVICE_GUIDE_ANDROID_TV": "📺 Android TV",
+  "DEVICE_GUIDE_IOS": "📱 iOS (iPhone/iPad)",
+  "DEVICE_GUIDE_MAC": "🎯 macOS",
+  "DEVICE_GUIDE_WINDOWS": "💻 Windows",
+  "DISABLE_BUTTON": "❌ Disable",
+  "ENABLE_BUTTON": "✅ Enable",
+  "ERROR": "❌ An error occurred",
+  "ERROR_TRY_AGAIN": "❌ An error occurred. Please try again.",
+  "ERROR_RULES_RETRY": "An error occurred. Please try accepting the rules again:",
+  "GO_TO_BALANCE_TOP_UP": "💳 Go to balance top up",
+  "RETURN_TO_SUBSCRIPTION_CHECKOUT": "⬅️ Return to subscription checkout",
+  "INSUFFICIENT_BALANCE": "❌ Insufficient balance.\n\nTop up {amount} and try again.",
+  "LANGUAGE_SELECTED": "🌐 Interface language set: <b>English</b>",
+  "LOADING": "⏳ Loading...",
+  "MAIN_MENU": "👤 <b>{user_name}</b>\n\n📱 <b>Subscription:</b> {subscription_status}\n\nChoose an option:\n",
+  "MAIN_MENU_ACTION_PROMPT": "Choose an option:",
+  "MAIN_MENU_BUTTON": "🏠 Main menu",
+  "MANAGE_DEVICES_BUTTON": "🔧 Manage devices",
+  "MENU_BALANCE": "💰 Balance",
+  "MENU_SUBSCRIPTION": "📱 Subscription",
+  "MENU_TRIAL": "🎁 Trial subscription",
+  "MY_BALANCE_BUTTON": "💰 My balance",
+  "MY_SUBSCRIPTION_BUTTON": "📱 My subscription",
+  "NO": "❌ No",
+  "NO_SERVERS_AVAILABLE": "❌ No servers available",
+  "NO_TRAFFIC_PACKAGES": "❌ No packages available",
+  "OTHER_APPS_BUTTON": "📋 Other apps",
+  "PAGINATION_NEXT": "➡️",
+  "PAGINATION_PREV": "⬅️",
+  "PAYMENTS_TEMPORARILY_UNAVAILABLE": "⚠️ Payment methods are temporarily unavailable",
+  "PAYMENT_CARD_TRIBUTE": "💳 Bank card (Tribute)",
+  "PAYMENT_CARD_YOOKASSA": "💳 Bank card (YooKassa)",
+  "PAYMENT_CRYPTOBOT": "🪙 Cryptocurrency (CryptoBot)",
+  "PAYMENT_SBP_YOOKASSA": "🏦 Pay via SBP (YooKassa)",
+  "PAYMENT_TELEGRAM_STARS": "⭐ Telegram Stars",
+  "PAYMENT_VIA_SUPPORT": "🛠️ Via support",
+  "PAY_NOW_BUTTON": "💳 Pay",
+  "PAY_WITH_COINS_BUTTON": "🪙 Pay",
+  "PENDING_CANCEL_BUTTON": "⌛ Cancel",
+  "POST_REGISTRATION_TRIAL_BUTTON": "🚀 Activate free trial 🚀",
+  "REFERRAL_ANALYTICS_BUTTON": "📊 Analytics",
+  "REFERRAL_CODE_ACCEPTED": "✅ Referral code accepted!",
+  "REFERRAL_CODE_INVALID": "❌ Invalid referral code",
+  "REFERRAL_CODE_INVALID_HELP": "❌ Invalid referral code.\n\n💡 If you have a referral code, please double-check the spelling.\n⏭️ To continue without a referral code, use the /start command.",
+  "REFERRAL_CODE_QUESTION": "\n🤝 <b>Do you have a friend's referral code?</b>\n\nIf you have a promo code or referral link, enter it now to receive a bonus!\n\nSend the code or tap \"Skip\":\n",
+  "REFERRAL_CODE_SKIP": "⏭️ Skip",
+  "ALREADY_REGISTERED_REFERRAL": "ℹ️ You are already registered. A referral link cannot be applied.",
+  "REFERRAL_LIST_BUTTON": "👥 Referral list",
+  "RESET_ALL_DEVICES_BUTTON": "🔄 Reset all devices",
+  "RESET_DEVICE_CONFIRM_BUTTON": "✅ Reset this device",
+  "RESET_TRAFFIC_BUTTON": "🔄 Reset traffic",
+  "RULES_HEADER": "📋 <b>Service Rules</b>",
+  "RULES_ACCEPTED_PROCESSING": "✅ Rules accepted! Completing registration...",
+  "RULES_TEXT_DEFAULT": "📋 <b>Service Usage Rules</b>\n\n1. Do not use the service for illegal activity\n2. Avoid sharing pirated or malicious content\n3. Spam and phishing are prohibited\n4. Using the service for DDoS attacks is forbidden\n5. One account is intended for one person\n6. Refunds are provided only in exceptional cases\n7. The administration may block accounts that violate the rules\n\n<b>By using the service you agree to follow these rules.</b>",
+  "SEND_CONTACT_BUTTON": "📱 Share contact",
+  "SEND_LOCATION_BUTTON": "📍 Share location",
+  "SHOW_QR_BUTTON": "📱 Show QR code",
+  "SHOW_SUBSCRIPTION_LINK": "📋 Show subscription link",
+  "SKIP_BUTTON": "Skip ➡️",
+  "SUBSCRIPTION_SETTINGS_BUTTON": "⚙️ Subscription settings",
+  "SUB_STATUS_ACTIVE_FEW_DAYS": "💎 Active\n⚠️ expires in {days} days",
+  "SUB_STATUS_ACTIVE_LONG": "💎 Active\n📅 until {end_date} ({days} days)",
+  "SUB_STATUS_ACTIVE_TODAY": "💎 Active\n⚠️ expires today!",
+  "SUB_STATUS_ACTIVE_TOMORROW": "💎 Active\n⚠️ expires tomorrow!",
+  "SUB_STATUS_EXPIRED": "🔴 Expired\n📅 {end_date}",
+  "SUB_STATUS_NONE": "❌ Not available",
+  "SUB_STATUS_TRIAL_ACTIVE": "🎁 Trial subscription\n📅 until {end_date} ({days} days)",
+  "SUB_STATUS_TRIAL_TODAY": "🎁 Trial subscription\n⚠️ expires today!",
+  "SUB_STATUS_TRIAL_TOMORROW": "🎁 Trial subscription\n⚠️ expires tomorrow!",
+  "SUBSCRIPTION_ACTIVE": "✅ Active",
+  "SUCCESS": "✅ Success",
+  "REGISTRATION_COMPLETING": "✅ Completing registration...",
+  "SWITCH_TRAFFIC_BUTTON": "🔄 Switch traffic",
+  "TOPUP_BALANCE_BUTTON": "💳 Top up balance",
+  "TRAFFIC_PACKAGES_NOT_CONFIGURED": "⚠️ Traffic packages are not configured",
+  "TRIAL_ACTIVATE_BUTTON": "🎁 Activate",
+  "PROMOCODE_EMPTY_INPUT": "❌ Please enter a valid promo code",
+  "STARS_PAYMENT_ENROLLMENT_ERROR": "❌ Failed to credit funds. Please contact support; the payment will be verified manually.",
+  "STARS_PAYMENT_PROCESSING_ERROR": "❌ Technical error processing the payment. Please contact support for assistance.",
+  "STARS_PAYMENT_SUCCESS": "🎉 <b>Payment processed successfully!</b>\n\n⭐ Stars spent: {stars_spent}\n💰 Added to balance: {amount} ₽\n🆔 Transaction ID: {transaction_id}...\n\nThank you for topping up! 🚀",
+  "STARS_PAYMENT_USER_NOT_FOUND": "❌ Error: user not found. Please contact support.",
+  "STARS_PRECHECK_INVALID_PAYLOAD": "Payment validation error. Please try again.",
+  "STARS_PRECHECK_TECHNICAL_ERROR": "Technical error. Please try again later.",
+  "STARS_PRECHECK_USER_NOT_FOUND": "User not found. Please contact support.",
+  "UNKNOWN_CALLBACK_ALERT": "❓ Unknown action. Please try again.",
+  "UNKNOWN_COMMAND_MESSAGE": "❓ I didn't understand that command. Use the menu buttons.",
+  "WELCOME": "\n🎉 <b>Welcome to VPN Service!</b>\n\nOur service provides fast and secure internet access without restrictions.\n\n🔐 <b>Advantages:</b>\n• High connection speed\n• Servers in different countries  \n• Reliable data protection\n• 24/7 support\n\nTo get started, select interface language:\n",
+  "WELCOME_FALLBACK": "Welcome, {user_name}!",
+  "YES": "✅ Yes",
+  "ACCESS_DENIED": "❌ Access denied",
+  "ADMIN_MESSAGES": "📨 Broadcasts",
+  "ADMIN_MONITORING": "🔍 Monitoring",
+  "ADMIN_PANEL": "\n⚙️ <b>Administration panel</b>\n\nSelect a section to manage:\n",
+  "ADMIN_PROMOCODES": "🎫 Promo codes",
+  "ADMIN_REFERRALS": "🤝 Referral program",
+  "ADMIN_REMNAWAVE": "🖥️ Remnawave",
+  "ADMIN_RULES": "📋 Rules",
+  "ADMIN_STATISTICS": "📊 Statistics",
+  "ADMIN_PROMO_GROUPS": "💳 Promo groups",
+  "ADMIN_PROMO_GROUPS_TITLE": "💳 <b>Promo groups</b>",
+  "ADMIN_PROMO_GROUPS_SUMMARY": "Groups total: {count}\nMembers total: {members}",
+  "ADMIN_PROMO_GROUPS_DISCOUNTS": "Discounts — servers: {servers}%, traffic: {traffic}%, devices: {devices}%",
+  "ADMIN_PROMO_GROUPS_DEFAULT_LABEL": " (default)",
+  "ADMIN_PROMO_GROUPS_MEMBERS_COUNT": "Members: {count}",
+  "ADMIN_PROMO_GROUPS_EMPTY": "No promo groups found.",
+  "ADMIN_USER_PROMO_GROUP_BUTTON": "👥 Promo group",
+  "ADMIN_USER_PROMO_GROUP_TITLE": "👥 <b>User promo group</b>",
+  "ADMIN_USER_PROMO_GROUP_CURRENT": "Current group: {name}",
+  "ADMIN_USER_PROMO_GROUP_CURRENT_NONE": "Current group: not assigned",
+  "ADMIN_USER_PROMO_GROUP_DISCOUNTS": "Discounts — servers: {servers}%, traffic: {traffic}%, devices: {devices}%",
+  "ADMIN_USER_PROMO_GROUP_DISCOUNTS_NONE": "No discounts configured.",
+  "ADMIN_USER_PROMO_GROUP_SELECT": "Select a promo group to assign:",
+  "ADMIN_USER_PROMO_GROUP_UPDATED": "✅ User promo group updated: “{name}”",
+  "ADMIN_USER_PROMO_GROUP_ALREADY": "ℹ️ The user is already in this promo group.",
+  "ADMIN_USER_PROMO_GROUP_ERROR": "❌ Failed to update the user's promo group.",
+  "ADMIN_USER_PROMO_GROUP_BACK": "⬅️ Back to user",
+  "ADMIN_PROMO_GROUP_DETAILS_TITLE": "💳 <b>Promo group:</b> {name}",
+  "ADMIN_PROMO_GROUP_DETAILS_MEMBERS": "Members: {count}",
+  "ADMIN_PROMO_GROUP_DETAILS_DEFAULT": "This is the default group.",
+  "ADMIN_PROMO_GROUP_MEMBERS_BUTTON": "👥 Members",
+  "ADMIN_PROMO_GROUP_EDIT_BUTTON": "✏️ Edit",
+  "ADMIN_PROMO_GROUP_DELETE_BUTTON": "🗑️ Delete",
+  "ADMIN_PROMO_GROUP_CREATE_NAME_PROMPT": "Enter a name for the new promo group:",
+  "ADMIN_PROMO_GROUP_INVALID_NAME": "Name cannot be empty.",
+  "ADMIN_PROMO_GROUP_CREATE_TRAFFIC_PROMPT": "Enter traffic discount (0-100):",
+  "ADMIN_PROMO_GROUP_CREATE_SERVERS_PROMPT": "Enter server discount (0-100):",
+  "ADMIN_PROMO_GROUP_CREATE_DEVICES_PROMPT": "Enter device discount (0-100):",
+  "ADMIN_PROMO_GROUP_INVALID_PERCENT": "Enter a number from 0 to 100.",
+  "ADMIN_PROMO_GROUP_CREATED": "Promo group “{name}” created.",
+  "ADMIN_PROMO_GROUP_EDIT_NAME_PROMPT": "Enter a new name (current: {name}):",
+  "ADMIN_PROMO_GROUP_EDIT_TRAFFIC_PROMPT": "Enter new traffic discount (0-100):",
+  "ADMIN_PROMO_GROUP_EDIT_SERVERS_PROMPT": "Enter new server discount (0-100):",
+  "ADMIN_PROMO_GROUP_EDIT_DEVICES_PROMPT": "Enter new device discount (0-100):",
+  "ADMIN_PROMO_GROUP_UPDATED": "Promo group “{name}” updated.",
+  "ADMIN_PROMO_GROUP_MEMBERS_TITLE": "👥 Members of {name}",
+  "ADMIN_PROMO_GROUP_MEMBERS_EMPTY": "This group has no members yet.",
+  "ADMIN_PROMO_GROUP_DELETE_FORBIDDEN": "The default promo group cannot be deleted.",
+  "ADMIN_PROMO_GROUP_DELETE_CONFIRM": "Delete promo group “{name}”? All users will be moved to the default group.",
+  "ADMIN_PROMO_GROUP_DELETED": "Promo group “{name}” deleted.",
+  "ADMIN_SUBSCRIPTIONS": "📱 Subscriptions",
+  "ADMIN_USERS": "👥 Users",
+  "AUTOPAY_DISABLED_TEXT": "Disabled — don't forget to renew manually!",
+  "AUTOPAY_ENABLED_TEXT": "Enabled — the subscription will renew automatically",
+  "AUTOPAY_FAILED": "\n❌ <b>Autopay failed</b>\n\nWe couldn't charge the renewal payment.\nBalance available: {balance}\nRequired: {required}\n\nPlease top up your balance and renew manually.\n",
+  "AUTOPAY_SUCCESS": "\n✅ <b>Autopay completed</b>\n\nYour subscription was automatically renewed for {days} days.\nCharged from balance: {amount}\n",
+  "BALANCE_BUTTON": "💰 Balance: {balance}",
+  "BALANCE_BUTTON_ZERO": "💰 Balance: 0 ₽",
+  "BALANCE_HISTORY": "📊 Transaction history",
+  "BALANCE_INFO": "\n💰 <b>Balance: {balance}</b>\n\nChoose an action:\n",
+  "BALANCE_SUPPORT_REQUEST": "🛠️ Request via support",
+  "BALANCE_TOP_UP": "💳 Top up",
+  "CAMPAIGN_EXISTING_USER": "ℹ️ This promo link is available only to new users.",
+  "CAMPAIGN_BONUS_BALANCE": "🎉 You received {amount} for registering via the \"{name}\" campaign!",
+  "CAMPAIGN_BONUS_SUBSCRIPTION": "🎉 You’ve been granted a {days}-day subscription (traffic: {traffic}, devices: {devices}) from the \"{name}\" campaign!",
+  "BUY_SUBSCRIPTION_START": "\n💎 <b>Subscription setup</b>\n\nLet's configure a plan that fits you.\n\nFirst, choose the subscription period:\n",
+  "CHANGE_DEVICES_CONFIRM": "\n📱 <b>Confirm change</b>\n\nCurrent amount: {current_devices} devices\nNew amount: {new_devices} devices\n\nAction: {action}\n💰 {cost}\n\nApply this change?\n",
+  "CHANGE_DEVICES_INFO": "\n📱 <b>Adjust device limit</b>\n\nCurrent limit: {current_devices} devices\n\nChoose the new number of devices:\n\n💡 <b>Important:</b>\n• Increasing — extra charge proportional to the remaining time\n• Decreasing — funds are not refunded\n",
+  "CHANGE_DEVICES_SUCCESS_DECREASE": "\n✅ Device limit decreased!\n\n📱 Was: {old_count} → Now: {new_count}\nℹ️ Payments are not refunded\n",
+  "CHANGE_DEVICES_SUCCESS_INCREASE": "\n✅ Device limit increased!\n\n📱 Was: {old_count} → Now: {new_count}\n💰 Charged: {amount}\n",
+  "CHANGE_DEVICES_TITLE": "📱 Change device limit",
+  "CONTACT_SUPPORT": "💬 Contact support",
+  "CREATE_INVITE": "📝 Create invite",
+  "DEVICES_INSUFFICIENT_BALANCE": "⚠️ Insufficient balance!\nRequired: {required} (for {months} mo)\nYou have: {balance}",
+  "DEVICES_LIMIT_EXCEEDED": "⚠️ Maximum device limit exceeded ({limit})",
+  "DEVICES_MINIMUM_LIMIT": "⚠️ Minimum number of devices: {limit}",
+  "DEVICES_NO_CHANGE": "ℹ️ Device limit was not changed",
+  "INVALID_AMOUNT": "❌ Invalid amount",
+  "MAINTENANCE_MODE_ACTIVE": "\n🔧 Maintenance in progress!\n\nThe service is temporarily unavailable while we improve performance.\n\n⏰ Estimated completion time: unknown\n🔄 Please try again later\n\nWe apologize for the inconvenience.\n",
+  "MAINTENANCE_MODE_API_ERROR": "\n🔧 Maintenance in progress!\n\nThe service is temporarily unavailable due to connection issues with the servers.\n\n⏰ We're working on it. Please try again in a few minutes.\n\n🔄 Last check: {last_check}\n",
+  "MENU_ADMIN": "⚙️ Admin panel",
+  "MENU_BUY_SUBSCRIPTION": "💎 Buy subscription",
+  "MENU_EXTEND_SUBSCRIPTION": "⏰ Extend subscription",
+  "MENU_PROMOCODE": "🎫 Promo code",
+  "MENU_REFERRALS": "🤝 Referral program",
+  "MENU_RULES": "📋 Service rules",
+  "MENU_SUPPORT": "🛠️ Support",
+  "OPERATION_CANCELLED": "❌ Operation cancelled",
+  "PERIOD_14_DAYS": "📅 14 days - {settings.format_price(settings.PRICE_14_DAYS)}",
+  "PERIOD_30_DAYS": "📅 30 days - {settings.format_price(settings.PRICE_30_DAYS)}",
+  "PERIOD_60_DAYS": "📅 60 days - {settings.format_price(settings.PRICE_60_DAYS)}",
+  "PERIOD_90_DAYS": "📅 90 days - {settings.format_price(settings.PRICE_90_DAYS)}",
+  "PERIOD_180_DAYS": "📅 180 days - {settings.format_price(settings.PRICE_180_DAYS)}",
+  "PERIOD_360_DAYS": "📅 360 days - {settings.format_price(settings.PRICE_360_DAYS)}",
+  "PROMOCODE_ENTER": "🎫 Enter promo code",
+  "PROMOCODE_EXPIRED": "❌ Promo code has expired",
+  "PROMOCODE_INVALID": "❌ Invalid promo code",
+  "PROMOCODE_SUCCESS": "🎉 Promo code applied!",
+  "PROMOCODE_USED": "ℹ️ Promo code has already been used",
+  "REFERRAL_CODE_APPLIED": "🎁 Referral code applied! You will receive a bonus after the first purchase.",
+  "REFERRAL_INFO": "\n🤝 <b>Referral program</b>\n\n👥 <b>Invited:</b> {referrals_count} friends\n💰 <b>Earned:</b> {earned_amount}\n\n🔗 <b>Your referral link:</b>\n<code>{referral_link}</code>\n\n🎫 <b>Your promo code:</b>\n<code>{referral_code}</code>\n\n💰 <b>Terms:</b>\n• Per friend: {registration_bonus}\n• Top-up commission: {commission_percent}%\n",
+  "REFERRAL_INVITE_MESSAGE": "\n🎯 <b>Invitation to the VPN service</b>\n\nHi! I invite you to an excellent VPN service!\n\n🎁 Use my link to get a bonus: {bonus}\n\n🔗 Join: {link}\n🎫 Or use promo code: {code}\n\n💪 Fast, reliable, affordable!\n",
+  "RULES_ACCEPT": "✅ I accept the rules",
+  "RULES_DECLINE": "❌ I do not accept",
+  "RULES_REQUIRED": "❗️ You must accept the rules to use the service!",
+  "SELECT_COUNTRIES": "Select countries:",
+  "SELECT_DEVICES": "Number of devices:",
+  "SELECT_PERIOD": "Choose period:",
+  "SELECT_TRAFFIC": "Choose traffic package:",
+  "SUBSCRIPTION_EXPIRED": "\n❌ <b>Subscription expired</b>\n\nYour subscription has ended. Renew it to restore access.\n",
+  "SUBSCRIPTION_EXPIRING": "\n⚠️ <b>Subscription expiring!</b>\n\nYour subscription expires in {days} days.\n\nRenew it now so you don't lose access.\n",
+  "SUBSCRIPTION_EXPIRING_PAID": "\n⚠️ <b>Subscription expires in {days_text}!</b>\n\nYour paid subscription ends on {end_date}.\n\n💳 <b>Autopay:</b> {autopay_status}\n\n{action_text}\n",
+  "SUBSCRIPTION_INFO": "\n📱 <b>Subscription details</b>\n\n📊 <b>Status:</b> {status}\n🎭 <b>Type:</b> {type}\n📅 <b>Valid until:</b> {end_date}\n⏰ <b>Days left:</b> {days_left}\n\n📈 <b>Traffic:</b> {traffic_used} / {traffic_limit}\n🌍 <b>Servers:</b> {countries_count} countries\n📱 <b>Devices:</b> {devices_used} / {devices_limit}\n\n💳 <b>Autopay:</b> {autopay_status}\n",
+  "SUBSCRIPTION_NONE": "❌ No active subscription",
+  "SUBSCRIPTION_NOT_FOUND": "❌ Subscription not found",
+  "SUBSCRIPTION_PURCHASED": "🎉 Subscription purchased successfully!",
+  "SUBSCRIPTION_SUMMARY": "\n📋 <b>Final configuration</b>\n\n📅 <b>Period:</b> {period} days\n📈 <b>Traffic:</b> {traffic}\n🌍 <b>Countries:</b> {countries}\n📱 <b>Devices:</b> {devices}\n\n💰 <b>Total:</b> {total_price}\n\nConfirm the purchase?\n",
+  "SUBSCRIPTION_TRIAL": "🧪 Trial subscription",
+  "SUPPORT_INFO": "\n🛠️ <b>Technical support</b>\n\nFor any questions contact our support:\n\n👤 {settings.SUPPORT_USERNAME}\n\nWe can help with:\n• Connection setup\n• Troubleshooting issues\n• Payment questions\n• Other requests\n\n⏰ Response time: usually within 1-2 hours\n",
+  "SWITCH_TRAFFIC_CONFIRM": "\n🔄 <b>Confirm traffic change</b>\n\nCurrent limit: {current_traffic}\nNew limit: {new_traffic}\n\nAction: {action}\n💰 {cost}\n\nApply this change?\n",
+  "SWITCH_TRAFFIC_INFO": "\n🔄 <b>Switch traffic limit</b>\n\nCurrent limit: {current_traffic}\nChoose the new traffic amount:\n\n💡 <b>Important:</b>\n• Increasing — you pay the difference proportionally to the remaining time\n• Decreasing — payments are not refunded\n• The used traffic counter is NOT reset\n",
+  "SWITCH_TRAFFIC_SUCCESS_DECREASE": "\n✅ Traffic limit decreased!\n\n📊 Was: {old_traffic} → Now: {new_traffic}\nℹ️ Payments are not refunded\n",
+  "SWITCH_TRAFFIC_SUCCESS_INCREASE": "\n✅ Traffic limit increased!\n\n📊 Was: {old_traffic} → Now: {new_traffic}\n💰 Charged: {amount}\n",
+  "SWITCH_TRAFFIC_TITLE": "🔄 Switch traffic limit",
+  "TOP_UP_AMOUNT": "💳 Enter top-up amount (in rubles):",
+  "TOP_UP_METHODS": "\n💳 <b>Select a payment method</b>\n\nAmount: {amount}\n",
+  "TOP_UP_STARS": "⭐ Telegram Stars",
+  "TOP_UP_TRIBUTE": "💎 Bank card",
+  "TRAFFIC_5GB": "📊 5 GB - {settings.format_price(settings.PRICE_TRAFFIC_5GB)}",
+  "TRAFFIC_10GB": "📊 10 GB - {settings.format_price(settings.PRICE_TRAFFIC_10GB)}",
+  "TRAFFIC_25GB": "📊 25 GB - {settings.format_price(settings.PRICE_TRAFFIC_25GB)}",
+  "TRAFFIC_50GB": "📊 50 GB - {settings.format_price(settings.PRICE_TRAFFIC_50GB)}",
+  "TRAFFIC_100GB": "📊 100 GB - {settings.format_price(settings.PRICE_TRAFFIC_100GB)}",
+  "TRAFFIC_250GB": "📊 250 GB - {settings.format_price(settings.PRICE_TRAFFIC_250GB)}",
+  "TRAFFIC_UNLIMITED": "📊 Unlimited - {settings.format_price(settings.PRICE_TRAFFIC_UNLIMITED)}",
+  "TRAFFIC_INSUFFICIENT_BALANCE": "⚠️ Insufficient balance!\nRequired: {required} (for {months} mo)\nYou have: {balance}",
+  "TRAFFIC_NO_CHANGE": "ℹ️ Traffic limit was not changed",
+  "TRIAL_ACTIVATED": "🎉 Trial subscription activated!",
+  "TRIAL_ALREADY_USED": "❌ The trial subscription has already been used",
+  "TRIAL_AVAILABLE": "\n🎁 <b>Trial subscription</b>\n\nYou can get a free trial plan:\n\n⏰ <b>Duration:</b> {days} days\n📈 <b>Traffic:</b> {traffic} GB\n📱 <b>Devices:</b> {devices} pcs\n🌍 <b>Server:</b> {server_name}\n\nActivate the trial subscription?\n",
+  "TRIAL_ENDING_SOON": "\n🎁 <b>The trial subscription is ending soon!</b>\n\nYour trial expires in a few hours.\n\n💎 <b>Don't want to lose VPN access?</b>\nSwitch to the full subscription!\n\n🔥 <b>Special offer:</b>\n• 30 days for {price}\n• Unlimited traffic\n• All servers available\n• Speeds up to 1 Gbit/s\n\n⚡️ Activate before the trial ends!\n",
+  "USER_NOT_FOUND": "❌ User not found",
+  "MENU_LANGUAGE": "🌐 Language",
+  "SUBSCRIPTION_STATUS_EXPIRED": "Expired",
+  "SUBSCRIPTION_STATUS_TRIAL": "Trial",
+  "SUBSCRIPTION_STATUS_ACTIVE": "Active",
+  "SUBSCRIPTION_STATUS_UNKNOWN": "Unknown",
+  "SUBSCRIPTION_TIME_LEFT_EXPIRED": "expired",
+  "SUBSCRIPTION_TIME_LEFT_DAYS": "{days} days",
+  "SUBSCRIPTION_TIME_LEFT_HOURS": "{hours} hr",
+  "SUBSCRIPTION_TIME_LEFT_MINUTES": "{minutes} min",
+  "SUBSCRIPTION_WARNING_TOMORROW": "\n⚠️ expires tomorrow!",
+  "SUBSCRIPTION_WARNING_TODAY": "\n⚠️ expires today!",
+  "SUBSCRIPTION_WARNING_MINUTES": "\n🔴 expires in a few minutes!",
+  "SUBSCRIPTION_TYPE_TRIAL": "Trial",
+  "SUBSCRIPTION_TYPE_PAID": "Paid",
+  "SUBSCRIPTION_TRAFFIC_UNLIMITED": "∞ (unlimited) | Used: {used} GB",
+  "SUBSCRIPTION_TRAFFIC_LIMITED": "{used} / {limit} GB",
+  "SUBSCRIPTION_NO_SERVERS": "No servers",
+  "SUBSCRIPTION_OVERVIEW_TEMPLATE": "👤 {full_name}\n💰 Balance: {balance}\n📱 Subscription: {status_emoji} {status_display}{warning}\n\n📱 Subscription details\n🎭 Type: {subscription_type}\n📅 Valid until: {end_date}\n⏰ Time left: {time_left}\n📈 Traffic: {traffic}\n🌍 Servers: {servers}\n📱 Devices: {devices_used} / {device_limit}",
+  "SUBSCRIPTION_CONNECTED_DEVICES_TITLE": "<blockquote>📱 <b>Connected devices:</b>\n",
+  "SUBSCRIPTION_CONNECTED_DEVICES_FOOTER": "</blockquote>",
+  "SUBSCRIPTION_CONNECT_LINK_SECTION": "🔗 <b>Connection link:</b>\n<code>{subscription_url}</code>",
+  "SUBSCRIPTION_CONNECT_LINK_PROMPT": "📱 Copy the link and add it to your VPN app",
+  "SUBSCRIPTION_IMPORT_LINK_SECTION": "🔗 <b>Your import link for the VPN app:</b>\n<code>{subscription_url}</code>",
+  "SUBSCRIPTION_IMPORT_INSTRUCTION_PROMPT": "📱 Tap the button below to get setup instructions for your device",
+  "BACK_TO_MAIN_MENU_BUTTON": "⬅️ Back to main menu",
+  "CUSTOM_MINIAPP_URL_NOT_SET": "⚠ Custom mini-app link is not configured",
+  "SUBSCRIPTION_LINK_GENERATING_NOTICE": "{purchase_text}\n\nThe link is being generated, open the 'My subscription' section in a few seconds.",
+  "SUBSCRIPTION_NO_ACTIVE_LINK": "⚠ You don't have an active subscription or the link is still being generated",
+  "SUBSCRIPTION_CONNECT_MINIAPP_MESSAGE": "📱 <b>Connect subscription</b>\n\n🚀 Tap the button below to open the subscription in the Telegram mini app:",
+  "SUBSCRIPTION_CONNECT_CUSTOM_MESSAGE": "🚀 <b>Connect subscription</b>\n\n📱 Tap the button below to open the app:",
+  "SUBSCRIPTION_CONNECT_LINK_MESSAGE": "🚀 <b>Connect subscription</b>\n\n🔗 Tap the button below to open the subscription link:",
+  "SUBSCRIPTION_CONNECT_DEVICE_MESSAGE": "📱 <b>Connect subscription</b>\n\n🔗 <b>Subscription link:</b>\n<code>{subscription_url}</code>\n\n💡 <b>Choose your device</b> to get detailed setup instructions:",
+  "SUBSCRIPTION_LINK_UNAVAILABLE": "❌ Subscription link is unavailable",
+  "SUBSCRIPTION_DEVICE_APPS_NOT_FOUND": "❌ No apps found for this device",
+  "SUBSCRIPTION_DEVICE_GUIDE_TITLE": "📱 <b>Setup for {device_name}</b>",
+  "SUBSCRIPTION_DEVICE_LINK_TITLE": "🔗 <b>Subscription link:</b>",
+  "SUBSCRIPTION_DEVICE_FEATURED_APP": "📋 <b>Recommended app:</b> {app_name}",
+  "SUBSCRIPTION_DEVICE_STEP_INSTALL_TITLE": "<b>Step 1 - Install:</b>",
+  "SUBSCRIPTION_DEVICE_STEP_ADD_TITLE": "<b>Step 2 - Add subscription:</b>",
+  "SUBSCRIPTION_DEVICE_STEP_CONNECT_TITLE": "<b>Step 3 - Connect:</b>",
+  "SUBSCRIPTION_DEVICE_HOW_TO_TITLE": "💡 <b>How to connect:</b>",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP1": "1. Install the app from the link above",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP2": "2. Copy the subscription link (tap on it)",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP3": "3. Open the app and paste the link",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP4": "4. Connect to a server",
+  "SUBSCRIPTION_APPS_TITLE": "📱 <b>Apps for {device_name}</b>",
+  "SUBSCRIPTION_APPS_PROMPT": "Choose an app to connect:",
+  "SUBSCRIPTION_APP_NOT_FOUND": "❌ App not found",
+  "SUBSCRIPTION_SPECIFIC_APP_TITLE": "📱 <b>{app_name} - {device_name}</b>",
+  "SUBSCRIPTION_ADDITIONAL_STEP_TITLE": "<b>{title}:</b>",
+  "SUBSCRIPTION_LINK_USAGE_TITLE": "📱 <b>How to use:</b>",
+  "SUBSCRIPTION_LINK_STEP1": "1. Tap the link above to copy it",
+  "SUBSCRIPTION_LINK_STEP2": "2. Open your VPN app",
+  "SUBSCRIPTION_LINK_STEP3": "3. Find the 'Add subscription' or 'Import' option",
+  "SUBSCRIPTION_LINK_STEP4": "4. Paste the copied link",
+  "SUBSCRIPTION_LINK_HINT": "💡 If the link didn't copy, select it manually and copy.",
+  "REFERRAL_PROGRAM_TITLE": "👥 <b>Referral program</b>",
+  "REFERRAL_STATS_HEADER": "📊 <b>Your statistics:</b>",
+  "REFERRAL_STATS_INVITED": "• Invited users: <b>{count}</b>",
+  "REFERRAL_STATS_FIRST_TOPUPS": "• Made first top-up: <b>{count}</b>",
+  "REFERRAL_STATS_ACTIVE": "• Active referrals: <b>{count}</b>",
+  "REFERRAL_STATS_CONVERSION": "• Conversion: <b>{rate}%</b>",
+  "REFERRAL_STATS_TOTAL_EARNED": "• Earned in total: <b>{amount}</b>",
+  "REFERRAL_STATS_MONTH_EARNED": "• Earned last month: <b>{amount}</b>",
+  "REFERRAL_REWARDS_HEADER": "🎁 <b>How rewards work:</b>",
+  "REFERRAL_REWARD_NEW_USER": "• New user receives: <b>{bonus}</b> on the first top-up from <b>{minimum}</b>",
+  "REFERRAL_REWARD_INVITER": "• You receive on the referral's first top-up: <b>{bonus}</b>",
+  "REFERRAL_REWARD_COMMISSION": "• Commission from each referral top-up: <b>{percent}%</b>",
+  "REFERRAL_LINK_TITLE": "🔗 <b>Your referral link:</b>",
+  "REFERRAL_CODE_TITLE": "🆔 <b>Your code:</b> <code>{code}</code>",
+  "REFERRAL_RECENT_EARNINGS_HEADER": "💰 <b>Latest rewards:</b>",
+  "REFERRAL_EARNING_REASON_FIRST_TOPUP": "🎉 First top-up",
+  "REFERRAL_EARNING_REASON_COMMISSION_TOPUP": "💰 Top-up commission",
+  "REFERRAL_EARNING_REASON_COMMISSION_PURCHASE": "💰 Purchase commission",
+  "REFERRAL_RECENT_EARNINGS_ITEM": "• {reason}: <b>{amount}</b> from {referral_name}",
+  "REFERRAL_EARNINGS_BY_TYPE_HEADER": "📈 <b>Earnings by type:</b>",
+  "REFERRAL_EARNINGS_FIRST_TOPUPS": "• Bonuses for first top-ups: <b>{count}</b> ({amount})",
+  "REFERRAL_EARNINGS_TOPUPS": "• Top-up commissions: <b>{count}</b> ({amount})",
+  "REFERRAL_EARNINGS_PURCHASES": "• Purchase commissions: <b>{count}</b> ({amount})",
+  "REFERRAL_INVITE_FOOTER": "📢 Invite friends and earn!",
+  "REFERRAL_LINK_CAPTION": "🔗 Your referral link:\n{link}",
+  "REFERRAL_LIST_EMPTY": "📋 You have no referrals yet.\n\nShare your referral link to start earning!",
+  "REFERRAL_LIST_HEADER": "👥 <b>Your referrals</b> (page {current}/{total})",
+  "REFERRAL_LIST_ITEM_HEADER": "{index}. {status} <b>{name}</b>",
+  "REFERRAL_LIST_ITEM_TOPUPS": "   {emoji} Top-ups: {count}",
+  "REFERRAL_LIST_ITEM_EARNED": "   💎 Earned from them: {amount}",
+  "REFERRAL_LIST_ITEM_REGISTERED": "   📅 Registered: {days} days ago",
+  "REFERRAL_LIST_ITEM_ACTIVITY": "   🕐 Activity: {days} days ago",
+  "REFERRAL_LIST_ITEM_ACTIVITY_LONG_AGO": "   🕐 Activity: long ago",
+  "REFERRAL_LIST_PREV_PAGE": "⬅️ Back",
+  "REFERRAL_LIST_NEXT_PAGE": "Next ➡️",
+  "REFERRAL_ANALYTICS_TITLE": "📊 <b>Referral analytics</b>",
+  "REFERRAL_ANALYTICS_EARNINGS_HEADER": "💰 <b>Earnings by period:</b>",
+  "REFERRAL_ANALYTICS_EARNINGS_TODAY": "• Today: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_WEEK": "• Week: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_MONTH": "• Month: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_QUARTER": "• Quarter: {amount}",
+  "REFERRAL_ANALYTICS_TOP_TITLE": "🏆 <b>Top {count} referrals:</b>",
+  "REFERRAL_ANALYTICS_TOP_ITEM": "{index}. {name}: {amount} ({count} rewards)",
+  "REFERRAL_ANALYTICS_FOOTER": "📈 Keep growing your referral network!",
+  "REFERRAL_INVITE_TITLE": "🎉 Join the VPN service!",
+  "REFERRAL_INVITE_BONUS": "💎 On your first top-up from {minimum} you get {bonus} as a bonus!",
+  "REFERRAL_INVITE_FEATURE_FAST": "🚀 Fast connection",
+  "REFERRAL_INVITE_FEATURE_SERVERS": "🌍 Servers worldwide",
+  "REFERRAL_INVITE_FEATURE_SECURE": "🔒 Reliable protection",
+  "REFERRAL_INVITE_LINK_PROMPT": "👇 Follow the link:",
+  "REFERRAL_SHARE_BUTTON": "📤 Share",
+  "REFERRAL_INVITE_CREATED_TITLE": "📝 <b>Invitation created!</b>",
+  "REFERRAL_INVITE_CREATED_INSTRUCTION": "Tap the “📤 Share” button to send the invite to any chat or copy the text below:",
+  "PAYMENT_METHODS_ONLY_SUPPORT": "💳 <b>Balance top-up methods</b>\n\n⚠️ Automated payment methods are temporarily unavailable.\nContact support to top up your balance.\n\nChoose a top-up method:",
+  "PAYMENT_METHODS_TITLE": "💳 <b>Balance top-up methods</b>",
+  "PAYMENT_METHODS_PROMPT": "Choose the payment method that suits you:",
+  "PAYMENT_METHODS_FOOTER": "Choose a top-up method:",
+  "PAYMENT_METHOD_STARS_NAME": "⭐ <b>Telegram Stars</b>",
+  "PAYMENT_METHOD_STARS_DESCRIPTION": "fast and convenient",
+  "PAYMENT_METHOD_YOOKASSA_NAME": "💳 <b>Bank card</b>",
+  "PAYMENT_METHOD_YOOKASSA_DESCRIPTION": "via YooKassa",
+  "PAYMENT_METHOD_TRIBUTE_NAME": "💳 <b>Bank card</b>",
+  "PAYMENT_METHOD_TRIBUTE_DESCRIPTION": "via Tribute",
+  "PAYMENT_METHOD_CRYPTOBOT_NAME": "🪙 <b>Cryptocurrency</b>",
+  "PAYMENT_METHOD_CRYPTOBOT_DESCRIPTION": "via CryptoBot",
+  "PAYMENT_METHOD_SUPPORT_NAME": "🛠️ <b>Support team</b>",
+  "PAYMENT_METHOD_SUPPORT_DESCRIPTION": "other options",
+  "PAYMENT_METHODS_UNAVAILABLE_ALERT": "⚠️ Automated payment methods are temporarily unavailable. Contact support to top up your balance."
+}

app/localization/locales/ru.json

@@ -0,0 +1,383 @@
+{
+  "ACCESS_DENIED": "❌ Доступ запрещен",
+  "ADD_COUNTRIES_BUTTON": "🌐 Добавить страны",
+  "ADMIN_MAIN_MENU": "🏠 Главное меню",
+  "ADMIN_CAMPAIGNS": "📣 Рекламные кампании",
+  "ADMIN_MESSAGES": "📨 Рассылки",
+  "ADMIN_MONITORING": "🔍 Мониторинг",
+  "ADMIN_PANEL": "\n⚙️ <b>Административная панель</b>\n\nВыберите раздел для управления:\n",
+  "ADMIN_PROMOCODES": "🎫 Промокоды",
+  "ADMIN_REFERRALS": "🤝 Партнерка",
+  "ADMIN_REMNAWAVE": "🖥️ Remnawave",
+  "ADMIN_RULES": "📋 Правила",
+  "ADMIN_STATISTICS": "📊 Статистика",
+  "ADMIN_PROMO_GROUPS": "💳 Промогруппы",
+  "ADMIN_PROMO_GROUPS_TITLE": "💳 <b>Промогруппы</b>",
+  "ADMIN_PROMO_GROUPS_SUMMARY": "Всего групп: {count}\nВсего участников: {members}",
+  "ADMIN_PROMO_GROUPS_DISCOUNTS": "Скидки — серверы: {servers}%, трафик: {traffic}%, устройства: {devices}%",
+  "ADMIN_PROMO_GROUPS_DEFAULT_LABEL": " (базовая)",
+  "ADMIN_PROMO_GROUPS_MEMBERS_COUNT": "Участников: {count}",
+  "ADMIN_PROMO_GROUPS_EMPTY": "Промогруппы не найдены.",
+  "ADMIN_USER_PROMO_GROUP_BUTTON": "👥 Промогруппа",
+  "ADMIN_USER_PROMO_GROUP_TITLE": "👥 <b>Промогруппа пользователя</b>",
+  "ADMIN_USER_PROMO_GROUP_CURRENT": "Текущая группа: {name}",
+  "ADMIN_USER_PROMO_GROUP_CURRENT_NONE": "Текущая группа: не назначена",
+  "ADMIN_USER_PROMO_GROUP_DISCOUNTS": "Скидки — серверы: {servers}%, трафик: {traffic}%, устройства: {devices}%",
+  "ADMIN_USER_PROMO_GROUP_DISCOUNTS_NONE": "Скидки не заданы.",
+  "ADMIN_USER_PROMO_GROUP_SELECT": "Выберите промогруппу для назначения:",
+  "ADMIN_USER_PROMO_GROUP_UPDATED": "✅ Промогруппа пользователя обновлена: «{name}»",
+  "ADMIN_USER_PROMO_GROUP_ALREADY": "ℹ️ Пользователь уже состоит в этой промогруппе.",
+  "ADMIN_USER_PROMO_GROUP_ERROR": "❌ Не удалось обновить промогруппу пользователя.",
+  "ADMIN_USER_PROMO_GROUP_BACK": "⬅️ К пользователю",
+  "ADMIN_PROMO_GROUP_DETAILS_TITLE": "💳 <b>Промогруппа:</b> {name}",
+  "ADMIN_PROMO_GROUP_DETAILS_MEMBERS": "Участников: {count}",
+  "ADMIN_PROMO_GROUP_DETAILS_DEFAULT": "Это базовая группа.",
+  "ADMIN_PROMO_GROUP_MEMBERS_BUTTON": "👥 Участники",
+  "ADMIN_PROMO_GROUP_EDIT_BUTTON": "✏️ Изменить",
+  "ADMIN_PROMO_GROUP_DELETE_BUTTON": "🗑️ Удалить",
+  "ADMIN_PROMO_GROUP_CREATE_NAME_PROMPT": "Введите название новой промогруппы:",
+  "ADMIN_PROMO_GROUP_INVALID_NAME": "Название не может быть пустым.",
+  "ADMIN_PROMO_GROUP_CREATE_TRAFFIC_PROMPT": "Введите скидку на трафик (0-100):",
+  "ADMIN_PROMO_GROUP_CREATE_SERVERS_PROMPT": "Введите скидку на серверы (0-100):",
+  "ADMIN_PROMO_GROUP_CREATE_DEVICES_PROMPT": "Введите скидку на устройства (0-100):",
+  "ADMIN_PROMO_GROUP_INVALID_PERCENT": "Введите число от 0 до 100.",
+  "ADMIN_PROMO_GROUP_CREATED": "Промогруппа «{name}» создана.",
+  "ADMIN_PROMO_GROUP_EDIT_NAME_PROMPT": "Введите новое название промогруппы (текущее: {name}):",
+  "ADMIN_PROMO_GROUP_EDIT_TRAFFIC_PROMPT": "Введите новую скидку на трафик (0-100):",
+  "ADMIN_PROMO_GROUP_EDIT_SERVERS_PROMPT": "Введите новую скидку на серверы (0-100):",
+  "ADMIN_PROMO_GROUP_EDIT_DEVICES_PROMPT": "Введите новую скидку на устройства (0-100):",
+  "ADMIN_PROMO_GROUP_UPDATED": "Промогруппа «{name}» обновлена.",
+  "ADMIN_PROMO_GROUP_MEMBERS_TITLE": "👥 Участники группы {name}",
+  "ADMIN_PROMO_GROUP_MEMBERS_EMPTY": "В этой группе пока нет участников.",
+  "ADMIN_PROMO_GROUP_DELETE_FORBIDDEN": "Базовую промогруппу нельзя удалить.",
+  "ADMIN_PROMO_GROUP_DELETE_CONFIRM": "Удалить промогруппу «{name}»? Все пользователи будут переведены в базовую группу.",
+  "ADMIN_PROMO_GROUP_DELETED": "Промогруппа «{name}» удалена.",
+  "ADMIN_SUBSCRIPTIONS": "📱 Подписки",
+  "ADMIN_USERS": "👥 Пользователи",
+  "AUTOPAY_BUTTON": "💳 Автоплатёж",
+  "AUTOPAY_DISABLED_TEXT": "Отключен - не забудьте продлить вручную!",
+  "AUTOPAY_ENABLED_TEXT": "Включен - подписка продлится автоматически",
+  "AUTOPAY_FAILED": "\n❌ <b>Ошибка автоплатежа</b>\n\nНе удалось списать средства для продления подписки.\nНедостаточно средств на балансе: {balance}\nТребуется: {required}\n\nПополните баланс и продлите подписку вручную.\n",
+  "AUTOPAY_SET_DAYS_BUTTON": "⚙️ Настроить дни",
+  "AUTOPAY_SUCCESS": "\n✅ <b>Автоплатеж выполнен</b>\n\nВаша подписка автоматически продлена на {days} дней.\nСписано с баланса: {amount}\n",
+  "BACK": "⬅️ Назад",
+  "BACK_TO_SUBSCRIPTION": "⬅️ К подписке",
+  "BALANCE_BUTTON": "💰 Баланс: {balance}",
+  "BALANCE_BUTTON_DEFAULT": "💰 Баланс: {balance}",
+  "BALANCE_BUTTON_ZERO": "💰 Баланс: 0 ₽",
+  "BALANCE_HISTORY": "📊 История операций",
+  "BALANCE_INFO": "\n💰 <b>Баланс: {balance}</b>\n\nВыберите действие:\n",
+  "BALANCE_SUPPORT_REQUEST": "🛠️ Запрос через поддержку",
+  "BALANCE_TOP_UP": "💳 Пополнить",
+  "CAMPAIGN_EXISTING_USER": "ℹ️ Эта рекламная ссылка доступна только новым пользователям.",
+  "CAMPAIGN_BONUS_BALANCE": "🎉 Вы получили {amount} за регистрацию по кампании «{name}»!",
+  "CAMPAIGN_BONUS_SUBSCRIPTION": "🎉 Вам выдана подписка на {days} д. (трафик: {traffic}, устройств: {devices}) по кампании «{name}»!",
+  "BUY_SUBSCRIPTION_START": "\n💎 <b>Настройка подписки</b>\n\nДавайте настроим вашу подписку под ваши потребности.\n\nСначала выберите период подписки:\n",
+  "CANCEL": "❌ Отмена",
+  "CHANGE_DEVICES_BUTTON": "📱 Изменить устройства",
+  "CHANGE_DEVICES_CONFIRM": "\n    📱 <b>Подтверждение изменения</b>\n\n    Текущее количество: {current_devices} устройств\n    Новое количество: {new_devices} устройств\n\n    Действие: {action}\n    💰 {cost}\n\n    Подтвердить изменение?\n    ",
+  "CHANGE_DEVICES_INFO": "\n    📱 <b>Изменение количества устройств</b>\n\n    Текущий лимит: {current_devices} устройств\n\n    Выберите новое количество устройств:\n\n    💡 <b>Важно:</b>\n    • При увеличении - доплата пропорционально оставшемуся времени\n    • При уменьшении - возврат средств не производится\n    ",
+  "CHANGE_DEVICES_SUCCESS_DECREASE": "\n    ✅ Количество устройств уменьшено!\n\n    📱 Было: {old_count} → Стало: {new_count}\n    ℹ️ Возврат средств не производится\n    ",
+  "CHANGE_DEVICES_SUCCESS_INCREASE": "\n    ✅ Количество устройств увеличено!\n\n    📱 Было: {old_count} → Стало: {new_count}\n    💰 Списано: {amount}\n    ",
+  "CHANGE_DEVICES_TITLE": "📱 Изменение количества устройств",
+  "CHANNEL_CHECK_BUTTON": "✅ Я подписался",
+  "CHANNEL_REQUIRED_TEXT": "🔒 Для использования бота подпишитесь на новостной канал, а затем нажмите кнопку ниже.",
+  "CHANNEL_SUBSCRIBE_BUTTON": "🔗 Подписаться",
+  "CHANNEL_SUBSCRIBE_REQUIRED_ALERT": "❌ Вы не подписались на канал!",
+  "CHANNEL_SUBSCRIBE_THANKS": "✅ Спасибо за подписку",
+  "CHECK_STATUS_BUTTON": "📊 Проверить статус",
+  "CHOOSE_ANOTHER_DEVICE": "📱 Выбрать другое устройство",
+  "CONFIRM": "✅ Подтвердить",
+  "CONFIRM_CHANGE_BUTTON": "✅ Подтвердить изменение",
+  "CONNECT_BUTTON": "🔗 Подключиться",
+  "CONTACT_SUPPORT": "💬 Написать в поддержку",
+  "CONTINUE": "➡️ Продолжить",
+  "CONTINUE_BUTTON": "✅ Продолжить",
+  "COPY_SUBSCRIPTION_LINK": "📋 Скопировать ссылку подписки",
+  "CREATE_INVITE": "📝 Создать приглашение",
+  "CREATE_INVITE_BUTTON": "📝 Создать приглашение",
+  "DEVICES_INSUFFICIENT_BALANCE": "⚠️ Недостаточно средств!\nТребуется: {required} (за {months} мес)\nУ вас: {balance}",
+  "DEVICES_LIMIT_EXCEEDED": "⚠️ Превышен максимальный лимит устройств ({limit})",
+  "DEVICES_MINIMUM_LIMIT": "⚠️ Минимальное количество устройств: {limit}",
+  "DEVICES_NO_CHANGE": "ℹ️ Количество устройств не изменилось",
+  "DEVICE_CONNECTION_HELP": "❓ Как подключить устройство заново?",
+  "DEVICE_GUIDE_ANDROID": "🤖 Android",
+  "DEVICE_GUIDE_ANDROID_TV": "📺 Android TV",
+  "DEVICE_GUIDE_IOS": "📱 iOS (iPhone/iPad)",
+  "DEVICE_GUIDE_MAC": "🎯 macOS",
+  "DEVICE_GUIDE_WINDOWS": "💻 Windows",
+  "DISABLE_BUTTON": "❌ Выключить",
+  "ENABLE_BUTTON": "✅ Включить",
+  "ERROR": "❌ Произошла ошибка",
+  "ERROR_TRY_AGAIN": "❌ Произошла ошибка. Попробуйте еще раз.",
+  "ERROR_RULES_RETRY": "Произошла ошибка. Попробуйте принять правила еще раз:",
+  "GO_TO_BALANCE_TOP_UP": "💳 Перейти к пополнению баланса",
+  "RETURN_TO_SUBSCRIPTION_CHECKOUT": "⬅️ Вернуться к оформлению подписки",
+  "INSUFFICIENT_BALANCE": "❌ Недостаточно средств на балансе.  \n    \n    <b>Пополните баланс на {amount} и попробуйте снова.</b>\n    ",
+  "INVALID_AMOUNT": "❌ Неверная сумма",
+  "LANGUAGE_SELECTED": "🌐 Язык интерфейса установлен: <b>Русский</b>",
+  "LOADING": "⏳ Загрузка...",
+  "MAINTENANCE_MODE_ACTIVE": "\n🔧 Технические работы!\n\nСервис временно недоступен. Ведутся технические работы по улучшению качества обслуживания.\n\n⏰ Ориентировочное время завершения: неизвестно\n🔄 Попробуйте позже\n\nПриносим извинения за временные неудобства.\n",
+  "MAINTENANCE_MODE_API_ERROR": "\n🔧 Технические работы!\n\nСервис временно недоступен из-за проблем с подключением к серверам.\n\n⏰ Мы работаем над восстановлением. Попробуйте через несколько минут.\n\n🔄 Последняя проверка: {last_check}\n",
+  "MAIN_MENU": "👤 <b>{user_name}</b>\n    \n📱 <b>Подписка:</b> {subscription_status}\n\nВыберите действие:\n",
+  "MAIN_MENU_ACTION_PROMPT": "Выберите действие:",
+  "MAIN_MENU_BUTTON": "🏠 Главное меню",
+  "MANAGE_DEVICES_BUTTON": "🔧 Управление устройствами",
+  "MENU_ADMIN": "⚙️ Админ-панель",
+  "MENU_BALANCE": "💰 Баланс",
+  "MENU_BUY_SUBSCRIPTION": "💎 Купить подписку",
+  "MENU_EXTEND_SUBSCRIPTION": "⏰ Продлить подписку",
+  "MENU_LANGUAGE": "🌐 Язык",
+  "MENU_PROMOCODE": "🎫 Промокод",
+  "MENU_REFERRALS": "🤝 Партнерка",
+  "MENU_RULES": "📋 Правила сервиса",
+  "MENU_SUBSCRIPTION": "📱 Подписка",
+  "MENU_SUPPORT": "🛠️ Техподдержка",
+  "MENU_TRIAL": "🧪 Тестовая подписка",
+  "MY_BALANCE_BUTTON": "💰 Мой баланс",
+  "MY_SUBSCRIPTION_BUTTON": "📱 Моя подписка",
+  "NO": "❌ Нет",
+  "NO_SERVERS_AVAILABLE": "❌ Нет доступных серверов",
+  "NO_TRAFFIC_PACKAGES": "❌ Нет доступных пакетов",
+  "OPERATION_CANCELLED": "❌ Операция отменена",
+  "OTHER_APPS_BUTTON": "📋 Другие приложения",
+  "PAGINATION_NEXT": "➡️",
+  "PAGINATION_PREV": "⬅️",
+  "PAYMENTS_TEMPORARILY_UNAVAILABLE": "⚠️ Способы оплаты временно недоступны",
+  "PAYMENT_CARD_TRIBUTE": "💳 Банковская карта (Tribute)",
+  "PAYMENT_CARD_YOOKASSA": "💳 Банковская карта (YooKassa)",
+  "PAYMENT_CRYPTOBOT": "🪙 Криптовалюта (CryptoBot)",
+  "PAYMENT_SBP_YOOKASSA": "🏬 Оплатить по СБП (YooKassa)",
+  "PAYMENT_TELEGRAM_STARS": "⭐ Telegram Stars",
+  "PAYMENT_VIA_SUPPORT": "🛠️ Через поддержку",
+  "PAY_NOW_BUTTON": "💳 Оплатить",
+  "PAY_WITH_COINS_BUTTON": "🪙 Оплатить",
+  "PENDING_CANCEL_BUTTON": "⌛ Отмена",
+  "PERIOD_14_DAYS": "📅 14 дней - {settings.format_price(settings.PRICE_14_DAYS)}",
+  "PERIOD_180_DAYS": "📅 180 дней - {settings.format_price(settings.PRICE_180_DAYS)}",
+  "PERIOD_30_DAYS": "📅 30 дней - {settings.format_price(settings.PRICE_30_DAYS)}",
+  "PERIOD_360_DAYS": "📅 360 дней - {settings.format_price(settings.PRICE_360_DAYS)}",
+  "PERIOD_60_DAYS": "📅 60 дней - {settings.format_price(settings.PRICE_60_DAYS)}",
+  "PERIOD_90_DAYS": "📅 90 дней - {settings.format_price(settings.PRICE_90_DAYS)}",
+  "POST_REGISTRATION_TRIAL_BUTTON": "🚀 Подключиться бесплатно 🚀",
+  "PROMOCODE_ENTER": "🎫 Введите промокод:",
+  "PROMOCODE_EMPTY_INPUT": "❌ Введите корректный промокод",
+  "PROMOCODE_EXPIRED": "❌ Промокод истек",
+  "PROMOCODE_INVALID": "❌ Неверный промокод",
+  "PROMOCODE_SUCCESS": "🎉 Промокод активирован! {description}",
+  "PROMOCODE_USED": "❌ Промокод уже использован",
+  "REFERRAL_ANALYTICS_BUTTON": "📊 Аналитика",
+  "REFERRAL_CODE_APPLIED": "🎁 Реферальный код применен! Вы получите бонус после первой покупки.",
+  "REFERRAL_CODE_ACCEPTED": "✅ Реферальный код принят!",
+  "REFERRAL_CODE_INVALID": "❌ Неверный реферальный код",
+  "REFERRAL_CODE_INVALID_HELP": "❌ Неверный реферальный код.\n\n💡 Если у вас есть реферальный код, убедитесь что он введен правильно.\n⏭️ Для продолжения регистрации без реферального кода используйте команду /start",
+  "REFERRAL_CODE_QUESTION": "\n🤝 <b>У вас есть реферальный код от друга?</b>\n\nЕсли у вас есть промокод или реферальная ссылка от друга, введите её сейчас, чтобы получить бонус!\n\nВведите код или нажмите \"Пропустить\":\n",
+  "REFERRAL_CODE_SKIP": "⏭️ Пропустить",
+  "ALREADY_REGISTERED_REFERRAL": "ℹ️ Вы уже зарегистрированы в системе. Реферальная ссылка не может быть применена.",
+  "REFERRAL_INFO": "\n🤝 <b>Реферальная программа</b>\n\n👥 <b>Приглашено:</b> {referrals_count} друзей\n💰 <b>Заработано:</b> {earned_amount}\n\n🔗 <b>Ваша реферальная ссылка:</b>\n<code>{referral_link}</code>\n\n🎫 <b>Ваш промокод:</b>\n<code>{referral_code}</code>\n\n💰 <b>Условия:</b>\n• За каждого друга: {registration_bonus}\n• Процент с пополнений: {commission_percent}%\n",
+  "REFERRAL_INVITE_MESSAGE": "\n🎯 <b>Приглашение в VPN сервис</b>\n\nПривет! Приглашаю тебя в отличный VPN сервис!\n\n🎁 По моей ссылке ты получишь бонус: {bonus}\n\n🔗 Переходи: {link}\n🎫 Или используй промокод: {code}\n\n💪 Быстро, надежно, недорого!\n",
+  "REFERRAL_LIST_BUTTON": "👥 Список рефералов",
+  "RESET_ALL_DEVICES_BUTTON": "🔄 Сбросить все устройства",
+  "RESET_DEVICE_CONFIRM_BUTTON": "✅ Да, сбросить это устройство",
+  "RESET_TRAFFIC_BUTTON": "🔄 Сбросить трафик",
+  "RULES_ACCEPT": "✅ Принимаю правила",
+  "RULES_ACCEPTED_PROCESSING": "✅ Правила приняты! Завершаем регистрацию...",
+  "RULES_DECLINE": "❌ Не принимаю",
+  "RULES_HEADER": "📋 <b>Правила сервиса</b>",
+  "RULES_REQUIRED": "❗️ Для использования сервиса необходимо принять правила!",
+  "RULES_TEXT_DEFAULT": "📋 <b>Правила использования сервиса</b>\n\n1. Запрещено использовать сервис для противоправной деятельности\n2. Не распространяйте пиратский или вредоносный контент\n3. Запрещены спам и фишинг\n4. Нельзя использовать сервис для DDoS-атак\n5. Один аккаунт предназначен для одного пользователя\n6. Возвраты возможны только в исключительных случаях\n7. Администрация может заблокировать аккаунт при нарушении правил\n\n<b>Используя сервис, вы подтверждаете согласие с этими правилами.</b>",
+  "SELECT_COUNTRIES": "Выберите страны:",
+  "SELECT_DEVICES": "Количество устройств:",
+  "SELECT_PERIOD": "Выберите период:",
+  "SELECT_TRAFFIC": "Выберите пакет трафика:",
+  "SEND_CONTACT_BUTTON": "📱 Отправить контакт",
+  "SEND_LOCATION_BUTTON": "📍 Отправить геолокацию",
+  "SHOW_QR_BUTTON": "📱 Показать QR код",
+  "SHOW_SUBSCRIPTION_LINK": "📋 Показать ссылку подписки",
+  "SKIP_BUTTON": "⏭️ Пропустить",
+  "SUBSCRIPTION_ACTIVE": "✅ Активна",
+  "SUBSCRIPTION_EXPIRED": "\n❌ <b>Подписка истекла</b>\n\nВаша подписка истекла. Для восстановления доступа продлите подписку.\n",
+  "SUBSCRIPTION_EXPIRING": "\n⚠️ <b>Подписка истекает!</b>\n\nВаша подписка истекает через {days} дней.\n\nНе забудьте продлить подписку, чтобы не потерять доступ к серверам.\n",
+  "SUBSCRIPTION_EXPIRING_PAID": "\n⚠️ <b>Подписка истекает через {days_text}!</b>\n\nВаша платная подписка истекает {end_date}.\n\n💳 <b>Автоплатеж:</b> {autopay_status}\n\n{action_text}\n",
+  "SUBSCRIPTION_INFO": "\n📱 <b>Информация о подписке</b>\n\n📊 <b>Статус:</b> {status}\n🎭 <b>Тип:</b> {type}\n📅 <b>Действует до:</b> {end_date}\n⏰ <b>Осталось дней:</b> {days_left}\n\n📈 <b>Трафик:</b> {traffic_used} / {traffic_limit}\n🌍 <b>Серверы:</b> {countries_count} стран\n📱 <b>Устройства:</b> {devices_used} / {devices_limit}\n\n💳 <b>Автоплатеж:</b> {autopay_status}\n",
+  "SUBSCRIPTION_NONE": "❌ Нет активной подписки",
+  "SUBSCRIPTION_NOT_FOUND": "❌ Подписка не найдена",
+  "SUBSCRIPTION_PURCHASED": "🎉 Подписка успешно приобретена!",
+  "SUBSCRIPTION_SETTINGS_BUTTON": "⚙️ Настройки подписки",
+  "SUBSCRIPTION_SUMMARY": "\n📋 <b>Итоговая конфигурация</b>\n\n📅 <b>Период:</b> {period} дней\n📈 <b>Трафик:</b> {traffic}\n🌍 <b>Страны:</b> {countries}\n📱 <b>Устройства:</b> {devices}\n\n💰 <b>Итого к оплате:</b> {total_price}\n\nПодтвердить покупку?\n",
+  "SUBSCRIPTION_TRIAL": "🧪 Тестовая подписка",
+  "SUB_STATUS_ACTIVE_FEW_DAYS": "💎 Активна\n⚠️ истекает через {days} дн.",
+  "SUB_STATUS_ACTIVE_LONG": "💎 Активна\n📅 до {end_date} ({days} дн.)",
+  "SUB_STATUS_ACTIVE_TODAY": "💎 Активна\n⚠️ истекает сегодня!",
+  "SUB_STATUS_ACTIVE_TOMORROW": "💎 Активна\n⚠️ истекает завтра!",
+  "SUB_STATUS_EXPIRED": "🔴 Истекла\n📅 {end_date}",
+  "SUB_STATUS_NONE": "❌ Отсутствует",
+  "SUB_STATUS_TRIAL_ACTIVE": "🎁 Тестовая подписка\n📅 до {end_date} ({days} дн.)",
+  "SUB_STATUS_TRIAL_TODAY": "🎁 Тестовая подписка\n⚠️ истекает сегодня!",
+  "SUB_STATUS_TRIAL_TOMORROW": "🎁 Тестовая подписка\n⚠️ истекает завтра!",
+  "SUCCESS": "✅ Успешно",
+  "REGISTRATION_COMPLETING": "✅ Завершаем регистрацию...",
+  "SUPPORT_INFO": "\n🛠️ <b>Техническая поддержка</b>\n\nПо всем вопросам обращайтесь к нашей поддержке:\n\n👤 {settings.SUPPORT_USERNAME}\n\nМы поможем с:\n• Настройкой подключения\n• Решением технических проблем  \n• Вопросами по оплате\n• Другими вопросами\n\n⏰ Время ответа: обычно в течение 1-2 часов\n",
+  "SWITCH_TRAFFIC_BUTTON": "🔄 Переключить трафик",
+  "SWITCH_TRAFFIC_CONFIRM": "\n🔄 <b>Подтверждение переключения трафика</b>\n\nТекущий лимит: {current_traffic}\nНовый лимит: {new_traffic}\n\nДействие: {action}\n💰 {cost}\n\nПодтвердить переключение?\n",
+  "SWITCH_TRAFFIC_INFO": "\n🔄 <b>Переключение лимита трафика</b>\n\nТекущий лимит: {current_traffic}\nВыберите новый лимит трафика:\n\n💡 <b>Важно:</b>\n• При увеличении - доплата за разницу пропорционально оставшемуся времени\n• При уменьшении - возврат средств не производится\n• Счетчик использованного трафика НЕ сбрасывается\n",
+  "SWITCH_TRAFFIC_SUCCESS_DECREASE": "\n✅ Лимит трафика уменьшен!\n\n📊 Было: {old_traffic} → Стало: {new_traffic}\nℹ️ Возврат средств не производится\n",
+  "SWITCH_TRAFFIC_SUCCESS_INCREASE": "\n✅ Лимит трафика увеличен!\n\n📊 Было: {old_traffic} → Стало: {new_traffic}\n💰 Списано: {amount}\n",
+  "SWITCH_TRAFFIC_TITLE": "🔄 Переключение лимита трафика",
+  "TOPUP_BALANCE_BUTTON": "💳 Попол\\у043Dить баланс",
+  "TOP_UP_AMOUNT": "💳 Введите сумму для пополнения (в рублях):",
+  "TOP_UP_METHODS": "\n💳 <b>Выберите способ оплаты</b>\n\nСумма: {amount}\n",
+  "TOP_UP_STARS": "⭐ Telegram Stars",
+  "STARS_PAYMENT_ENROLLMENT_ERROR": "❌ Произошла ошибка при зачислении средств. Обратитесь в поддержку, платеж будет проверен вручную.",
+  "STARS_PAYMENT_PROCESSING_ERROR": "❌ Техническая ошибка при обработке платежа. Обратитесь в поддержку для решения проблемы.",
+  "STARS_PAYMENT_SUCCESS": "🎉 <b>Платеж успешно обработан!</b>\n\n⭐ Потрачено звезд: {stars_spent}\n💰 Зачислено на баланс: {amount} ₽\n🆔 ID транзакции: {transaction_id}...\n\nСпасибо за пополнение! 🚀",
+  "STARS_PAYMENT_USER_NOT_FOUND": "❌ Ошибка: пользователь не найден. Обратитесь в поддержку.",
+  "STARS_PRECHECK_INVALID_PAYLOAD": "Ошибка валидации платежа. Попробуйте еще раз.",
+  "STARS_PRECHECK_TECHNICAL_ERROR": "Техническая ошибка. Попробуйте позже.",
+  "STARS_PRECHECK_USER_NOT_FOUND": "Пользователь не найден. Обратитесь в поддержку.",
+  "TOP_UP_TRIBUTE": "💎 Банковская карта",
+  "TRAFFIC_100GB": "📊 100 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_100GB)}",
+  "TRAFFIC_10GB": "📊 10 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_10GB)}",
+  "TRAFFIC_250GB": "📊 250 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_250GB)}",
+  "TRAFFIC_25GB": "📊 25 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_25GB)}",
+  "TRAFFIC_50GB": "📊 50 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_50GB)}",
+  "TRAFFIC_5GB": "📊 5 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_5GB)}",
+  "TRAFFIC_INSUFFICIENT_BALANCE": "⚠️ Недостаточно средств!\nТребуется: {required} (за {months} мес)\nУ вас: {balance}",
+  "TRAFFIC_NO_CHANGE": "ℹ️ Лимит трафика не изменился",
+  "TRAFFIC_PACKAGES_NOT_CONFIGURED": "⚠️ Пакеты трафика не настроены",
+  "TRAFFIC_UNLIMITED": "📊 Безлимит - {settings.format_price(settings.PRICE_TRAFFIC_UNLIMITED)}",
+  "TRIAL_ACTIVATED": "🎉 Тестовая подписка активирована!",
+  "TRIAL_ACTIVATE_BUTTON": "🎁 Активировать",
+  "TRIAL_ALREADY_USED": "❌ Тестовая подписка уже была использована",
+  "TRIAL_AVAILABLE": "\n🎁 <b>Тестовая подписка</b>\n\nВы можете получить бесплатную тестовую подписку:\n\n⏰ <b>Период:</b> {days} дней\n📈 <b>Трафик:</b> {traffic} ГБ\n📱 <b>Устройства:</b> {devices} шт.\n🌍 <b>Сервер:</b> {server_name}\n\nАктивировать тестовую подписку?\n",
+  "TRIAL_ENDING_SOON": "\n🎁 <b>Тестовая подписка скоро закончится!</b>\n\nВаша тестовая подписка истекает через несколько часов.\n\n💎 <b>Не хотите остаться без VPN?</b>\nПереходите на полную подписку!\n\n🔥 <b>Специальное предложение:</b>\n• 30 дней всего за {price}\n• Безлимитный трафик  \n• Все серверы доступны\n• Скорость до 1ГБит/сек\n\n⚡️ Успейте оформить до окончания тестового периода!\n",
+  "UNKNOWN_CALLBACK_ALERT": "❓ Неизвестная команда. Попробуйте ещё раз.",
+  "UNKNOWN_COMMAND_MESSAGE": "❓ Не понимаю эту команду. Используйте кнопки меню.",
+  "USER_NOT_FOUND": "❌ Пользователь не найден",
+  "WELCOME": "\n🎉 <b>Добро пожаловать в VPN сервис!</b>\n\nНаш сервис предоставляет быстрый и безопасный доступ к интернету без ограничений.\n\n🔐 <b>Преимущества:</b>\n• Высокая скорость подключения\n• Серверы в разных странах\n• Надежная защита данных\n• Круглосуточная поддержка\n\nДля начала работы выберите язык интерфейса:\n",
+  "WELCOME_FALLBACK": "Добро пожаловать, {user_name}!",
+  "YES": "✅ Да",
+  "SUBSCRIPTION_STATUS_EXPIRED": "Истекла",
+  "SUBSCRIPTION_STATUS_TRIAL": "Тестовая",
+  "SUBSCRIPTION_STATUS_ACTIVE": "Активна",
+  "SUBSCRIPTION_STATUS_UNKNOWN": "Неизвестно",
+  "SUBSCRIPTION_TIME_LEFT_EXPIRED": "истёк",
+  "SUBSCRIPTION_TIME_LEFT_DAYS": "{days} дн.",
+  "SUBSCRIPTION_TIME_LEFT_HOURS": "{hours} ч.",
+  "SUBSCRIPTION_TIME_LEFT_MINUTES": "{minutes} мин.",
+  "SUBSCRIPTION_WARNING_TOMORROW": "\n⚠️ истекает завтра!",
+  "SUBSCRIPTION_WARNING_TODAY": "\n⚠️ истекает сегодня!",
+  "SUBSCRIPTION_WARNING_MINUTES": "\n🔴 истекает через несколько минут!",
+  "SUBSCRIPTION_TYPE_TRIAL": "Триал",
+  "SUBSCRIPTION_TYPE_PAID": "Платная",
+  "SUBSCRIPTION_TRAFFIC_UNLIMITED": "∞ (безлимит) | Использовано: {used} ГБ",
+  "SUBSCRIPTION_TRAFFIC_LIMITED": "{used} / {limit} ГБ",
+  "SUBSCRIPTION_NO_SERVERS": "Нет серверов",
+  "SUBSCRIPTION_OVERVIEW_TEMPLATE": "👤 {full_name}\n💰 Баланс: {balance}\n📱 Подписка: {status_emoji} {status_display}{warning}\n\n📱 Информация о подписке\n🎭 Тип: {subscription_type}\n📅 Действует до: {end_date}\n⏰ Осталось: {time_left}\n📈 Трафик: {traffic}\n🌍 Серверы: {servers}\n📱 Устройства: {devices_used} / {device_limit}",
+  "SUBSCRIPTION_CONNECTED_DEVICES_TITLE": "<blockquote>📱 <b>Подключенные устройства:</b>\n",
+  "SUBSCRIPTION_CONNECTED_DEVICES_FOOTER": "</blockquote>",
+  "SUBSCRIPTION_CONNECT_LINK_SECTION": "🔗 <b>Ссылка для подключения:</b>\n<code>{subscription_url}</code>",
+  "SUBSCRIPTION_CONNECT_LINK_PROMPT": "📱 Скопируйте ссылку и добавьте в ваше VPN приложение",
+  "SUBSCRIPTION_IMPORT_LINK_SECTION": "🔗 <b>Ваша ссылка для импорта в VPN приложение:</b>\n<code>{subscription_url}</code>",
+  "SUBSCRIPTION_IMPORT_INSTRUCTION_PROMPT": "📱 Нажмите кнопку ниже, чтобы получить инструкцию по настройке VPN на вашем устройстве",
+  "BACK_TO_MAIN_MENU_BUTTON": "⬅️ В главное меню",
+  "CUSTOM_MINIAPP_URL_NOT_SET": "⚠ Кастомная ссылка для мини-приложения не настроена",
+  "SUBSCRIPTION_LINK_GENERATING_NOTICE": "{purchase_text}\n\nСсылка генерируется, перейдите в раздел 'Моя подписка' через несколько секунд.",
+  "SUBSCRIPTION_NO_ACTIVE_LINK": "⚠ У вас нет активной подписки или ссылка еще генерируется",
+  "SUBSCRIPTION_CONNECT_MINIAPP_MESSAGE": "📱 <b>Подключить подписку</b>\n\n🚀 Нажмите кнопку ниже, чтобы открыть подписку в мини-приложении Telegram:",
+  "SUBSCRIPTION_CONNECT_CUSTOM_MESSAGE": "🚀 <b>Подключить подписку</b>\n\n📱 Нажмите кнопку ниже, чтобы открыть приложение:",
+  "SUBSCRIPTION_CONNECT_LINK_MESSAGE": "🚀 <b>Подключить подписку</b>\n\n🔗 Нажмите кнопку ниже, чтобы открыть ссылку подписки:",
+  "SUBSCRIPTION_CONNECT_DEVICE_MESSAGE": "📱 <b>Подключить подписку</b>\n\n🔗 <b>Ссылка подписки:</b>\n<code>{subscription_url}</code>\n\n💡 <b>Выберите ваше устройство</b> для получения подробной инструкции по настройке:",
+  "SUBSCRIPTION_LINK_UNAVAILABLE": "❌ Ссылка подписки недоступна",
+  "SUBSCRIPTION_DEVICE_APPS_NOT_FOUND": "❌ Приложения для этого устройства не найдены",
+  "SUBSCRIPTION_DEVICE_GUIDE_TITLE": "📱 <b>Настройка для {device_name}</b>",
+  "SUBSCRIPTION_DEVICE_LINK_TITLE": "🔗 <b>Ссылка подписки:</b>",
+  "SUBSCRIPTION_DEVICE_FEATURED_APP": "📋 <b>Рекомендуемое приложение:</b> {app_name}",
+  "SUBSCRIPTION_DEVICE_STEP_INSTALL_TITLE": "<b>Шаг 1 - Установка:</b>",
+  "SUBSCRIPTION_DEVICE_STEP_ADD_TITLE": "<b>Шаг 2 - Добавление подписки:</b>",
+  "SUBSCRIPTION_DEVICE_STEP_CONNECT_TITLE": "<b>Шаг 3 - Подключение:</b>",
+  "SUBSCRIPTION_DEVICE_HOW_TO_TITLE": "💡 <b>Как подключить:</b>",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP1": "1. Установите приложение по ссылке выше",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP2": "2. Скопируйте ссылку подписки (нажмите на неё)",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP3": "3. Откройте приложение и вставьте ссылку",
+  "SUBSCRIPTION_DEVICE_HOW_TO_STEP4": "4. Подключитесь к серверу",
+  "SUBSCRIPTION_APPS_TITLE": "📱 <b>Приложения для {device_name}</b>",
+  "SUBSCRIPTION_APPS_PROMPT": "Выберите приложение для подключения:",
+  "SUBSCRIPTION_APP_NOT_FOUND": "❌ Приложение не найдено",
+  "SUBSCRIPTION_SPECIFIC_APP_TITLE": "📱 <b>{app_name} - {device_name}</b>",
+  "SUBSCRIPTION_ADDITIONAL_STEP_TITLE": "<b>{title}:</b>",
+  "SUBSCRIPTION_LINK_USAGE_TITLE": "📱 <b>Как использовать:</b>",
+  "SUBSCRIPTION_LINK_STEP1": "1. Нажмите на ссылку выше чтобы её скопировать",
+  "SUBSCRIPTION_LINK_STEP2": "2. Откройте ваше VPN приложение",
+  "SUBSCRIPTION_LINK_STEP3": "3. Найдите функцию \"Добавить подписку\" или \"Import\"",
+  "SUBSCRIPTION_LINK_STEP4": "4. Вставьте скопированную ссылку",
+  "SUBSCRIPTION_LINK_HINT": "💡 Если ссылка не скопировалась, выделите её вручную и скопируйте.",
+  "REFERRAL_PROGRAM_TITLE": "👥 <b>Реферальная программа</b>",
+  "REFERRAL_STATS_HEADER": "📊 <b>Ваша статистика:</b>",
+  "REFERRAL_STATS_INVITED": "• Приглашено пользователей: <b>{count}</b>",
+  "REFERRAL_STATS_FIRST_TOPUPS": "• Сделали первое пополнение: <b>{count}</b>",
+  "REFERRAL_STATS_ACTIVE": "• Активных рефералов: <b>{count}</b>",
+  "REFERRAL_STATS_CONVERSION": "• Конверсия: <b>{rate}%</b>",
+  "REFERRAL_STATS_TOTAL_EARNED": "• Заработано всего: <b>{amount}</b>",
+  "REFERRAL_STATS_MONTH_EARNED": "• За последний месяц: <b>{amount}</b>",
+  "REFERRAL_REWARDS_HEADER": "🎁 <b>Как работают награды:</b>",
+  "REFERRAL_REWARD_NEW_USER": "• Новый пользователь получает: <b>{bonus}</b> при первом пополнении от <b>{minimum}</b>",
+  "REFERRAL_REWARD_INVITER": "• Вы получаете при первом пополнении реферала: <b>{bonus}</b>",
+  "REFERRAL_REWARD_COMMISSION": "• Комиссия с каждого пополнения реферала: <b>{percent}%</b>",
+  "REFERRAL_LINK_TITLE": "🔗 <b>Ваша реферальная ссылка:</b>",
+  "REFERRAL_CODE_TITLE": "🆔 <b>Ваш код:</b> <code>{code}</code>",
+  "REFERRAL_RECENT_EARNINGS_HEADER": "💰 <b>Последние начисления:</b>",
+  "REFERRAL_EARNING_REASON_FIRST_TOPUP": "🎉 Первое пополнение",
+  "REFERRAL_EARNING_REASON_COMMISSION_TOPUP": "💰 Комиссия с пополнения",
+  "REFERRAL_EARNING_REASON_COMMISSION_PURCHASE": "💰 Комиссия с покупки",
+  "REFERRAL_RECENT_EARNINGS_ITEM": "• {reason}: <b>{amount}</b> от {referral_name}",
+  "REFERRAL_EARNINGS_BY_TYPE_HEADER": "📈 <b>Доходы по типам:</b>",
+  "REFERRAL_EARNINGS_FIRST_TOPUPS": "• Бонусы за первые пополнения: <b>{count}</b> ({amount})",
+  "REFERRAL_EARNINGS_TOPUPS": "• Комиссии с пополнений: <b>{count}</b> ({amount})",
+  "REFERRAL_EARNINGS_PURCHASES": "• Комиссии с покупок: <b>{count}</b> ({amount})",
+  "REFERRAL_INVITE_FOOTER": "📢 Приглашайте друзей и зарабатывайте!",
+  "REFERRAL_LINK_CAPTION": "🔗 Ваша реферальная ссылка:\n{link}",
+  "REFERRAL_LIST_EMPTY": "📋 У вас пока нет рефералов.\n\nПоделитесь своей реферальной ссылкой, чтобы начать зарабатывать!",
+  "REFERRAL_LIST_HEADER": "👥 <b>Ваши рефералы</b> (стр. {current}/{total})",
+  "REFERRAL_LIST_ITEM_HEADER": "{index}. {status} <b>{name}</b>",
+  "REFERRAL_LIST_ITEM_TOPUPS": "   {emoji} Пополнений: {count}",
+  "REFERRAL_LIST_ITEM_EARNED": "   💎 Заработано с него: {amount}",
+  "REFERRAL_LIST_ITEM_REGISTERED": "   📅 Регистрация: {days} дн. назад",
+  "REFERRAL_LIST_ITEM_ACTIVITY": "   🕐 Активность: {days} дн. назад",
+  "REFERRAL_LIST_ITEM_ACTIVITY_LONG_AGO": "   🕐 Активность: давно",
+  "REFERRAL_LIST_PREV_PAGE": "⬅️ Назад",
+  "REFERRAL_LIST_NEXT_PAGE": "Вперед ➡️",
+  "REFERRAL_ANALYTICS_TITLE": "📊 <b>Аналитика рефералов</b>",
+  "REFERRAL_ANALYTICS_EARNINGS_HEADER": "💰 <b>Доходы по периодам:</b>",
+  "REFERRAL_ANALYTICS_EARNINGS_TODAY": "• Сегодня: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_WEEK": "• За неделю: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_MONTH": "• За месяц: {amount}",
+  "REFERRAL_ANALYTICS_EARNINGS_QUARTER": "• За квартал: {amount}",
+  "REFERRAL_ANALYTICS_TOP_TITLE": "🏆 <b>Топ-{count} рефералов:</b>",
+  "REFERRAL_ANALYTICS_TOP_ITEM": "{index}. {name}: {amount} ({count} начислений)",
+  "REFERRAL_ANALYTICS_FOOTER": "📈 Продолжайте развивать свою реферальную сеть!",
+  "REFERRAL_INVITE_TITLE": "🎉 Присоединяйся к VPN сервису!",
+  "REFERRAL_INVITE_BONUS": "💎 При первом пополнении от {minimum} ты получишь {bonus} бонусом на баланс!",
+  "REFERRAL_INVITE_FEATURE_FAST": "🚀 Быстрое подключение",
+  "REFERRAL_INVITE_FEATURE_SERVERS": "🌍 Серверы по всему миру",
+  "REFERRAL_INVITE_FEATURE_SECURE": "🔒 Надежная защита",
+  "REFERRAL_INVITE_LINK_PROMPT": "👇 Переходи по ссылке:",
+  "REFERRAL_SHARE_BUTTON": "📤 Поделиться",
+  "REFERRAL_INVITE_CREATED_TITLE": "📝 <b>Приглашение создано!</b>",
+  "REFERRAL_INVITE_CREATED_INSTRUCTION": "Нажмите кнопку «📤 Поделиться» чтобы отправить приглашение в любой чат, или скопируйте текст ниже:",
+  "PAYMENT_METHODS_ONLY_SUPPORT": "💳 <b>Способы пополнения баланса</b>\n\n⚠️ В данный момент автоматические способы оплаты временно недоступны.\nОбратитесь в техподдержку для пополнения баланса.\n\nВыберите способ пополнения:",
+  "PAYMENT_METHODS_TITLE": "💳 <b>Способы пополнения баланса</b>",
+  "PAYMENT_METHODS_PROMPT": "Выберите удобный для вас способ оплаты:",
+  "PAYMENT_METHODS_FOOTER": "Выберите способ пополнения:",
+  "PAYMENT_METHOD_STARS_NAME": "⭐ <b>Telegram Stars</b>",
+  "PAYMENT_METHOD_STARS_DESCRIPTION": "быстро и удобно",
+  "PAYMENT_METHOD_YOOKASSA_NAME": "💳 <b>Банковская карта</b>",
+  "PAYMENT_METHOD_YOOKASSA_DESCRIPTION": "через YooKassa",
+  "PAYMENT_METHOD_TRIBUTE_NAME": "💳 <b>Банковская карта</b>",
+  "PAYMENT_METHOD_TRIBUTE_DESCRIPTION": "через Tribute",
+  "PAYMENT_METHOD_CRYPTOBOT_NAME": "🪙 <b>Криптовалюта</b>",
+  "PAYMENT_METHOD_CRYPTOBOT_DESCRIPTION": "через CryptoBot",
+  "PAYMENT_METHOD_SUPPORT_NAME": "🛠️ <b>Через поддержку</b>",
+  "PAYMENT_METHOD_SUPPORT_DESCRIPTION": "другие способы",
+  "PAYMENT_METHODS_UNAVAILABLE_ALERT": "⚠️ В данный момент автоматические способы оплаты временно недоступны. Для пополнения баланса обратитесь в техподдержку."
+}

app/localization/texts.py

@@ -1,619 +1,226 @@
+from __future__ import annotations
+
 import asyncio
-from typing import Dict, Any
+import logging
+from typing import Any, Dict
+
 from app.config import settings
+from app.localization.loader import (
+    DEFAULT_LANGUAGE,
+    clear_locale_cache,
+    load_locale,
+)
 
-_cached_rules = {}
+_logger = logging.getLogger(__name__)
 
-def _get_default_rules(language: str = "ru") -> str:
-    if language == "en":
-        return """
-🔒 <b>Service Usage Rules</b>
+_cached_rules: Dict[str, str] = {}
 
-1. It is forbidden to use the service for illegal activities
-2. Copyright infringement is prohibited
-3. Spam and malware distribution are prohibited
-4. Using the service for DDoS attacks is prohibited
-5. One account - one user
-6. Refunds are made only in exceptional cases
-7. Administration reserves the right to block an account for violating the rules
 
-<b>By accepting the rules, you agree to comply with them.</b>
-"""
-    else:
-        return """
-📋 <b>Правила использования сервиса</b>
+def _get_cached_rules_value(language: str) -> str:
+    if language in _cached_rules:
+        return _cached_rules[language]
 
-1. Запрещается использование сервиса для незаконной деятельности
-2. Запрещается нарушение авторских прав
-3. Запрещается спам и рассылка вредоносного ПО
-4. Запрещается использование сервиса для DDoS атак
-5. Один аккаунт - один пользователь
-6. Возврат средств производится только в исключительных случаях
-7. Администрация оставляет за собой право заблокировать аккаунт при нарушении правил
+    default = _get_default_rules(language)
+    _cached_rules[language] = default
+    return default
+
+
+def _build_dynamic_values(language: str) -> Dict[str, Any]:
+    language_code = (language or DEFAULT_LANGUAGE).split("-")[0].lower()
+
+    if language_code == "ru":
+        return {
+            "PERIOD_14_DAYS": f"📅 14 дней - {settings.format_price(settings.PRICE_14_DAYS)}",
+            "PERIOD_30_DAYS": f"📅 30 дней - {settings.format_price(settings.PRICE_30_DAYS)}",
+            "PERIOD_60_DAYS": f"📅 60 дней - {settings.format_price(settings.PRICE_60_DAYS)}",
+            "PERIOD_90_DAYS": f"📅 90 дней - {settings.format_price(settings.PRICE_90_DAYS)}",
+            "PERIOD_180_DAYS": f"📅 180 дней - {settings.format_price(settings.PRICE_180_DAYS)}",
+            "PERIOD_360_DAYS": f"📅 360 дней - {settings.format_price(settings.PRICE_360_DAYS)}",
+            "TRAFFIC_5GB": f"📊 5 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_5GB)}",
+            "TRAFFIC_10GB": f"📊 10 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_10GB)}",
+            "TRAFFIC_25GB": f"📊 25 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_25GB)}",
+            "TRAFFIC_50GB": f"📊 50 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_50GB)}",
+            "TRAFFIC_100GB": f"📊 100 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_100GB)}",
+            "TRAFFIC_250GB": f"📊 250 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_250GB)}",
+            "TRAFFIC_UNLIMITED": f"📊 Безлимит - {settings.format_price(settings.PRICE_TRAFFIC_UNLIMITED)}",
+            "SUPPORT_INFO": (
+                "\n🛠️ <b>Техническая поддержка</b>\n\n"
+                "По всем вопросам обращайтесь к нашей поддержке:\n\n"
+                f"👤 {settings.SUPPORT_USERNAME}\n\n"
+                "Мы поможем с:\n"
+                "• Настройкой подключения\n"
+                "• Решением технических проблем  \n"
+                "• Вопросами по оплате\n"
+                "• Другими вопросами\n\n"
+                "⏰ Время ответа: обычно в течение 1-2 часов\n"
+            ),
+        }
+
+    if language_code == "en":
+        return {
+            "PERIOD_14_DAYS": f"📅 14 days - {settings.format_price(settings.PRICE_14_DAYS)}",
+            "PERIOD_30_DAYS": f"📅 30 days - {settings.format_price(settings.PRICE_30_DAYS)}",
+            "PERIOD_60_DAYS": f"📅 60 days - {settings.format_price(settings.PRICE_60_DAYS)}",
+            "PERIOD_90_DAYS": f"📅 90 days - {settings.format_price(settings.PRICE_90_DAYS)}",
+            "PERIOD_180_DAYS": f"📅 180 days - {settings.format_price(settings.PRICE_180_DAYS)}",
+            "PERIOD_360_DAYS": f"📅 360 days - {settings.format_price(settings.PRICE_360_DAYS)}",
+            "TRAFFIC_5GB": f"📊 5 GB - {settings.format_price(settings.PRICE_TRAFFIC_5GB)}",
+            "TRAFFIC_10GB": f"📊 10 GB - {settings.format_price(settings.PRICE_TRAFFIC_10GB)}",
+            "TRAFFIC_25GB": f"📊 25 GB - {settings.format_price(settings.PRICE_TRAFFIC_25GB)}",
+            "TRAFFIC_50GB": f"📊 50 GB - {settings.format_price(settings.PRICE_TRAFFIC_50GB)}",
+            "TRAFFIC_100GB": f"📊 100 GB - {settings.format_price(settings.PRICE_TRAFFIC_100GB)}",
+            "TRAFFIC_250GB": f"📊 250 GB - {settings.format_price(settings.PRICE_TRAFFIC_250GB)}",
+            "TRAFFIC_UNLIMITED": f"📊 Unlimited - {settings.format_price(settings.PRICE_TRAFFIC_UNLIMITED)}",
+            "SUPPORT_INFO": (
+                "\n🛠️ <b>Technical support</b>\n\n"
+                "For any questions contact our support:\n\n"
+                f"👤 {settings.SUPPORT_USERNAME}\n\n"
+                "We can help with:\n"
+                "• Connection setup\n"
+                "• Troubleshooting issues\n"
+                "• Payment questions\n"
+                "• Other requests\n\n"
+                "⏰ Response time: usually within 1-2 hours\n"
+            ),
+        }
+
+    return {}
 
-<b>Принимая правила, вы соглашаетесь соблюдать их.</b>
-"""
 
 class Texts:
-    def __init__(self, language: str = "ru"):
-        self.language = language
-    
-    @property
-    def RULES_TEXT(self) -> str:
-        if self.language in _cached_rules:
-            return _cached_rules[self.language]
-        
-        return _get_default_rules(self.language)
-    
-    BACK = "⬅️ Назад"
-    CANCEL = "❌ Отмена"
-    CONFIRM = "✅ Подтвердить"
-    CONTINUE = "➡️ Продолжить"
-    YES = "✅ Да"
-    NO = "❌ Нет"
-    LOADING = "⏳ Загрузка..."
-    ERROR = "❌ Произошла ошибка"
-    SUCCESS = "✅ Успешно"
-    
+    def __init__(self, language: str = DEFAULT_LANGUAGE):
+        self.language = language or DEFAULT_LANGUAGE
+        raw_data = load_locale(self.language)
+        self._values = {key: value for key, value in raw_data.items()}
+
+        if self.language != DEFAULT_LANGUAGE:
+            fallback_data = load_locale(DEFAULT_LANGUAGE)
+        else:
+            fallback_data = self._values
+
+        self._fallback_values = {
+            key: value for key, value in fallback_data.items() if key not in self._values
+        }
+
+        self._values.update(_build_dynamic_values(self.language))
+
+    def __getattr__(self, item: str) -> Any:
+        if item == "language":
+            return super().__getattribute__(item)
+        try:
+            return self._get_value(item)
+        except KeyError as error:
+            raise AttributeError(item) from error
+
+    def __getitem__(self, item: str) -> Any:
+        return self._get_value(item)
+
+    def get(self, item: str, default: Any = None) -> Any:
+        try:
+            return self._get_value(item)
+        except KeyError:
+            return default
+
+    def t(self, key: str, default: Any = None) -> Any:
+        try:
+            return self._get_value(key)
+        except KeyError:
+            if default is not None:
+                return default
+            raise
+
+    def _get_value(self, item: str) -> Any:
+        if item == "RULES_TEXT":
+            return _get_cached_rules_value(self.language)
+
+        if item in self._values:
+            return self._values[item]
+
+        if item in self._fallback_values:
+            return self._fallback_values[item]
+
+        _logger.warning(
+            "Missing localization key '%s' for language '%s'",
+            item,
+            self.language,
+        )
+        raise KeyError(item)
+
     @staticmethod
     def format_price(kopeks: int) -> str:
-        return f"{int(kopeks / 100)} ₽"
-    
+        return settings.format_price(kopeks)
+
     @staticmethod
     def format_traffic(gb: float) -> str:
         if gb == 0:
             return "∞ (безлимит)"
-        elif gb >= 1024:
-            return f"{gb/1024:.1f} ТБ"
-        else:
-            return f"{gb:.0f} ГБ"
+        if gb >= 1024:
+            return f"{gb / 1024:.1f} ТБ"
+        return f"{gb:.0f} ГБ"
 
 
-class RussianTexts(Texts):
-    
-    def __init__(self):
-        super().__init__("ru")
-    
-    WELCOME = """
-🎉 <b>Добро пожаловать в VPN сервис!</b>
+def get_texts(language: str = DEFAULT_LANGUAGE) -> Texts:
+    return Texts(language)
 
-Наш сервис предоставляет быстрый и безопасный доступ к интернету без ограничений.
 
-🔐 <b>Преимущества:</b>
-• Высокая скорость подключения
-• Серверы в разных странах
-• Надежная защита данных
-• Круглосуточная поддержка
-
-Для начала работы выберите язык интерфейса:
-"""
-    
-    LANGUAGE_SELECTED = "🌐 Язык интерфейса установлен: <b>Русский</b>"
-    
-    RULES_ACCEPT = "✅ Принимаю правила"
-    RULES_DECLINE = "❌ Не принимаю"
-    RULES_REQUIRED = "❗️ Для использования сервиса необходимо принять правила!"
-    
-    REFERRAL_CODE_QUESTION = """
-🤝 <b>У вас есть реферальный код от друга?</b>
-
-Если у вас есть промокод или реферальная ссылка от друга, введите её сейчас, чтобы получить бонус!
-
-Введите код или нажмите "Пропустить":
-"""
-    
-    REFERRAL_CODE_APPLIED = "🎁 Реферальный код применен! Вы получите бонус после первой покупки."
-    REFERRAL_CODE_INVALID = "❌ Неверный реферальный код"
-    REFERRAL_CODE_SKIP = "⏭️ Пропустить"
-       
-    MAIN_MENU = """👤 <b>{user_name}</b>
-    
-📱 <b>Подписка:</b> {subscription_status}
-
-Выберите действие:
-"""
-    
-    MENU_BALANCE = "💰 Баланс"
-    MENU_SUBSCRIPTION = "📱 Подписка"
-    MENU_TRIAL = "🧪 Тестовая подписка"
-    MENU_BUY_SUBSCRIPTION = "💎 Купить подписку"
-    MENU_EXTEND_SUBSCRIPTION = "⏰ Продлить подписку"
-    MENU_PROMOCODE = "🎫 Промокод"
-    MENU_REFERRALS = "🤝 Партнерка"
-    MENU_SUPPORT = "🛠️ Техподдержка"
-    MENU_RULES = "📋 Правила сервиса"
-    MENU_LANGUAGE = "🌐 Язык"
-    MENU_ADMIN = "⚙️ Админ-панель"
-    BALANCE_BUTTON = "💰 Баланс: {balance}"
-    BALANCE_BUTTON_ZERO = "💰 Баланс: 0 ₽"
-    
-    SUBSCRIPTION_NONE = "❌ Нет активной подписки"
-    SUBSCRIPTION_TRIAL = "🧪 Тестовая подписка"
-    SUBSCRIPTION_ACTIVE = "✅ Активна"
-    SUBSCRIPTION_EXPIRED = "⏰ Истекла"
-    
-    SUBSCRIPTION_INFO = """
-📱 <b>Информация о подписке</b>
-
-📊 <b>Статус:</b> {status}
-🎭 <b>Тип:</b> {type}
-📅 <b>Действует до:</b> {end_date}
-⏰ <b>Осталось дней:</b> {days_left}
-
-📈 <b>Трафик:</b> {traffic_used} / {traffic_limit}
-🌍 <b>Серверы:</b> {countries_count} стран
-📱 <b>Устройства:</b> {devices_used} / {devices_limit}
-
-💳 <b>Автоплатеж:</b> {autopay_status}
-"""
-    
-    TRIAL_AVAILABLE = """
-🎁 <b>Тестовая подписка</b>
-
-Вы можете получить бесплатную тестовую подписку:
-
-⏰ <b>Период:</b> {days} дней
-📈 <b>Трафик:</b> {traffic} ГБ
-📱 <b>Устройства:</b> {devices} шт.
-🌍 <b>Сервер:</b> {server_name}
-
-Активировать тестовую подписку?
-"""
-    
-    TRIAL_ACTIVATED = "🎉 Тестовая подписка активирована!"
-    TRIAL_ALREADY_USED = "❌ Тестовая подписка уже была использована"
-
-    CHANGE_DEVICES_TITLE = "📱 Изменение количества устройств"
-    CHANGE_DEVICES_INFO = """
-    📱 <b>Изменение количества устройств</b>
-
-    Текущий лимит: {current_devices} устройств
-
-    Выберите новое количество устройств:
-
-    💡 <b>Важно:</b>
-    • При увеличении - доплата пропорционально оставшемуся времени
-    • При уменьшении - возврат средств не производится
-    """
-
-    CHANGE_DEVICES_CONFIRM = """
-    📱 <b>Подтверждение изменения</b>
-
-    Текущее количество: {current_devices} устройств
-    Новое количество: {new_devices} устройств
-
-    Действие: {action}
-    💰 {cost}
-
-    Подтвердить изменение?
-    """
-
-    CHANGE_DEVICES_SUCCESS_INCREASE = """
-    ✅ Количество устройств увеличено!
-
-    📱 Было: {old_count} → Стало: {new_count}
-    💰 Списано: {amount}
-    """
-
-    CHANGE_DEVICES_SUCCESS_DECREASE = """
-    ✅ Количество устройств уменьшено!
-
-    📱 Было: {old_count} → Стало: {new_count}
-    ℹ️ Возврат средств не производится
-    """
-
-    DEVICES_NO_CHANGE = "ℹ️ Количество устройств не изменилось"
-    DEVICES_MINIMUM_LIMIT = "⚠️ Минимальное количество устройств: {limit}"
-    DEVICES_LIMIT_EXCEEDED = "⚠️ Превышен максимальный лимит устройств ({limit})"
-    DEVICES_INSUFFICIENT_BALANCE = "⚠️ Недостаточно средств!\nТребуется: {required} (за {months} мес)\nУ вас: {balance}"
-    
-    BUY_SUBSCRIPTION_START = """
-💎 <b>Настройка подписки</b>
-
-Давайте настроим вашу подписку под ваши потребности.
-
-Сначала выберите период подписки:
-"""
-    
-    SELECT_PERIOD = "Выберите период:"
-    SELECT_TRAFFIC = "Выберите пакет трафика:"
-    SELECT_COUNTRIES = "Выберите страны:"
-    SELECT_DEVICES = "Количество устройств:"
-    
-    PERIOD_14_DAYS = f"📅 14 дней - {settings.format_price(settings.PRICE_14_DAYS)}"
-    PERIOD_30_DAYS = f"📅 30 дней - {settings.format_price(settings.PRICE_30_DAYS)}"
-    PERIOD_60_DAYS = f"📅 60 дней - {settings.format_price(settings.PRICE_60_DAYS)}"
-    PERIOD_90_DAYS = f"📅 90 дней - {settings.format_price(settings.PRICE_90_DAYS)}"
-    PERIOD_180_DAYS = f"📅 180 дней - {settings.format_price(settings.PRICE_180_DAYS)}"
-    PERIOD_360_DAYS = f"📅 360 дней - {settings.format_price(settings.PRICE_360_DAYS)}"
-    
-    TRAFFIC_5GB = f"📊 5 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_5GB)}"
-    TRAFFIC_10GB = f"📊 10 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_10GB)}"
-    TRAFFIC_25GB = f"📊 25 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_25GB)}"
-    TRAFFIC_50GB = f"📊 50 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_50GB)}"
-    TRAFFIC_100GB = f"📊 100 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_100GB)}"
-    TRAFFIC_250GB = f"📊 250 ГБ - {settings.format_price(settings.PRICE_TRAFFIC_250GB)}"
-    TRAFFIC_UNLIMITED = f"📊 Безлимит - {settings.format_price(settings.PRICE_TRAFFIC_UNLIMITED)}"
-    
-    SUBSCRIPTION_SUMMARY = """
-📋 <b>Итоговая конфигурация</b>
-
-📅 <b>Период:</b> {period} дней
-📈 <b>Трафик:</b> {traffic}
-🌍 <b>Страны:</b> {countries}
-📱 <b>Устройства:</b> {devices}
-
-💰 <b>Итого к оплате:</b> {total_price}
-
-Подтвердить покупку?
-"""
-    
-    INSUFFICIENT_BALANCE = """❌ Недостаточно средств на балансе.  
-    
-    <b>Пополните баланс на {amount} и попробуйте снова.</b>
-    """
-    GO_TO_BALANCE_TOP_UP = "💳 Перейти к пополнению баланса"
-    RETURN_TO_SUBSCRIPTION_CHECKOUT = "↩️ Вернуться к оформлению"
-    NO_SAVED_SUBSCRIPTION_ORDER = "❌ Сохраненный заказ не найден. Соберите подписку заново."
-    SUBSCRIPTION_PURCHASED = "🎉 Подписка успешно приобретена!"
-    
-    BALANCE_INFO = """
-💰 <b>Баланс: {balance}</b>
-
-Выберите действие:
-"""
-    
-    BALANCE_HISTORY = "📊 История операций"
-    BALANCE_TOP_UP = "💳 Пополнить"
-    BALANCE_SUPPORT_REQUEST = "🛠️ Запрос через поддержку"
-    
-    TOP_UP_AMOUNT = "💳 Введите сумму для пополнения (в рублях):"
-    TOP_UP_METHODS = """
-💳 <b>Выберите способ оплаты</b>
-
-Сумма: {amount}
-"""
-    
-    TOP_UP_STARS = "⭐ Telegram Stars"
-    TOP_UP_TRIBUTE = "💎 Банковская карта"
-    
-    PROMOCODE_ENTER = "🎫 Введите промокод:"
-    PROMOCODE_SUCCESS = "🎉 Промокод активирован! {description}"
-    PROMOCODE_INVALID = "❌ Неверный промокод"
-    PROMOCODE_EXPIRED = "❌ Промокод истек"
-    PROMOCODE_USED = "❌ Промокод уже использован"
-    
-    REFERRAL_INFO = """
-🤝 <b>Реферальная программа</b>
-
-👥 <b>Приглашено:</b> {referrals_count} друзей
-💰 <b>Заработано:</b> {earned_amount}
-
-🔗 <b>Ваша реферальная ссылка:</b>
-<code>{referral_link}</code>
-
-🎫 <b>Ваш промокод:</b>
-<code>{referral_code}</code>
-
-💰 <b>Условия:</b>
-• За каждого друга: {registration_bonus}
-• Процент с пополнений: {commission_percent}%
-"""
-    
-    REFERRAL_INVITE_MESSAGE = """
-🎯 <b>Приглашение в VPN сервис</b>
-
-Привет! Приглашаю тебя в отличный VPN сервис!
-
-🎁 По моей ссылке ты получишь бонус: {bonus}
-
-🔗 Переходи: {link}
-🎫 Или используй промокод: {code}
-
-💪 Быстро, надежно, недорого!
-"""
-
-    CREATE_INVITE = "📝 Создать приглашение"
-    CAMPAIGN_EXISTING_USER = (
-        "ℹ️ Эта рекламная ссылка доступна только новым пользователям."
-    )
-    CAMPAIGN_BONUS_BALANCE = (
-        "🎉 Вы получили {amount} за регистрацию по кампании «{name}»!"
-    )
-    CAMPAIGN_BONUS_SUBSCRIPTION = "🎉 Вам выдана подписка на {days} д. (трафик: {traffic}, устройств: {devices}) по кампании «{name}»!"
-
-    TRIAL_ENDING_SOON = """
-🎁 <b>Тестовая подписка скоро закончится!</b>
-
-Ваша тестовая подписка истекает через несколько часов.
-
-💎 <b>Не хотите остаться без VPN?</b>
-Переходите на полную подписку!
-
-🔥 <b>Специальное предложение:</b>
-• 30 дней всего за {price}
-• Безлимитный трафик  
-• Все серверы доступны
-• Скорость до 1ГБит/сек
-
-⚡️ Успейте оформить до окончания тестового периода!
-"""
-
-    MAINTENANCE_MODE_ACTIVE = """
-🔧 Технические работы!
-
-Сервис временно недоступен. Ведутся технические работы по улучшению качества обслуживания.
-
-⏰ Ориентировочное время завершения: неизвестно
-🔄 Попробуйте позже
-
-Приносим извинения за временные неудобства.
-"""
-
-    MAINTENANCE_MODE_API_ERROR = """
-🔧 Технические работы!
-
-Сервис временно недоступен из-за проблем с подключением к серверам.
-
-⏰ Мы работаем над восстановлением. Попробуйте через несколько минут.
-
-🔄 Последняя проверка: {last_check}
-"""
-
-    SUBSCRIPTION_EXPIRING_PAID = """
-⚠️ <b>Подписка истекает через {days_text}!</b>
-
-Ваша платная подписка истекает {end_date}.
-
-💳 <b>Автоплатеж:</b> {autopay_status}
-
-{action_text}
-"""
-
-    AUTOPAY_ENABLED_TEXT = "Включен - подписка продлится автоматически"
-    AUTOPAY_DISABLED_TEXT = "Отключен - не забудьте продлить вручную!"
-
-    SUBSCRIPTION_EXPIRED = """
-❌ <b>Подписка истекла</b>
-
-Ваша подписка истекла. Для восстановления доступа продлите подписку.
-
-🔧 Доступ к серверам заблокирован до продления.
-"""
-
-    AUTOPAY_SUCCESS = """
-✅ <b>Автоплатеж выполнен</b>
-
-Ваша подписка автоматически продлена на {days} дней.
-Списано с баланса: {amount}
-
-Новая дата окончания: {new_end_date}
-"""
-
-    AUTOPAY_FAILED = """
-❌ <b>Ошибка автоплатежа</b>
-
-Не удалось списать средства для продления подписки.
-
-💰 Ваш баланс: {balance}
-💳 Требуется: {required}
-
-Пополните баланс и продлите подписку вручную.
-"""
-    
-    SUPPORT_INFO = f"""
-🛠️ <b>Техническая поддержка</b>
-
-По всем вопросам обращайтесь к нашей поддержке:
-
-👤 {settings.get_support_contact_display_html()}
-
-Мы поможем с:
-• Настройкой подключения
-• Решением технических проблем  
-• Вопросами по оплате
-• Другими вопросами
-
-⏰ Время ответа: обычно в течение 1-2 часов
-"""
-    
-    CONTACT_SUPPORT = "💬 Написать в поддержку"
-    
-    ADMIN_PANEL = """
-⚙️ <b>Административная панель</b>
-
-Выберите раздел для управления:
-"""
-    
-    ADMIN_USERS = "👥 Пользователи"
-    ADMIN_SUBSCRIPTIONS = "📱 Подписки"
-    ADMIN_PROMOCODES = "🎫 Промокоды"
-    ADMIN_CAMPAIGNS = "📣 Рекламные кампании"
-    ADMIN_MESSAGES = "📨 Рассылки"
-    ADMIN_MONITORING = "🔍 Мониторинг"
-    ADMIN_REFERRALS = "🤝 Партнерка"
-    ADMIN_RULES = "📋 Правила"
-    ADMIN_REMNAWAVE = "🖥️ Remnawave"
-    ADMIN_STATISTICS = "📊 Статистика"
-    
-    ACCESS_DENIED = "❌ Доступ запрещен"
-    USER_NOT_FOUND = "❌ Пользователь не найден"
-    SUBSCRIPTION_NOT_FOUND = "❌ Подписка не найдена"
-    INVALID_AMOUNT = "❌ Неверная сумма"
-    OPERATION_CANCELLED = "❌ Операция отменена"
-    
-    SUBSCRIPTION_EXPIRING = """
-⚠️ <b>Подписка истекает!</b>
-
-Ваша подписка истекает через {days} дней.
-
-Не забудьте продлить подписку, чтобы не потерять доступ к серверам.
-"""
-    
-    SUBSCRIPTION_EXPIRED = """
-❌ <b>Подписка истекла</b>
-
-Ваша подписка истекла. Для восстановления доступа продлите подписку.
-"""
-    
-    AUTOPAY_SUCCESS = """
-✅ <b>Автоплатеж выполнен</b>
-
-Ваша подписка автоматически продлена на {days} дней.
-Списано с баланса: {amount}
-"""
-
-    SWITCH_TRAFFIC_TITLE = "🔄 Переключение лимита трафика"
-    SWITCH_TRAFFIC_INFO = """
-🔄 <b>Переключение лимита трафика</b>
-
-Текущий лимит: {current_traffic}
-Выберите новый лимит трафика:
-
-💡 <b>Важно:</b>
-• При увеличении - доплата за разницу пропорционально оставшемуся времени
-• При уменьшении - возврат средств не производится
-• Счетчик использованного трафика НЕ сбрасывается
-"""
-
-    SWITCH_TRAFFIC_CONFIRM = """
-🔄 <b>Подтверждение переключения трафика</b>
-
-Текущий лимит: {current_traffic}
-Новый лимит: {new_traffic}
-
-Действие: {action}
-💰 {cost}
-
-Подтвердить переключение?
-"""
-
-    SWITCH_TRAFFIC_SUCCESS_INCREASE = """
-✅ Лимит трафика увеличен!
-
-📊 Было: {old_traffic} → Стало: {new_traffic}
-💰 Списано: {amount}
-"""
-
-    SWITCH_TRAFFIC_SUCCESS_DECREASE = """
-✅ Лимит трафика уменьшен!
-
-📊 Было: {old_traffic} → Стало: {new_traffic}
-ℹ️ Возврат средств не производится
-"""
-
-    TRAFFIC_NO_CHANGE = "ℹ️ Лимит трафика не изменился"
-    TRAFFIC_INSUFFICIENT_BALANCE = "⚠️ Недостаточно средств!\nТребуется: {required} (за {months} мес)\nУ вас: {balance}"
-    
-    AUTOPAY_FAILED = """
-❌ <b>Ошибка автоплатежа</b>
-
-Не удалось списать средства для продления подписки.
-Недостаточно средств на балансе: {balance}
-Требуется: {required}
-
-Пополните баланс и продлите подписку вручную.
-"""
-
-
-class EnglishTexts(Texts):
-    
-    def __init__(self):
-        super().__init__("en")
-    
-    WELCOME = """
-🎉 <b>Welcome to VPN Service!</b>
-
-Our service provides fast and secure internet access without restrictions.
-
-🔐 <b>Advantages:</b>
-• High connection speed
-• Servers in different countries  
-• Reliable data protection
-• 24/7 support
-
-To get started, select interface language:
-"""
-    
-    LANGUAGE_SELECTED = "🌐 Interface language set: <b>English</b>"
-    
-    BACK = "⬅️ Back"
-    CANCEL = "❌ Cancel"
-    CONFIRM = "✅ Confirm"
-    CONTINUE = "➡️ Continue"
-    YES = "✅ Yes"
-    NO = "❌ No"
-    ADMIN_CAMPAIGNS = "📣 Campaigns"
-
-    MENU_BALANCE = "💰 Balance"
-    MENU_SUBSCRIPTION = "📱 Subscription"
-    MENU_TRIAL = "🎁 Trial subscription"
-    INSUFFICIENT_BALANCE = """❌ Insufficient balance. " \
-    
-    Top up {amount} and try again."""
-    GO_TO_BALANCE_TOP_UP = "💳 Go to balance top up"
-    RETURN_TO_SUBSCRIPTION_CHECKOUT = "↩️ Back to checkout"
-    NO_SAVED_SUBSCRIPTION_ORDER = "❌ Saved subscription order not found. Please configure it again."
-    CAMPAIGN_EXISTING_USER = "ℹ️ This campaign link is available for new users only."
-    CAMPAIGN_BONUS_BALANCE = "🎉 You received {amount} for joining via campaign “{name}”!"
-    CAMPAIGN_BONUS_SUBSCRIPTION = "🎉 You received a {days}-day subscription (traffic: {traffic}, devices: {devices}) from campaign “{name}”!"
-    
-
-LANGUAGES = {
-    "ru": RussianTexts,
-    "en": EnglishTexts
-}
-
-
-def get_texts(language: str = "ru") -> Texts:
-    return LANGUAGES.get(language, RussianTexts)()
-
-async def get_rules_from_db(language: str = "ru") -> str:
+async def get_rules_from_db(language: str = DEFAULT_LANGUAGE) -> str:
     try:
         from app.database.database import get_db
         from app.database.crud.rules import get_current_rules_content
-        
+
         async for db in get_db():
             rules = await get_current_rules_content(db, language)
             if rules:
                 _cached_rules[language] = rules
                 return rules
             break
-            
-    except Exception as e:
-        print(f"Ошибка получения правил из БД: {e}")
-    
-    default_rules = _get_default_rules(language)
-    _cached_rules[language] = default_rules
-    return default_rules
 
-def get_rules_sync(language: str = "ru") -> str:
+    except Exception as error:  # pragma: no cover - defensive logging
+        _logger.warning("Failed to load rules from DB for %s: %s", language, error)
+
+    default = _get_default_rules(language)
+    _cached_rules[language] = default
+    return default
+
+
+def _get_default_rules(language: str = DEFAULT_LANGUAGE) -> str:
+    default_key = "RULES_TEXT_DEFAULT"
+    locale = load_locale(language)
+    if default_key in locale:
+        return locale[default_key]
+    fallback = load_locale(DEFAULT_LANGUAGE)
+    return fallback.get(default_key, "")
+
+
+def get_rules_sync(language: str = DEFAULT_LANGUAGE) -> str:
+    if language in _cached_rules:
+        return _cached_rules[language]
+
     try:
-        if language in _cached_rules:
-            return _cached_rules[language]
-        
-        loop = asyncio.new_event_loop()
-        asyncio.set_event_loop(loop)
-        rules = loop.run_until_complete(get_rules_from_db(language))
-        loop.close()
-        return rules
-        
-    except Exception as e:
-        print(f"Ошибка получения правил: {e}")
-        return _get_default_rules(language)
+        loop = asyncio.get_running_loop()
+    except RuntimeError:
+        return asyncio.run(get_rules(language))
 
-async def refresh_rules_cache(language: str = "ru"):
-    try:
-        if language in _cached_rules:
-            del _cached_rules[language]
-        
-        await get_rules_from_db(language)
-        print(f"✅ Кеш правил для языка {language} обновлен")
-        
-    except Exception as e:
-        print(f"Ошибка обновления кеша правил: {e}")
+    loop.create_task(get_rules(language))
+    return _get_cached_rules_value(language)
 
-def clear_rules_cache():
-    global _cached_rules
+
+async def get_rules(language: str = DEFAULT_LANGUAGE) -> str:
+    if language in _cached_rules:
+        return _cached_rules[language]
+
+    return await get_rules_from_db(language)
+
+
+async def refresh_rules_cache(language: str = DEFAULT_LANGUAGE) -> None:
+    if language in _cached_rules:
+        del _cached_rules[language]
+    await get_rules_from_db(language)
+
+
+def clear_rules_cache() -> None:
     _cached_rules.clear()
-    print("✅ Кеш правил очищен")
+
+
+def reload_locales() -> None:
+    clear_locale_cache()

app/middlewares/channel_checker.py

@@ -8,6 +8,8 @@ from aiogram.enums import ChatMemberStatus
 
 from app.config import settings
 from app.keyboards.inline import get_channel_sub_keyboard
+from app.localization.loader import DEFAULT_LANGUAGE
+from app.localization.texts import get_texts
 from app.utils.check_reg_process import is_registration_process
 
 logger = logging.getLogger(__name__)
@@ -111,9 +113,27 @@ class ChannelCheckerMiddleware(BaseMiddleware):
     @staticmethod
     async def _deny_message(event: TelegramObject, bot: Bot, channel_link: str):
         logger.debug("🚫 Отправляем сообщение о необходимости подписки")
-        channel_sub_kb = get_channel_sub_keyboard(channel_link)
-        text = f"""🔒 Для использования бота подпишитесь на новостной канал, чтобы получать уведомления о новых возможностях и обновлениях бота. Спасибо!"""
-        
+
+        user = None
+        if isinstance(event, (Message, CallbackQuery)):
+            user = getattr(event, "from_user", None)
+        elif isinstance(event, Update):
+            if event.message and event.message.from_user:
+                user = event.message.from_user
+            elif event.callback_query and event.callback_query.from_user:
+                user = event.callback_query.from_user
+
+        language = DEFAULT_LANGUAGE
+        if user and user.language_code:
+            language = user.language_code.split('-')[0]
+
+        texts = get_texts(language)
+        channel_sub_kb = get_channel_sub_keyboard(channel_link, language=language)
+        text = texts.t(
+            "CHANNEL_REQUIRED_TEXT",
+            "🔒 Для использования бота подпишитесь на новостной канал, чтобы получать уведомления о новых возможностях и обновлениях бота. Спасибо!",
+        )
+
         try:
             if isinstance(event, Message):
                 return await event.answer(text, reply_markup=channel_sub_kb)

app/services/subscription_service.py

@@ -4,7 +4,7 @@ from typing import Optional, List, Tuple
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.config import settings
-from app.database.models import Subscription, User, SubscriptionStatus
+from app.database.models import Subscription, User, SubscriptionStatus, PromoGroup
 from app.external.remnawave_api import (
     RemnaWaveAPI, RemnaWaveUser, UserStatus, 
     TrafficLimitStrategy, RemnaWaveAPIError
@@ -19,6 +19,25 @@ from app.utils.pricing_utils import (
 
 logger = logging.getLogger(__name__)
 
+
+def _resolve_discount_percent(
+    user: Optional[User],
+    promo_group: Optional[PromoGroup],
+    category: str,
+    *,
+    period_days: Optional[int] = None,
+) -> int:
+    if user is not None:
+        try:
+            return user.get_promo_discount(category, period_days)
+        except AttributeError:
+            pass
+
+    if promo_group is not None:
+        return promo_group.get_discount_percent(category, period_days)
+
+    return 0
+
 def get_traffic_reset_strategy():
     from app.config import settings
     strategy = settings.DEFAULT_TRAFFIC_RESET_STRATEGY.upper()
@@ -266,9 +285,12 @@ class SubscriptionService:
         self,
         period_days: int,
         traffic_gb: int,
-        server_squad_ids: List[int], 
+        server_squad_ids: List[int],
         devices: int,
-        db: AsyncSession 
+        db: AsyncSession,
+        *,
+        user: Optional[User] = None,
+        promo_group: Optional[PromoGroup] = None,
     ) -> Tuple[int, List[int]]:
     
         from app.config import PERIOD_PRICES
@@ -279,68 +301,167 @@ class SubscriptionService:
     
         base_price = PERIOD_PRICES.get(period_days, 0)
         
+        promo_group = promo_group or (user.promo_group if user else None)
+
         traffic_price = settings.get_traffic_price(traffic_gb)
-    
+        traffic_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "traffic",
+            period_days=period_days,
+        )
+        traffic_discount = traffic_price * traffic_discount_percent // 100
+        discounted_traffic_price = traffic_price - traffic_discount
+
         server_prices = []
         total_servers_price = 0
-    
+        servers_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "servers",
+            period_days=period_days,
+        )
+
         for server_id in server_squad_ids:
             server = await get_server_squad_by_id(db, server_id)
             if server and server.is_available and not server.is_full:
-                server_prices.append(server.price_kopeks)
-                total_servers_price += server.price_kopeks
-                logger.debug(f"Сервер {server.display_name}: {server.price_kopeks/100}₽")
+                server_price = server.price_kopeks
+                server_discount = server_price * servers_discount_percent // 100
+                discounted_server_price = server_price - server_discount
+                server_prices.append(discounted_server_price)
+                total_servers_price += discounted_server_price
+                log_message = f"Сервер {server.display_name}: {server_price/100}₽"
+                if server_discount > 0:
+                    log_message += (
+                        f" (скидка {servers_discount_percent}%: -{server_discount/100}₽ → {discounted_server_price/100}₽)"
+                    )
+                logger.debug(log_message)
             else:
                 server_prices.append(0)
                 logger.warning(f"Сервер ID {server_id} недоступен")
-    
+
         devices_price = max(0, devices - settings.DEFAULT_DEVICE_LIMIT) * settings.PRICE_PER_DEVICE
-        
-        total_price = base_price + traffic_price + total_servers_price + devices_price
-        
+        devices_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "devices",
+            period_days=period_days,
+        )
+        devices_discount = devices_price * devices_discount_percent // 100
+        discounted_devices_price = devices_price - devices_discount
+
+        total_price = base_price + discounted_traffic_price + total_servers_price + discounted_devices_price
+
         logger.info(f"Расчет стоимости новой подписки:")
         logger.info(f"   Период {period_days} дней: {base_price/100}₽")
-        if traffic_price > 0:
-            logger.info(f"   Трафик {traffic_gb} ГБ: {traffic_price/100}₽")
+        if discounted_traffic_price > 0:
+            message = f"   Трафик {traffic_gb} ГБ: {traffic_price/100}₽"
+            if traffic_discount > 0:
+                message += (
+                    f" (скидка {traffic_discount_percent}%: -{traffic_discount/100}₽ → {discounted_traffic_price/100}₽)"
+                )
+            logger.info(message)
         if total_servers_price > 0:
-            logger.info(f"   Серверы ({len(server_squad_ids)}): {total_servers_price/100}₽")
-        if devices_price > 0:
-            logger.info(f"   Устройства ({devices}): {devices_price/100}₽")
+            message = f"   Серверы ({len(server_squad_ids)}): {total_servers_price/100}₽"
+            if servers_discount_percent > 0:
+                message += (
+                    f" (скидка {servers_discount_percent}% применяется ко всем серверам)"
+                )
+            logger.info(message)
+        if discounted_devices_price > 0:
+            message = f"   Устройства ({devices}): {devices_price/100}₽"
+            if devices_discount > 0:
+                message += (
+                    f" (скидка {devices_discount_percent}%: -{devices_discount/100}₽ → {discounted_devices_price/100}₽)"
+                )
+            logger.info(message)
         logger.info(f"   ИТОГО: {total_price/100}₽")
-        
+
         return total_price, server_prices
     
     async def calculate_renewal_price(
         self,
         subscription: Subscription,
         period_days: int,
-        db: AsyncSession
+        db: AsyncSession,
+        *,
+        user: Optional[User] = None,
+        promo_group: Optional[PromoGroup] = None,
     ) -> int:
         try:
             from app.config import PERIOD_PRICES
-            
+
             base_price = PERIOD_PRICES.get(period_days, 0)
-            
+
+            if user is None:
+                user = getattr(subscription, "user", None)
+            promo_group = promo_group or (user.promo_group if user else None)
+
             servers_price, _ = await self.get_countries_price_by_uuids(
                 subscription.connected_squads, db
             )
-            
+
+            servers_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "servers",
+                period_days=period_days,
+            )
+            servers_discount = servers_price * servers_discount_percent // 100
+            discounted_servers_price = servers_price - servers_discount
+
             devices_price = max(0, subscription.device_limit - settings.DEFAULT_DEVICE_LIMIT) * settings.PRICE_PER_DEVICE
-            
+            devices_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "devices",
+                period_days=period_days,
+            )
+            devices_discount = devices_price * devices_discount_percent // 100
+            discounted_devices_price = devices_price - devices_discount
+
             traffic_price = settings.get_traffic_price(subscription.traffic_limit_gb)
-            
-            total_price = base_price + servers_price + devices_price + traffic_price
-            
+            traffic_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "traffic",
+                period_days=period_days,
+            )
+            traffic_discount = traffic_price * traffic_discount_percent // 100
+            discounted_traffic_price = traffic_price - traffic_discount
+
+            total_price = (
+                base_price
+                + discounted_servers_price
+                + discounted_devices_price
+                + discounted_traffic_price
+            )
+
             logger.info(f"💰 Расчет стоимости продления для подписки {subscription.id} (по текущим ценам):")
             logger.info(f"   📅 Период {period_days} дней: {base_price/100}₽")
             if servers_price > 0:
-                logger.info(f"   🌍 Серверы ({len(subscription.connected_squads)}) по текущим ценам: {servers_price/100}₽")
+                message = f"   🌍 Серверы ({len(subscription.connected_squads)}) по текущим ценам: {discounted_servers_price/100}₽"
+                if servers_discount > 0:
+                    message += (
+                        f" (скидка {servers_discount_percent}%: -{servers_discount/100}₽ от {servers_price/100}₽)"
+                    )
+                logger.info(message)
             if devices_price > 0:
-                logger.info(f"   📱 Устройства ({subscription.device_limit}): {devices_price/100}₽")
+                message = f"   📱 Устройства ({subscription.device_limit}): {discounted_devices_price/100}₽"
+                if devices_discount > 0:
+                    message += (
+                        f" (скидка {devices_discount_percent}%: -{devices_discount/100}₽ от {devices_price/100}₽)"
+                    )
+                logger.info(message)
             if traffic_price > 0:
-                logger.info(f"   📊 Трафик ({subscription.traffic_limit_gb} ГБ): {traffic_price/100}₽")
+                message = f"   📊 Трафик ({subscription.traffic_limit_gb} ГБ): {discounted_traffic_price/100}₽"
+                if traffic_discount > 0:
+                    message += (
+                        f" (скидка {traffic_discount_percent}%: -{traffic_discount/100}₽ от {traffic_price/100}₽)"
+                    )
+                logger.info(message)
             logger.info(f"   💎 ИТОГО: {total_price/100}₽")
-            
+
             return total_price
             
         except Exception as e:
@@ -440,9 +561,12 @@ class SubscriptionService:
         self,
         period_days: int,
         traffic_gb: int,
-        server_squad_ids: List[int], 
+        server_squad_ids: List[int],
         devices: int,
-        db: AsyncSession 
+        db: AsyncSession,
+        *,
+        user: Optional[User] = None,
+        promo_group: Optional[PromoGroup] = None,
     ) -> Tuple[int, List[int]]:
     
         from app.config import PERIOD_PRICES
@@ -455,89 +579,183 @@ class SubscriptionService:
         
         base_price = PERIOD_PRICES.get(period_days, 0)
         
+        promo_group = promo_group or (user.promo_group if user else None)
+
         traffic_price_per_month = settings.get_traffic_price(traffic_gb)
-        total_traffic_price = traffic_price_per_month * months_in_period
-        
+        traffic_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "traffic",
+            period_days=period_days,
+        )
+        traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+        discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+        total_traffic_price = discounted_traffic_per_month * months_in_period
+
         server_prices = []
         total_servers_price = 0
-        
+        servers_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "servers",
+            period_days=period_days,
+        )
+
         for server_id in server_squad_ids:
             server = await get_server_squad_by_id(db, server_id)
             if server and server.is_available and not server.is_full:
                 server_price_per_month = server.price_kopeks
-                server_price_total = server_price_per_month * months_in_period
+                server_discount_per_month = server_price_per_month * servers_discount_percent // 100
+                discounted_server_per_month = server_price_per_month - server_discount_per_month
+                server_price_total = discounted_server_per_month * months_in_period
                 server_prices.append(server_price_total)
                 total_servers_price += server_price_total
-                logger.debug(f"Сервер {server.display_name}: {server_price_per_month/100}₽/мес x {months_in_period} мес = {server_price_total/100}₽")
+                log_message = (
+                    f"Сервер {server.display_name}: {server_price_per_month/100}₽/мес x {months_in_period} мес = {server_price_total/100}₽"
+                )
+                if server_discount_per_month > 0:
+                    log_message += (
+                        f" (скидка {servers_discount_percent}%: -{server_discount_per_month * months_in_period/100}₽)"
+                    )
+                logger.debug(log_message)
             else:
                 server_prices.append(0)
                 logger.warning(f"Сервер ID {server_id} недоступен")
-        
+
         additional_devices = max(0, devices - settings.DEFAULT_DEVICE_LIMIT)
         devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-        total_devices_price = devices_price_per_month * months_in_period
-        
+        devices_discount_percent = _resolve_discount_percent(
+            user,
+            promo_group,
+            "devices",
+            period_days=period_days,
+        )
+        devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+        discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+        total_devices_price = discounted_devices_per_month * months_in_period
+
         total_price = base_price + total_traffic_price + total_servers_price + total_devices_price
-        
+
         logger.info(f"Расчет стоимости новой подписки на {period_days} дней ({months_in_period} мес):")
         logger.info(f"   Период {period_days} дней: {base_price/100}₽")
         if total_traffic_price > 0:
-            logger.info(
+            message = (
                 f"   Трафик {traffic_gb} ГБ: {traffic_price_per_month/100}₽/мес x {months_in_period} = {total_traffic_price/100}₽"
             )
+            if traffic_discount_per_month > 0:
+                message += (
+                    f" (скидка {traffic_discount_percent}%: -{traffic_discount_per_month * months_in_period/100}₽)"
+                )
+            logger.info(message)
         if total_servers_price > 0:
-            logger.info(f"   Серверы ({len(server_squad_ids)}): {total_servers_price/100}₽")
+            message = f"   Серверы ({len(server_squad_ids)}): {total_servers_price/100}₽"
+            if servers_discount_percent > 0:
+                message += (
+                    f" (скидка {servers_discount_percent}% применяется ко всем серверам)"
+                )
+            logger.info(message)
         if total_devices_price > 0:
-            logger.info(
+            message = (
                 f"   Устройства ({additional_devices}): {devices_price_per_month/100}₽/мес x {months_in_period} = {total_devices_price/100}₽"
             )
+            if devices_discount_per_month > 0:
+                message += (
+                    f" (скидка {devices_discount_percent}%: -{devices_discount_per_month * months_in_period/100}₽)"
+                )
+            logger.info(message)
         logger.info(f"   ИТОГО: {total_price/100}₽")
-        
+
         return total_price, server_prices
     
     async def calculate_renewal_price_with_months(
         self,
         subscription: Subscription,
         period_days: int,
-        db: AsyncSession
+        db: AsyncSession,
+        *,
+        user: Optional[User] = None,
+        promo_group: Optional[PromoGroup] = None,
     ) -> int:
         try:
             from app.config import PERIOD_PRICES
-            
+
             months_in_period = calculate_months_from_days(period_days)
-            
+
             base_price = PERIOD_PRICES.get(period_days, 0)
-            
+
+            if user is None:
+                user = getattr(subscription, "user", None)
+            promo_group = promo_group or (user.promo_group if user else None)
+
             servers_price_per_month, _ = await self.get_countries_price_by_uuids(
                 subscription.connected_squads, db
             )
-            total_servers_price = servers_price_per_month * months_in_period
-            
+            servers_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "servers",
+                period_days=period_days,
+            )
+            servers_discount_per_month = servers_price_per_month * servers_discount_percent // 100
+            discounted_servers_per_month = servers_price_per_month - servers_discount_per_month
+            total_servers_price = discounted_servers_per_month * months_in_period
+
             additional_devices = max(0, subscription.device_limit - settings.DEFAULT_DEVICE_LIMIT)
             devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-            total_devices_price = devices_price_per_month * months_in_period
-            
+            devices_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "devices",
+                period_days=period_days,
+            )
+            devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+            discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+            total_devices_price = discounted_devices_per_month * months_in_period
+
             traffic_price_per_month = settings.get_traffic_price(subscription.traffic_limit_gb)
-            total_traffic_price = traffic_price_per_month * months_in_period
-            
+            traffic_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "traffic",
+                period_days=period_days,
+            )
+            traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+            discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+            total_traffic_price = discounted_traffic_per_month * months_in_period
+
             total_price = base_price + total_servers_price + total_devices_price + total_traffic_price
-            
+
             logger.info(f"💰 Расчет стоимости продления подписки {subscription.id} на {period_days} дней ({months_in_period} мес):")
             logger.info(f"   📅 Период {period_days} дней: {base_price/100}₽")
             if total_servers_price > 0:
-                logger.info(
+                message = (
                     f"   🌍 Серверы: {servers_price_per_month/100}₽/мес x {months_in_period} = {total_servers_price/100}₽"
                 )
+                if servers_discount_per_month > 0:
+                    message += (
+                        f" (скидка {servers_discount_percent}%: -{servers_discount_per_month * months_in_period/100}₽)"
+                    )
+                logger.info(message)
             if total_devices_price > 0:
-                logger.info(
+                message = (
                     f"   📱 Устройства: {devices_price_per_month/100}₽/мес x {months_in_period} = {total_devices_price/100}₽"
                 )
+                if devices_discount_per_month > 0:
+                    message += (
+                        f" (скидка {devices_discount_percent}%: -{devices_discount_per_month * months_in_period/100}₽)"
+                    )
+                logger.info(message)
             if total_traffic_price > 0:
-                logger.info(
+                message = (
                     f"   📊 Трафик: {traffic_price_per_month/100}₽/мес x {months_in_period} = {total_traffic_price/100}₽"
                 )
+                if traffic_discount_per_month > 0:
+                    message += (
+                        f" (скидка {traffic_discount_percent}%: -{traffic_discount_per_month * months_in_period/100}₽)"
+                    )
+                logger.info(message)
             logger.info(f"   💎 ИТОГО: {total_price/100}₽")
-            
+
             return total_price
             
         except Exception as e:
@@ -556,32 +774,92 @@ class SubscriptionService:
         
         if additional_server_ids is None:
             additional_server_ids = []
-        
-        current_time = datetime.utcnow()
+
         months_to_pay = get_remaining_months(subscription.end_date)
-        
+        period_hint_days = months_to_pay * 30 if months_to_pay > 0 else None
+
+        user = getattr(subscription, "user", None)
+        promo_group = user.promo_group if user else None
+
         total_price = 0
-        
+
         if additional_traffic_gb > 0:
             traffic_price_per_month = settings.get_traffic_price(additional_traffic_gb)
-            total_price += traffic_price_per_month * months_to_pay
-            logger.info(f"Трафик +{additional_traffic_gb}ГБ: {traffic_price_per_month/100}₽/мес x {months_to_pay} = {traffic_price_per_month * months_to_pay/100}₽")
-        
+            traffic_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "traffic",
+                period_days=period_hint_days,
+            )
+            traffic_discount_per_month = traffic_price_per_month * traffic_discount_percent // 100
+            discounted_traffic_per_month = traffic_price_per_month - traffic_discount_per_month
+            traffic_total_price = discounted_traffic_per_month * months_to_pay
+            total_price += traffic_total_price
+            message = (
+                f"Трафик +{additional_traffic_gb}ГБ: {traffic_price_per_month/100}₽/мес x {months_to_pay}"
+                f" = {traffic_total_price/100}₽"
+            )
+            if traffic_discount_per_month > 0:
+                message += (
+                    f" (скидка {traffic_discount_percent}%:"
+                    f" -{traffic_discount_per_month * months_to_pay/100}₽)"
+                )
+            logger.info(message)
+
         if additional_devices > 0:
             devices_price_per_month = additional_devices * settings.PRICE_PER_DEVICE
-            total_price += devices_price_per_month * months_to_pay
-            logger.info(f"Устройства +{additional_devices}: {devices_price_per_month/100}₽/мес x {months_to_pay} = {devices_price_per_month * months_to_pay/100}₽")
-        
+            devices_discount_percent = _resolve_discount_percent(
+                user,
+                promo_group,
+                "devices",
+                period_days=period_hint_days,
+            )
+            devices_discount_per_month = devices_price_per_month * devices_discount_percent // 100
+            discounted_devices_per_month = devices_price_per_month - devices_discount_per_month
+            devices_total_price = discounted_devices_per_month * months_to_pay
+            total_price += devices_total_price
+            message = (
+                f"Устройства +{additional_devices}: {devices_price_per_month/100}₽/мес x {months_to_pay}"
+                f" = {devices_total_price/100}₽"
+            )
+            if devices_discount_per_month > 0:
+                message += (
+                    f" (скидка {devices_discount_percent}%:"
+                    f" -{devices_discount_per_month * months_to_pay/100}₽)"
+                )
+            logger.info(message)
+
         if additional_server_ids and db:
             for server_id in additional_server_ids:
                 from app.database.crud.server_squad import get_server_squad_by_id
                 server = await get_server_squad_by_id(db, server_id)
                 if server and server.is_available:
                     server_price_per_month = server.price_kopeks
-                    server_total_price = server_price_per_month * months_to_pay
+                    servers_discount_percent = _resolve_discount_percent(
+                        user,
+                        promo_group,
+                        "servers",
+                        period_days=period_hint_days,
+                    )
+                    server_discount_per_month = (
+                        server_price_per_month * servers_discount_percent // 100
+                    )
+                    discounted_server_per_month = (
+                        server_price_per_month - server_discount_per_month
+                    )
+                    server_total_price = discounted_server_per_month * months_to_pay
                     total_price += server_total_price
-                    logger.info(f"Сервер {server.display_name}: {server_price_per_month/100}₽/мес x {months_to_pay} = {server_total_price/100}₽")
-        
+                    message = (
+                        f"Сервер {server.display_name}: {server_price_per_month/100}₽/мес x {months_to_pay}"
+                        f" = {server_total_price/100}₽"
+                    )
+                    if server_discount_per_month > 0:
+                        message += (
+                            f" (скидка {servers_discount_percent}%:"
+                            f" -{server_discount_per_month * months_to_pay/100}₽)"
+                        )
+                    logger.info(message)
+
         logger.info(f"Итого доплата за {months_to_pay} мес: {total_price/100}₽")
         return total_price
     

app/services/user_service.py

@@ -1,6 +1,6 @@
 import logging
 from datetime import datetime, timedelta
-from typing import Optional, List, Dict, Any
+from typing import Optional, List, Dict, Any, Tuple
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy import delete, select, update
 from aiogram import Bot
@@ -10,13 +10,14 @@ from app.database.crud.user import (
     get_users_count, get_users_statistics, get_inactive_users,
     add_user_balance, subtract_user_balance, update_user, delete_user
 )
+from app.database.crud.promo_group import get_promo_group_by_id
 from app.database.crud.transaction import get_user_transactions_count
 from app.database.crud.subscription import get_subscription_by_user_id
 from app.database.models import (
-    User, UserStatus, Subscription, Transaction, PromoCode, PromoCodeUse, 
-    ReferralEarning, SubscriptionServer, YooKassaPayment, BroadcastHistory, 
-    CryptoBotPayment, SubscriptionConversion, UserMessage, WelcomeText, 
-    SentNotification
+    User, UserStatus, Subscription, Transaction, PromoCode, PromoCodeUse,
+    ReferralEarning, SubscriptionServer, YooKassaPayment, BroadcastHistory,
+    CryptoBotPayment, SubscriptionConversion, UserMessage, WelcomeText,
+    SentNotification, PromoGroup
 )
 from app.config import settings
 
@@ -192,10 +193,10 @@ class UserService:
             user = await get_user_by_id(db, user_id)
             if not user:
                 return False
-            
+
             # Сохраняем старый баланс для уведомления
             old_balance = user.balance_kopeks
-            
+
             if amount_kopeks > 0:
                 await add_user_balance(db, user, amount_kopeks, description=description)
                 logger.info(f"Админ {admin_id} пополнил баланс пользователя {user_id} на {amount_kopeks/100}₽")
@@ -204,26 +205,61 @@ class UserService:
                 success = await subtract_user_balance(db, user, abs(amount_kopeks), description)
                 if success:
                     logger.info(f"Админ {admin_id} списал с баланса пользователя {user_id} {abs(amount_kopeks)/100}₽")
-            
+
             # Отправляем уведомление пользователю, если операция прошла успешно
             if success and bot:
                 # Обновляем пользователя для получения нового баланса
                 await db.refresh(user)
-                
+
                 # Получаем имя администратора
                 if not admin_name:
                     admin_user = await get_user_by_id(db, admin_id)
                     admin_name = admin_user.full_name if admin_user else f"Админ #{admin_id}"
-                
+
                 # Отправляем уведомление (не блокируем операцию если не удалось отправить)
                 await self._send_balance_notification(bot, user, amount_kopeks, admin_name)
-            
+
             return success
-            
+
         except Exception as e:
             logger.error(f"Ошибка изменения баланса пользователя: {e}")
             return False
-    
+
+    async def update_user_promo_group(
+        self,
+        db: AsyncSession,
+        user_id: int,
+        promo_group_id: int
+    ) -> Tuple[bool, Optional[User], Optional[PromoGroup]]:
+        try:
+            user = await get_user_by_id(db, user_id)
+            if not user:
+                return False, None, None
+
+            promo_group = await get_promo_group_by_id(db, promo_group_id)
+            if not promo_group:
+                return False, None, None
+
+            user.promo_group_id = promo_group.id
+            user.promo_group = promo_group
+            user.updated_at = datetime.utcnow()
+
+            await db.commit()
+            await db.refresh(user)
+
+            logger.info(
+                "👥 Промогруппа пользователя %s обновлена на '%s'",
+                user.telegram_id,
+                promo_group.name,
+            )
+
+            return True, user, promo_group
+
+        except Exception as e:
+            await db.rollback()
+            logger.error(f"Ошибка обновления промогруппы пользователя {user_id}: {e}")
+            return False, None, None
+
     async def block_user(
         self,
         db: AsyncSession,

app/states.py

@@ -59,10 +59,20 @@ class AdminStates(StatesGroup):
     editing_campaign_subscription_traffic = State()
     editing_campaign_subscription_devices = State()
     editing_campaign_subscription_servers = State()
-    
+
     waiting_for_broadcast_message = State()
     waiting_for_broadcast_media = State()
     confirming_broadcast = State()
+
+    creating_promo_group_name = State()
+    creating_promo_group_traffic_discount = State()
+    creating_promo_group_server_discount = State()
+    creating_promo_group_device_discount = State()
+
+    editing_promo_group_name = State()
+    editing_promo_group_traffic_discount = State()
+    editing_promo_group_server_discount = State()
+    editing_promo_group_device_discount = State()
     
     editing_squad_price = State()
     editing_traffic_price = State()

app/utils/payment_utils.py

@@ -1,5 +1,7 @@
 from typing import List, Dict, Tuple
+
 from app.config import settings
+from app.localization.texts import get_texts
 
 def get_available_payment_methods() -> List[Dict[str, str]]:
     """
@@ -54,28 +56,50 @@ def get_available_payment_methods() -> List[Dict[str, str]]:
     
     return methods
 
-def get_payment_methods_text() -> str:
+def get_payment_methods_text(language: str) -> str:
     """
     Генерирует текст с описанием доступных способов оплаты
     """
+    texts = get_texts(language)
     methods = get_available_payment_methods()
-    
+
     if len(methods) <= 1:  # Только поддержка
-        return """💳 <b>Способы пополнения баланса</b>
+        return texts.t(
+            "PAYMENT_METHODS_ONLY_SUPPORT",
+            """💳 <b>Способы пополнения баланса</b>
 
 ⚠️ В данный момент автоматические способы оплаты временно недоступны.
 Обратитесь в техподдержку для пополнения баланса.
 
-Выберите способ пополнения:"""
-    
-    text = "💳 <b>Способы пополнения баланса</b>\n\n"
-    text += "Выберите удобный для вас способ оплаты:\n\n"
-    
+Выберите способ пополнения:""",
+        )
+
+    text = texts.t(
+        "PAYMENT_METHODS_TITLE",
+        "💳 <b>Способы пополнения баланса</b>",
+    ) + "\n\n"
+    text += texts.t(
+        "PAYMENT_METHODS_PROMPT",
+        "Выберите удобный для вас способ оплаты:",
+    ) + "\n\n"
+
     for method in methods:
-        text += f"{method['icon']} <b>{method['name']}</b> - {method['description']}\n"
-    
-    text += "\nВыберите способ пополнения:"
-    
+        method_id = method['id'].upper()
+        name = texts.t(
+            f"PAYMENT_METHOD_{method_id}_NAME",
+            f"{method['icon']} <b>{method['name']}</b>",
+        )
+        description = texts.t(
+            f"PAYMENT_METHOD_{method_id}_DESCRIPTION",
+            method['description'],
+        )
+        text += f"{name} - {description}\n"
+
+    text += "\n" + texts.t(
+        "PAYMENT_METHODS_FOOTER",
+        "Выберите способ пополнения:",
+    )
+
     return text
 
 def is_payment_method_available(method_id: str) -> bool:

app/utils/pricing_utils.py

@@ -1,4 +1,5 @@
 from datetime import datetime, timedelta
+from datetime import datetime
 from typing import Tuple
 import logging
 
@@ -28,8 +29,8 @@ def calculate_period_multiplier(period_days: int) -> Tuple[int, float]:
 
 
 def calculate_prorated_price(
-    monthly_price: int, 
-    end_date: datetime, 
+    monthly_price: int,
+    end_date: datetime,
     min_charge_months: int = 1
 ) -> Tuple[int, int]:
     months_remaining = get_remaining_months(end_date)
@@ -42,6 +43,25 @@ def calculate_prorated_price(
     return total_price, months_to_charge
 
 
+def apply_percentage_discount(amount: int, percent: int) -> Tuple[int, int]:
+    if amount <= 0 or percent <= 0:
+        return amount, 0
+
+    clamped_percent = max(0, min(100, percent))
+    discount_value = amount * clamped_percent // 100
+    discounted_amount = amount - discount_value
+
+    logger.debug(
+        "Применена скидка %s%%: %s → %s (скидка %s)",
+        clamped_percent,
+        amount,
+        discounted_amount,
+        discount_value,
+    )
+
+    return discounted_amount, discount_value
+
+
 def format_period_description(days: int, language: str = "ru") -> str:
     months = calculate_months_from_days(days)
     

docker-compose.yml

@@ -57,11 +57,13 @@ services:
       REDIS_URL: "redis://redis:6379/0"
       
       TZ: "Europe/Moscow"
+      LOCALES_PATH: "${LOCALES_PATH:-/app/locales}"
     volumes:
       # Логи
       - ./logs:/app/logs:rw
       # Данные приложения (для SQLite в случае переключения)
       - ./data:/app/data:rw
+      - ./locales:/app/locales:rw
       # Конфигурация приложения
       # - ./app-config.json:/app/app-config.json:ro
       # Timezone

main.py

@@ -18,6 +18,7 @@ from app.external.webhook_server import WebhookServer
 from app.external.yookassa_webhook import start_yookassa_webhook_server
 from app.database.universal_migration import run_universal_migration
 from app.services.backup_service import backup_service
+from app.localization.loader import ensure_locale_templates
 
 
 class GracefulExit:
@@ -43,6 +44,11 @@ async def main():
     logger = logging.getLogger(__name__)
     logger.info("🚀 Запуск Bedolaga Remnawave Bot...")
     
+    try:
+        ensure_locale_templates()
+    except Exception as error:
+        logger.warning("Failed to prepare locale templates: %s", error)
+
     killer = GracefulExit()
     signal.signal(signal.SIGINT, killer.exit_gracefully)
     signal.signal(signal.SIGTERM, killer.exit_gracefully)

migrations/alembic/versions/1f5f3a3f5a4d_add_promo_groups_and_user_fk.py

@@ -0,0 +1,224 @@
+"""add promo groups table and link users"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+PROMO_GROUPS_TABLE = "promo_groups"
+USERS_TABLE = "users"
+PROMO_GROUP_COLUMN = "promo_group_id"
+PROMO_GROUP_INDEX = "ix_users_promo_group_id"
+PROMO_GROUP_FK = "fk_users_promo_group_id_promo_groups"
+DEFAULT_PROMO_GROUP_NAME = "Базовый юзер"
+
+
+def _table_exists(inspector: sa.Inspector, table_name: str) -> bool:
+    return table_name in inspector.get_table_names()
+
+
+def _column_exists(inspector: sa.Inspector, table_name: str, column_name: str) -> bool:
+    return any(col["name"] == column_name for col in inspector.get_columns(table_name))
+
+
+def _index_exists(inspector: sa.Inspector, table_name: str, index_name: str) -> bool:
+    return any(index["name"] == index_name for index in inspector.get_indexes(table_name))
+
+
+def _foreign_key_exists(inspector: sa.Inspector, table_name: str, fk_name: str) -> bool:
+    return any(fk["name"] == fk_name for fk in inspector.get_foreign_keys(table_name))
+
+revision: str = "1f5f3a3f5a4d"
+down_revision: Union[str, None] = "cbd1be472f3d"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
+
+    if not _table_exists(inspector, PROMO_GROUPS_TABLE):
+        op.create_table(
+            PROMO_GROUPS_TABLE,
+            sa.Column("id", sa.Integer(), primary_key=True),
+            sa.Column("name", sa.String(length=255), nullable=False),
+            sa.Column(
+                "server_discount_percent",
+                sa.Integer(),
+                nullable=False,
+                server_default=sa.text("0"),
+            ),
+            sa.Column(
+                "traffic_discount_percent",
+                sa.Integer(),
+                nullable=False,
+                server_default=sa.text("0"),
+            ),
+            sa.Column(
+                "device_discount_percent",
+                sa.Integer(),
+                nullable=False,
+                server_default=sa.text("0"),
+            ),
+            sa.Column(
+                "is_default",
+                sa.Boolean(),
+                nullable=False,
+                server_default=sa.text("false"),
+            ),
+            sa.Column(
+                "created_at",
+                sa.DateTime(),
+                nullable=False,
+                server_default=sa.func.now(),
+            ),
+            sa.Column(
+                "updated_at",
+                sa.DateTime(),
+                nullable=False,
+                server_default=sa.func.now(),
+            ),
+            sa.UniqueConstraint("name", name="uq_promo_groups_name"),
+        )
+        inspector = sa.inspect(bind)
+
+    if not _column_exists(inspector, USERS_TABLE, PROMO_GROUP_COLUMN):
+        op.add_column(
+            USERS_TABLE,
+            sa.Column(PROMO_GROUP_COLUMN, sa.Integer(), nullable=True),
+        )
+        inspector = sa.inspect(bind)
+
+    if _column_exists(inspector, USERS_TABLE, PROMO_GROUP_COLUMN):
+        if not _index_exists(inspector, USERS_TABLE, PROMO_GROUP_INDEX):
+            op.create_index(PROMO_GROUP_INDEX, USERS_TABLE, [PROMO_GROUP_COLUMN])
+
+        inspector = sa.inspect(bind)
+        if not _foreign_key_exists(inspector, USERS_TABLE, PROMO_GROUP_FK):
+            op.create_foreign_key(
+                PROMO_GROUP_FK,
+                USERS_TABLE,
+                PROMO_GROUPS_TABLE,
+                [PROMO_GROUP_COLUMN],
+                ["id"],
+                ondelete="RESTRICT",
+            )
+
+    inspector = sa.inspect(bind)
+    if not _table_exists(inspector, PROMO_GROUPS_TABLE) or not _column_exists(
+        inspector, USERS_TABLE, PROMO_GROUP_COLUMN
+    ):
+        return
+
+    promo_groups_table = sa.table(
+        PROMO_GROUPS_TABLE,
+        sa.column("id", sa.Integer()),
+        sa.column("name", sa.String()),
+        sa.column("server_discount_percent", sa.Integer()),
+        sa.column("traffic_discount_percent", sa.Integer()),
+        sa.column("device_discount_percent", sa.Integer()),
+        sa.column("is_default", sa.Boolean()),
+    )
+
+    connection = bind
+    existing_named_group = (
+        connection.execute(
+            sa.select(
+                promo_groups_table.c.id,
+                promo_groups_table.c.is_default,
+            )
+            .where(promo_groups_table.c.name == DEFAULT_PROMO_GROUP_NAME)
+            .limit(1)
+        )
+        .mappings()
+        .first()
+    )
+
+    if existing_named_group:
+        default_group_id = existing_named_group["id"]
+        if not existing_named_group["is_default"]:
+            connection.execute(
+                sa.update(promo_groups_table)
+                .where(promo_groups_table.c.id == default_group_id)
+                .values(is_default=True)
+            )
+    else:
+        default_group_id = connection.execute(
+            sa.select(promo_groups_table.c.id)
+            .where(promo_groups_table.c.is_default.is_(True))
+            .limit(1)
+        ).scalar_one_or_none()
+
+        if default_group_id is None:
+            default_group_id = connection.execute(
+                sa.insert(promo_groups_table)
+                .values(
+                    name=DEFAULT_PROMO_GROUP_NAME,
+                    server_discount_percent=0,
+                    traffic_discount_percent=0,
+                    device_discount_percent=0,
+                    is_default=True,
+                )
+                .returning(promo_groups_table.c.id)
+            ).scalar_one()
+
+    users_table = sa.table(
+        USERS_TABLE,
+        sa.column("promo_group_id", sa.Integer()),
+    )
+    connection.execute(
+        sa.update(users_table)
+        .where(users_table.c.promo_group_id.is_(None))
+        .values(promo_group_id=default_group_id)
+    )
+
+    inspector = sa.inspect(bind)
+    column_info = next(
+        (col for col in inspector.get_columns(USERS_TABLE) if col["name"] == PROMO_GROUP_COLUMN),
+        None,
+    )
+    if column_info and column_info.get("nullable", True):
+        op.alter_column(
+            USERS_TABLE,
+            PROMO_GROUP_COLUMN,
+            existing_type=sa.Integer(),
+            nullable=False,
+        )
+
+
+def downgrade() -> None:
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
+
+    if _column_exists(inspector, USERS_TABLE, PROMO_GROUP_COLUMN):
+        column_info = next(
+            (
+                col
+                for col in inspector.get_columns(USERS_TABLE)
+                if col["name"] == PROMO_GROUP_COLUMN
+            ),
+            None,
+        )
+        if column_info and not column_info.get("nullable", False):
+            op.alter_column(
+                USERS_TABLE,
+                PROMO_GROUP_COLUMN,
+                existing_type=sa.Integer(),
+                nullable=True,
+            )
+
+        inspector = sa.inspect(bind)
+        if _foreign_key_exists(inspector, USERS_TABLE, PROMO_GROUP_FK):
+            op.drop_constraint(PROMO_GROUP_FK, USERS_TABLE, type_="foreignkey")
+
+        inspector = sa.inspect(bind)
+        if _index_exists(inspector, USERS_TABLE, PROMO_GROUP_INDEX):
+            op.drop_index(PROMO_GROUP_INDEX, table_name=USERS_TABLE)
+
+        op.drop_column(USERS_TABLE, PROMO_GROUP_COLUMN)
+
+    inspector = sa.inspect(bind)
+    if _table_exists(inspector, PROMO_GROUPS_TABLE):
+        op.drop_table(PROMO_GROUPS_TABLE)

migrations/alembic/versions/3d9b35c6bd8f_add_paid_price_to_subscription.py

@@ -1,29 +0,0 @@
-"""add_paid_price_to_subscription
-
-Revision ID: 3d9b35c6bd8f
-Revises: 
-Create Date: 2025-08-23 08:17:00.563340
-
-"""
-from typing import Sequence, Union
-
-from alembic import op
-import sqlalchemy as sa
-
-
-# revision identifiers, used by Alembic.
-revision: str = '3d9b35c6bd8f'
-down_revision: Union[str, None] = None
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
-
-
-def upgrade():
-    # ### commands auto generated by Alembic - please adjust! ###
-    op.add_column('subscriptions', sa.Column('paid_price_kopeks', sa.Integer(), nullable=False, server_default='0'))
-    # ### end Alembic commands ###
-
-def downgrade():
-    # ### commands auto generated by Alembic - please adjust! ###
-    op.drop_column('subscriptions', 'paid_price_kopeks')
-    # ### end Alembic commands ###

migrations/alembic/versions/5d1f1f8b2e9a_add_advertising_campaigns.py

@@ -6,6 +6,21 @@ from alembic import op
 import sqlalchemy as sa
 
 
+CAMPAIGNS_TABLE = "advertising_campaigns"
+CAMPAIGNS_START_INDEX = "ix_advertising_campaigns_start_parameter"
+CAMPAIGNS_ID_INDEX = "ix_advertising_campaigns_id"
+REGISTRATIONS_TABLE = "advertising_campaign_registrations"
+REGISTRATIONS_ID_INDEX = "ix_advertising_campaign_registrations_id"
+
+
+def _table_exists(inspector: sa.Inspector, table_name: str) -> bool:
+    return table_name in inspector.get_table_names()
+
+
+def _index_exists(inspector: sa.Inspector, table_name: str, index_name: str) -> bool:
+    return any(index["name"] == index_name for index in inspector.get_indexes(table_name))
+
+
 revision: str = "5d1f1f8b2e9a"
 down_revision: Union[str, None] = "cbd1be472f3d"
 branch_labels: Union[str, Sequence[str], None] = None
@@ -13,58 +28,119 @@ depends_on: Union[str, Sequence[str], None] = None
 
 
 def upgrade() -> None:
-    op.create_table(
-        "advertising_campaigns",
-        sa.Column("id", sa.Integer(), primary_key=True),
-        sa.Column("name", sa.String(length=255), nullable=False),
-        sa.Column("start_parameter", sa.String(length=64), nullable=False),
-        sa.Column("bonus_type", sa.String(length=20), nullable=False),
-        sa.Column("balance_bonus_kopeks", sa.Integer(), nullable=False, server_default="0"),
-        sa.Column("subscription_duration_days", sa.Integer(), nullable=True),
-        sa.Column("subscription_traffic_gb", sa.Integer(), nullable=True),
-        sa.Column("subscription_device_limit", sa.Integer(), nullable=True),
-        sa.Column("subscription_squads", sa.JSON(), nullable=True),
-        sa.Column("is_active", sa.Boolean(), nullable=False, server_default=sa.text("true")),
-        sa.Column("created_by", sa.Integer(), nullable=True),
-        sa.Column("created_at", sa.DateTime(), server_default=sa.func.now(), nullable=False),
-        sa.Column("updated_at", sa.DateTime(), server_default=sa.func.now(), nullable=False),
-        sa.ForeignKeyConstraint(["created_by"], ["users.id"], ondelete="SET NULL"),
-    )
-    op.create_index(
-        "ix_advertising_campaigns_start_parameter",
-        "advertising_campaigns",
-        ["start_parameter"],
-        unique=True,
-    )
-    op.create_index(
-        "ix_advertising_campaigns_id",
-        "advertising_campaigns",
-        ["id"],
-    )
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
 
-    op.create_table(
-        "advertising_campaign_registrations",
-        sa.Column("id", sa.Integer(), primary_key=True),
-        sa.Column("campaign_id", sa.Integer(), nullable=False),
-        sa.Column("user_id", sa.Integer(), nullable=False),
-        sa.Column("bonus_type", sa.String(length=20), nullable=False),
-        sa.Column("balance_bonus_kopeks", sa.Integer(), nullable=False, server_default="0"),
-        sa.Column("subscription_duration_days", sa.Integer(), nullable=True),
-        sa.Column("created_at", sa.DateTime(), server_default=sa.func.now(), nullable=False),
-        sa.ForeignKeyConstraint(["campaign_id"], ["advertising_campaigns.id"], ondelete="CASCADE"),
-        sa.ForeignKeyConstraint(["user_id"], ["users.id"], ondelete="CASCADE"),
-        sa.UniqueConstraint("campaign_id", "user_id", name="uq_campaign_user"),
-    )
-    op.create_index(
-        "ix_advertising_campaign_registrations_id",
-        "advertising_campaign_registrations",
-        ["id"],
-    )
+    if not _table_exists(inspector, CAMPAIGNS_TABLE):
+        op.create_table(
+            CAMPAIGNS_TABLE,
+            sa.Column("id", sa.Integer(), primary_key=True),
+            sa.Column("name", sa.String(length=255), nullable=False),
+            sa.Column("start_parameter", sa.String(length=64), nullable=False),
+            sa.Column("bonus_type", sa.String(length=20), nullable=False),
+            sa.Column(
+                "balance_bonus_kopeks",
+                sa.Integer(),
+                nullable=False,
+                server_default="0",
+            ),
+            sa.Column("subscription_duration_days", sa.Integer(), nullable=True),
+            sa.Column("subscription_traffic_gb", sa.Integer(), nullable=True),
+            sa.Column("subscription_device_limit", sa.Integer(), nullable=True),
+            sa.Column("subscription_squads", sa.JSON(), nullable=True),
+            sa.Column(
+                "is_active",
+                sa.Boolean(),
+                nullable=False,
+                server_default=sa.text("true"),
+            ),
+            sa.Column("created_by", sa.Integer(), nullable=True),
+            sa.Column(
+                "created_at",
+                sa.DateTime(),
+                server_default=sa.func.now(),
+                nullable=False,
+            ),
+            sa.Column(
+                "updated_at",
+                sa.DateTime(),
+                server_default=sa.func.now(),
+                nullable=False,
+            ),
+            sa.ForeignKeyConstraint(["created_by"], ["users.id"], ondelete="SET NULL"),
+        )
+        inspector = sa.inspect(bind)
+
+    if not _index_exists(inspector, CAMPAIGNS_TABLE, CAMPAIGNS_START_INDEX):
+        op.create_index(
+            CAMPAIGNS_START_INDEX,
+            CAMPAIGNS_TABLE,
+            ["start_parameter"],
+            unique=True,
+        )
+
+    inspector = sa.inspect(bind)
+    if not _index_exists(inspector, CAMPAIGNS_TABLE, CAMPAIGNS_ID_INDEX):
+        op.create_index(CAMPAIGNS_ID_INDEX, CAMPAIGNS_TABLE, ["id"])
+
+    inspector = sa.inspect(bind)
+    if not _table_exists(inspector, REGISTRATIONS_TABLE):
+        op.create_table(
+            REGISTRATIONS_TABLE,
+            sa.Column("id", sa.Integer(), primary_key=True),
+            sa.Column("campaign_id", sa.Integer(), nullable=False),
+            sa.Column("user_id", sa.Integer(), nullable=False),
+            sa.Column("bonus_type", sa.String(length=20), nullable=False),
+            sa.Column(
+                "balance_bonus_kopeks",
+                sa.Integer(),
+                nullable=False,
+                server_default="0",
+            ),
+            sa.Column("subscription_duration_days", sa.Integer(), nullable=True),
+            sa.Column(
+                "created_at",
+                sa.DateTime(),
+                server_default=sa.func.now(),
+                nullable=False,
+            ),
+            sa.ForeignKeyConstraint(
+                ["campaign_id"],
+                [f"{CAMPAIGNS_TABLE}.id"],
+                ondelete="CASCADE",
+            ),
+            sa.ForeignKeyConstraint(["user_id"], ["users.id"], ondelete="CASCADE"),
+            sa.UniqueConstraint("campaign_id", "user_id", name="uq_campaign_user"),
+        )
+        inspector = sa.inspect(bind)
+
+    if not _index_exists(inspector, REGISTRATIONS_TABLE, REGISTRATIONS_ID_INDEX):
+        op.create_index(
+            REGISTRATIONS_ID_INDEX,
+            REGISTRATIONS_TABLE,
+            ["id"],
+        )
 
 
 def downgrade() -> None:
-    op.drop_index("ix_advertising_campaign_registrations_id", table_name="advertising_campaign_registrations")
-    op.drop_table("advertising_campaign_registrations")
-    op.drop_index("ix_advertising_campaigns_id", table_name="advertising_campaigns")
-    op.drop_index("ix_advertising_campaigns_start_parameter", table_name="advertising_campaigns")
-    op.drop_table("advertising_campaigns")
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
+
+    if _index_exists(inspector, REGISTRATIONS_TABLE, REGISTRATIONS_ID_INDEX):
+        op.drop_index(REGISTRATIONS_ID_INDEX, table_name=REGISTRATIONS_TABLE)
+
+    inspector = sa.inspect(bind)
+    if _table_exists(inspector, REGISTRATIONS_TABLE):
+        op.drop_table(REGISTRATIONS_TABLE)
+
+    inspector = sa.inspect(bind)
+    if _index_exists(inspector, CAMPAIGNS_TABLE, CAMPAIGNS_ID_INDEX):
+        op.drop_index(CAMPAIGNS_ID_INDEX, table_name=CAMPAIGNS_TABLE)
+
+    inspector = sa.inspect(bind)
+    if _index_exists(inspector, CAMPAIGNS_TABLE, CAMPAIGNS_START_INDEX):
+        op.drop_index(CAMPAIGNS_START_INDEX, table_name=CAMPAIGNS_TABLE)
+
+    inspector = sa.inspect(bind)
+    if _table_exists(inspector, CAMPAIGNS_TABLE):
+        op.drop_table(CAMPAIGNS_TABLE)

migrations/alembic/versions/8fd1e338eb45_add_sent_notifications_table.py

@@ -1,8 +1,11 @@
 """add sent notifications table"""
 
 from typing import Sequence, Union
+
 from alembic import op
 import sqlalchemy as sa
+from sqlalchemy.engine.reflection import Inspector
+
 
 revision: str = '8fd1e338eb45'
 down_revision: Union[str, None] = '3d9b35c6bd8f'
@@ -10,18 +13,46 @@ branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 
 
+TABLE_NAME = 'sent_notifications'
+UNIQUE_CONSTRAINT_NAME = 'uq_sent_notifications'
+UNIQUE_CONSTRAINT_COLUMNS = ['user_id', 'subscription_id', 'notification_type', 'days_before']
+
+
+def _table_exists(inspector: Inspector) -> bool:
+    return TABLE_NAME in inspector.get_table_names()
+
+
+def _unique_constraint_exists(inspector: Inspector) -> bool:
+    existing_constraints = {
+        constraint['name'] for constraint in inspector.get_unique_constraints(TABLE_NAME)
+    }
+    return UNIQUE_CONSTRAINT_NAME in existing_constraints
+
+
 def upgrade() -> None:
-    op.create_table(
-        'sent_notifications',
-        sa.Column('id', sa.Integer(), primary_key=True),
-        sa.Column('user_id', sa.Integer(), sa.ForeignKey('users.id'), nullable=False),
-        sa.Column('subscription_id', sa.Integer(), sa.ForeignKey('subscriptions.id'), nullable=False),
-        sa.Column('notification_type', sa.String(length=50), nullable=False),
-        sa.Column('days_before', sa.Integer(), nullable=True),
-        sa.Column('created_at', sa.DateTime(), server_default=sa.func.now()),
-        sa.UniqueConstraint('user_id', 'subscription_id', 'notification_type', 'days_before', name='uq_sent_notifications'),
-    )
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
+
+    if not _table_exists(inspector):
+        op.create_table(
+            TABLE_NAME,
+            sa.Column('id', sa.Integer(), primary_key=True),
+            sa.Column('user_id', sa.Integer(), sa.ForeignKey('users.id'), nullable=False),
+            sa.Column('subscription_id', sa.Integer(), sa.ForeignKey('subscriptions.id'), nullable=False),
+            sa.Column('notification_type', sa.String(length=50), nullable=False),
+            sa.Column('days_before', sa.Integer(), nullable=True),
+            sa.Column('created_at', sa.DateTime(), server_default=sa.func.now()),
+            sa.UniqueConstraint(*UNIQUE_CONSTRAINT_COLUMNS, name=UNIQUE_CONSTRAINT_NAME),
+        )
+    elif not _unique_constraint_exists(inspector):
+        op.create_unique_constraint(
+            UNIQUE_CONSTRAINT_NAME, TABLE_NAME, UNIQUE_CONSTRAINT_COLUMNS
+        )
 
 
 def downgrade() -> None:
-    op.drop_table('sent_notifications')
+    bind = op.get_bind()
+    inspector = sa.inspect(bind)
+
+    if _table_exists(inspector):
+        op.drop_table(TABLE_NAME)

migrations/alembic/versions/cbd1be472f3d_add_cascade_to_sent_notifications.py

@@ -1,24 +0,0 @@
-"""add cascade delete to sent notifications"""
-
-from typing import Sequence, Union
-from alembic import op
-import sqlalchemy as sa
-
-revision: str = 'cbd1be472f3d'
-down_revision: Union[str, None] = '8fd1e338eb45'
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
-
-
-def upgrade() -> None:
-    op.drop_constraint('sent_notifications_user_id_fkey', 'sent_notifications', type_='foreignkey')
-    op.drop_constraint('sent_notifications_subscription_id_fkey', 'sent_notifications', type_='foreignkey')
-    op.create_foreign_key('fk_sent_notifications_user_id_users', 'sent_notifications', 'users', ['user_id'], ['id'], ondelete='CASCADE')
-    op.create_foreign_key('fk_sent_notifications_subscription_id_subscriptions', 'sent_notifications', 'subscriptions', ['subscription_id'], ['id'], ondelete='CASCADE')
-
-
-def downgrade() -> None:
-    op.drop_constraint('fk_sent_notifications_user_id_users', 'sent_notifications', type_='foreignkey')
-    op.drop_constraint('fk_sent_notifications_subscription_id_subscriptions', 'sent_notifications', type_='foreignkey')
-    op.create_foreign_key('sent_notifications_user_id_fkey', 'sent_notifications', 'users', ['user_id'], ['id'])
-    op.create_foreign_key('sent_notifications_subscription_id_fkey', 'sent_notifications', 'subscriptions', ['subscription_id'], ['id'])

requirements.txt

@@ -11,6 +11,7 @@ pydantic==2.11.9
 pydantic-settings==2.10.1
 python-dotenv==1.1.1
 redis==5.0.1
+PyYAML==6.0.2
 
 # YooKassa SDK
 yookassa==3.7.0