# 🎯 КНОПОЧНЫЙ ИНТЕРФЕЙС — РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ ## ✅ ЧТО РЕАЛИЗОВАНО Все команды теперь доступны через **кнопки**, slash-команды остались как альтернатива для опытных пользователей! --- ## 🛡️ АДМИН-МЕНЮ ### Вызов: `/admin` **Новое меню включает:** ``` 🛡️ ПАНЕЛЬ АДМИНИСТРАТОРА [📊 Статистика] [🕵️ Шпионы] [👥 Пользователи] [⏳ Непроверенные] [🏆 Рейтинг] [☠️ Токсичность] [🏠 Квартиры] [⚠️ Предупреждения] [🔇 Муты] [🚫 Баны] [🔍 Поиск] [👤 Действия] [📥 Экспорт] [📤 Рассылка] [🚫 Отозвать вериф.] [📋 Список не вериф.] [❓ Помощь] ``` --- ### 🔍 ПОИСК **Кнопка «🔍 Поиск»** → два варианта: #### 1. Поиск квартиры - Нажимаете «🏠 Поиск квартиры» - Бот просит ввести номер квартиры - Вводите: `88` или `12А` - Бот показывает всех жильцов этой квартиры #### 2. Поиск пользователя - Нажимаете «👤 Поиск пользователя» - Бот просит ввести имя, username или ID - Вводите: `Иван` или `@ivan` или `123456789` - Бот показывает найденных пользователей (до 20) --- ### 👤 ДЕЙСТВИЯ С ПОЛЬЗОВАТЕЛЕМ **Кнопка «👤 Действия»** → список пользователей с пагинацией: ``` 👥 Выберите пользователя ✅ Иван (кв. 45) | 123456789 ⏳ Мария (кв. 12) | 987654321 ✅ Пётр (кв. 88) | 456789123 ⬅️ Назад Вперёд ➡️ 📄 Стр. 1/5 🔙 Назад ``` **После выбора пользователя:** ``` ⚙️ Действия с пользователем 👤 Иван (кв. 45) ID: 123456789 [⚠️ Предупредить] [🚫 Забанить] [✅ Разбанить] [🔓 Снять вериф.] [⏳ Отозвать (7д)] [📊 Рейтинг] [📝 История] [📞 Телефон] [🔙 Назад к списку] [🔙 В меню] ``` #### Доступные действия: | Кнопка | Действие | |--------|----------| | ⚠️ Предупредить | TODO: Выдать предупреждение | | 🚫 Забанить | Бан с подтверждением (Да/Нет) | | ✅ Разбанить | Разбанить если забанен | | 🔓 Снять верификацию | Снять верификацию мгновенно | | ⏳ Отозвать (7д) | TODO: Отозвать на 7 дней | | 📊 Рейтинг | Показать рейтинг пользователя | | 📝 История | TODO: История профиля | | 📞 Телефон | Показать телефон пользователя | --- ### ⚠️ ПРЕДУПРЕЖДЕНИЯ (АНТИ-СПАМ) **Кнопка «⚠️ Предупреждения»** → подменю: ``` ⚠️ Предупреждения и анти-спам [📋 Стоп-слова] [🌐 Домены] [🔑 Паттерны] [🔑 Ключевые слова] [🔙 Назад] ``` #### Управление стоп-словами: 1. **«📋 Стоп-слова»** → список слов с пагинацией 2. Нажмите на слово `❌ слово` чтобы удалить 3. **«➕ Добавить слово»** → введите слово текстом 4. **«⬅️/➡️»** — навигация по страницам #### Управление доменами: 1. **«🌐 Домены»** → список доменов 2. Нажмите на домен чтобы удалить 3. **«➕ Добавить домен»** → введите домен текстом #### Управление паттернами: 1. **«🔑 Паттерны»** → список паттернов 2. Нажмите на паттерн чтобы удалить 3. **«➕ Добавить паттерн»** → введите паттерн текстом --- ### 🏆 РЕЙТИНГ **Кнопка «🏆 Рейтинг»** → топ-10 + меню: ``` 🏆 ТОП-10 ПО РЕЙТИНГУ 🥇 Иван (кв. 45) └─ Рейтинг: 150 | Уровень: Сосед 🥈 Мария (кв. 12) └─ Рейтинг: 120 | Уровень: Сосед ... [🏆 Топ-10] [📊 Уровни] [🔙 Назад] ``` --- ### ☠️ ТОКСИЧНОСТЬ **Кнопка «☠️ Токсичность»** → подменю: ``` ☠️ Токсичность пользователей [☠️ Топ токсичных] [📊 Статистика] [🔙 Назад] ``` #### Топ токсичных: Показывает топ-10 пользователей по toxicity score #### Статистика токсичности: - Всего пользователей - Токсичных (>50) - Средний score --- ### 🔇 МУТЫ / 🚫 БАНЫ **Кнопка «🔇 Муты»** → список замутованных пользователей **Кнопка «🚫 Баны»** → список забаненных пользователей --- ### 📋 СПИСОК НЕ ВЕРИФИЦИРОВАННЫХ **Кнопка «📋 Список не вериф.»** → пользователи с отозванной верификацией --- ## 🏠 ПОЛЬЗОВАТЕЛЬСКОЕ МЕНЮ ### Вызов: `/start` или кнопка «🔙 В главное меню» ``` 🏠 ГЛАВНОЕ МЕНЮ ЖИЛЬЦА [📞 Экстренные телефоны] [👷 Мастера] [👮 Участковый] [📅 График отключений] [📢 Объявления] [🏆 Достижения] [📅 События] [💰 Платежи] [📋 Опросы] [🔍 Моя квартира] [📣 Подать объявление] [📊 Токсичность] [🏠 Темы чата] [🙏 Поблагодарить] [❓ Помощь] ``` --- ### 🙏 ПОБЛАГОДАРИТЬ **Кнопка «🙏 Поблагодарить»** → выбор пользователя: ``` 🙏 Поблагодарить пользователя Выберите пользователя которому хотите сказать спасибо: (+10 к рейтингу) 🙏 Иван (кв. 45) 🙏 Мария (кв. 12) 🙏 Пётр (кв. 88) ⬅️ ➡️ 🔙 Назад ``` **После выбора:** ``` 🙏 Поблагодарить пользователя? Иван (кв. 45) Пользователь получит +10 к рейтингу. [✅ Поблагодарить] [❌ Отмена] ``` **После подтверждения:** - Пользователь получает +10 к рейтингу - Вы можете поблагодарить ещё раз через 24 часа - Нельзя поблагодарить самого себя --- ### 🏆 ДОСТИЖЕНИЯ **Кнопка «🏆 Достижения»** → показывает ваши достижения (команда `/achievements`) --- ### 📅 СОБЫТИЯ **Кнопка «📅 События»** → список событий дома (команда `/events`) --- ### 💰 ПЛАТЕЖИ **Кнопка «💰 Платежи»** → список платежей ЖКХ (команда `/payments`) --- ### 📋 ОПРОСЫ **Кнопка «📋 Опросы»** → активные опросы (команда `/polls`) --- ### 📊 ТОКСИЧНОСТЬ **Кнопка «📊 Токсичность»** → топ-10 токсичных пользователей --- ### 🏠 ТЕМЫ ЧАТА **Кнопка «🏠 Темы чата»** → статистика по темам чата (команда `/topics`) --- ### 🔍 МОЯ КВАРТИРА **Кнопка «🔍 Моя квартира»** → информация о вашей квартире: - Номер квартиры - Статус верификации - Рейтинг - Уровень --- ### 📣 ПОДАТЬ ОБЪЯВЛЕНИЕ **Кнопка «📣 Подать объявление»** → мастер создания объявления (команда `/ad`) --- ### 📅 ГРАФИК ОТКЛЮЧЕНИЙ **Кнопка «📅 График отключений»** → расписание отключений (команда `/график`) --- ### 📢 ОБЪЯВЛЕНИЯ **Кнопка «📢 Объявления»** → доска объявлений (команда `/ads`) --- ## 🎯 ПРЕИМУЩЕСТВА НОВОГО ИНТЕРФЕЙСА | Было | Стало | |------|-------| | Нужно помнить команды | Всё в меню | | Нужно вводить ID вручную | Выбор кнопками | | Ошибки в синтаксисе | Невозможно ошибиться | | Неочевидно что доступно | Все функции видны | | Только slash-команды | Кнопки + slash (по желанию) | | Нет пагинации | Пагинация на 20 элементов | | Нет подтверждения действий | Подтверждение для важных действий | --- ## 🔧 ТЕХНИЧЕСКИЕ ДЕТАЛИ ### Пагинация: - **20 пользователей** на странице - Навигация: **⬅️ Назад** / **Вперёд ➡️** - Инфо: **📄 Стр. X/Y** ### Состояния (FSM): - Поиск квартиры - Поиск пользователя - Добавление стоп-слова - Добавление домена - Добавление паттерна ### Подтверждения: - Бан пользователя (Да/Нет) - Благодарность пользователя (Да/Нет) --- ## 🧪 ТЕСТИРОВАНИЕ ### Тест 1: Админ-меню ```bash /admin ``` **Ожидаешь:** Меню со всеми кнопками ### Тест 2: Поиск квартиры 1. `/admin` → «🔍 Поиск» → «🏠 Поиск квартиры» 2. Введи: `45` 3. **Ожидаешь:** Список жильцов кв. 45 ### Тест 3: Действия с пользователем 1. `/admin` → «👤 Действия» 2. Выбери пользователя из списка 3. Нажми «🚫 Забанить» → «✅ Да» 4. **Ожидаешь:** Пользователь забанен ### Тест 4: Стоп-слова 1. `/admin` → «⚠️ Предупреждения» → «📋 Стоп-слова» 2. Нажми на слово чтобы удалить 3. «➕ Добавить слово» → введи слово 4. **Ожидаешь:** Слово добавлено/удалено ### Тест 5: Поблагодарить 1. `/start` → «🙏 Поблагодарить» 2. Выбери пользователя 3. Подтверди благодарность 4. **Ожидаешь:** +10 к рейтингу пользователя --- ## 📝 ЗАМЕЧАНИЯ ### TODO (требует доработки): - ⏳ Отозвать верификацию на 7 дней (требуется поле в БД) - 📝 История профиля (интеграция с /history) - ⚠️ Предупредить пользователя (интеграция с системой warning) ### Slash-команды (альтернатива): Все slash-команды продолжают работать: - `/stats`, `/spies`, `/users`, `/ban`, `/revoke` и т.д. - Русские алиасы: `/статистика`, `/шпионы`, `/пользователи` --- ## 🚀 СЛЕДУЮЩИЕ ШАГИ 1. **Протестировать** все сценарии в бою 2. **Собрать фидбек** от админов и пользователей 3. **Доработать** TODO функции 4. **Добавить** новые кнопки по запросу --- **ВСЁ ГОТОВО К ТЕСТИРОВАНИЮ! 🎉**