Управление браками

Это руководство для администраторов по управлению системой браков в боте. Система браков позволяет пользователям создавать браки друг с другом, отслеживать их длительность и статус.

Админ-панель управления браками

Для доступа к админ-панели управления браками отправьте команду /admin_marriages в личные сообщения боту. Команда доступна только администраторам и работает только в личных сообщениях.

Админ-панель предоставляет следующие возможности:

• Создание брака - создание брака между двумя пользователями
• Расторжение брака - расторжение существующего брака
• Изменение даты - изменение даты создания брака
• Просмотр информации - просмотр детальной информации о браке

Быстрое создание брака

Для быстрого создания брака используйте команду:

/admin_marry @user1 @user2 [DD.MM.YYYY]

Примеры:

• /admin_marry @username1 @username2 - создаст брак с сегодняшней датой
• /admin_marry @username1 @username2 01.01.2020 - создаст брак с указанной датой
• /admin_marry 123456789 987654321 - создаст брак по ID пользователей

Важно:

• Команда работает только в личных сообщениях
• Доступна только администраторам
• Если один из пользователей уже состоит в браке, предыдущий брак будет автоматически расторгнут
• При создании брака бот автоматически отправляет уведомление в группу с поздравлениями
• Если дата не указана, используется сегодняшняя дата
• Формат даты: DD.MM.YYYY (например, 15.03.2024)

Интерактивное создание брака

Через админ-панель (/admin_marriages):

1. Выберите пункт "Создать брак"
2. Отправьте упоминание первого пользователя (@username) или его ID
3. Отправьте упоминание второго пользователя (@username) или его ID
4. Если нужно указать дату - отправьте дату в формате DD.MM.YYYY, или отправьте "сегодня"
5. Подтвердите создание брака

Поиск пользователей:

При указании имени пользователя (не username и не ID) бот выполнит поиск по базе данных. Поиск работает с русскими именами и без учета регистра. Если найдено несколько пользователей, вам будет предложено выбрать нужного из списка.

Примеры поиска:

• Иван - найдет пользователей с именем "Иван" (в любом регистре)
• Мария - найдет пользователей с именем "Мария" или "мария"
• @username - точное упоминание по username
• 123456789 - поиск по ID пользователя

Расторжение брака

Для расторжения брака:

1. Откройте админ-панель командой /admin_marriages
2. Выберите пункт "Расторгнуть брак"
3. Отправьте упоминание пользователя (@username), его имя или ID
4. Подтвердите расторжение брака

Примечание: При расторжении брака бот автоматически отправляет уведомление в группу с информацией о расторжении и датой расторжения.

Изменение даты брака

Для изменения даты брака:

1. Откройте админ-панель командой /admin_marriages
2. Выберите пункт "Изменить дату"
3. Отправьте упоминание пользователя (@username), его имя или ID
4. Отправьте новую дату в формате DD.MM.YYYY (например, 01.01.2020)
5. Подтвердите изменение даты

Важно: Изменение даты влияет на длительность брака и его статус (годовщины).

Просмотр информации о браке

Для просмотра информации о браке:

1. Откройте админ-панель командой /admin_marriages
2. Выберите пункт "Просмотр информации"
3. Отправьте упоминание пользователя (@username), его имя или ID

Вы получите информацию о:

• Участниках брака
• Дате свадьбы
• Длительности брака
• Текущем статусе (годовщине)

Система статусов брака

Браки имеют различные статусы в зависимости от длительности:

Статусы до 1 года:

• Сразу после создания - Молодожены 💑
• 2 месяца - Зеленая свадьба 💚
• 3 месяца - Ситцевая свадьба 🧵
• 4 месяца - Льняная свадьба 🌾
• 5 месяцев - Шелковая свадьба 🎀
• 6 месяцев - Розовая свадьба 🌹
• 7 месяцев - Медная свадьба 🪙
• 8 месяцев - Жестяная свадьба 🥫
• 9 месяцев - Фаянсовая свадьба 🍶
• 10 месяцев - Алюминиевая свадьба 🔩
• 11 месяцев - Стальная свадьба ⚙️
• 12 месяцев (1 год) - Никелевая свадьба 🔗

Статусы после 1 года:

• 1 год - Бумажная свадьба 📄
• 2 года - Деревянная свадьба 🪵
• 5 лет - Оловянная свадьба 🥫
• 10 лет - Хрустальная свадьба 💎
• 15 лет - Фарфоровая свадьба 🍽️
• 20 лет - Предсеребряная свадьба 🔘
• 25 лет - Серебряная свадьба 🥈
• 30 лет - Жемчужная свадьба 🫧
• 35 лет - Предрубиновая свадьба 🔴
• 40 лет - Рубиновая свадьба 💎
• 50 лет - Золотая свадьба 🥇
• 60 лет - Бриллиантовая свадьба 💎
• 70+ лет - Платиновая свадьба ⚪

Команды для пользователей

Пользователи могут использовать следующие команды в группе:

• /marry @username или /пожениться @username - предложить брак пользователю (работает только в группе)
• /divorce или /развестись - расторгнуть свой брак
• /my_marriage - посмотреть информацию о своем браке
• /marriages - посмотреть список всех браков в сообществе

Уведомления в группе

Бот автоматически отправляет уведомления в группу при следующих действиях:

• Создание брака: При создании брака через админ-панель или обычную команду /marry бот отправляет уведомление с информацией о браке (участники, дата, длительность, статус) и поздравлениями.
• Расторжение брака: При расторжении брака (через админ-панель или команду /divorce) бот отправляет уведомление о расторжении с датой и временем.
• Автоматическое расторжение: Если при создании нового брака автоматически расторгается предыдущий, в уведомлении будет указана информация об этом.

Особенности системы

• Один брак на пользователя: Пользователь может состоять только в одном браке одновременно. При создании нового брака предыдущий автоматически расторгается.
• Коулдаун: Между предложениями брака одному и тому же пользователю есть ограничение по времени.
• Предложения брака: Предложения брака действительны в течение 5 минут.
• Автоматическое расторжение: При создании нового брака для пользователя, который уже состоит в браке, старый брак автоматически расторгается.
• Поиск пользователей: Система поиска поддерживает русские имена и работает без учета регистра. Можно искать по имени, фамилии, username или ID пользователя.

Отмена действий

В любой момент выполнения действия в админ-панели вы можете отменить его, отправив команду:

/cancel

или нажав кнопку "Отмена" в интерфейсе.