Merge pull request #153 from Fr1ngg/codex/update-readme-with-available-features

docs: expand functionality overview

README.md

@@ -538,35 +538,37 @@ WEBHOOK_PATH=/webhook
 🛒 **Умная покупка подписок**
 - 📅 Гибкие периоды (14-360 дней)
 - 📊 Выбор трафика или фиксированный лимит
-- 🌍 Автоматический выбор серверов(для одного сквада) или ручной выбор из множества
-- 📱 Настройка количества устройств
+- 🌍 Автоматический выбор серверов (для одного сквада) или ручной выбор из множества
+- 📱 Настройка количества устройств и серверов прямо при оформлении
+- 🧾 Понятный калькулятор стоимости с учетом всех опций
 
 🧪 **Тестовая подписка**
 - Настраиваемый триал-период
-- Уведомления об истечении
-- Плавный переход на платную версию
-- Приветственное сообщение с предложением активации триала (С возможностью отключения)
+- Уведомления об истечении и сценарий мягкой конверсии в платную подписку
+- Приветственное сообщение с предложением активации триала (с возможностью отключения)
+- Поддержка рекламных кампаний с автоматической выдачей бонусных подписок
 
 💰 **Удобные платежи**
-- ⭐ Telegram Stars 
-- 💳 Tribute 
-- 💳 YooKassa
-- 💰 CryptoBot
-- 🎁 Реферальные бонусы
-- Детальная история транзакций 
+- ⭐ Telegram Stars
+- 💳 Tribute
+- 💳 YooKassa (включая СБП и онлайн-чек)
+- 💰 CryptoBot (мультивалюта и срок жизни инвойсов)
+- 🎁 Реферальные и промо-бонусы
+- Детальная история транзакций и чеков
 
 📱 **Управление подписками**
-- 📈 Статистика использования в реальном времени (Используемый трафик, подключенные устройства)
-- 🔄 Автопродление с баланса
-- 🔄 Управление трафиком
-- 🌍 Переключение серверов на лету
+- 📈 Статистика использования в реальном времени (трафик, устройства, серверы)
+- 🔄 Автопродление с баланса с настройкой дней и мгновенными уведомлениями
+- 🔄 Управление трафиком и лимитами без участия оператора
+- 🌍 Переключение серверов Remnawave на лету
 - 📱 Управление устройствами + сброс HWID
+- 🧩 Смена языка и персональных настроек
 
 🎁 **Бонусная система**
-- 🎫 Промокоды на деньги/дни/триал
-- 👥 Защищенная реферальная программа с комиссиями
-- 🔔 Своевременные уведомления
-- 📊 Детальная статистика рефералов
+- 🎫 Промокоды на деньги/дни/длинный триал
+- 👥 Защищенная реферальная программа с комиссиями и антифродом
+- 📊 Детальная статистика рефералов и кампаний
+- 📨 Персональные рассылки и уведомления о новых бонусах
 
 </td>
 <td width="50%" valign="top">
@@ -574,63 +576,85 @@ 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`). Эти файлы можно редактировать напрямую на рабочем сервере.